Samla in och läsa OpenTelemetry-data i Azure Container Apps (förhandsversion)

Med hjälp av en OpenTelemetry-dataagent med din Azure Container Apps-miljö kan du välja att skicka observerbarhetsdata i ett OpenTelemetry-format genom att:

• Skicka data från en agent till en önskad slutpunkt. Målalternativen är Azure Monitor Application Insights, Datadog och alla OTLP-kompatibla slutpunkter (OpenTelemetry Protocol).

• Ändra enkelt målslutpunkter utan att behöva konfigurera om hur de genererar data och utan att behöva köra en OpenTelemetry-agent manuellt.

Den här artikeln visar hur du konfigurerar en OpenTelemetry-agent för din containerapp.

Konfigurera en OpenTelemetry-agent

OpenTelemetry-agenter finns i din containerappmiljö. Du konfigurerar agentinställningar via en ARM-mall eller Bicep-anrop till miljön, eller via CLI eller via Terraform (via AzAPI-providern).

Varje slutpunktstyp (Azure Monitor Application Insights, DataDog och OTLP) har specifika konfigurationskrav.

Förutsättningar

Att aktivera den hanterade OpenTelemetry-agenten i din miljö innebär inte automatiskt att agenten samlar in data. Agenter skickar endast data baserat på dina konfigurationsinställningar och instrumenterar koden korrekt.

Konfigurera källkod

Förbered ditt program för att samla in data genom att installera OpenTelemetry SDK och följa Riktlinjerna för OpenTelemetry för att instrumentera mått, loggar eller spårningar.

Initiera slutpunkter

Innan du kan skicka data till ett insamlingsmål måste du först skapa en instans av måltjänsten. Om du till exempel vill skicka data till Azure Monitor Application Insights måste du skapa en Application Insights-instans i förväg.

Den hanterade OpenTelemetry-agenten accepterar följande mål:

• Azure Monitor Application Insights
• Datadog
• Valfri OTLP-slutpunkt (till exempel New Relic eller Honeycomb)

I följande tabell visas vilken typ av data du kan skicka till varje mål:

Mål	Loggar	Mått	Spårningar
Azure App Insights	Ja	No	Ja
Datadog	Nej	Ja	Ja
OpenTelemetry Protocol (OTLP) konfigurerad slutpunkt	Ja	Ja	Ja

Azure Monitor Application Insights

Den enda konfigurationsinformation som krävs från Application Insights är anslutningssträng. När du har anslutningssträng kan du konfigurera agenten via containerappens ARM-mall med Azure CLI-kommandon eller Terraform.

Anslutningssträng innehåller en instrumentationsnyckel, som är en unik identifierare som används för att associera telemetri till en specifik Application Insights-resurs. Instrumenteringsnycklar är inte säkerhetstoken eller säkerhetsnycklar och betraktas inte som hemligheter.

Om du vill skydda din Application Insights-resurs från missbruk läser du Microsoft Entra-autentisering för Application Insights. Application Insights-resursen måste dock tillåta lokal autentisering för att ta emot data från OpenTelemetry-dataagenten.

ARM-mall

Innan du distribuerar den här mallen <PLACEHOLDERS> ersätter du med dina värden.

JSON

{
  ...
  "properties": {
    "appInsightsConfiguration ": {  
      "connectionString": "<APP_INSIGHTS_CONNECTION_STRING>"
    }
    "openTelemetryConfiguration": {
      ...
      "tracesConfiguration":{
        "destinations": ["appInsights"]
      },
      "logsConfiguration": {
        "destinations": ["appInsights"]
      }
    }
  }
}

Bicep

Bicep

resource environment 'Microsoft.App/managedEnvironments@2024-10-02-preview' = {
  ...
  properties: {
    appInsightsConfiguration: {
      connectionString: '<APP_INSIGHTS_CONNECTION_STRING>'
    }
    openTelemetryConfiguration: {
      ...
      tracesConfiguration: {
        destinations: [
          'appInsights'
        ]
      }
      logsConfiguration: {
        destinations: [
          'appInsights'
        ]
      }
    }
  }
}

