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.

OpenTelemetry Kollektor

Der OpenTelemetry Collector ist ein herstellerunabhängiger Open-Source-Agent, der Telemetriedaten empfängt, verarbeitet und exportiert. Er fungiert als zentrale Pipeline zwischen Ihren Anwendungen und Amazon. Er sammelt Metriken CloudWatch, Protokolle und Traces aus mehreren Quellen und sendet sie an das CloudWatch Protokoll (OTLP). OpenTelemetry

Die Verwendung des OpenTelemetry Collectors mit CloudWatch bietet die folgenden Vorteile:

Unterstützte Empfänger

Der OpenTelemetry Collector unterstützt eine Vielzahl von Empfängern für die Aufnahme von Telemetriedaten. Sie können OpenTelemetry Empfänger wie den OTLP-Empfänger für Anwendungen verwenden, die mit OpenTelemetry SDKs instrumentiert sind, oder Prometheus-Empfänger, um Metriken von vorhandenen Prometheus-Exporteuren zu entfernen. Zu den CloudWatch häufigsten Prometheus-Empfängern, die verwendet werden, gehören:

Sie können mehrere Empfänger in einem einzigen Collector konfigurieren, sodass Sie sowohl die Prometheus-Metriken als auch die Prometheus-Metriken sammeln OpenTelemetry und über dieselbe Pipeline an sie senden können. CloudWatch Die vollständige Liste der verfügbaren Empfänger finden Sie im OpenTelemetry Collector-Repository.

Erste Schritte

Voraussetzung — Wenn Sie den OTLP-Endpunkt für die Ablaufverfolgung verwenden, stellen Sie sicher, dass die Transaktionssuche aktiviert ist.

Schritte:

Authentifizieren Sie sich mit einem Inhaber-Token (API-Schlüssel)

Wenn Sie die AWS Anmeldeinformationen auf dem Host nicht konfigurieren müssen — wenn Sie beispielsweise auf einer anderen AWS Infrastruktur, anderen Cloud-Anbietern oder CI/CD Pipelines ausgeführt werden —, können Sie die Bearer-Token-Authentifizierung anstelle von SigV4 verwenden. Bearer-Token werden für die Metriken- und Logs-Endpunkte unterstützt (für jeden Dienst sind separate API-Schlüssel erforderlich). Die Bearer-Token-Authentifizierung wird für Traces nicht unterstützt.

Anweisungen zur Einrichtung finden Sie unterInhaber-Token-Authentifizierung für Metriken einrichten. Informationen zu Protokollen finden Sie unter Inhaber-Token-Authentifizierung für Protokolle https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_HTTP_Endpoints_BearerTokenAuth.html einrichten.

Ein Beispiel für eine Collector-Konfiguration mit Bearer-Token finden Sie im Beispiel für Bearer-Token-Metriken in den folgenden Collector-Konfigurationsbeispielen.

Beispiele für eine Collector-Konfiguration

Kopieren Sie den folgenden Inhalt und fügen Sie ihn ein, um Ihren Kollektor so zu konfigurieren, dass er Protokolle und Ablaufverfolgungen an die OTLP-Endpunkte sendet.

receivers:
  otlp:
    protocols:
      grpc:
        endpoint: 0.0.0.0:4317
      http:
        endpoint: 0.0.0.0:4318

exporters:
  otlphttp/logs:
    compression: gzip
    logs_endpoint: logs_otlp_endpoint
    headers: 
      x-aws-log-group: ency_log_group
      x-aws-log-stream: default
    auth:
      authenticator: sigv4auth/logs
      
  otlphttp/traces:
    compression: gzip
    traces_endpoint: traces_otlp_endpoint
    auth:
      authenticator: sigv4auth/traces

extensions:
  sigv4auth/logs:
    region: "region"
    service: "logs"
  sigv4auth/traces:
    region: "region"
    service: "xray"

