Usa la API de Telemetry

Puedes configurar el agente de operaciones para que use la API de Telemetry (OTLP) y envíe registros, métricas y seguimientos a tu proyecto de Google Cloud . La API de Telemetry, telemetry.googleapis.com, es una implementación del protocolo OpenTelemetry de código abierto. Cuando configuras el agente de operaciones para que use esta API, el agente de operaciones envía datos de telemetría con la API de Telemetry en lugar de la API propietaria de Cloud Monitoring, la API de Logging o la API de Trace.

Si adoptas el uso de la API de Telemetry en el agente de operaciones y tienes gráficos o políticas de alertas que supervisan el uso de la API, debes actualizar estos artefactos para supervisar el extremo telemetry.googleapis.com en lugar de los extremos monitoring.googleapis.com, logging.googleapis.com o cloudtrace.googleapis.com.

Antes de comenzar

Para usar la API de Telemetry, haz lo siguiente:

  1. Habilita la API de Telemetry en tu proyecto Google Cloud si aún no está habilitada. Puedes habilitar la API ejecutando el siguiente comando:

    gcloud services enable telemetry.googleapis.com

  2. Ajusta las cuotas de la API de Telemetry si los valores predeterminados no son suficientes. La API de Telemetry tiene cuotas independientes de las de la API de Cloud Monitoring y la API de Cloud Logging. Para obtener información sobre las cuotas y los límites de la API de Telemetry, consulta lo siguiente:

    Es posible que debas ajustar estas cuotas para adaptarlas al volumen de datos de telemetría que transfieres.

  3. Si recopilas seguimientos, otorga el rol Cloud Telemetry Traces Writer (roles/telemetry.tracesWriter) a la cuenta de servicio que usa el agente de operaciones. Este rol proporciona los permisos necesarios para escribir registros.

Configura el agente de operaciones para que use la API de Telemetry

El Agente de operaciones proporciona una opción de configuración para cambiar entre el envío de datos de telemetría con la API propietaria (la opción predeterminada) y con la API de Telemetría. Para recopilar datos de telemetría con el agente de operaciones y la API de Telemetry, debes hacer lo siguiente, como se describe en las siguientes secciones:

  1. Instala una versión del Agente de operaciones que admita la API de Telemetry.
  2. Actualiza el archivo config.yaml del agente de operaciones para establecer la opción de configuración.
  3. Reinicia el agente de operaciones para que se aplique el cambio.

Usa la versión 2.71.0 o posterior del Agente de operaciones

Para usar la API de Telemetry con el agente de operaciones, debes instalar la versión 2.71.0 o posterior del agente de operaciones. Para obtener información sobre la instalación del agente de operaciones, consulta Instala el agente de operaciones en VMs individuales.

Establece la opción de configuración

Para otorgarle acceso al agente de operaciones a la API de Telemetry, configura la opción de configuración otlp_exporter como true en el archivo config.yaml del agente:

global:
   otlp_exporter: true

Reinicia el Agente de operaciones

Linux

  1. Para reiniciar el agente, ejecuta el siguiente comando en la instancia: 
    sudo systemctl restart google-cloud-ops-agent
  2. Para confirmar que el agente se haya reiniciado, ejecuta el siguiente comando y verifica que los componentes “Agente de métricas” y “Agente de Logging” se hayan iniciado: 
    sudo systemctl status "google-cloud-ops-agent*"

Windows

  1. Conéctate a la instancia a través de RDP o una herramienta similar y accede a Windows.
  2. Haz clic con el botón derecho en el ícono de PowerShell y selecciona Ejecutar como administrador para abrir una terminal de PowerShell con privilegios de administrador.
  3. Para reiniciar el agente, ejecuta el siguiente comando de PowerShell: 
    Restart-Service google-cloud-ops-agent -Force
  4. Para confirmar que el agente se haya reiniciado, ejecuta el siguiente comando y verifica que los componentes “Agente de métricas” y “Agente de Logging” se hayan iniciado: 
    Get-Service google-cloud-ops-agent*

Configura el Agente de operaciones para que no use la API de Telemetry

Para detener la recopilación de telemetría del Agente de operaciones con la API de Telemetry y reanudar la recopilación con la API de Cloud Monitoring, la API de Logging y la API de Trace, haz lo siguiente:

  1. Quita la opción otlp_exporter del archivo config.yaml. Como alternativa, puedes establecer la opción en false.

  2. Reinicia el agente de operaciones para que se aplique el cambio.

¿Qué sigue?