Azure CLI

Innan du kör det här kommandot ersätter <PLACEHOLDERS> du med dina värden.

Azure CLI

az containerapp env telemetry app-insights set \
  --resource-group <RESOURCE_GROUP_NAME> \
  --name <ENVIRONMENT_NAME> \
  --connection-string <APP_INSIGHTS_CONNECTION_STRING> \
  --enable-open-telemetry-traces true \
  --enable-open-telemetry-logs true

Anteckning

På grund av anslutningssträngens känslighet kan du inte se detaljvärdena för anslutningssträng när kommandot returneras. Systemet visar det som null.

Terraform

HashiCorp Configuration Language

resource "azapi_update_resource" "app_insights_open_telemetry_integration" {
  name      = azurerm_container_app_environment.managed_environment.name
  parent_id = azurerm_resource_group.resource_group.id
  type      = "Microsoft.App/managedEnvironments@2023-11-02-preview"
  body = jsonencode({
    properties = {
      appInsightsConfiguration = {
        connectionString = azurerm_application_insights.applicationinsights.connection_string
      }
      appLogsConfiguration = {
        destination = "log-analytics"
        logAnalyticsConfiguration = {
          customerId = azurerm_log_analytics_workspace.workspace.workspace_id
          sharedKey  = azurerm_log_analytics_workspace.workspace.primary_shared_key
        }
      }
      openTelemetryConfiguration = {
        tracesConfiguration = {
          destinations = ["appInsights"]
        }
        logsConfiguration = {
          destinations = ["appInsights"]
        }
      }
    }
  })
}

Datadog

Datadog-agentkonfigurationen kräver ett värde för site och key från din Datadog-instans. Samla in dessa värden från din Datadog-instans enligt den här tabellen:

Datadog-agentegenskap	Konfigurationsegenskap för Container Apps
DD_SITE	site
DD_API_KEY	key

När du har den här konfigurationsinformationen kan du konfigurera agenten via containerappens ARM- eller Bicep-mall eller med Azure CLI-kommandon.

Undvik att ange värdet för en hemlighet, till exempel din Datadog API-nyckel, direkt i en produktionsmiljö. Använd i stället en referens till en hemlighet som lagras i Azure Key Vault.

Du måste aktivera nyckelvalvet för malldistribution. Det gör du genom att skapa nyckelvalvet med enabledForTemplateDeployment egenskapen aktiverad eller köra följande Azure CLI-kommando <KEY_VAULT_NAME> och ersätta med ditt värde:

Azure CLI

az keyvault update --name <KEY_VAULT_NAME> --enabled-for-template-deployment true

Mer information finns i:

• Använda Azure Key Vault till att säkert skicka parametervärden under en distribution
• Självstudie: Integrera Azure Key Vault i arm-malldistributionen

ARM-mall

Skapa en parameterfil för att hämta din Datadog API-nyckel från ett Azure Key Vault.

Innan du distribuerar följande filer ersätter <PLACEHOLDERS> du med dina värden.

JSON

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "datadogapikey": {
      "reference": {
        "keyVault": {
          "id": "/subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<RESOURCE_GROUP_NAME>/providers/Microsoft.KeyVault/vaults/<KEY_VAULT_NAME>"
        },
        "secretName": "<KEY_VAULT_SECRET_NAME>"
      }
    }
  }
}

Nu kan du referera till parametern datadogapikey i ARM-mallen.

JSON

{
  ...
  "parameters": {
    "datadogapikey": {
      "type": "securestring"
    }
  },
  "properties": {
    ...
    "openTelemetryConfiguration": {
      ...
      "destinationsConfiguration":{
        ...
        "dataDogConfiguration":{
          "site": "<YOUR_DATADOG_SUBDOMAIN>.datadoghq.com",
          "key": "<YOUR_DATADOG_KEY>"
        }
      },
      "tracesConfiguration":{
        "destinations": ["dataDog"]
      },
      "metricsConfiguration": {
        "destinations": ["dataDog"]
      }
    }
  }
}