service:
  telemetry:
  extensions: [sigv4auth/logs, sigv4auth/traces]
  pipelines:
    logs:
      receivers: [otlp]
      exporters: [otlphttp/logs]
    traces:
      receivers: [otlp]
      exporters: [otlphttp/traces]   
                
            

Das Folgende ist ein Beispiel für das Senden von Protokollen und Ablaufverfolgungen mit sigv4 an us-east-1.

receivers:
  otlp:
    protocols:
      grpc:
        endpoint: 0.0.0.0:4317
      http:
        endpoint: 0.0.0.0:4318

exporters:
  otlphttp/logs:
    compression: gzip
    logs_endpoint: https://logs.us-east-1.amazonaws.com/v1/logs
    headers: 
      x-aws-log-group: MyApplicationLogs
      x-aws-log-stream: default
    auth:
      authenticator: sigv4auth/logs
      
  otlphttp/traces:
    compression: gzip
    traces_endpoint: https://xray.us-east-1.amazonaws.com/v1/traces
    auth:
      authenticator: sigv4auth/traces

extensions:
  sigv4auth/logs:
    region: "us-east-1"
    service: "logs"
  sigv4auth/traces:
    region: "us-east-1"
    service: "xray"

service:
  telemetry:
  extensions: [sigv4auth/logs, sigv4auth/traces]
  pipelines:
    logs:
     receivers: [otlp]
      exporters: [otlphttp/logs]
    traces:
      receivers: [otlp]
      exporters: [otlphttp/traces]   
                 
                
            

Kopieren Sie den folgenden Inhalt und fügen Sie ihn ein, um Ihren Collector so zu konfigurieren, dass er Metriken an die OTLP-Endpunkte sendet.

receivers:
  otlp:
    protocols:
      http:
        endpoint: "0.0.0.0:4318"

processors:
  batch:
    send_batch_size: 200
    timeout: 10s

exporters:
  otlphttp:
    tls:
      insecure: false
    endpoint: metrics_otlp_endpoint
    auth:
      authenticator: sigv4auth

extensions:
  sigv4auth:
    service: "monitoring"
    region: "region"

service:
  extensions: [sigv4auth]
  pipelines:
    metrics:
      receivers: [otlp]
      processors: [batch]
      exporters: [otlphttp]
            

Das Folgende ist ein Beispiel für das Senden von Metriken mithilfe von sigv4 an us-east-1.

receivers:
  otlp:
    protocols:
      http:
        endpoint: "0.0.0.0:4318"

processors:
  batch:
    send_batch_size: 200
    timeout: 10s

exporters:
  otlphttp:
    tls:
      insecure: false
    endpoint: "https://monitoring.us-east-1.amazonaws.com/v1/metrics:443"
    auth:
      authenticator: sigv4auth

extensions:
  sigv4auth:
    service: "monitoring"
    region: "us-east-1"

service:
  extensions: [sigv4auth]
  pipelines:
    metrics:
      receivers: [otlp]
      processors: [batch]
      exporters: [otlphttp]
            

Metriken mit Bearer-Token-Authentifizierung

Im Folgenden finden Sie ein Beispiel für das Senden von Metriken mithilfe eines Bearer-Tokens an us-east-1. Anweisungen zur Einrichtung und bewährte Sicherheitsmethoden finden Sie unter. Inhaber-Token-Authentifizierung für Metriken einrichten

extensions:
  bearertokenauth:
    filename: "/etc/otel/cw-api-key"

receivers:
  otlp:
    protocols:
      http:
        endpoint: "0.0.0.0:4318"

processors:
  batch:
    send_batch_size: 200
    timeout: 10s

exporters:
  otlphttp:
    tls:
      insecure: false
    endpoint: "https://monitoring.us-east-1.amazonaws.com/v1/metrics"
    auth:
      authenticator: bearertokenauth

service:
  extensions: [bearertokenauth]
  pipelines:
    metrics:
      receivers: [otlp]
      processors: [batch]
      exporters: [otlphttp]