Google usa tecnología de IA para traducir contenido al idioma que prefieras. Las traducciones generadas por IA pueden contener errores.

Monitorizar el uso de las APIs

En esta página se describe cómo usar las métricas de las APIs para monitorizar y comprender el uso que haces de las APIs de Google y de Google Cloud.

Las APIs de Google generan métricas de uso detalladas que pueden ayudarte a hacer lo siguiente:

Monitoriza y analiza el uso que haces de las APIs de Google.
Monitoriza el rendimiento de tus aplicaciones y APIs de Google.
Descubre problemas entre tus aplicaciones y las APIs de Google.

Puede acelerar considerablemente los tiempos de resolución cuando solucionas problemas o necesitas asistencia técnica de Google.

Las métricas que generan las APIs de Google son las señales estándar que usan los ingenieros de fiabilidad de sitios de Google para evaluar el estado de un servicio. Estas métricas abarcan el número de solicitudes, las tasas de error, las latencias totales, las latencias de backend, los tamaños de las solicitudes y los tamaños de las respuestas. Para consultar las definiciones de las métricas de la API, consulta la documentación de Cloud Monitoring.

Puedes ver las métricas de las APIs en dos lugares: el panel de APIs y Cloud Monitoring. Las métricas que ves son específicas de tu proyecto y no reflejan el estado general del servicio.

Usar el panel de control de APIs

La forma más sencilla de ver las métricas de tu API es usar el panel de APIs de la consola de Google Cloud. Puedes ver un resumen de todo tu uso de las APIs o consultar en detalle el uso de una API específica.

Para ver un resumen del uso de tu API, sigue estos pasos:

Ve a la sección APIs y servicios de la consola de Cloud. El panel de control principal de la API se muestra de forma predeterminada. En esta página puedes ver todas las APIs que tienes habilitadas en tu proyecto, así como gráficos de resumen de las siguientes métricas:
- Tráfico: el número de solicitudes por segundo que tu proyecto envía o recibe sobre las APIs habilitadas
- Errores: el porcentaje de solicitudes a APIs habilitadas que han provocado errores.
- Latencia mediana: la latencia mediana de las solicitudes a las APIs habilitadas, si está disponible".

Para ver los detalles de uso de una API específica, sigue estos pasos:

Selecciona la API que quieras ver en la lista principal de APIs del panel de control de APIs. En la página Información general de la API se muestra un gráfico de tráfico más detallado con un desglose por código de respuesta.
Para obtener información de uso aún más detallada, selecciona Ver métricas. De forma predeterminada, se muestran los siguientes gráficos prediseñados, aunque hay más disponibles:
- Tráfico por código de respuesta
- Errores por método de API
- Latencia general en los percentiles 50, 95 y 99
- Latencia por método de API (mediana)
Si quieres añadir más gráficos, puedes seleccionar otros predefinidos en el menú desplegable Seleccionar gráficos.

Usar Cloud Monitoring

Si usas Cloud Monitoring, puedes profundizar en los datos de las métricas disponibles con el explorador de métricas para obtener más información sobre el uso de tu API. Cloud Monitoring admite una amplia variedad de métricas, que puedes combinar con filtros y agregaciones para obtener perspectivas nuevas y útiles del rendimiento de tu aplicación. Por ejemplo, puedes combinar una métrica de recuento de solicitudes con un filtro de la clase de código de respuesta HTTP para crear un panel de control que muestre las tasas de error a lo largo del tiempo, o bien puedes consultar la latencia del percentil 95 de las solicitudes a la API Cloud Pub/Sub.

Métricas disponibles

En la siguiente tabla se enumeran las métricas de serviceruntime disponibles. Las métricas de uso de la API son las que incluyen consumed_api como recurso monitorizado.

