Registros de API¶

Introducción¶

La página Registros de API dentro del API Manager muestra una tabla de todos los registros de procesamiento de API, así como los registros de depurar (si el registro de depurar está habilitado). Los registros se muestran para las APIs personalizadas, OData y Proxy cuando se llaman a través de Pasarela de API en Nube o Pasarela de API Privada.

Hay cuatro tipos de registros que se pueden registrar para una llamada API:

• Registros de API: Los registros de API se generan automáticamente en la página Registros de API para cada llamada a la API de API Manager. Los registros de API contienen información sobre la llamada de API, incluida la marca de tiempo de la solicitud de API, el código de estado HTTP, el ID de solicitud, el método de solicitud, el URI de solicitud, el tiempo de respuesta, la IP de origen de la aplicación que llama, la aplicación de origen, y cualquier mensaje de registro.
• Registros de depuración de API: Los registros de depurar de API son entradas adicionales en un registro de API existente que rastrea completamente cada solicitud recibida a través de la URL de servicio de API de API Manager. El registro de depurar de API no está habilitado de forma predeterminada y debe habilitarse en una API de API Manager individual para que los registros de depurar de API se incluyan en un registro de API.
• Registros detallados de API: Los registros detallados de API son entradas adicionales en un registro de API existente que consisten en datos de solicitud y respuesta recibidos o enviados a través de la URL de servicio de API de API Manager. El registro detallado de API no está habilitado de forma predeterminada y debe habilitarse en una API de API Manager individual para que los registros detallados de API se incluyan en un registro de API.
• Registros de operación de API: Los registros de operación de API contienen el inicio de una llamada de API y el tiempo transcurrido. A diferencia de los registros de API, los registros de depurar y los registros detallados, los registros de operación de API requieren el uso de un Agente Privado y están habilitados en el archivo de configuración del Agente Privado. Estos registros se registran en el Agente Privado en el jitterbit.log archivo ubicado en el log directorio.

Los datos de registro para registros de API, registros de depurar y registros detallados están disponibles en la página Registros de API durante 90 días a partir de la fecha en que se consume la API.

Para obtener más información sobre cómo habilitar registros de depurar y registros detallados, consulte estos recursos:

• Paso 1: Configuración de Configuración de API Personalizada
• Paso 1: Configuración de Configuración del Servicio OData
• Paso 1: Configuración básica de Configuración de proxy de API

Para agregar información de registro adicional para APIs de OData, incluidos los datos SQL enviados a la base de datos, edite el archivo de configuración del Agente Privado y establecer DebugJDML a true.

Accediendo a la Página de Registros de API¶

Se puede acceder a la página Registros de API desde el menú del Portal Harmony o desde otras páginas dentro del API Manager:

• Desde la Inicio o Descargas páginas, o desde las páginas Cloud Studio, Vinyl, Marketplace, Management Console, EDI, o Citizen Integrator, use el menú Harmony Portal en la parte superior izquierda para ir a API Manager > API Logs:

  

• Desde Mis APIs, Administrador del portal, Análisis, Perfiles de seguridad, Grupos de IPs Confiables, o Grupos API, use el menú de navegación de API Manager para seleccionar Registros de API:

  

Encabezado de la Página de Registros API¶

El encabezado en la parte superior de la página Registros de API incluye el menú de navegación del API Manager, una barra de búsqueda, filtros y opciones adicionales:

Puede ajustar los datos mostrados utilizando los menús desplegables Filtrar por y Ver datos.

Filtrado por¶

Los menús desplegables Filtrar por le permiten mostrar registros de API según criterios específicos en cualquier combinación de ambientes, APIs, perfiles, códigos de estado o métodos de solicitud.

Cada filtro muestra una lista desplegable de criterios entre los que puede seleccionar uno o varios criterios.

Estos son los criterios disponibles para filtrar:

• Ambientes: Utilice el menú desplegable para seleccionar ambientes donde se encuentran las APIs. Cuando no se seleccionan todos los filtros, se muestran los ambientes de todas las APIs de la organización a la que tiene acceso.

• APIs: Utilice el menú desplegable para seleccionar las APIs publicadas dentro de la organización. Cuando no se seleccionan todos los filtros, se muestran todas las APIs de la organización a la que tiene acceso.

  Nota

  Las APIs publicadas anteriormente que dejen de publicarse no aparecerán en el menú desplegable APIs. Los registros de API para estas APIs estarán presentes en la página Registros de API, pero no se pueden filtrar.

• Perfiles: Utilice el menú desplegable para seleccionar los perfiles de seguridad asignados de las APIs. Cuando no se seleccionan todos los filtros, se muestran todos los perfiles de seguridad de la organización a la que tiene acceso.

• Códigos de estado: Utilice el menú desplegable para seleccionar los grupos de códigos de estado de respuesta HTTP, seleccionando entre Éxito (2xx), Redirecciones (3xx), Errores de cliente (4xx), y Errores del servidor (5xx). Cuando no se seleccionan todos los filtros, se muestran todos los códigos de estado de respuesta HTTP para las APIs en las organizaciones a las que tiene acceso. Para obtener más información sobre los códigos de estado, consulte w3.org status definiciones de código.

