Usa la API de Telemetry

En este documento, se describe cómo configurar el Agente de operaciones para usar la API de Telemetry (OTLP), telemetry.googleapis.com. La API de Telemetry es una implementación de el protocolo de código abierto OpenTelemetry. Cuando habilitas esta función, el Agente de operaciones envía registros y métricas a tu Google Cloud proyecto mediante la API de Telemetry en lugar de la API de Cloud Monitoring y la API de Cloud Logging, que son propietarias.

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 o logging.googleapis.com.

Antes de comenzar

Para usar la API de Telemetry, haz lo siguiente:

  1. Habilita la API de Telemetry en tu Google Cloud proyecto, si aún no está habilitada. Para habilitar la API, ejecuta 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 ingresas.

Configura el Agente de operaciones para usar la API de Telemetry

Durante el período de vista previa, el uso de la API de Telemetry por parte del Agente de operaciones se controla mediante una variable de entorno, EXPERIMENTAL_FEATURES. Para recopilar 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. Configura la variable de entorno EXPERIMENTAL_FEATURES.
  3. Reinicia el Agente de operaciones para recoger el cambio.

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

Para usar la API de Telemetry con el Agente de operaciones, debes instalar la versión 2.66.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 de VMs individuales.

Configura la variable de entorno

Para otorgar al Agente de operaciones acceso a la API de Telemetry, configura la variable de entorno EXPERIMENTAL_FEATURES con el valor otlp_exporter, como se muestra en las siguientes pestañas:

Linux

Para modificar el entorno del Agente de operaciones, ejecuta los siguientes comandos en tu instancia:

for service in \
        google-cloud-ops-agent \
        google-cloud-ops-agent-fluent-bit \
        google-cloud-ops-agent-opentelemetry-collector \
        ; do
        sudo mkdir -p "/etc/systemd/system/${service}.service.d"
        echo -e '[Service]\nEnvironment="EXPERIMENTAL_FEATURES=otlp_exporter"' | sudo tee "/etc/systemd/system/${service}.service.d/otlp_exporter.conf"
done
sudo systemctl daemon-reload

Windows

Para modificar el entorno del Agente de operaciones, sigue estos pasos:

  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. Ejecuta el siguiente comando de PowerShell para configurar la variable de entorno EXPERIMENTAL_FEATURES: 
    setx EXPERIMENTAL_FEATURES "otlp_exporter" /M

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 evitar que el Agente de operaciones recopile telemetría con la API de Telemetry y reanudar la recopilación de telemetría con la API de Cloud Monitoring y la API de Cloud Logging, debes hacer lo siguiente:

  1. Anula la configuración de la variable de entorno EXPERIMENTAL_FEATURES.

    Linux

    Para modificar el entorno del Agente de operaciones, ejecuta los siguientes comandos en tu instancia:

    sudo find /etc/systemd/system -name otlp_exporter.conf | sudo xargs rm
sudo systemctl daemon-reload

    Windows

    Para modificar el entorno del Agente de operaciones, sigue estos pasos:

    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. Ejecuta el siguiente comando de PowerShell para quitar la variable de entorno EXPERIMENTAL_FEATURES: 
      REG delete "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" /F /V EXPERIMENTAL_FEATURES

  2. Reinicia el Agente de operaciones para recoger el cambio.

¿Qué sigue?