Enumerar los descriptores de métricas y los tipos de recurso supervisado con la
API de Cloud Monitoring te permite inspeccionar los esquemas y las etiquetas de las métricas para consultar
los datos de series temporales o diseñar métricas. Puedes explorar los tipos de métricas integradas Google Cloud,
definidas por el usuario y de terceros, así como los tipos de recurso supervisado
en tu proyecto. Las métricas de terceros, como las de
Bindplane, usan el prefijo
workload.googleapis.com/3rd-party-app-name/. Consulta la
documentación de fuentes de Bindplane. Para obtener listas de referencia de los tipos integrados, consulta la lista de métricas y la lista de recursos supervisados.
Puedes ejecutar estos métodos de la API sin escribir código en las pestañas Protocolo con el Explorador de APIs o usar las muestras de código en tu lenguaje preferido.
Antes de comenzar
Para obtener una introducción a las métricas y los recursos supervisados, consulta Métricas, series temporales y recursos.
Enumerar descriptores de métrica
Los descriptores de métricas son los esquemas que definen las métricas. Para obtener detalles sobre las métricas que te interesan, explora los descriptores de métricas disponibles:- Métricas integradas: puedes emitir solicitudes a la API de cualquier proyecto existente o puedes usar la documentación de las listas de métricas.
- Métricas externas y definidas por el usuario: Debes emitir la solicitud a la API a un proyecto en el que se defina la métrica definida por el usuario o en el que existan datos de series temporales para la métrica.
Para obtener más información sobre el nombre de los tipos de métricas, consulta Convenciones de nombres.
Enumerar tipos de métricas
Para obtener una lista actual de descriptores de métricas, usa el método metricDescriptors.list.
Para limitar el conjunto de tipos de métricas que se muestran, usa un filtro.
Para obtener ayuda con la elección de los tipos de métricas que se deben buscar, consulta Tipos de valores y clases de métricas.
Protocolo
- Abre la página de referencia de
metricDescriptors.list. - En el panel etiquetado como Probar este método, ingresa lo siguiente:
- name: Ingresa la ruta de acceso y el ID de tu proyecto:
projects/PROJECT_ID
- filter: Ingresa lo siguiente:
metric.type = starts_with("compute.googleapis.com")
- name: Ingresa la ruta de acceso y el ID de tu proyecto:
- Haz clic en Ejecutar.
En la siguiente respuesta de ejemplo, se muestran algunos de los descriptores de métricas recuperados:
"metricDescriptors": [
{
"name": "projects/PROJECT_ID/metricDescriptors/compute.googleapis.com/firewall/dropped_bytes_count",
"labels": [{...}],
...
"description": "Count of incoming bytes dropped by the firewall.",
"displayName": "Dropped bytes",
"type": "compute.googleapis.com/firewall/dropped_bytes_count",
...
},
{
"name": "projects/PROJECT_ID/metricDescriptors/compute.googleapis.com/firewall/dropped_packets_count",
"labels": [{...}],
...
"description": "Count of incoming packets dropped by the firewall.",
"displayName": "Dropped packets",
"type": "compute.googleapis.com/firewall/dropped_packets_count",
},
...
]
El valor type en cada descriptor identifica el descriptor de métrica, por
ejemplo, compute.googleapis.com/firewall/dropped_packets_count. A veces, este valor también se denomina “tipo de métrica” o “nombre de tipo de métrica”.
Para ver la solicitud como un comando curl, como una
solicitud HTTP o en JavaScript, haz clic en fullscreen Pantalla completa
en el Explorador de APIs.
C#
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Go
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Java
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Node.js
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
PHP
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Python
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Ruby
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Si tienes dificultades, consulta Solución de problemas de llamadas a la API.
Obtener descriptores de métricas
Para obtener información sobre un solo tipo de métrica, usa el
método metricDescriptors.get.
Este método muestra un descriptor de métrica.
Para recuperar un descriptor de métrica específico, debes proporcionar el nombre completo de la métrica a la API. El nombre completo se construye a partir de dos componentes:
- Un prefijo que consta de
projects/PROJECT_ID/metricDescriptors - El valor
typeque identifica el descriptor de métrica, por ejemplo,compute.googleapis.com/firewall/dropped_packets_count. Consulta la pestaña Protocolo en Tipos de métricas de lista para obtener más información sobre el valortype.
A continuación, se muestra un ejemplo del nombre completo de una métrica:
projects/PROJECT_ID/metricDescriptors/compute.googleapis.com/firewall/dropped_packets_count
Protocolo
Para obtener el descriptor de la métrica /firewall/dropped_packets_count
de Compute Engine, haz lo siguiente:
- Abre la página de referencia de
metricDescriptors.get. - En el panel etiquetado como Probar este método, ingresa lo siguiente:
- name: Ingresa el ID de tu proyecto y el nombre de la métrica:
projects/PROJECT_ID/metricDescriptors/compute.googleapis.com/firewall/dropped_packets_count
Reemplaza PROJECT_ID por el ID de tu proyecto de Google Cloud .
- name: Ingresa el ID de tu proyecto y el nombre de la métrica:
- Haz clic en Ejecutar.
La siguiente respuesta de ejemplo muestra el descriptor de la métrica:
{
"name": "projects/PROJECT_ID/metricDescriptors/compute.googleapis.com/firewall/dropped_packets_count",
"labels": [
{
"key": "instance_name",
"description": "The name of the VM instance."
}
],
"metricKind": "DELTA",
"valueType": "INT64",
"unit": "1",
"description": "Count of incoming packets dropped by the firewall.",
"displayName": "Dropped packets",
"type": "compute.googleapis.com/firewall/dropped_packets_count",
}
Para ver la solicitud como un comando curl, como una
solicitud HTTP o en JavaScript, haz clic en fullscreen Pantalla completa
en el Explorador de APIs.
C#
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Go
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Java
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Node.js
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
PHP
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Python
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Ruby
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Si tienes dificultades, consulta Solución de problemas de llamadas a la API.
Enumerar recursos supervisados
Los recursos supervisados son entidades de la nube que se pueden supervisar. Para encontrar los tipos de entidades que tienen métricas, explora la lista de tipos de recursos supervisados.
Para obtener información sobre los recursos supervisados, puedes emitir solicitudes a la API de cualquier proyecto existente o puedes usar la documentación de la Lista de recursos supervisados.
Enumera los tipos de recursos
Para obtener una lista actualizada de los tipos de recursos supervisados de la API de Monitoring, usa el método monitoredResourceDescriptors.list y proporciona tu ID del proyecto.
Protocolo
- Abre la página de referencia de
monitoredResourceDescriptors.list. - En el panel etiquetado como Probar este método, ingresa lo siguiente:
- name: Ingresa la ruta de acceso y el ID de tu proyecto:
projects/PROJECT_ID
- name: Ingresa la ruta de acceso y el ID de tu proyecto:
- Haz clic en Ejecutar.
En la siguiente respuesta de muestra, se presentan algunos de los tipos de recursos supervisados mostrados:
{
"resourceDescriptors": [
{
"type": "aiplatform.googleapis.com/Endpoint",
"displayName": "AI Platform Endpoint",
"description": "A Cloud AI Platform API Endpoint where Models are deployed into it.",
"labels": [{...}],
"name": "projects/PROJECT_ID/monitoredResourceDescriptors/aiplatform.googleapis.com/Endpoint",
},
{
"type": "aiplatform.googleapis.com/Featurestore",
"displayName": "AI Platform Feature Store",
"description": "A Cloud AI Platform Feature Store.",
"labels": [{...}],
"name": "projects/PROJECT_ID/monitoredResourceDescriptors/aiplatform.googleapis.com/Featurestore",
},
]
}
Para ver la solicitud como un comando curl, como una
solicitud HTTP o en JavaScript, haz clic en fullscreen Pantalla completa
en el Explorador de APIs.
C#
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Go
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Java
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Node.js
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
PHP
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Python
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Ruby
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Si tienes dificultades, consulta Solución de problemas de llamadas a la API.
Obtén descriptores de recursos
Para obtener un descriptor de recurso supervisado específico, usa el
método monitoredResourceDescriptors.get.
Para recuperar un descriptor de recursos supervisado específico, necesitas el nombre completo del descriptor de la API. El nombre completo se construye a partir de dos componentes:
- Un prefijo que consta de
projects/PROJECT_ID/monitoredResourceDescriptors - El valor
typeque identifica el descriptor de recursos supervisados, por ejemplo,gce_instance. Consulta la pestaña Protocolo en Tipos de recursos de lista para obtener más información sobre el valortype.
A continuación, se muestra un ejemplo del nombre completo de un recurso supervisado:
projects/PROJECT_ID/monitoredResourceDescriptors/gce_instance
Protocolo
Para obtener el descriptor del tipo de recurso gce_instance,
haz lo siguiente:
- Abre la página de referencia de
monitoredResourceDescriptors.get. - En el panel etiquetado como Probar este método, ingresa lo siguiente:
- name: Ingresa la ruta de acceso y el ID de tu proyecto, y el nombre del
recurso:
projects/PROJECT_ID/monitoredResourceDescriptors/gce_instance
- name: Ingresa la ruta de acceso y el ID de tu proyecto, y el nombre del
recurso:
- Haz clic en Ejecutar.
En la siguiente respuesta de ejemplo, se muestra el descriptor de este recurso supervisado:
{
"type": "gce_instance",
"displayName": "VM Instance",
"description": "A virtual machine instance hosted in Compute Engine.",
"labels": [
{
"key": "project_id",
"description": "The identifier of the Google Cloud project associated with this resource, such as \"my-project\"."
},
{
"key": "instance_id",
"description": "The numeric VM instance identifier assigned by Compute Engine."
},
{
"key": "zone",
"description": "The Compute Engine zone in which the VM is running."
}
],
"name": "projects/PROJECT_ID/monitoredResourceDescriptors/gce_instance"
}
Para ver la solicitud como un comando curl, como una
solicitud HTTP o en JavaScript, haz clic en fullscreen Pantalla completa
en el Explorador de APIs.
C#
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Go
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Java
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Node.js
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
PHP
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Python
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Ruby
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Si tienes dificultades, consulta Solución de problemas de llamadas a la API.
¿Qué sigue?
- Para obtener información sobre cómo usar la API de Cloud Monitoring para leer datos de series temporales, consulta Recupera datos de series temporales.
- Para obtener una lista de los tipos de recursos supervisados disponibles para usar con las métricas definidas por el usuario, consulta Elige un tipo de recurso supervisado.