Uso de Grafana para analizar métricas de OpenTelemetry

Supervise el estado y el rendimiento de la instancia mediante paneles y métricas proporcionados por la pila de métricas de OpenTelemetry.

En este artículo

Prerrequisitos

Las métricas de OpenTelemetry deben estar habilitadas en la instancia. Para obtener instrucciones de configuración, consulte Configuración de OpenTelemetry para la instancia.

  1. Desde una cuenta administrativa de GitHub Enterprise Server, en la esquina superior derecha de cualquier página, haz clic en .
  2. Si todavía no está en la página "Administrador del sitio", en la esquina superior izquierda, haga clic en Administrador del sitio.
  3. En la barra lateral " Site admin", haz clic en Consola de administración.
  4. Si has creado varias cuentas de usuario de la Consola de administración, selecciona Administrador del sitio raíz o Usuario de la Consola de administración . Para más información sobre las cuentas de usuario de Consola de administración, consulta Administración del acceso a la Consola de administración.
  5. Escribe tus credenciales de la Consola de administración. A continuación, haga clic en Continue (Continuar).
  6. Haga clic en la pestaña Supervisión .

Etiquetas de métricas

Los exportadores de pila de OpenTelemetry adjuntan automáticamente etiquetas a las métricas. Las etiquetas comunes son:

  • job — el nombre del exportador que produjo la métrica.
  • instance : el nombre de instancia desde el que se originó la métrica.

Para algunos exportadores (como node_exporter o haproxy_exporter), la documentación de código abierto puede estar disponible buscando el valor de la job etiqueta.

La disponibilidad de las etiquetas varía según el exportador y la métrica. Algunas GitHub métricas de nivel de aplicación pueden proporcionar menos etiquetas que las métricas de infraestructura o exportador, y las etiquetas están sujetas a cambios de versión a versión.

Inspección de consultas del panel

Importante

Los paneles pregenerados se pueden abrir y editar para la inspección, pero no se pueden guardar los cambios. Cree una copia de un panel para aplicar y conservar las personalizaciones.

Para comprender qué métricas y consultas potencian un panel determinado, use el menú del panel gráfico (3 puntos verticales) al ver un panel de Grafana:

  • Editar: abre el editor del panel. Esta es la manera más directa de revisar y ajustar las consultas que impulsan la visualización.
  • Explorar: abre Grafana Explore con las consultas del panel rellenadas previamente, lo que permite el análisis interactivo.
  • Desglose de Métricas: abre un panel lateral para descubrir métricas relacionadas y desglosar la métrica por valores de etiqueta.

Exploración de métricas en Grafana

Grafana proporciona varias maneras de detectar y analizar las métricas disponibles en la instancia.

Desglose de Grafana

Grafana Drilldown proporciona un flujo de trabajo guiado para detectar métricas mediante el filtrado de prefijos de métricas, etiquetas y valores de etiqueta. Después de seleccionar una métrica, Grafana puede desglosar la serie por los valores de etiqueta disponibles. Por ejemplo, haproxy_backend_response_errors_total se puede agrupar por valores de etiqueta de proxy o back-end.

Exploración de Grafana

Grafana Explore permite el análisis interactivo mediante PromQL (lenguaje de consulta Prometheus), incluido un generador de consultas que puede ayudar a los usuarios a detectar métricas y etiquetas disponibles.

Sugerencias para trabajar en Grafana Explore:

  • Use el explorador de métricas del modo de código para detectar métricas y etiquetas. Seleccionar etiquetas y valores de etiqueta pueden revelar métricas asociadas y seleccionar una métrica puede revelar etiquetas asociadas y valores de etiqueta.
  • Después de seleccionar una métrica, cambie al modo Generador para obtener sugerencias para refinar la consulta.
  • Acceda a operaciones adicionales a través del botón + Operaciones .
  • Personalice las etiquetas de leyenda en el panel Opciones mediante la configuración Leyenda , por ejemplo false. De forma predeterminada, Grafana asigna etiquetas de leyenda basadas en conjuntos de etiquetas únicos.

Lectura adicional