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:

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

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

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

    La API de Monitoring se ilustra con ejemplos que usan las API de Explorer, 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 proporcionadas por Stackdriver Monitoring:

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

Todas estas operaciones en métricas requieren la API de Stackdriver Monitoring v3. Consulta Introducción a la API de Stackdriver Monitoring para obtener documentación de referencia.

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

Antes de comenzar

Las métricas personalizadas son una función con cargo a Stackdriver Monitoring y podría haber costos para tus métricas personalizadas. Para obtener más información sobre precios, consulta Precios de Stackdriver.

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

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

Si deseas configurar métricas basadas en accesos Stackdriver en tus proyectos de GCP, usa métricas basada en registros.

Sobre métricas personalizadas

Las métricas personalizadas son las mismas que las métricas integradas de Monitoring, excepto:

  • Puedes crear métricas personalizadas dentro de tus proyectos de GCP.
  • Los nombres de métricas personalizadas generalmente comienzan en custom.googleapis.com/, que difiere de las métricas integradas.
  • Puedes escribir datos de series temporales a tus métricas personalizadas.
  • Puedes borrar tus métricas personalizadas.

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

La siguiente tabla muestra qué métodos de la API de Monitoring se pueden usar con métricas personalizadas y con métricas integradas:

Método API para supervisar API Usar con
métricas personalizadas
Usar con
métricas incorporadas
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 en el número de métricas personalizadas y el número de series temporales activas, y para el período de retención de datos. Si deseas mantener tus datos de métrica más allá del período de retención, debes copiarlos manualmente 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 métricos.

¿Te ha resultado útil esta página? Enviar comentarios:

Enviar comentarios sobre...

Stackdriver Monitoring
Si necesitas ayuda, visita nuestra página de asistencia.