Om du vill distribuera resursen kör du följande Azure CLI-kommando och <PLACEHOLDERS> ersätter med dina värden.

Azure CLI

az deployment group create \
  --resource-group <RESOURCE_GROUP> \
  --template-file <ARM_TEMPLATE_FILE> \
  --parameters <PARAMETER_FILE>

Bicep

Skapa en parameterfil för att hämta din Datadog API-nyckel från ett Azure Key Vault.

Innan du distribuerar följande filer ersätter <PLACEHOLDERS> du med dina värden.

Bicep

using '<BICEP_TEMPLATE_FILE>'

param datadogapikey = az.getSecret('<SUBSCRIPTION_ID>', '<RESOURCE_GROUP_NAME>', '<KEY_VAULT_NAME>', '<SECRET_NAME>', '<SECRET_VERSION_ID>')

Prenumerations-ID:t har formuläret 123e4567-e89b-12d3-a456-426614174000. Det hemliga versions-ID:t har formuläret 123e4567e89b12d3a456426614174000.

Nu kan du referera till parametern datadogapikey i Bicep-mallen.

Bicep

@secure()
param datadogapikey string

resource environment 'Microsoft.App/managedEnvironments@2024-10-02-preview' = {
  ...
  properties: {
    openTelemetryConfiguration: {
      destinationsConfiguration: {
        dataDogConfiguration: {
          site: 'datadoghq.com'
          key: datadogapikey
        }
      }
      ...
      metricsConfiguration: {
        destinations: [
          'dataDog'
          'customDashboard'
        ]
      }
    }
  }
}

Om du vill distribuera resursen kör du följande Azure CLI-kommando och <PLACEHOLDERS> ersätter med dina värden.

Azure CLI

az deployment group create \
  --resource-group <RESOURCE_GROUP> \
  --template-file <BICEP_TEMPLATE_FILE> \
  --parameters <PARAMETER_FILE>

Azure CLI

Innan du kör det här kommandot ersätter <PLACEHOLDERS> du med dina värden.

Azure CLI

az containerapp env telemetry data-dog set \
  --resource-group <RESOURCE_GROUP_NAME> \
  --name <ENVIRONMENT_NAME> \
  --site  "<DATADOG_SUBDOMAIN>.datadoghq.com" \
  --key <DATADOG_KEY> \
  --enable-open-telemetry-traces true \
  --enable-open-telemetry-metrics true

Anteckning

På grund av nyckelns känslighet kan du inte se informationsvärdena för nyckeln när kommandot returneras. Systemet visar det som null.

Terraform

HashiCorp Configuration Language

resource "azapi_update_resource" "app_insights_open_telemetry_integration" {
  name      = azurerm_container_app_environment.managed_environment.name
  parent_id = azurerm_resource_group.resource_group.id
  type      = "Microsoft.App/managedEnvironments@2023-11-02-preview"
  body = jsonencode({
    properties = {
      openTelemetryConfiguration = {
        destinationsConfiguration = {
          dataDogConfiguration = {
            site = "<YOUR_DATADOG_SUBDOMAIN>.datadoghq.com"
            key = "<YOUR_DATADOG_KEY>"
          }
        }
        tracesConfiguration = {
          destinations = ["dataDog"]
        }
        metricsConfiguration = {
          destinations = ["dataDog"]
        }
      }
    }
  })
}

OTLP-slutpunkt

En Slutpunkt för OpenTelemetry Protocol (OTLP) är ett telemetridatamål som använder OpenTelemetry-data. I programkonfigurationen kan du lägga till flera OTLP-slutpunkter. I följande exempel läggs två slutpunkter till och följande data skickas till dessa slutpunkter.

