En esta página, se describe cómo puedes supervisar el estado de las API de API Gateway mediante los registros y las métricas que API Gateway mantiene por ti automáticamente.
Cuando creas una API, API Gateway crea automáticamente un servicio administrado correspondiente. El nombre del servicio administrado creado se puede encontrar en el resultado del siguiente comando:
gcloud api-gateway apis describe API_ID
El nombre de tu servicio es el valor del campo managedService
.
Cuando los usuarios realizan solicitudes a tu API, API Gateway registra información sobre estas y las respuestas. API Gateway también realiza un seguimiento de tres de los cuatro indicadores de oro de la supervisión: latencia, tráfico y errores. Estas métricas de rendimiento y uso te ayudan a supervisar tu API.
Antes de comenzar
A fin de generar registros y métricas para ver, implementa una API y envíale solicitudes. Si aún no creaste ni implementaste una API en una puerta de enlace, prueba la Guía de inicio rápido de API Gateway.
Descripción general de la API
Cuando depures un problema con tu servicio o tan solo desees asegurarte de que todo funcione bien, ve a la descripción general de la API siguiendo estos pasos:
En Google Cloud Console, ve a la página API Gateway > API de tu proyecto:
Si tienes más de una API, haz clic en la que quieres supervisar.
Asegúrate de que te encuentres en la pestaña Descripción general.
Grafos
La página de descripción general proporciona una serie de gráficos para algunas de las métricas, de modo que puedas localizar las alzas, las caídas o la actividad inesperada de inmediato. Si usas los filtros en la parte superior de la página, podrás hacer lo siguiente:
- Usa la lista desplegable Seleccionar gráficos para mostrar los gráficos de las métricas que te interesan y quitar los que no deseas ver.
- Ajusta el permiso de los gráficos mediante la selección de los distintos intervalos de tiempo. Esto ajusta el intervalo de tiempo de los valores que se muestran, lo que también modifica el nivel de detalle de los puntos.
Tabla de métodos
Cuando estés listo para desglosar más, desplázate debajo de los grafos hasta llegar a la tabla que contiene las métricas de los métodos individuales de la API. Puedes llevar a cabo las siguientes acciones:
- En la esquina superior izquierda de la tabla, haz clic en el ícono Filtrar tabla para seleccionar las opciones de consulta de filtro mejor definidas de la tabla desplegable. Agrega un
OR
entre cada consulta de filtro para buscar varios términos. - En la esquina superior derecha de la tabla, haz clic en el ícono Opciones de visualización de columnas para ver una lista desplegable. Marca las métricas que te interesan y desmarca las que no deseas ver.
- En la esquina superior derecha de la descripción general, selecciona un intervalo de tiempo para los valores de métrica en la tabla mediante el selector de intervalos de tiempo. Este intervalo se usará para los grafos y la tabla.
Logs
Cuando encuentres un problema en las métricas, puedes usar la página Explorador de registros en Google Cloud Console para ver los registros de las solicitudes y respuestas de tu API.
Si deseas ver registros individuales de los métodos de la API, haz clic en Ver registros en la tabla.
Para ver registros de todos los métodos de la API, haz clic en Ver todos los registros en la esquina inferior derecha.
Para ubicar los registros de API Gateway directamente desde la página Explorador de registros, haz lo siguiente:
En Cloud Console, ve a la página Explorador de registros.
Selecciona API producida,
SERVICE_NAME
, en la queSERVICE_NAME
es el nombre del servicio administrado.
Consulta la referencia de registros de API Gateway para obtener detalles sobre la estructura de los registros en el explorador de registros.
Aprende qué más puedes hacer con los registros:
- Comienza a usar el Explorador de registros.
- Exporta tus registros con Cloud Console. Este te permite transmitir registros a BigQuery para realizar un análisis más detallado, guardar los registros sin procesar en Cloud Storage o enviarlos a temas de mensajes de Pub/Sub.
- Usa Filtros de registro avanzados para especificar el conjunto de entradas de registro que deseas ver, por ejemplo, si quieres obtener todas las solicitudes con una latencia mayor a 300 milisegundos.
Filtro para un proyecto de consumidor específico
Para filtrar métricas en un proyecto de consumidor específico, haz lo siguiente:
Obtén el número del proyecto del consumidor de la API. Si no tienes permiso para acceder al proyecto de consumidor de la API, pídele el número del proyecto a alguien que sí tenga acceso.
En Cloud Console, ve a la página API Gateway > API de tu proyecto.
En la esquina superior izquierda de la página Descripción general, ingresa el número del proyecto en el campo Filtrar por número de proyecto.
Haz clic en Filtrar.
Las métricas en la página se actualizan para mostrar solo el tráfico del proyecto especificado.