IBM Cloud Docs
Recopilación de métricas utilizando la escritura remota de Prometheus

Recopilación de métricas utilizando la escritura remota de Prometheus

Puede configurar la escritura remota de Prometheus para recopilar métricas de entornos donde no hay disponible un agente de Monitoring y enviarlas a una instancia de Monitoring.

Puede recopilar métricas de:

  • Un servidor Prometheus existente.
  • Trabajos efímeros o por lotes que pueden no existir el tiempo suficiente para que un agente de Monitoring los extraiga.
  • Hosts de Windows y otros sistemas operativos en los que el agente de Monitoring no está disponible.
  • Arquitecturas no basadas en x86, normalmente vistas en entornos de IoT o Edge Computing.
  • Cargas de trabajo no contenerizadas como, por ejemplo, NGNIX, aplicaciones personalizadas, RabbitMQ, etc.

Prometheus remote write option
Prometheus remote write

Puede supervisar las métricas que se recopilan utilizando la escritura remota de Prometheus a través de la interfaz de usuario web de Monitoring. También puede utilizar PromQL para consultar los datos con el lenguaje de consulta Prometheus estándar.

Configuración de la escritura remota de Prometheus

Puede configurar el servidor de Prometheus para escribir de forma remota en una instancia de Monitoring. Por ejemplo:

  • Puede configurar el servidor Prometheus que se ejecuta en un clúster de Kubernetes de diferentes maneras. Según cómo lo haya instalado, puede elegir cualquiera de las opciones siguientes para configurar la característica de escritura remota en Prometheus para enviar métricas a una instancia de IBM Cloud Monitoring:

    • Configurar un servidor de Prometheus que esté gestionado por Prometheus Operator

    • Configurar un servidor de Prometheus utilizando Helm

    • Configure un servidor Prometheus a través de un ConfigMap de Kubernetes

    Para obtener más información, consulte Recopilación de métricas utilizando la escritura remota de Prometheus.

Prometheus v2.25 y versiones anteriores

Para Prometheus v2.25 y versiones anteriores, debe configurar la sección remote_write del archivo de configuración prometheus.yml como se indica a continuación:

global:
  external_labels:
    [ <labelname>: <labelvalue> ... ]
remote_write:
- url: "https://<INGESTION_URL>/prometheus/remote/write"
  bearer_token: "<MONITOR_API_TOKEN>"

Donde

  • <MONITOR_API_TOKEN> contiene el token de autorización. Para obtener más información, consulte Trabajar con señales de API de Monitor.
  • <INGESTION_URL> indica el punto final de ingestión. Debe establecer como valor el punto final de ingestión de la región donde está disponible la instancia de Monitoring. Para obtener más información, consulte Puntos finales.

Prometheus versión 2.26 y versiones posteriores

Para Prometheus v2.26 y versiones posteriores, debe configurar la sección remote_write del archivo de configuración prometheus.yml como se indica a continuación:

global:
  external_labels:
    [ <labelname>: <labelvalue> ... ]
remote_write:
- url: "https://<INGESTION_URL>/prometheus/remote/write"
  authorization:
    credentials: "<MONITOR_API_TOKEN>"

Donde

  • <MONITOR_API_TOKEN> contiene el token de autorización. Para obtener más información, consulte Trabajar con señales de API de Monitor.
  • <INGESTION_URL> indica el punto final de ingestión. Debe establecer como valor el punto final de ingestión de la región donde está disponible la instancia de Monitoring. Para obtener más información, consulte Puntos finales.

Gestión de métricas recopiladas mediante escritura remota

De forma predeterminada, cuando configura el servidor Prometheus para que escriba de forma remota en una instancia de Monitoring, se recopilan todas las métricas e incluyen una etiqueta remote_write: true para identificarlas fácilmente.

Cómo controlar las métricas que se envían

Puede gestionar y controlar las métricas que recopila y envía a una instancia de Monitoring. Para seleccionar las series y etiquetas a recopilar y para reducir el número de series activas que se envían a la instancia de Monitoring, puede crear configuraciones de reetiquetado utilizando el bloque write_relabel_configs dentro de la sección remote_write.