Las cadenas "metric type" de esta tabla deben tener el prefijo serviceruntime.googleapis.com/. Se ha omitido ese prefijo en las entradas de la tabla. Cuando consultes una etiqueta, usa el prefijo metric.labels.. Por ejemplo, metric.labels.LABEL="VALUE".

Tipo de métrica ^{Fase de lanzamiento} (Niveles de jerarquía de recursos) Nombre visible
Tipo, unidad Recursos monitorizados	Descripción Etiquetas
`api/request_count` ^GA *(proyecto)* Recuento de solicitudes
`DELTA`, `INT64`, `1` api consumed_api produced_api	Número de solicitudes completadas. Se muestrea cada 60 segundos. Después del muestreo, los datos no podrán verse durante un máximo de 1800 segundos. `protocol`: El protocolo de la solicitud, por ejemplo, "http" o "grpc". `response_code`: El código de respuesta HTTP de las solicitudes HTTP o el código equivalente de las solicitudes gRPC. Consulta la asignación de códigos en https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto. `response_code_class`: Clase de código de respuesta de solicitudes HTTP o clase equivalente de HTTP para solicitudes gRPC (por ejemplo, "2xx" o "4xx"). `grpc_status_code`: Código de respuesta gRPC numérico para solicitudes gRPC o código equivalente de gRPC para solicitudes HTTP. Consulta la asignación de códigos en https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto.
`api/request_latencies` ^GA *(proyecto)* Latencias de las solicitudes
`DELTA`, `DISTRIBUTION`, `s` api consumed_api produced_api	Distribución de latencias en segundos de las solicitudes que no son de streaming. Se muestrea cada 60 segundos. Después del muestreo, los datos no podrán verse durante un máximo de 1800 segundos.
`api/request_latencies_backend` ^GA *(project)* Latencias de backend de solicitudes
`DELTA`, `DISTRIBUTION`, `s` api produced_api	Distribución de las latencias de backend en segundos de las solicitudes que no son de streaming. Se muestrea cada 60 segundos. Después del muestreo, los datos no podrán verse durante un máximo de 1800 segundos.
`api/request_latencies_overhead` ^GA *(proyecto)* Latencias de sobrecarga de solicitudes
`DELTA`, `DISTRIBUTION`, `s` api produced_api	Distribución de las latencias de las solicitudes en segundos para las solicitudes que no son de streaming, excluyendo el backend. Se muestrea cada 60 segundos. Después del muestreo, los datos no podrán verse durante un máximo de 1800 segundos.
`api/request_sizes` ^GA *(proyecto)* Tamaños de las solicitudes
`DELTA`, `DISTRIBUTION`, `By` api consumed_api produced_api	Distribución de los tamaños de las solicitudes en bytes registrados al completar la solicitud. Se muestrea cada 60 segundos. Después del muestreo, los datos no podrán verse durante un máximo de 1800 segundos.
`api/response_sizes` ^GA *(project)* Tamaños de respuesta
`DELTA`, `DISTRIBUTION`, `By` api consumed_api produced_api	Distribución de los tamaños de las respuestas en bytes registradas al completarse la solicitud. Se muestrea cada 60 segundos. Después del muestreo, los datos no podrán verse durante un máximo de 1800 segundos.
`mcp/request_count` ^BETA *(project)* Recuento de solicitudes de MCP
`DELTA`, `INT64`, `1` consumed_mcp_api	Número de solicitudes de MCP. `response_code`: El código de respuesta HTTP de las solicitudes HTTP o el código equivalente de HTTP para las solicitudes de MCP. `response_code_class`: Clase del código de respuesta de las solicitudes HTTP o clase equivalente de HTTP de las solicitudes gRPC (por ejemplo, "2xx" o "4xx").
`mcp/request_durations` ^BETA *(project)* Duración de la solicitud de MCP
`DELTA`, `DISTRIBUTION`, `s` consumed_mcp_api	Duración de la solicitud de MCP desde que se envió hasta que se recibió la respuesta o la confirmación.
`quota/allocation/usage` ^GA *(proyecto, carpeta, organización)* Uso de la cuota de asignación
`GAUGE`, `INT64` y `1` consumer_quota producer_quota	Cuota de asignación total consumida. Los valores que se registren más de una vez por minuto se descartarán. Si no se reciben cambios en el uso de la cuota, el último valor se repite al menos cada 24 horas. Se muestrea cada 60 segundos. `quota_metric`: Nombre de la métrica de cuota o del grupo de cuotas.
`quota/concurrent/exceeded` ^ALFA *(project, folder, organization)* Concurrent Quota Exceeded
`DELTA`, `INT64`, `1` consumer_quota	Número de veces que se ha intentado superar la cuota simultánea. Se muestrea cada 86.400 segundos. Después del muestreo, los datos no podrán verse durante un máximo de 180 segundos. `limit_name`: Nombre del límite de cuota, como "Solicitudes por día" o "Direcciones IP en uso". `quota_metric`: Nombre de la métrica de cuota o del grupo de cuotas. `time_window`: Tamaño de la ventana para los límites de operaciones simultáneas.
`quota/concurrent/limit` ^ALFA *(project, folder, organization)* Límite de cuota simultánea
`GAUGE`, `INT64` y `1` consumer_quota producer_quota	El límite simultáneo de la cuota. Se muestrea cada 86.400 segundos. Después del muestreo, los datos no podrán verse durante un máximo de 180 segundos. `limit_name`: Nombre del límite de cuota, como "Solicitudes por día" o "Direcciones IP en uso". `quota_metric`: Nombre de la métrica de cuota o del grupo de cuotas. `time_window`: Tamaño de la ventana para los límites de operaciones simultáneas.
`quota/concurrent/usage` ^ALFA *(project, folder, organization)* Uso de cuota simultáneo
`GAUGE`, `INT64` y `1` consumer_quota producer_quota	El uso simultáneo de la cuota. Se muestrea cada 60 segundos. Después del muestreo, los datos no podrán verse durante un máximo de 180 segundos. `limit_name`: Nombre del límite de cuota, como "Solicitudes por día" o "Direcciones IP en uso". `quota_metric`: Nombre de la métrica de cuota o del grupo de cuotas. `time_window`: Tamaño de la ventana para los límites de operaciones simultáneas.
`quota/exceeded` ^GA *(proyecto, carpeta u organización)* Error "Se ha superado la cuota"
`GAUGE`, `BOOL`, `1` consumer_quota	El error se ha producido al superar el límite de cuota. Se muestrea cada 60 segundos. `limit_name`: Nombre del límite de cuota, como "Solicitudes por día" o "Direcciones IP en uso". `quota_metric`: Nombre de la métrica de cuota o del grupo de cuotas.
`quota/limit` ^GA *(proyecto, carpeta, organización)* Límite de cuota
`GAUGE`, `INT64` y `1` consumer_quota producer_quota	El límite de la cuota. Se muestrea cada 86.400 segundos. `limit_name`: Nombre del límite de cuota, como "Solicitudes por día" o "Direcciones IP en uso". `quota_metric`: Nombre de la métrica de cuota o del grupo de cuotas.
`quota/rate/net_usage` ^GA *(proyecto, carpeta, organización)* Uso de cuota de velocidad
`DELTA`, `INT64` y `1` consumer_quota producer_quota	La cuota total de tarifas consumida. Se muestrea cada 60 segundos. Después del muestreo, los datos no podrán verse durante un máximo de 240 segundos. `method`: Nombre del método de la API, como "disks.list". `quota_metric`: Nombre de la métrica de cuota o del grupo de cuotas.
`reserved/metric1` ^EARLY_ACCESS

Monitorizar el uso de las APIs Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.

Usar el panel de control de APIs

Usar Cloud Monitoring

Métricas disponibles

Monitorizar el uso de las APIs