Descripción general

Datadog proporciona puntos de conexión de ingesta OTLP dedicados para plataformas administradas, lo que le permite enviar trazas, métricas y registros directamente a Datadog con una configuración mínima. Cada plataforma compatible tiene su propio subdominio OTLP (por ejemplo, cloudflare.integrations.otlp.datadoghq.com). Estos puntos de conexión dedicados permiten a Datadog identificar la fuente del tráfico y aplicar procesamiento y atribución específicos de la plataforma. El punto de conexión OTLP genérico asume que hay un servidor presente, lo que puede causar un comportamiento inesperado para el tráfico de plataformas administradas.

Utilice esta opción cuando ejecute cargas de trabajo en una plataforma administrada donde no sea factible instalar un Datadog Agent o un OpenTelemetry Collector. Si su plataforma no se encuentra en la tabla a continuación y usted ejecuta en cómputo sin servidor de AWS, Azure o GCP, consulte Serverless.

Para obtener recomendaciones de nombre de host para la ingesta directa de OTLP, consulte Hostname and Tagging.

Cada punto de conexión admite las siguientes rutas de señal:

Para la configuración específica de la señal (traducción de métricas, procesamiento de registros), consulte las páginas de los puntos de conexión de Logs y Metrics.

Configuración

Para enviar datos OTLP a Datadog a través de un punto de conexión de plataforma administrada, configure su exportador de OpenTelemetry con las siguientes variables de entorno. Reemplace {platform} con el subdominio de su plataforma de la tabla de plataformas compatibles.

export OTEL_EXPORTER_OTLP_PROTOCOL="http/protobuf"
export OTEL_EXPORTER_OTLP_ENDPOINT="https://{platform}.integrations.otlp."
export OTEL_EXPORTER_OTLP_HEADERS="dd-api-key=${DD_API_KEY}"

Para enviar solo trazas:

export OTEL_EXPORTER_OTLP_TRACES_PROTOCOL="http/protobuf"
export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT="https://{platform}.integrations.otlp./v1/traces"
export OTEL_EXPORTER_OTLP_TRACES_HEADERS="dd-api-key=${DD_API_KEY}"

Plataformas compatibles

Todos los puntos de conexión siguen el patrón https://{subdomain}.integrations.otlp./.

Para habilitar la exportación OTLP desde una plataforma administrada que no aparezca en la lista anterior, comuníquese con su Customer Success Manager.

Limitaciones

Sin enriquecimiento de metadatos

Sin un Collector o Agent, la telemetría no se enriquece con metadatos de servidor. Las funciones que dependen de estos metadatos (por ejemplo, la Lista de servidores de infraestructura) no están disponibles. Consulte la lista de compatibilidad de OpenTelemetry para ver la lista completa de funciones afectadas.

Normalización limitada

Cierto procesamiento de señales que un Collector o Agent realiza automáticamente no ocurre con la ingesta directa. Por ejemplo, la conversión de métricas de acumulativo a delta requiere un componente con estado. Si su plataforma exporta métricas acumulativas, configure su SDK o pipeline para exportar temporalidad delta.

Métricas de traza

Las métricas de traza se calculan de forma predeterminada para los puntos de conexión de plataformas administradas. Las plataformas administradas pueden muestrear el tráfico antes de la exportación, lo cual puede afectar la precisión de las métricas de traza.

Muestreo

Los controles de muestreo disponibles en el Collector (muestreo basado en el seguimiento de las últimas líneas, muestreo probabilístico) no están disponibles con la ingesta directa. Las plataformas administradas pueden aplicar su propio muestreo antes de la exportación.

Lecturas adicionales

Documentación, enlaces y artículos útiles adicionales:

Compatibilidad con OpenTelemetry en DatadogDOCUMENTACIÓN Punto de conexión de ingesta OTLP de DatadogDOCUMENTACIÓN