Telemetry API verwenden

Sie können den Ops-Agent so konfigurieren, dass er die Telemetry (OTLP) API verwendet, um Logs, Messwerte und Traces an Ihr Google Cloud -Projekt zu senden. Die Telemetry API, telemetry.googleapis.com, ist eine Implementierung des Open-Source-OpenTelemetry-Protokolls. Wenn Sie den Ops-Agent für die Verwendung dieser API konfigurieren, sendet er Telemetriedaten über die Telemetry API anstelle der proprietären Cloud Monitoring API, Logging API oder Trace API.

Wenn Sie die Telemetry API im Ops-Agent verwenden und Diagramme oder Benachrichtigungsrichtlinien haben, mit denen Ihre API-Nutzung überwacht wird, müssen Sie diese Artefakte aktualisieren, damit der telemetry.googleapis.com-Endpunkt anstelle der Endpunkte monitoring.googleapis.com, logging.googleapis.com oder cloudtrace.googleapis.com überwacht wird.

Hinweis

So verwenden Sie die Telemetry API:

  1. Aktivieren Sie die Telemetry API in Ihrem Google Cloud Projekt, falls sie noch nicht aktiviert ist. Sie können die API mit dem folgenden Befehl aktivieren:

    gcloud services enable telemetry.googleapis.com

  2. Passen Sie die Kontingente für die Telemetry API an, wenn die Standardwerte nicht ausreichen. Die Telemetry API hat separate Kontingente für die Cloud Monitoring API und die Cloud Logging API. Informationen zu den Kontingenten und Limits für die Telemetry API finden Sie unter:

    Möglicherweise müssen Sie diese Kontingente an das Volumen der Telemetriedaten anpassen, die Sie aufnehmen.

  3. Wenn Sie Traces erfassen, weisen Sie dem vom Ops-Agent verwendeten Dienstkonto die Rolle Cloud Telemetry Traces Writer (roles/telemetry.tracesWriter) zu. Diese Rolle bietet die Berechtigungen, die zum Schreiben von Traces erforderlich sind.

Ops-Agent für die Verwendung der Telemetry API konfigurieren

Der Ops-Agent bietet eine Konfigurationsoption, mit der Sie zwischen dem Senden von Telemetriedaten über die proprietäre API (Standard) und über die Telemetry API wechseln können. Wenn Sie Telemetriedaten mit dem Ops-Agenten und der Telemetry API erfassen möchten, müssen Sie die folgenden Schritte ausführen, wie in den folgenden Abschnitten beschrieben:

  1. Installieren Sie eine Version des Ops-Agents, die die Telemetry API unterstützt.
  2. Aktualisieren Sie die Ops-Agent-Datei config.yaml, um die Konfigurationsoption festzulegen.
  3. Starten Sie den Ops-Agent neu, damit die Änderung wirksam wird.

Ops-Agent-Version 2.71.0 oder höher verwenden

Wenn Sie die Telemetry API mit dem Ops-Agenten verwenden möchten, müssen Sie den Ops-Agenten in Version 2.71.0 oder höher installieren. Informationen zum Installieren des Ops-Agents finden Sie unter Ops-Agent auf einzelnen VMs installieren.

Konfigurationsoption festlegen

Gewähren Sie dem Ops-Agent Zugriff auf die Telemetry API, indem Sie die Konfigurationsoption otlp_exporter in der Datei config.yaml des Agents auf true setzen:

global:
   otlp_exporter: true

Ops-Agent neu starten

Linux

  1. Führen Sie den folgenden Befehl auf der Instanz aus, um den Agenten neu zu starten: 
    sudo systemctl restart google-cloud-ops-agent
  2. Führen Sie den folgenden Befehl aus, um zu überprüfen, ob der Agent neu gestartet wurde. Prüfen Sie dann, ob die Komponenten „Metrics-Agent“ und „Logging-Agent“ gestartet wurden: 
    sudo systemctl status "google-cloud-ops-agent*"

Windows

  1. Stellen Sie mithilfe von RDP oder einem ähnlichen Tool eine Verbindung zu Ihrer Instanz her und melden Sie sich bei Windows an.
  2. Öffnen Sie ein PowerShell-Terminal mit Administratorberechtigungen. Klicken Sie dazu mit der rechten Maustaste auf das PowerShell-Symbol und wählen Sie Als Administrator ausführen aus.
  3. Führen Sie den folgenden PowerShell-Befehl aus, um den Agenten neu zu starten: 
    Restart-Service google-cloud-ops-agent -Force
  4. Führen Sie den folgenden Befehl aus, um zu überprüfen, ob der Agent neu gestartet wurde. Prüfen Sie dann, ob die Komponenten „Metrics-Agent“ und „Logging-Agent“ gestartet wurden: 
    Get-Service google-cloud-ops-agent*

Ops-Agent so konfigurieren, dass die Telemetry API nicht verwendet wird

So verhindern Sie, dass der Ops-Agent Telemetriedaten über die Telemetry API erfasst, und setzen die Erfassung von Telemetriedaten über die Cloud Monitoring API, die Logging API und die Trace API fort:

  1. Entfernen Sie die Option otlp_exporter aus der Datei config.yaml. Alternativ können Sie die Option auf false festlegen.

  2. Starten Sie den Ops-Agenten neu, damit die Änderung wirksam wird.

Nächste Schritte