Recopila métricas de tus cargas de trabajo

En esta página, se describe el proceso para extraer métricas de las cargas de trabajo en entornos aislados de Google Distributed Cloud (GDC) para facilitar la supervisión y la observabilidad de los datos.

Puedes extraer y recopilar las métricas que producen tus componentes con el tiempo. La plataforma de supervisión ofrece una API personalizada para extraer métricas de las cargas de trabajo en ejecución dentro del espacio de nombres de tu proyecto de Distributed Cloud. Para extraer métricas, implementa un recurso personalizado MonitoringTarget en el espacio de nombres de tu proyecto en el servidor de la API de Management. Cuando se implementa este recurso, la plataforma de supervisión inicia la recopilación de datos.

El recurso personalizado MonitoringTarget dirige la canalización de supervisión para que extraiga los Pods designados dentro de tu proyecto. Estos Pods deben exponer un extremo HTTP que proporcione métricas en un formato de exposición de Prometheus, como OpenMetrics. Luego, las métricas recopiladas se muestran en la instancia de Grafana de tu proyecto, lo que te brinda estadísticas sobre el estado operativo de tu aplicación.

Para configurar el recurso personalizado MonitoringTarget, debes especificar los Pods dentro del espacio de nombres de tu proyecto para la recopilación de métricas. Puedes personalizar varios parámetros de configuración, como la frecuencia de la extracción, el extremo de las métricas de los pods, las etiquetas y las anotaciones.

Antes de comenzar

Para obtener los permisos que necesitas para administrar recursos personalizados de MonitoringTarget, pídele al administrador de IAM de la organización o al administrador de IAM del proyecto que te otorgue uno de los roles de MonitoringTarget asociados.

Según el nivel de acceso y los permisos que necesites, es posible que obtengas roles de creador, editor o visualizador para este recurso en una organización o un proyecto. Para obtener más información, consulta Prepara los permisos de IAM.

Configura el recurso personalizado MonitoringTarget

El recurso personalizado MonitoringTarget le indica a la plataforma de supervisión dónde recopilar las métricas. Puedes especificar los Pods para los que recopilas métricas, el extremo de métricas de esos Pods, la frecuencia de descarte y cualquier otro parámetro de configuración adicional.

Este recurso define los siguientes parámetros de configuración:

• Destinos: Son los Pods y sus extremos dentro de tu proyecto que exponen métricas.
• Intervalo de recuperación: Es la frecuencia con la que deseas extraer métricas de los extremos seleccionados.
• Personalizaciones de etiquetas: Son reglas opcionales con cualquier modificación de etiquetas para las métricas.

Elige uno de los siguientes métodos para especificar los extremos de las métricas en el recurso personalizado MonitoringTarget:

• Extremos estáticos: Declaras explícitamente el extremo (puerto, ruta de acceso, esquema) en la configuración de MonitoringTarget.

• Anotaciones: La información del extremo de la métrica del pod se recupera de las anotaciones dentro del archivo Deployment del contenedor. Este método ofrece más flexibilidad si cada Pod tiene diferentes extremos.

Consulta la especificación completa de MonitoringTarget y la documentación de referencia de la API para obtener más campos y opciones.

Especificación de MonitoringTarget completa

En el siguiente archivo YAML, se muestra un ejemplo de la especificación completa del recurso personalizado MonitoringTarget. Para obtener más información y una descripción completa de los campos, consulta la documentación de referencia de la API.

apiVersion: monitoring.gdc.goog/v1
kind: MonitoringTarget
metadata:
  # Choose the same namespace as the workload pods.
  namespace: PROJECT_NAMESPACE
  name: MONITORING_TARGET_NAME
spec:
  # Choose matching pattern that identifies pods for this job.
  # Optional
  # Relationship between different selectors: AND
  selector:
    # Choose clusters to consider for this job.
    # Optional: List
    # Default: All clusters applicable to this project.
    # Relationship between different list elements: OR
    matchClusters:
    - string

    # Choose pod labels to consider for this job.
    # Optional: Map of key-value pairs.
    # Default: No filtering by label.
    # Relationship between different pairs: AND
    matchLabels:
      key1: value1

    # Choose annotations to consider for this job.
    # Optional: Map of key-value pairs
    # Default: No filtering by annotation
    # Relationship between different pairs: AND
    matchAnnotations:
      key1: value1

  # Configure the endpoint exposed for this job.
  podMetricsEndpoints:
    # Choose a port either through static value or annotation.
    # Optional
    # Annotation takes priority.
    # Default: static port 80
    port:
      value: integer
      annotation: string

    # Choose a path either through static value or annotation.
    # Optional
    # Annotation takes priority
    # Default: static path /metrics
    path:
      value: string
      annotation: string

    # Choose a scheme either through a static value (http or https) or annotation.
    # Optional
    # Annotation takes priority
    # Default: static scheme http
    scheme:
      value: string
      annotation: string

    # Choose the frequency to scrape the metrics endpoint defined in podMetricsEndpoints
    # Optional
    # Default: 60s
    scrapeInterval: string

    # Dynamically rewrite the label set of a target before it gets scraped.
    # https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config
    # Optional
    # Default: No filtering by label
    metricsRelabelings:
    - sourceLabels:
      - string
      separator: string
      regex: string
      action: string
      targetLabel: string
      replacement: string

Reemplaza lo siguiente:

• PROJECT_NAMESPACE: Es el espacio de nombres de tu proyecto.
• MONITORING_TARGET_NAME: Es el nombre del archivo de definición de MonitoringTarget.