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 del protocolo de línea de OpenTelemetry de código abierto. Cuando habilitas esta función, el Agente de operaciones envía registros y métricas a tu proyecto de Google Cloud con la API de Telemetría en lugar de la API de Cloud Monitoring y la API de Cloud Logging 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 proyecto Google Cloud 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 transfieres.

Configura el agente de operaciones para que use 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 con una variable de entorno, EXPERIMENTAL_FEATURES. 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. Configura la variable de entorno EXPERIMENTAL_FEATURES.
  3. Reinicia el agente de operaciones para que se aplique 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 una 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.

Configura la variable de entorno

Para otorgarle acceso al Agente de operaciones a la API de Telemetry, establece la variable de entorno EXPERIMENTAL_FEATURES en 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 establecer 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 Telemetría

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

  1. Desactiva 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 que se aplique el cambio.

¿Qué sigue?