Amazon CloudWatch 에이전트

CloudWatch 에이전트는 OpenTelemetry Collector를 기반으로 구축되므로 이를 사용하여 OpenTelemetry 데이터를 수신하고 CloudWatch OTLP 엔드포인트로 전송할 수 있습니다. 단일 에이전트가 CloudWatch Application Signals 및 CloudWatch Enhanced Container Insights와 같은 엄선된 환경을 지원할 수도 있으므로 대부분의 고객에게 이는 OpenTelemetry 원격 측정을 CloudWatch로 전송하는 데 권장되는 방법입니다.

지금 에이전트를 통해 OpenTelemetry 데이터를 전송하려면 OpenTelemetry 수집기 구성을 YAML으로 제공하고 에이전트의 자체 구성에 추가합니다. CloudWatch 에이전트 구성 파일로 에이전트를 시작한 후 OpenTelemetry YAML 파일을 추가합니다.

/opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl -a fetch-config -c file:/tmp/agent.json -s
/opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl -a append-config -c file:/tmp/otel.yaml -s

에이전트는 시작 시 2가지 구성 파일을 병합하고 해결된 구성을 로깅합니다. 에이전트가 자동으로 생성하는 파이프라인과의 병합 충돌을 방지하려면 OpenTelemetry YAML의 각 구성 요소 및 파이프라인 이름에 사용자 지정 접미사를 추가합니다(예: otlphttp/cwagent).

지원되는 OpenTelemetry 구성 요소

추가된 YAML 구성에서 다음 OpenTelemetry 구성 요소를 구성할 수 있습니다. 여기에 표시된 구성 요소 유형 이름을 YAML의 키로 사용합니다.

CloudWatch 에이전트는 AWS 대상에 원격 측정 쓰기만 지원합니다.

구성 예제

다음 예제에서는 otlphttp 내보내기 및 sigv4auth 확장을 사용하여 각 신호를 해당 CloudWatch OTLP 엔드포인트로 전송합니다. 각 구성 요소와 파이프라인 이름은 /cwagent 접미사를 사용하여 에이전트가 자동으로 생성하는 파이프라인과의 충돌을 방지합니다. 리전을 해당 AWS 리전으로 바꿉니다.

Metrics

receivers:
  otlp/cwagent:
    protocols:
      http:
        endpoint: 0.0.0.0:4318
processors:
  batch/cwagent: {}
exporters:
  otlphttp/cwagent:
    metrics_endpoint: https://monitoring.region.amazonaws.com/v1/metrics
    auth:
      authenticator: sigv4auth/cwagent
extensions:
  sigv4auth/cwagent:
    region: "region"
    service: "monitoring"
service:
  extensions: [sigv4auth/cwagent]
  pipelines:
    metrics/cwagent:
      receivers: [otlp/cwagent]
      processors: [batch/cwagent]
      exporters: [otlphttp/cwagent]

로그

receivers:
  otlp/cwagent:
    protocols:
      http:
        endpoint: 0.0.0.0:4318
exporters:
  otlphttp/cwagent:
    logs_endpoint: https://logs.region.amazonaws.com/v1/logs
    headers:
      x-aws-log-group: my-log-group
      x-aws-log-stream: default
    auth:
      authenticator: sigv4auth/cwagent
extensions:
  sigv4auth/cwagent:
    region: "region"
    service: "logs"
service:
  extensions: [sigv4auth/cwagent]
  pipelines:
    logs/cwagent:
      receivers: [otlp/cwagent]
      exporters: [otlphttp/cwagent]

트레이스

receivers:
  otlp/cwagent:
    protocols:
      http:
        endpoint: 0.0.0.0:4318
exporters:
  otlphttp/cwagent:
    traces_endpoint: https://xray.region.amazonaws.com/v1/traces
    auth:
      authenticator: sigv4auth/cwagent
extensions:
  sigv4auth/cwagent:
    region: "region"
    service: "xray"
service:
  extensions: [sigv4auth/cwagent]
  pipelines:
    traces/cwagent:
      receivers: [otlp/cwagent]
      exporters: [otlphttp/cwagent]