Slutpunktnamn	Data som skickas till slutpunkten
oltp1	Mått och/eller spårningar
oltp2	Loggar och/eller spårningar

Du kan konfigurera så många OTLP-konfigurerade slutpunkter som du vill, men varje slutpunkt måste ha ett distinkt namn.

ARM-mall

JSON

{
  "properties": {
    "appInsightsConfiguration": {},
    "openTelemetryConfiguration": {
      "destinationsConfiguration":{
        "otlpConfigurations": [
          {
            "name": "otlp1",
            "endpoint": "ENDPOINT_URL_1",
            "insecure": false,
            "headers": "api-key-1=key"
          },
          {
            "name": "otlp2",
            "endpoint": "ENDPOINT_URL_2",
            "insecure": true
          }
        ]
      },
      "logsConfiguration": { 
        "destinations": ["otlp2"]
      },
      "tracesConfiguration":{
        "destinations": ["otlp1", "otlp2"]
      },
      "metricsConfiguration": {
        "destinations": ["otlp1"]
      }
    }
  }
}

Bicep

Bicep

resource environment 'Microsoft.App/managedEnvironments@2024-10-02-preview' = {
  ...
  properties: {
    openTelemetryConfiguration: {
      destinationsConfiguration: {
        otlpConfigurations: [
          {
            name: 'otlp1'
            endpoint: 'ENDPOINT_URL_1'
            insecure: false
            headers: 'api-key-1=key'
          }
          {
            name: 'otlp2'
            endpoint: 'ENDPOINT_URL_2'
            insecure: true
          },
        ]
      }
      logsConfiguration: {
        destinations: [
          'otlp2'
        ]
      }
      tracesConfiguration: {
        destinations: [
          'otlp1'
          'otlp2'
        ]
      }
      metricsConfiguration: {
        destinations: [
          'otlp1'
        ]
      }
    }
  }
}

Azure CLI

Azure CLI

az containerapp env telemetry otlp add \
  --resource-group <RESOURCE_GROUP_NAME> \
  --name <ENVIRONMENT_NAME> \
  --otlp-name "otlp1" \
  --endpoint "ENDPOINT_URL_1" \
  --insecure false \
  --headers "api-key-1=key" \
  --enable-open-telemetry-traces true \
  --enable-open-telemetry-metrics true
az containerapp env telemetry otlp add \
  --resource-group <RESOURCE_GROUP_NAME> \
  --name <ENVIRONMENT_NAME> \
  --otlp-name "otlp2" \
  --endpoint "ENDPOINT_URL_2" \
  --insecure true \
  --enable-open-telemetry-traces true \
  --enable-open-telemetry-logs true

Anteckning

På grund av rubrikvärdets känslighet kan du inte se detaljvärdena för huvudets värde när kommandot returneras. Systemet visar dem som null.

Terraform

HashiCorp Configuration Language

resource "azapi_update_resource" "app_insights_open_telemetry_integration" {
  name      = azurerm_container_app_environment.managed_environment.name
  parent_id = azurerm_resource_group.resource_group.id
  type      = "Microsoft.App/managedEnvironments@2023-11-02-preview"
  body = jsonencode({
    properties = {
      openTelemetryConfiguration = {
        destinationsConfiguration = {
          otlpConfigurations = [
            {
              name = "otlp1"
              endpoint = "ENDPOINT_URL_1"
              insecure = false
              headers = "api-key-1=key"
            },
            {
              name = "otlp2"
              endpoint = "ENDPOINT_URL_2"
              insecure = true
            }
          ]
        }
        logsConfiguration = { 
          destinations = [
            "otlp2"
          ]
        },
        tracesConfiguration = {
          destinations = [
            "otlp1",
            "otlp2"
          ]
        },
        metricsConfiguration = {
          destinations = [
            "otlp1"
          ]
        }
      }
    }
  })
}

