activity-log

Utilice la política Registro de actividad para configurar las preferencias de registro para la actividad de API que se almacena en el análisis de IBM® API Connect . Las preferencias que especifique van a alterar temporalmente los valores predeterminados en cuanto a la recopilación y almacenado de detalles de la actividad de la API.

Soporte de pasarela

Tabla 1. Tabla que muestra qué pasarelas soportan esta política y la versión de política correspondiente
Pasarela	Versión de política
DataPower® Gateway (v5 compatible)	1.0.0

En este tema se describe cómo configurar la política en el origen de OpenAPI ; para obtener detalles sobre cómo configurar la política en la interfaz de usuario de ensamblaje, consulte Registro de actividad.

Nota: Si utiliza DataPower API Gateway, configure las preferencias de registro utilizando la extensión activity-log .

Acerca de

La política activity-log tiene el formato siguiente:

- activity-log:
  version: version
  title: title
  description: description
  content: activity_to_log_if_call_successful
  error-content: activity_to_log_if_call_unsuccessful

Aplique esta política añadiendo una extensión assembly con un campo execute al archivo de definición OpenAPI .

También puede aplicar una política activity-log utilizando el editor de ensamblaje API Designer para añadir una política incorporada a la API. Para obtener más información, consulte Registro de actividad en la sección de políticas incorporadas.

Nota: Si el registro de carga útil está habilitado, para que la pasarela capture el almacenamiento intermedio de cargas útiles también debe estar habilitado.

activity-log:
  success-content: activity_to_log_if_call_successful
  error-content: activity_to_log_if_call_unsuccessful
  enabled: is_activity_logging_enabled
buffering: true

Propiedades

La tabla siguiente describe las propiedades de política.

Tabla 2. Propiedades de la política Registro de actividad
Propiedad	Obligatorio	Descripción	Tipo de datos
version	Sí	El número de versión de la política	serie
title	Sí	Título de la política.	serie
description	Nee	Una descripción de la política.	serie
content	Sí	Define el tipo de contenido a registrar cuando la operación es satisfactoria. Valores válidos: `none`: Indica que no se produce ningún registro. Restricción: Esta opción desactiva las notificaciones para los desarrolladores de aplicaciones que utilizan su Portal CMS. `activity`: sólo registra la invocación (sólo se registra el URI de recurso). `header`: registra la actividad y la cabecera. `payload`: registra la actividad, cabecera y carga útil (la solicitud original, si existe, y la respuesta final). El valor predeterminado es `activity`.	serie
error-content	Nee	Indica qué contenido se debe registrar si se produce un error. Valores válidos: `none`: Indica que no se produce ningún registro. Restricción: Esta opción desactiva las notificaciones para los desarrolladores de aplicaciones que utilizan su Portal CMS. `activity`: sólo registra la invocación (sólo se registra el URI de recurso). `header`: registra la actividad y la cabecera. `payload`: registra la actividad, cabecera y carga útil (la solicitud original, si existe, y la respuesta final). El valor predeterminado es `payload`.	serie

Ejemplo 1

# use defaults

- activity-log:
  version: 1.0.0
  title: default activity logging

Ejemplo 2

- activity-log:
  version: 1.0.0
  title: no logging for successful calls
  content: none
  error-content: activity