Por ejemplo, para recopilar métricas de 1 espacio de nombres my-namespace, puede añadir lo siguiente:

remote_write:
    - url: https://<INGESTION_URL>/prometheus/remote/write
      authorization:
        credentials_file: /etc/secrets/<SECRET_NAME>
      write_relabel_configs:
        - action: keep
          regex: my-namespace
          source_labels:
          - namespace

Cómo etiquetar las métricas recopiladas por el servidor de Prometheus

Puede especificar etiquetas personalizadas que se envíen junto con cada serie temporal que recopile un servidor de Prometheus utilizando el bloque external_labels dentro de global.

Puede utilizar estas etiquetas para filtrar y definir el ámbito de las métricas que supervisa mediante paneles de control en la interfaz de usuario de Monitoring.

Por ejemplo, si tiene 2 servidores Prometheus distintos configurados para escribir de forma remota en una instancia de Monitoring, puede incluir una etiqueta externa para identificar cada servidor:

# Prometheus server 1
global:
  external_labels:
    provider: prometheus1
remote_write:
- url: ...
# Prometheus server 2
global:
  external_labels:
    provider: prometheus2
remote_write:
- url: ...

Límites de velocidad

La tabla siguiente lista los límites de tasa predeterminados por instancia:

Límites de velocidad
Tasa Límite Información
Escrituras paralelas 100 solicitudes simultáneas
Puntos de datos por minuto (DPM) 1 millón El número de puntos de datos que se envían depende de la frecuencia con la que se envían las métricas. Por ejemplo, un intervalo de extracción de 10 s enviará más DPM que un intervalo de 60 segundos
Número de escrituras por minuto 10.000

Puntos finales de ingestión para escritura remota

IBM Cloud Monitoring ha dejado en desuso el soporte de cliente de Prometheus de puntos finales con el formato https://ingest.<region> y https://ingest.private.<region> y los ha sustituido por nuevos puntos finales el 31 de mayo de 2024. El fin del soporte para los antiguos puntos finales es el 31 de agosto de 2024. Después de esa fecha, los antiguos puntos finales dejarán de funcionar. Los clientes que utilicen Prometheus Remote Write deben migrar para utilizar los nuevos puntos finales antes del 31 de agosto de 2024 para seguir utilizando Prometheus Remote Write.

En la tabla siguiente se muestran los puntos finales de ingestión públicos de Monitoring que puede configurar para recopilar métricas mediante la escritura remota de Prometheus:

La ingestión de grabación remota utiliza el puerto TCP 443.

Puntos finales públicos de escritura remotaPrometheus
Región Punto final
Dallas (US-South) https://ingest.us-south.monitoring.cloud.ibm.com/prometheus/remote/write En desuso
https://ingest.prws.us-south.monitoring.cloud.ibm.com/prometheus/remote/write
Frankfurt (EU-DE) https://ingest.eu-de.monitoring.cloud.ibm.com/prometheus/remote/write En desuso
https://ingest.prws.eu-de.monitoring.cloud.ibm.com/prometheus/remote/write
Londres (EU-GB) https://ingest.eu-gb.monitoring.cloud.ibm.com/prometheus/remote/write En desuso
https://ingest.prws.eu-gb.monitoring.cloud.ibm.com/prometheus/remote/write
Madrid (EU-ES) https://ingest.eu-es.monitoring.cloud.ibm.com/prometheus/remote/write En desuso
https://ingest.prws.eu-es.monitoring.cloud.ibm.com/prometheus/remote/write
JP-OSA https://ingest.jp-osa.monitoring.cloud.ibm.com/prometheus/remote/write En desuso
https://ingest.prws.jp-osa.monitoring.cloud.ibm.com/prometheus/remote/write
BR-SAO https://ingest.br-sao.monitoring.cloud.ibm.com/prometheus/remote/write En desuso
https://ingest.prws.br-sao.monitoring.cloud.ibm.com/prometheus/remote/write
Sídney (AU-SYD) https://ingest.au-syd.monitoring.cloud.ibm.com/prometheus/remote/write En desuso
https://ingest.prws.au-syd.monitoring.cloud.ibm.com/prometheus/remote/write
Tokio (JP-TOK) https://ingest.jp-tok.monitoring.cloud.ibm.com/prometheus/remote/write En desuso
https://ingest.prws.jp-tok.monitoring.cloud.ibm.com/prometheus/remote/write
CA-TOR https://ingest.ca-tor.monitoring.cloud.ibm.com/prometheus/remote/write En desuso
https://ingest.prws.ca-tor.monitoring.cloud.ibm.com/prometheus/remote/write
Washington (US-EAST) https://ingest.us-east.monitoring.cloud.ibm.com/prometheus/remote/write En desuso
https://ingest.prws.us-east.monitoring.cloud.ibm.com/prometheus/remote/write

