Exportación de datos de OpenTelemetry a Datadog en Azure Container Apps

En esta guía se muestra cómo configurar Azure Container Apps para reenviar registros, seguimientos y métricas a Datadog mediante el agente de OpenTelemetry administrado.

Para obtener más información sobre el agente de OpenTelemetry administrado, consulte Set up OpenTelemetry agents in Azure Container Apps.

Lo que aprendes

  • Cree una clave de la API de Datadog para la ingesta de telemetría.
  • Configure un destino de Datadog en el entorno de Container Apps mediante Bicep, CLI de Azure o el portal de Azure.
  • Aplique actualizaciones de configuración al entorno y la aplicación de Container Apps existentes.
  • Compruebe la telemetría en Datadog.

Prerequisites

  • Una suscripción Azure en la que puede crear grupos de recursos e implementar Azure Container Apps recursos.
  • Un entorno de Datadog y una clave de API.
  • CLI de Azure instalada e iniciada sesión.
  • Extensión de la CLI de Azure Container Apps instalada.
az extension add --name containerapp --upgrade

Creación de una clave de API de Datadog

Cree una clave de API de Datadog con permisos que permitan la ingesta de telemetría.

Necesitará los siguientes valores de Datadog para la configuración administrada de OTel para Container Apps:

  • site (valor completo del sitio de Datadog, por ejemplo: datadoghq.com, us3.datadoghq.com, us5.datadoghq.com, datadoghq.eu)
  • key (Clave de API de Datadog)

Para la creación y administración de claves de Datadog, consulte Datadog API y claves de aplicación.

Configuración de destinos de OpenTelemetry

Use una de las siguientes opciones para configurar Datadog como destino de OpenTelemetry en el entorno de Container Apps.

Importante

La configuración de un destino de OpenTelemetry administrado no genera automáticamente telemetría. La aplicación también debe instrumentarse para emitir seguimientos, métricas y registros mediante un SDK de OpenTelemetry.

Establezca variables de la CLI para el comando de implementación:

$RESOURCE_GROUP = "<resource-group-name>"
$DATADOG_SITE = "<datadog-site>" # Example: us3.datadoghq.com, us5.datadoghq.com, datadoghq.eu
$DATADOG_API_KEY = ""
$IMAGE = ""
$ACR_USERNAME = ""
$ACR_PASSWORD = ""

Use un bloque de recursos de entorno administrado como el ejemplo siguiente:

param datadogSite string
@secure()
param datadogApiKey string

var datadogDestinationName = 'dataDog'

resource environment 'Microsoft.App/managedEnvironments@2024-10-02-preview' = {
  name: ''
  location: ''
  properties: {
    openTelemetryConfiguration: {
      destinationsConfiguration: {
        dataDogConfiguration: {
          site: datadogSite
          key: datadogApiKey
        }
      }
      tracesConfiguration: {
        destinations: [
          datadogDestinationName
        ]
      }
      logsConfiguration: {
        destinations: [
          datadogDestinationName
        ]
      }
      metricsConfiguration: {
        destinations: [
          datadogDestinationName
        ]
      }
    }
  }
}

Use un bloque de recursos de aplicación de contenedor como el ejemplo siguiente para establecer las variables de entorno necesarias:

resource app 'Microsoft.App/containerApps@2024-10-02-preview' = {
  name: ''
  location: ''
  properties: {
    managedEnvironmentId: environment.id
    template: {
      containers: [
        {
          name: ''
          image: ''
          env: [
            {
              name: 'OTEL_SERVICE_NAME'
              value: ''
            }
            {
              name: 'OTEL_TRACES_EXPORTER'
              value: 'otlp'
            }
            {
              name: 'OTEL_METRICS_EXPORTER'
              value: 'otlp'
            }
            {
              name: 'OTEL_LOGS_EXPORTER'
              value: 'otlp'
            }
            {
              name: 'OTEL_EXPORTER_OTLP_PROTOCOL'
              value: 'grpc'
            }
          ]
        }
      ]
    }
  }
}

Para las implementaciones en producción, pase los valores de los tokens mediante parámetros seguros de Bicep o Key Vault en lugar de codificar los secretos de forma rígida.

Después de actualizar la plantilla, implemente la configuración de Bicep desde la raíz del repositorio:

az deployment group create `
  --resource-group $RESOURCE_GROUP `
  --template-file infra/main.bicep `
  --parameters @infra/main.parameters.json `
  image=$IMAGE `
  acrUsername=$ACR_USERNAME `
  acrPassword=$ACR_PASSWORD `
  datadogSite="$DATADOG_SITE" `
  datadogApiKey="$DATADOG_API_KEY"

La aplicación de contenedor ahora está configurada para enviar telemetría a Datadog a través del agente administrado de OpenTelemetry.

Comprobación de los datos de OpenTelemetry en Datadog

Después de completar la configuración, la aplicación contenedora comienza a enviar telemetría a Datadog a través del agente de OpenTelemetry administrado. Use Datadog para confirmar que los registros, seguimientos y métricas llegan desde la aplicación y que los datos aparecen en el contexto esperado del servicio y del entorno.

Valide los resultados comprobando herramientas de Datadog, como la exploración de registros, el seguimiento distribuido y la búsqueda de métricas. La consulta exacta o la ruta de navegación varían según los datos que se inspeccionen.

Para obtener más información sobre la exploración de datos en Datadog, consulte Observabilidad y telemetría de Datadog.

  • Last updated on