Name	beskrivning
resource-group	Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<NAME>
name	Namnet på Container Apps-miljön.
otlp-name	Ett namn som du väljer för att identifiera din OTLP-konfigurerade slutpunkt.
endpoint	URL:en för målet som tar emot insamlade data.
insecure	Standard sant. Definierar om du vill aktivera klienttransportsäkerhet för exportörens gRPC-anslutning. Om det är falskt krävs parametern headers .
headers	Blankstegsavgränsade värden i formatet "key=value" som ger nödvändig information för OTLP-slutpunkternas säkerhet. Exempel: "api-key=key other-config-value=value".

Konfigurera datamål

Om du vill konfigurera en agent använder du matrisen destinations för att definiera vilka agenter programmet skickar data till. Giltiga nycklar är antingen appInsights, dataDogeller namnet på din anpassade OTLP-slutpunkt. Du kan styra hur en agent beter sig baserat på datatyp och slutpunktsrelaterade alternativ.

Efter datatyp

Alternativ	Exempel
Välj en datatyp.	Du kan konfigurera loggar, mått och/eller spårningar individuellt.
Aktivera eller inaktivera alla datatyper.	Du kan välja att endast skicka spårningar och inga andra data.
Skicka en datatyp till flera slutpunkter.	Du kan skicka loggar till både DataDog och en OTLP-konfigurerad slutpunkt.
Skicka olika datatyper till olika platser.	Du kan skicka spårningar till en OTLP-slutpunkt och mått till DataDog.
Inaktivera sändning av alla datatyper.	Du kan välja att inte skicka några data via OpenTelemetry-agenten.

Efter slutpunkt

• Du kan bara konfigurera en Application Insights- och Datadog-slutpunkt i taget.
• Du kan definiera mer än en OTLP-konfigurerad slutpunkt, men var och en måste ha ett distinkt namn.

Följande ARM-exempelmall visar hur du använder en OTLP-slutpunkt med namnet customDashboard. Den skickar:

• spårningar till appinsikter och customDashboard
• loggar till appinsikter och customDashboard
• mått till DataDog och customDashboard

JSON

{
  ...
  "properties": {
    ...
    "openTelemetryConfiguration": {
      ...
      "tracesConfiguration": {
        "destinations": [
          "appInsights",
          "customDashboard"
        ]
      },
      "logsConfiguration": {
        "destinations": [
          "appInsights",
          "customDashboard"
        ]
      },
      "metricsConfiguration": {
        "destinations": [
          "dataDog",
          "customDashboard"
        ]
      }
    }
  }
}

Exempel på OpenTelemetry-konfiguration

Följande exempelmall visar hur du kan konfigurera containerappen för att samla in telemetridata med hjälp av Azure Monitor Application Insights, Datadog och med en anpassad OTLP-agent med namnet customDashboard.

Det här exemplet fungerar med parameterfilen som används för att hämta Datadog API-nyckeln från ett Azure Key Vault.

Innan du distribuerar den här mallen <PLACEHOLDERS> ersätter du med dina värden.

ARM-mall

JSON

{
  "location": "eastus",
  "properties": {
    "appInsightsConfiguration": {
      "connectionString": "<APP_INSIGHTS_CONNECTION_STRING>"
    },
    "openTelemetryConfiguration": {
      "destinationsConfiguration": {
        "dataDogConfiguration": {
          "site": "datadoghq.com",
          "key": "parameters('datadogapikey')]"
        },
        "otlpConfigurations": [
          {
            "name": "customDashboard",
            "endpoint": "<OTLP_ENDPOINT_URL>",
            "insecure": true
          }
        ]
      },
      "tracesConfiguration": {
        "destinations": [
          "appInsights",
          "customDashboard"
        ]
      },
      "logsConfiguration": {
        "destinations": [
          "appInsights",
          "customDashboard"
        ]
      },
      "metricsConfiguration": {
        "destinations": [
          "dataDog",
          "customDashboard"
        ]
      }
    }
  }
}

Bicep

Bicep

@secure()
param datadogapikey string