• Métodos de solicitud: Utilice el menú desplegable para seleccionar los métodos de solicitud HTTP, seleccionando entre GET, PUT, POST, DELETE, PATCH, y FUSIONAR. Cuando no se seleccionan todos los filtros, se muestran todos los métodos de solicitud HTTP para las APIs de la organización a la que tiene acceso. Para obtener más información sobre los métodos de solicitud HTTP, consulte métodos de solicitud de w3.org.

Ver Datos¶

La opción Ver datos le permite mostrar registros dentro de un período de tiempo específico. La configuración predeterminada para el período de tiempo es Últimos 7 días.

Utilice el menú desplegable Ver datos para seleccionar el período de tiempo deseado. Seleccione uno de Últimos 10 minutos, Última hora, Últimas 10 horas, Últimas 24 horas, Últimos 7 días, Último mes o Período personalizado.

Seleccionar Período personalizado le permite mostrar registros de API dentro de un período de tiempo específico. Cuando se selecciona esta opción, se muestran campos de calendario adicionales De y A:

• Desde: Haga clic para ajustar la fecha y hora de inicio de los registros de API.
• Para: Haga clic para ajustar la fecha y hora de finalización de los registros de API.

Después de hacer clic en los campos de calendario Desde o Hasta, se muestra un cuadro de diálogo de calendario donde puede seleccionar la fecha y la hora:

Buscando¶

La barra de búsqueda le permite filtrar los registros según los criterios de búsqueda proporcionados a continuación:

• Solo registros con mensajes: Seleccione para restringir aún más los resultados de búsqueda solo a registros que incluyan detalles de registro. Los resultados de la búsqueda se actualizarán automáticamente.

Criterio de Búsqueda¶

Estos son los criterios de búsqueda que se pueden utilizar. Se incluyen ejemplos de criterios de búsqueda válidos e inválidos:

Combinando Búsquedas¶

Las búsquedas pueden contener una combinación de criterios. Los criterios de búsqueda combinados deben estar separados por un punto y coma (;) entre cada criterio. Estos son ejemplos de búsquedas combinadas válidas:

message=%Access Denied%;requesturi=%contacts%;

requestid=%yzaccwui%;message=%REJECT%;
requesturi=%contacts%;responsetime<=2;
responsetime>=5;sourceapp=%Chrome%;
responsetime>=5;sourceip=70.5%;
sourceapp=%Chrome%;message=%REJECT%;

sourceapp=%Mozilla%;responsetime<=1;

sourceip=70.5%;requesturi=%contacts%;

Opciones Adicionales¶

Se muestran opciones de registro de API adicionales en el lado izquierdo de la página, directamente encima de la barra de búsqueda:

• Ver última actualización: Muestra la última vez que se actualizaron los datos de forma dinámica o manual. La hora se muestra en el formato h:mm:ss.

• Actualizar: Haga clic para actualizar los datos del registro según los filtros aplicados y los criterios de búsqueda.

• Descargar como CSV: Haga clic para descargar los datos de registro actuales según los filtros aplicados y los criterios de búsqueda.

  Nota

  El campo de fecha dentro del archivo CSV es una marca de tiempo UNIX que requerirá conversión si desea utilizar un formato de fecha y hora diferente.

Ver Registros de API¶

Cada fila de la tabla de registros de API muestra datos de registro de API para una llamada de API:

• Marca de tiempo: La marca de tiempo de la solicitud de API. Los horarios se muestran en la huso horario de su navegador.
• Código de estado: El código de estado HTTP. Para obtener más información sobre los códigos de estado HTTP, consulte w3.org definiciones de códigos de estado.
• ID de solicitud: Un ID único para la solicitud de API.
• Método de solicitud: El método de solicitud HTTP de la API (GET, PUT, POST, DELETE, PATCH o MERGE).
• Solicitud de URI: La URL completa de la API a la que se llamó. Pase el cursor sobre el campo Solicitar URI para ver la URL completa.
• Tiempo de respuesta: La cantidad de tiempo, en milisegundos, que tardó la API en ejecutarse.
• IP de origen: La dirección IP externa de la aplicación o servidor que llamó a la API.
• Aplicación de origen: La aplicación de origen para la llamada API, presente solo cuando la llamada API se pasa en un encabezado de solicitud. Pase el cursor sobre la columna Aplicación de origen para ver el contenido del campo.

Cada página muestra 20 registros. Puede ver todos los registros dentro del filtro y los criterios de búsqueda usando los botones Siguiente y Anterior.

Ver Detalles del Registro¶

Para ver detalles de registro adicionales o registros de depurar (si están habilitados), haga clic en expandir icono en una entrada de registro:

Un registro de API típico contendrá estos detalles:

• Nombre de dominio de la región de Harmony, ruta de servicio y URL base (consulte URL del servicio API)
• Tiempo de procesamiento de llamadas API
• Información del perfil de seguridad, como el tipo de autorización y las credenciales utilizadas
• Detalles de la carga útil, incluida la longitud de la carga útil y el tamaño de la respuesta
• Información de error (si corresponde)
• Registros de depuración (si están habilitados)
• Registros detallados (si están habilitados)