Usa métricas personalizadas

En esta guía, se describe cómo crear y usar métricas personalizadas. La información se divide en las siguientes secciones:

  • Métricas personalizadas con OpenCensus describe cómo usar OpenCensus, una biblioteca de seguimiento y supervisión de configuración con código abierto, para crear métricas personalizadas, agregarles datos de métricas. y exportarla a Cloud Monitoring.

    Cuando las métricas de OpenCensus se exportan a Cloud Monitoring, Monitoring las trata como cualquier otra métrica personalizada.

  • Crea métricas personalizadas describe cómo usar la API de Cloud Monitoring para crear métricas personalizadas y agregarles datos de series temporales.

    El uso de la API de Monitoring se ilustra con ejemplos en los que se emplean el Explorador de API y los lenguajes de programación C#, Go, Java, Node.js, PHP, Python y Ruby.

La siguiente información se aplica tanto a las métricas personalizadas como a las métricas que proporciona Cloud Monitoring:

  • En las Métricas de navegación se explica cómo enumerar y examinar tus métricas personalizadas y las más de 900 métricas integradas.
  • En las Métricas de lectura se explica cómo recuperar datos de series temporales de métricas integradas y personalizadas con la API de Monitoring. También puedes usar datos de métricas en gráficos y alertas.

Todas estas operaciones en las métricas requieren la API de Cloud Monitoring v3. Consulta Introducción a la API de Cloud Monitoring for reference documentation.

Para ver una discusión de los conceptos que subyacen a las métricas en Cloud Monitoring, consulta Métricas, series temporales y recursos.

Antes de comenzar

Las métricas personalizadas pertenecen a los proyectos de Google Cloud que son miembros de un lugar de trabajo. Incluso si solo estás navegando por las métricas integradas, necesitas un proyecto desde el cual trabajar:

  1. Crea o selecciona un proyecto de Google Cloud Console a cuyos datos de supervisión quieras acceder. En esta guía, el ID de tu proyecto se conoce como {your-project-id}.
  2. Habilita tu proyecto para Monitoring.

Si deseas configurar métricas basadas en los registros de tus proyectos de Google Cloud, usa las métricas basadas en registros.

Acerca de las métricas personalizadas

Las métricas personalizadas son las mismas que las métricas integradas de Monitoring, excepto por los siguientes puntos:

  • Puedes crear métricas personalizadas en tus proyectos de Google Cloud.
  • Los nombres de las métricas personalizadas suelen comenzar con custom.googleapis.com/, lo que difiere de las métricas integradas.
  • Puedes escribir datos de series temporales en tus métricas personalizadas.
  • Puedes borrar tus métricas personalizadas.

Consulta la lista de métricas para obtener detalles sobre las métricas integradas.

En la siguiente tabla, se muestran qué métodos de la API de Monitoring se pueden usar con métricas personalizadas y con métricas integradas:

Método de API de la API de Monitoring Permite el uso con
métricas personalizadas
Permite el uso con
métricas integradas
monitoredResourceDescriptors.get
monitoredResourceDescriptors.list
metricDescriptors.get
metricDescriptors.list
timeSeries.list
timeSeries.create
metricDescriptors.create
metricDescriptors.delete

Límites y latencias

Consulta Cuotas y límites para conocer los límites relacionados con las métricas personalizadas y la retención de datos. Si deseas mantener tus datos de métrica más allá del período de retención, debes copiarlos de forma manual en otra ubicación, como Cloud Storage o BigQuery.

Para obtener más información sobre las latencias asociadas con la escritura de datos en métricas personalizadas, consulta Latencia de datos de métricas.