Source (fuente) del Datadog Agent

Documentos > Observability Pipelines > Fuentes > Source (fuente) del Datadog Agent

Disponible para:

Logs | Métricas

Utiliza la source (fuente) de Datadog de Observability Pipelines para recibir logs o métricas () del Datadog Agent. Selecciona y configura esta source (fuente) cuando configures un pipeline.

Nota: Si utilizas Datadog distribution of OpenTelemetry (DDOT) Collector para los logs, debes utilizar la source (fuente) de OpenTelemetry para enviar los logs a Observability Pipelines.

Requisitos previos

You already have the Datadog Agent installed to collect and route your logs and/or metrics to Datadog. If you do not have Datadog Agents set up, see the Datadog Agent documentation for more information.

You have the following information available:

A Datadog API key with Remote Configuration enabled.
Your Datadog Site URL. For example, datadoghq.com for the site US1.

Configurar la fuente en la interfaz de usuario del pipeline

Opcionalmente, activa el interruptor para habilitar TLS. Si habilitas TLS, se requieren los siguientes archivos de certificado y clave.

Server Certificate Path: la ruta al archivo del certificado que ha sido firmado por tu archivo raíz de autoridad de certificación (CA) en formato DER o PEM (X.509).
CA Certificate Path: la ruta al archivo de certificado que es tu archivo raíz de autoridad de certificación (CA) en formato DER o PEM (X.509).
Private Key Path: la ruta al archivo de clave privada .key que pertenece a la ruta de tu certificado de servidor en formato DER o PEM (PKCS#8).

Nota: Todas las rutas de acceso de archivos se hacen relativas al directorio de datos de configuración, que es /var/lib/observability-pipelines-worker/config/ en forma predeterminada. Consulta Configuraciones Avanzadas del Worker para obtener más información. El archivo debe ser propiedad del usuario observability-pipelines-worker group y observability-pipelines-worker, o al menos legible por el grupo o usuario.

Configurar las variables de entorno

Datadog Agent address:
- The Observability Pipelines Worker listens to this socket address to receive data from the Datadog Agent.
- Stored in the environment variable DD_OP_SOURCE_DATADOG_AGENT_ADDRESS.
Datadog Agent TLS passphrase (when enabled):
- Stored in the environment variable DD_OP_SOURCE_DATADOG_AGENT_KEY_PASS.

Conectar el Datadog Agent al worker de Observability Pipelines

Utiliza el archivo de configuración del Agent o el archivo de valores del Helm chart del Agent para conectar el Datadog Agent al worker de Observability Pipelines.

Nota: Si tu Agent se está ejecutando en un contenedor de Docker, debes excluir los logs de Observability Pipelines con la variable de entorno DD_CONTAINER_EXCLUDE_LOGS. Para Helm, utiliza datadog.containerExcludeLogs. Esto impide la duplicación de logs, ya que el Worker también envía sus propios logs directamente a Datadog. Consulta Recopilación de logs de Docker o Configurando de variables de entorno para Helm para obtener más información.

Agent configuration file

To send Datadog Agent logs to the Observability Pipelines Worker, update your Agent configuration file with the following:

observability_pipelines_worker:
  logs:
    enabled: true
    url: "http://<OPW_HOST>:8282"

<OPW_HOST> is the host IP address or the load balancer URL associated with the Observability Pipelines Worker.

For CloudFormation installs, use the LoadBalancerDNS CloudFormation output for the URL.

For Kubernetes installs, you can use the internal DNS record of the Observability Pipelines Worker service. For example: http://opw-observability-pipelines-worker.default.svc.cluster.local:<PORT>.

After you restart the Agent, your observability data should be going to the Worker, processed by the pipeline, and delivered to Datadog.

Agent Helm values file

To send Datadog Agent logs to the Observability Pipelines Worker, update your Datadog Helm chart datadog-values.yaml with the following environment variables. See Agent Environment Variables for more information.

datadog:
  env:
    - name: DD_OBSERVABILITY_PIPELINES_WORKER_LOGS_ENABLED
      value: true
    - name: DD_OBSERVABILITY_PIPELINES_WORKER_LOGS_URL
      value: "http://<OPW_HOST>:8282"

<OPW_HOST> is the IP/URL of the host (or load balancer) associated with the Observability Pipelines Worker.

For Kubernetes installs, you can use the internal DNS record of the Observability Pipelines Worker service. For example: http://opw-observability-pipelines-worker.default.svc.cluster.local:<PORT>.

Utiliza el archivo de configuración del Agent o el archivo de valores del Helm chart del Agent para conectar el Datadog Agent al worker de Observability Pipelines.

Nota: Si tu Agent se está ejecutando en un contenedor de Docker, debes excluir las métricas de Observability Pipelines, como las métricas de utilización y de entrada/salida de eventos, con la variable de entorno DD_CONTAINER_EXCLUDE_METRICS. Para Helm, utiliza datadog.containerExcludeMetrics. Esto impide la duplicación de métricas, ya que el Worker también envía sus propias métricas directamente a Datadog. Consulta Recopilación de métricas de Docker o Configuración de variables de entorno para Helm para obtener más información.

Agent configuration file

Para enviar las métricas de Datadog Agent al Worker de Observability Pipelines, actualiza tu archivo de configuración del Agent con lo siguiente:

observability_pipelines_worker:
  metrics:
    enabled: true
    url: "http://<OPW_HOST>:8383"

<OPW_HOST> es la dirección IP del host o la URL del equilibrador de carga asociado con el worker de Observability Pipelines.

Para las instalaciones de CloudFormation, utiliza la salida LoadBalancerDNS de CloudFormation para la URL.
Para las instalaciones de Kubernetes, puedes utilizar el registro DNS interno del servicio Observability Pipelines Worker. Por ejemplo: http://opw-observability-pipelines-worker.default.svc.cluster.local:<PORT>.

Nota: Si el Worker está escuchando logs en el puerto 8282, debes utilizar otro puerto para las métricas, como 8383.

Después de reiniciar el Agent, tus datos de observabilidad deberían ir al Worker, procesados por el pipeline y entregados a Datadog.

Agent Helm values file

Para enviar métricas del Datadog Agent al Observability Pipelines Worker, actualiza tu gráfico de Helm de Datadog datadog-values.yaml con las siguientes variables de entorno. Consulta Variables de entorno del Agent para obtener más información.

datadog:
  env:
    - name: DD_OBSERVABILITY_PIPELINES_WORKER_METRICS_ENABLED
      value: true
    - name: DD_OBSERVABILITY_PIPELINES_WORKER_METRICS_URL
      value: "http://<OPW_HOST>:8383"

<OPW_HOST> es la dirección IP del host o la URL del equilibrador de carga asociado con el worker de Observability Pipelines.

Para las instalaciones de Kubernetes, puedes utilizar el registro DNS interno del servicio Observability Pipelines Worker. Por ejemplo: http://opw-observability-pipelines-worker.default.svc.cluster.local:<PORT>.

Nota: Si el Worker está escuchando logs en el puerto 8282, debes utilizar otro puerto para las métricas, como 8383.