resource environment 'Microsoft.App/managedEnvironments@2024-10-02-preview' = {
  name: '<ENVIRONMENT_NAME>'
  location: '<LOCATION>'
  properties: {
    appInsightsConfiguration: {
      connectionString: '<APP_INSIGHTS_CONNECTION_STRING>'
    }
    openTelemetryConfiguration: {
      destinationsConfiguration: {
        dataDogConfiguration: {
          site: 'datadoghq.com'
          key: datadogapikey
        }
        otlpConfigurations: [
          {
            name: 'customDashboard'
            endpoint: '<OTLP_ENDPOINT_URL>'
            insecure: true
          }
        ]
      }
      tracesConfiguration: {
        destinations: [
          'appInsights'
          'customDashboard'
        ]
      }
      logsConfiguration: {
        destinations: [
          'appInsights'
          'customDashboard'
        ]
      }
      metricsConfiguration: {
        destinations: [
          'dataDog'
          'customDashboard'
        ]
      }
    }
  }
}

Mer information finns i Microsoft.App/managedEnvironments.

Miljövariabler

OpenTelemetry-agenten matar automatiskt in en uppsättning miljövariabler i ditt program vid körning.

De två första miljövariablerna följer standardkonfigurationen för OpenTelemetry-exportören och används i OTLP-standardpaket för programvaruutveckling. Om du uttryckligen anger miljövariabeln i containerappspecifikationen skriver ditt värde över det automatiskt inmatade värdet.

Läs mer om konfigurationen av OTLP-exportören i KONFIGURATION av OTLP-exportör.

Name	beskrivning
OTEL_EXPORTER_OTLP_ENDPOINT	En basslutpunkts-URL för valfri signaltyp, med ett valfritt angivet portnummer. Den här inställningen är användbar när du skickar mer än en signal till samma slutpunkt och vill att en miljövariabel ska styra slutpunkten. Exempel: http://otel.service.k8se-apps:4317/
OTEL_EXPORTER_OTLP_PROTOCOL	Anger otlp-transportprotokollet som används för alla telemetridata. Den hanterade agenten stöder grpcendast . Värde: grpc.

De övriga tre miljövariablerna är specifika för Azure Container Apps och matas alltid in. Dessa variabler innehåller agentens slutpunkts-URL:er för varje specifik datatyp (loggar, mått, spårningar).

Dessa variabler är bara nödvändiga om du använder både den hanterade OpenTelemetry-agenten och en annan OpenTelemetry-agent. Med hjälp av dessa variabler får du kontroll över hur du dirigerar data mellan de olika OpenTelemetry-agenterna.

Name	Beskrivning	Exempel
CONTAINERAPP_OTEL_TRACING_GRPC_ENDPOINT	Slutpunkts-URL endast för spårningsdata.	http://otel.service.k8se-apps:43178/v1/traces/
CONTAINERAPP_OTEL_LOGGING_GRPC_ENDPOINT	Slutpunkts-URL endast för loggdata.	http://otel.service.k8se-apps:43178/v1/logs/
CONTAINERAPP_OTEL_METRIC_GRPC_ENDPOINT	Slutpunkts-URL endast för måttdata.	http://otel.service.k8se-apps:43178/v1/metrics/

Kostnader för OpenTelemetry-agenten

Du debiteras för den underliggande beräkningen av agenten.

Se måltjänsten för deras faktureringsstruktur och villkor. Om du till exempel skickar data till både Azure Monitor Application Insights och Datadog ansvarar du för de avgifter som tillämpas av båda tjänsterna.

Kända begränsningar

• OpenTelemetry-agenter finns i förhandsversion.
• Systemdata, till exempel systemloggar eller standardmått för Container Apps, är inte tillgängliga för att skickas till OpenTelemetry-agenten.
• Application Insights-slutpunkten accepterar inte mått.
• Datadog-slutpunkten accepterar inte loggar.

Nästa steg

Lär dig mer om övervakning och hälsa