Sammeln 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.

Sammeln Sie Metriken und Traces mit OpenTelemetry

Mit dem CloudWatch Agent with the OpenTelemetry Protocol (OTLP), einer beliebten Open-Source-Lösung, können Sie Metriken und Traces aus 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 Sprachen finden Sie unter OpenTelemetry Unterstützte Sprache APIs & SDKs. .

Um OpenTelemetry Metriken und Traces zu sammeln, fügen Sie der CloudWatch Agenten-Konfigurationsdatei einen otlp Abschnitt hinzu. Der Abschnitt enthält 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 mit 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 OpenTelemetry SDK festgelegt wurde. 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 wurden. 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 soll.

    • 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 TLS-erforderliche Verbindungen verwendet werden soll.

Der otlp Abschnitt kann in der CloudWatch Agentenkonfigurationsdatei in mehrere Abschnitte aufgeteilt werden, je nachdem, wie und wohin Sie die Metriken und Traces senden möchten. Jeder otlp Abschnitt benötigt einen eindeutigen Endpunkt. Ausführliche Informationen zur Aufteilung der Metriken- und Traces-Endpunkte finden Sie in der SDK-Dokumentation unter OTLP Exporter Configuration. OpenTelemetry

Um Messwerte an CloudWatch oder Amazon Managed Service for Prometheus zu senden, fügen Sie den otlp Abschnitt unten metrics_collected innerhalb des metrics Abschnitts hinzu. Weitere Informationen zum Senden von Messdaten 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:

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

Um Metriken mit dem Embedded Metric Format (EMF) an Amazon CloudWatch Logs zu senden, fügen Sie den otlp Abschnitt unten metrics_collected innerhalb des logs Abschnitts hinzu. Dadurch werden die EMF-Protokolle standardmäßig an die /aws/cwagent Protokollgruppe und ein generierter Protokollstream gesendet. Die Metriken werden standardmäßig in den CWAgent Namespace 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 traces_collected innerhalb des otlp Abschnitts den traces Abschnitt unter hinzu. Das folgende Beispiel zeigt eine Konfiguration, die Traces an X-Ray sendet:

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