La siguiente tabla enumera los puntos finales de ingestión de Monitoring privado que puede configurar para recopilar métricas a través de Prometheus Escritura remota:

Puntos finales privados de escritura remotaPrometheus
Región Punto final
Dallas (US-South) https://ingest.private.us-south.monitoring.cloud.ibm.com/prometheus/remote/write En desuso
https://ingest.prws.private.us-south.monitoring.cloud.ibm.com/prometheus/remote/write
Frankfurt (EU-DE) https://ingest.private.eu-de.monitoring.cloud.ibm.com/prometheus/remote/write En desuso
https://ingest.prws.private.eu-de.monitoring.cloud.ibm.com/prometheus/remote/write
Londres (EU-GB) https://ingest.private.eu-gb.monitoring.cloud.ibm.com/prometheus/remote/write En desuso
https://ingest.prws.private.eu-gb.monitoring.cloud.ibm.com/prometheus/remote/write
Madrid (EU-ES) https://ingest.private.eu-es.monitoring.cloud.ibm.com/prometheus/remote/write En desuso
https://ingest.prws.private.eu-es.monitoring.cloud.ibm.com/prometheus/remote/write
JP-OSA https://ingest.private.jp-osa.monitoring.cloud.ibm.com/prometheus/remote/write En desuso
https://ingest.prws.private.jp-osa.monitoring.cloud.ibm.com/prometheus/remote/write
BR-SAO https://ingest.private.br-sao.monitoring.cloud.ibm.com/prometheus/remote/write En desuso
https://ingest.prws.private.br-sao.monitoring.cloud.ibm.com/prometheus/remote/write
Sídney (AU-SYD) https://ingest.private.au-syd.monitoring.cloud.ibm.com/prometheus/remote/write En desuso
https://ingest.prws.private.au-syd.monitoring.cloud.ibm.com/prometheus/remote/write
Tokio (JP-TOK) https://ingest.private.jp-tok.monitoring.cloud.ibm.com/prometheus/remote/write En desuso
https://ingest.prws.private.jp-tok.monitoring.cloud.ibm.com/prometheus/remote/write
CA-TOR https://ingest.private.ca-tor.monitoring.cloud.ibm.com/prometheus/remote/write En desuso
https://ingest.prws.private.ca-tor.monitoring.cloud.ibm.com/prometheus/remote/write
Washington (US-EAST) https://ingest.private.us-east.monitoring.cloud.ibm.com/prometheus/remote/write En desuso
https://ingest.prws.private.us-east.monitoring.cloud.ibm.com/prometheus/remote/write

Limitaciones

La característica de escritura remota de Prometheus de IBM Cloud Monitoring tiene las siguientes limitaciones:

  • En Explore se puede acceder a las métricas que se envían a una instancia, pero no son compatibles con el árbol de ámbito.

  • Solo se pueden utilizar las etiquetas que se recopilan en el origen para filtrar las métricas.

  • Los metadatos de una métrica no se envían mediante escritura remota.

  • Las métricas que tienen un nombre que termina en _total, _sum o _count se almacenan como contadores, de lo contrario se manejan como un indicador.

  • Puede establecer manualmente las unidades en los paneles de control.

  • No se pueden mezclar métricas con un muestreo diferente en un panel de control, por ejemplo, 10 s y 1 min.

    Considere la posibilidad de configurar el intervalo de dispersión para que sea de 10s, de modo que pueda combinar las métricas de escritura remota de Prometheus con métricas del agente de Monitoring.