Utilizzare l'API Telemetry

Puoi configurare l'Ops Agent in modo che utilizzi l'API Telemetry (OTLP) per inviare log, metriche e tracce al tuo progetto Google Cloud . L'API Telemetry, telemetry.googleapis.com, è un'implementazione del protocollo OpenTelemetry open source. Quando configuri l'Ops Agent per utilizzare questa API, l'Ops Agent invia la telemetria utilizzando l'API Telemetry anziché le API proprietarie Cloud Monitoring, API Logging o Trace.

Se adotti l'utilizzo dell'API Telemetry in Ops Agent e hai grafici o criteri di avviso che monitorano l'utilizzo dell'API, devi aggiornare questi artefatti per monitorare l'endpoint telemetry.googleapis.com anziché gli endpoint monitoring.googleapis.com, logging.googleapis.com o cloudtrace.googleapis.com.

Prima di iniziare

Per utilizzare l'API Telemetry:

  1. Abilita l'API Telemetry nel tuo progetto Google Cloud , se non è già abilitata. Puoi abilitare l'API eseguendo il seguente comando:

    gcloud services enable telemetry.googleapis.com

  2. Modifica le quote dell'API Telemetry, se i valori predefiniti non sono sufficienti. L'API Telemetry ha quote separate da quelle dell'API Cloud Monitoring e dell'API Cloud Logging. Per informazioni sulle quote e sui limiti dell'API Telemetry, consulta quanto segue:

    Potresti dover modificare queste quote per adattarle al volume di dati di telemetria che importi.

  3. Se raccogli le tracce, concedi il ruolo Cloud Telemetry Traces Writer (roles/telemetry.tracesWriter) al account di servizio utilizzato da Ops Agent. Questo ruolo fornisce le autorizzazioni necessarie per scrivere le tracce.

Configura l'Ops Agent per utilizzare l'API Telemetry

Ops Agent offre un'opzione di configurazione per passare dall'invio della telemetria utilizzando l'API proprietaria, ovvero l'impostazione predefinita, all'utilizzo dell'API Telemetry. Per raccogliere la telemetria utilizzando Ops Agent e l'API Telemetry, devi eseguire le seguenti operazioni, come descritto nelle sezioni seguenti:

  1. Installa una versione di Ops Agent che supporti l'API Telemetry.
  2. Aggiorna il file config.yaml di Ops Agent per impostare l'opzione di configurazione.
  3. Riavvia l'Ops Agent per applicare la modifica.

Utilizza Ops Agent versione 2.71.0 o successive

Per utilizzare l'API Telemetry con Ops Agent, devi installare Ops Agent versione 2.71.0 o successive. Per informazioni sull'installazione di Ops Agent, consulta Installazione di Ops Agent di singole VM.

Imposta l'opzione di configurazione

Concedi a Ops Agent l'accesso all'API Telemetry impostando l'opzione di configurazione otlp_exporter su true nel file config.yaml dell'agente:

global:
   otlp_exporter: true

Riavvia l'Ops Agent

Linux

  1. Per riavviare l'agente, esegui il seguente comando sull'istanza: 
    sudo systemctl restart google-cloud-ops-agent
  2. Per verificare che l'agente sia stato riavviato, esegui il seguente comando e verifica che i componenti "Agente Metriche" e "Agente Logging" siano stati avviati: 
    sudo systemctl status "google-cloud-ops-agent*"

Windows

  1. Connettiti all'istanza utilizzando RDP o uno strumento simile e accedi a Windows.
  2. Apri un terminale PowerShell con privilegi amministrativi facendo clic con il tasto destro del mouse sull'icona di PowerShell e selezionando Esegui come amministratore.
  3. Per riavviare l'agente, esegui il seguente comando PowerShell: 
    Restart-Service google-cloud-ops-agent -Force
  4. Per verificare che l'agente sia stato riavviato, esegui il seguente comando e verifica che i componenti "Agente Metriche" e "Agente Logging" siano stati avviati: 
    Get-Service google-cloud-ops-agent*

Configura l'Ops Agent in modo che non utilizzi l'API Telemetry

Per impedire a Ops Agent di raccogliere dati di telemetria utilizzando l'API Telemetry e riprendere la raccolta utilizzando le API Cloud Monitoring, API Logging e Trace, procedi nel seguente modo:

  1. Rimuovi l'opzione otlp_exporter dal file config.yaml. In alternativa, puoi impostare l'opzione su false.

  2. Riavvia Ops Agent per applicare la modifica.

Passaggi successivi