View a markdown version of this page

Erfassen Sie Metriken und Traces mit OpenTelemetry - Amazon CloudWatch

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Erfassen Sie Metriken und Traces mit OpenTelemetry

Mithilfe des CloudWatch Agenten with the OpenTelemetry Protocol (OTLP), einer beliebten Open-Source-Lösung, können Sie Metriken und Traces von Ihren Anwendungen oder Diensten sammeln. Sie können jedes OpenTelemetry SDK verwenden, um Metriken und Traces an den CloudWatch Agenten zu senden. Weitere Informationen zu den verfügbaren OpenTelemetry SDKs finden Sie unter OpenTelemetry Unterstützte Sprach-APIs und SDKs. .

Um OpenTelemetry Metriken und Traces zu sammeln, fügen Sie der CloudWatch Agenten-Konfigurationsdatei einen otlp Abschnitt hinzu. Der Abschnitt hat die folgenden Felder:

  • grpc_endpoint – Optional. Gibt die Adresse an, die der CloudWatch Agent verwenden soll, um auf OpenTelemetry Metriken oder Traces zu warten, die mithilfe von gRPC Remote Procedure Calls gesendet wurden. Das Format ist ip:port. Diese Adresse muss mit der Adresse übereinstimmen, die für den gRPC-Exporter im SDK festgelegt wurde. OpenTelemetry Wenn Sie dieses Feld auslassen, wird der Standard 127.0.0.1:4317 verwendet.

  • http_endpoint – Optional. Gibt die Adresse an, die der CloudWatch Agent verwenden soll, um auf OpenTelemetry Metriken oder Traces zu warten, die über HTTP gesendet werden. Das Format ist ip:port. Diese Adresse muss mit der Adresse übereinstimmen, die für den HTTP-Exporter im OpenTelemetry SDK festgelegt wurde. Wenn Sie dieses Feld auslassen, wird der Standard 127.0.0.1:4318 verwendet.

  • tls – Optional. Gibt an, dass der Server mit TLS konfiguriert werden sollte.

    • cert_file: Pfad zum TLS-Zertifikat, das für die erforderlichen TLS-Verbindungen verwendet werden soll.

    • key_file: Pfad zum TLS-Schlüssel, der für die erforderlichen TLS-Verbindungen verwendet werden soll.

Der otlp Abschnitt kann in mehrere Abschnitte der CloudWatch Agentenkonfigurationsdatei aufgeteilt werden, je nachdem, wie und wohin Sie die Metriken und Traces senden möchten.

Wichtig

Jeder otlp-Abschnitt erfordert einen eindeutigen Endpunkt und Port. Detaillierte Informationen zum Aufteilen der Metriken- und Trace-Endpunkte finden Sie in der SDK-Dokumentation unter OTLP Exporter-Konfiguration. OpenTelemetry

Um Metriken an CloudWatch oder Amazon Managed Service for Prometheus zu senden, fügen Sie den Abschnitt unter dem otlp Abschnitt hinzu. metrics_collected metrics Weitere Informationen zum Senden von Metriken an verschiedene Ziele finden Sie unter Erstellen oder bearbeiten Sie die CloudWatch Agenten-Konfigurationsdatei manuell. Das folgende Beispiel zeigt eine Konfiguration, die Metriken sendet an: CloudWatch

Anmerkung

Wenn Sie den Agenten in containerisierten Umgebungen ausführen und Telemetriedaten von außerhalb des Netzwerks des Agent-Containers senden, stellen Sie sicher, dass Sie den Endpunkt als und nicht den 0.0.0.0 Standardendpunkt angeben. 127.0.0.1

{
  "metrics": {
    "metrics_collected": {
      "otlp": {
        "grpc_endpoint": "127.0.0.1:4317",
        "http_endpoint": "127.0.0.1:4318"
      }
    }
  }
}

Um Messwerte mithilfe des Embedded Metric Formats (EMF) an Amazon CloudWatch Logs zu senden, fügen Sie den otlp Abschnitt unter metrics_collected dem Abschnitt hinzu. logs Dadurch werden die EMF-Protokolle standardmäßig an die /aws/cwagent-Protokollgruppe und ein generierter Protokollstream gesendet. Die Metriken werden standardmäßig in den Namespace CWAgent extrahiert. Das folgende Beispiel zeigt eine Konfiguration, die Metriken als EMF-Logs an CloudWatch Logs sendet:

{
  "logs": {
    "metrics_collected": {
      "otlp": {
        "grpc_endpoint": "127.0.0.1:4317",
        "http_endpoint": "127.0.0.1:4318"
      }
    }
  }
}

Um Traces an zu senden AWS X-Ray, fügen Sie den otlp Abschnitt unter traces_collected dem traces Abschnitt hinzu. Das folgende Beispiel zeigt eine Konfiguration, die Traces sendet an X-Ray:

{
  "traces": {
    "traces_collected": {
      "otlp": {
        "grpc_endpoint": "127.0.0.1:4317",
        "http_endpoint": "127.0.0.1:4318"
      }
    }
  }
}