View a markdown version of this page

Agente de Amazon CloudWatch - Amazon CloudWatch
Componentes de OpenTelemetry admitidosEjemplos de configuraciones

Agente de Amazon CloudWatch

El agente de CloudWatch se basa en el recopilador de OpenTelemetry, por lo que puede usarlo para recibir datos de OpenTelemetry y enviarlos a los puntos de conexión de OTLP de CloudWatch. Para la mayoría de los clientes, esta es la forma recomendada de enviar la telemetría de OpenTelemetry a CloudWatch, ya que un solo agente también puede impulsar experiencias seleccionadas, como CloudWatch Application Signals e Información de contenedores mejorada de CloudWatch.

Para enviar datos de OpenTelemetry a través del agente hoy mismo, debe proporcionar una configuración del recopilador de OpenTelemetry en YAML y agregarla a la propia configuración del agente. Inicie el agente con el archivo de configuración del agente de CloudWatch y, a continuación, agregue el archivo YAML de OpenTelemetry:

/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

El agente combina las dos configuraciones al inicio y registra la configuración resuelta. Para evitar conflictos de combinación con las canalizaciones que el agente crea automáticamente, agregue un sufijo personalizado a cada nombre de componente y canalización en su YAML de OpenTelemetry (por ejemplo, otlphttp/cwagent).

Componentes de OpenTelemetry admitidos

Los siguientes componentes de OpenTelemetry están disponibles para que los configure en la configuración de YAML adjunta. Use el nombre del tipo de componente que se muestra aquí como clave en su YAML.

Tipo de componente Componentes disponibles

Receptores

otlp, prometheus, statsd, collectd, jmx, hostmetrics, filelog, tcplog, udplog, jaeger, zipkin, kafka, kubeletstats

Procesadores

batch, memory_limiter, filter, attributes, resource, resourcedetection, metricstransform, transform, cumulativetodelta, deltatocumulative, deltatorate, groupbyattrs, groupbytrace, k8sattributes, metricsgeneration, metricstarttime, probabilistic_sampler, span, tail_sampling

Exportadores

otlphttp, awsemf, awscloudwatchlogs, awsxray, prometheusremotewrite, debug

Extensiones

sigv4auth, headers_setter, file_storage, health_check, pprof, zpages

El agente de CloudWatch solo admite la escritura de telemetría en los destinos de AWS.

Ejemplos de configuraciones

Los siguientes ejemplos envían cada señal al punto de conexión de OTLP de CloudWatch correspondiente mediante el exportador otlphttp y la extensión sigv4auth. Cada nombre de componente y canalización utiliza un sufijo /cwagent para evitar conflictos con las canalizaciones que el agente crea automáticamente. Sustituya region por su región de AWS.

Métricas

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]

Registros

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]

Seguimientos

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]
nota

Asegúrese de que Transaction Search esté habilitado antes de enviar rastros al punto de conexión de OTLP.