Azure Container Apps で OpenTelemetry データを収集して読み取る

Azure Container Apps 環境で OpenTelemetry データエージェントを使用すると、次の方法によって監視データを OpenTelemetry 形式で送信できます。

エージェントから目的のエンドポイントへのデータのパイプ処理。宛先オプションには、Azure Monitor Application Insights、Datadog、OpenTelemetry Protocol (OTLP) と互換性のあるエンドポイントが含まれます。
データの出力方法を再構成する必要がなく、宛先エンドポイントを簡単に変更できます。OpenTelemetry エージェントを手動で実行する必要はありません。

この記事では、コンテナーアプリの OpenTelemetry エージェントを設定および構成する方法について説明します。

OpenTelemetry エージェントを構成する

OpenTelemetry エージェントは、コンテナーアプリ環境内に常駐していますエージェント設定は、ARM テンプレート、環境への Bicep 呼び出し、CLI、または Terraform (AzAPI プロバイダーを使用) を使用して構成します。

各エンドポイントの種類 (Azure Monitor Application Insights、DataDog、OTLP) には、特定の構成要件があります。

前提条件

環境に対してマネージド OpenTelemetry エージェントを有効にしても、エージェントがデータを収集することを自動的に意味するわけではありません。エージェントは、構成設定とコードの正しいインストルメント化に基づいてのみデータを送信します。

ソースコードを構成する

OpenTelemetry SDK をインストールしてデータを収集するアプリケーションを準備し、OpenTelemetry ガイドラインに従って、メトリック、ログ、またはトレースをインストルメント化します。

エンドポイントを初期化する

コレクションの宛先にデータを送信する前に、まず宛先サービスのインスタンスを作成する必要があります。たとえば、Azure Monitor Application Insights にデータを送信する場合は、事前に Application Insights インスタンスを作成する必要があります。

マネージド OpenTelemetry エージェントは、次の宛先を受け入れます。

Azure Monitor アプリケーションインサイト
Datadog
任意の OTLP エンドポイント (例: New Relic または Honeycomb のどちらか)

注

Microsoft では、Azure Monitor Application Insights に送信されるデータのサポートを提供しています。データが Microsoft 以外のシステムに格納されると、データ関連のサポートはエンドポイントの組織の責任となります。

次の表に、各宛先に送信できるデータの種類を示します。

到着地	ログ	メトリック	トレース
Azure App Insights	はい	いいえ	はい
Datadog	はい	はい	はい
OpenTelemetry プロトコル (OTLP) で構成されたエンドポイント	はい	はい	はい

Azure Monitor アプリケーションインサイト

Application Insights に必要な構成の詳細は、接続文字列のみです。接続文字列を取得したら、コンテナーアプリの ARM テンプレート、Azure CLI コマンド、または Terraform を使用してエージェントを構成できます。

接続文字列にはインストルメンテーションキーが含まれています。これは、テレメトリを特定の Application Insights リソースに関連付けるために使用される一意識別子です。インストルメンテーションキーはセキュリティトークンやセキュリティキーではなく、シークレットと見なされません。

Application Insights リソースを不正使用から保護する場合は、「Application Insights 用 Microsoft Entra 認証」を参照してください。ただし、OpenTelemetry データエージェントからデータを受信するには、Application Insights リソースでローカル認証を許可する必要があります。

このテンプレートをデプロイする前に、<PLACEHOLDERS> を実際の値に置き換えてください。

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

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

このコマンドを実行する前に、<PLACEHOLDERS> を実際の値に置き換えてください。

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

注

接続文字列の機密性のため、コマンドが戻るときに接続文字列の詳細値を確認できません。システムはそれを null として表示します。

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

環境に対してマネージド OpenTelemetry エージェントを有効にした場合、コンテナーアプリで Datadog エージェントを実行する必要はありません。

OpenTelemetry エージェントの構成には、Datadog インスタンスからの site と key の値が必要です。次の表に従って、Datadog インスタンスからこれらの値を収集します。

Datadog インスタンスプロパティ	OpenTelemetry エージェント構成プロパティ
`DD_SITE`	`site`
`DD_API_KEY`	`key`

Azure portal で Datadog インスタンスを作成した場合、詳細については API キーを参照してください。

これらの構成の詳細を取得したら、コンテナーアプリの ARM または Bicep テンプレート、または Azure CLI コマンドを使用してエージェントを構成できます。

運用環境では、Datadog API キーなどのシークレットの値を直接指定しないでください。代わりに、Azure Key Vault に格納されているシークレットへの参照を使用します。

テンプレートのデプロイに対してキーコンテナーを有効にする必要があります。テンプレートのデプロイを有効にするには、 enabledForTemplateDeployment プロパティを有効にしてキーコンテナーを作成するか、次の Azure CLI コマンドを実行して、 <KEY_VAULT_NAME> を実際の値に置き換えます。

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

詳細については、次を参照してください。

Azure Key Vault から Datadog API を取得するためのパラメーターファイルを作成します。

次のファイルをデプロイする前に、<PLACEHOLDERS> を実際の値に置き換えてください。

{
  "$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>"
      }
    }
  }
}

これで、ARM テンプレートで datadogapikey パラメーターを参照できるようになりました。

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

リソースをデプロイするには、<PLACEHOLDERS> を実際の値に置き換えて次の Azure CLI コマンドを実行します。

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

Azure Key Vault から Datadog API を取得するためのパラメーターファイルを作成します。

次のファイルをデプロイする前に、<PLACEHOLDERS> を実際の値に置き換えてください。

using '<BICEP_TEMPLATE_FILE>'

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

サブスクリプション ID の形式は aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e です。シークレットバージョン ID の形式は 123e4567e89b12d3a456426614174000 です。

これで、Bicep ファイル内の datadogapikey パラメーターを参照できるようになりました。

@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'
        ]
      }
    }
  }
}

リソースをデプロイするには、<PLACEHOLDERS> を実際の値に置き換えて次の Azure CLI コマンドを実行します。

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

このコマンドを実行する前に、<PLACEHOLDERS> を実際の値に置き換えてください。

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

注

キーの機密性のため、コマンドが戻ったときにキーの詳細値を確認することはできません。システムはそれを null として表示します。

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 エンドポイント

OpenTelemetry プロトコル (OTLP) エンドポイントは、OpenTelemetry データを使用するテレメトリデータの宛先です。アプリケーション構成では、複数の OTLP エンドポイントを追加できます。次の例では、2 つのエンドポイントを追加し、これらのエンドポイントに次のデータを送信します。

エンドポイント名	エンドポイントに送信されるデータ
`oltp1`	メトリックやトレース
`oltp2`	ログやトレース

OTLP 構成のエンドポイントはいくつでも設定できますが、各エンドポイントには個別の名前が必要です。

{
  "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"]
      }
    }
  }
}

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'
        ]
      }
    }
  }
}

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

注

ヘッダー値が機密であるため、コマンドが返されたときにヘッダーの詳細な値は表示されません。システムでは、null として表示されます。

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"
          ]
        }
      }
    }
  })
}

名前	説明
`resource-group`	リソースグループの名前。 `az configure --defaults group=<NAME>` を使用して、既定のグループを構成できます。
`name`	コンテナーアプリ環境の名前。
`otlp-name`	OTLP 構成のエンドポイントを識別するために選択する名前。
`endpoint`	収集されたデータを受信する宛先の URL。
`insecure`	既定値は true です。エクスポーターの gRPC 接続に対してクライアントトランスポートセキュリティを有効にするかどうかを定義します。 false の場合は、`headers` パラメーターが必要です。
`headers`	'キー=値' 形式のスペース区切りの値。これは、OTLP エンドポイントのセキュリティに必要な情報を提供します。例: `"api-key=key other-config-value=value"`.

データ変換先を構成する

エージェントを構成するには、destinations 配列を使用して、アプリケーションがデータを送信するエージェントを定義します。有効なキーは、appInsights、dataDog、またはカスタム OTLP エンドポイントの名前です。エージェントの動作は、データ型とエンドポイント関連のオプションに基づいて制御できます。

データ型に基づく場合

オプション	例
データ型を選択します。	ログ、メトリック、トレースを個別に構成できます。
任意のデータ型を有効または無効にします。	トレースのみを送信し、他のデータは送信しない場合に選択できます。
1 つのデータ型を複数のエンドポイントに送信します。	DataDog と OTLP で構成されたエンドポイントの両方にログを送信できます。
異なるデータ型をさまざまな場所に送信します。	トレースを OTLP エンドポイントに送信し、メトリックを DataDog に送信できます。
すべてのデータ型の送信を無効にします。	OpenTelemetry エージェントを介してデータを送信しないことを選択できます。

エンドポイントに基づく場合

一度に設定できる Application Insights エンドポイントと Datadog エンドポイントは 1 つだけです。
複数の OTLP 構成エンドポイントを定義できますが、それぞれに個別の名前が必要です。

次の ARM テンプレートの例は、customDashboard という名前の OTLP エンドポイントを使用する方法を示しています。次を送信します。

アプリの分析情報と customDashboard にトレース
アプリの分析情報と customDashboard にログ
DataDog と customDashboard にメトリック

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

システムコンポーネント OpenTelemetry シグナルをエクスポートする

OpenTelemetry API バージョン 2024-08-02-previewから、システムコンポーネント OpenTelemetry シグナルをデータの宛先にエクスポートするようにコンテナーアプリ環境を構成できます。

Dapr トレースと KEDA メトリックをエクスポートするには、次の構成を使用します。

Dapr のトレース

次の ARM テンプレートの例は、Dapr トレースをトレースの宛先にエクスポートする方法を示しています。

{
  ...
  "properties": {
    ...
    "openTelemetryConfiguration": {
      ...
      "tracesConfiguration": {
        "destinations": [
          "appInsights",
          "customDashboard"
        ]，
        "includeDapr": true
      }
    }
  }
}

コンテナーアプリで Dapr を使用する方法の詳細については、「 Dapr の概要」を参照してください。

KEDA メトリック

次の ARM テンプレート例は、KEDA メトリックをメトリックの宛先にエクスポートする方法を示しています。

{
  ...
  "properties": {
    ...
    "openTelemetryConfiguration": {
      ...
      "metricsConfiguration": {
        "destinations": [
          "dataDog",
          "customDashboard"
        ]，
        "includeKeda": true
      }
    }
  }
}

Container Apps での KEDA サポートの詳細については、「スケーリングルールの設定」を参照してください。

OpenTelemetry の構成の例

次のテンプレート例は、Azure Monitor Application Insights、Datadog、customDashboard という名前のカスタム OTLP エージェントを使用して利用統計情報を収集するようにコンテナーアプリを構成する方法を示しています。

この例では、Azure Key Vault から Datadog API キーを取得するために使用されるパラメーターファイルを使用します。

このテンプレートをデプロイする前に、<PLACEHOLDERS> を実際の値に置き換えてください。

ARM テンプレート
二頭筋

{
  "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"
        ]
      }
    }
  }
}

@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'
        ]
      }
    }
  }
}

詳細については、Microsoft.App/managedEnvironments に関するページを参照してください。

データの回復性

エンドポイントへのメッセージングの中断が発生した場合、OpenTelemetry エージェントは次の手順を使用してデータの回復性をサポートします。

メモリ内バッファリングと再試行: エージェントはデータをメモリに保持し、最大 5 分間 (バックオフを使用して) 再試行を続けます。
データの削除: バッファー内のキューがいっぱいになった場合、または再試行後もエンドポイントがダウンしている場合、エージェントはメモリ不足を回避するために最も古いバッチを破棄します。

環境変数

OpenTelemetry エージェントでは、実行時に一連の環境変数をアプリケーションに自動的に挿入します。

最初の 2 つの環境変数は、標準の OpenTelemetry エクスポーター構成に従い、OTLP 標準ソフトウェア開発キットで使用されます。コンテナーアプリの仕様で環境変数を明示的に設定すると、自動的に挿入された値が設定した値によって上書きされます。

OTLP エクスポーターの構成については、「OTLP エクスポーターの構成」を参照してください。

名前	説明
`OTEL_EXPORTER_OTLP_ENDPOINT`	任意の型のシグナルのベースエンドポイント URL。必要に応じて指定されたポート番号を使用します。この設定は、同じエンドポイントに複数のシグナルを送信し、1 つの環境変数でエンドポイントを制御する場合に役立ちます。例: `http://otel.service.k8se-apps:4317/`
`OTEL_EXPORTER_OTLP_PROTOCOL`	すべてのテレメトリデータに使用される OTLP トランスポートプロトコルを指定します。マネージドエージェントは、`grpc` のみをサポートします。値: `grpc`。

他の 3 つの環境変数は Azure Container Apps に固有であり、常に挿入されます。これらの変数は、特定のデータ型 (ログ、メトリック、トレース) ごとにエージェントのエンドポイント URL を保持します。

これらの変数は、マネージド OpenTelemetry エージェントと別の OpenTelemetry エージェントの両方を使用している場合にのみ必要です。これらの変数を使用すると、異なる OpenTelemetry エージェント間でデータをルーティングする方法を制御できます。

名前	説明	例
`CONTAINERAPP_OTEL_TRACING_GRPC_ENDPOINT`	トレースデータのみのエンドポイント URL。	`http://otel.service.k8se-apps:43178/v1/traces/`
`CONTAINERAPP_OTEL_LOGGING_GRPC_ENDPOINT`	ログデータのみのエンドポイント URL。	`http://otel.service.k8se-apps:43178/v1/logs/`
`CONTAINERAPP_OTEL_METRIC_GRPC_ENDPOINT`	メトリックデータのみのエンドポイント URL。	`http://otel.service.k8se-apps:43178/v1/metrics/`

OpenTelemetry エージェントのコスト

マネージド OpenTelemetry エージェントは、追加のコンピューティングコストなしで実行されます。 Microsoft は、Container Apps 環境内でエージェントインフラストラクチャをプロビジョニングおよび管理します。

ただし、テレメトリデータを送信する宛先サービスによって適用される料金は、お客様の責任となります。課金構造と条件については、対象のサービスを参照してください。たとえば、Azure Monitor Application Insights と Datadog の両方にデータを送信する場合は、両方のサービスによって適用される料金を負担します。

エージェントリソースの割り当て

マネージド OpenTelemetry エージェントは、次の固定リソースでプロビジョニングされます。

CPU: 0.5 vCPU コア
メモリ: 1.5 GB RAM
レプリカ: 単一レプリカ (構成できません)

これらのリソースは Microsoft によって管理され、課金またはリソース消費のメトリックには表示されません。

既知の制限事項

システムログや Container Apps 標準メトリックなどのシステムデータは、OpenTelemetry エージェントに送信できません。
Application Insights エンドポイントはメトリックを受け入れません。
構成設定は、環境レベルで実行されます。異なるデータ型を異なる宛先に送信できますが、アプリごとにデータを分割することはできません。たとえば、同じアプリでメトリックを Datadog に送信し、トレースを App Insights に送信できます。
マネージドエージェントは、テレメトリデータの gRPC トランスポートプロトコルのみをサポートします。
マネージド OpenTelemetry エージェントは 1 つのレプリカとして実行され、高可用性のためにスケーリングまたは構成することはできません。
エージェントの状態と正常性のメトリックは、Azure portal や監視 API では現在公開されていません。
シークレット (API キーなど) は、テンプレートで直接指定する必要があります。エージェント構成に対する Azure Key Vault 統合は現在サポートされていません。

よく寄せられる質問

コードで OpenTelemetry SDK を参照する必要がありますか?

はい。 SDK はテレメトリデータを作成し、マネージドエージェントはデータのルーティングのみを担当します。
list コマンドが null を返す理由

az containerapp env telemetry otlp listを実行すると、値が保護を必要とする機密性の高いトークンである場合、応答はnullされます。
OpenTelemetry エージェントのコンピューティングリソースに対して課金されますか?

No. Microsoft は、追加のコンピューティングコストなしでエージェントインフラストラクチャをプロビジョニングおよび管理します。テレメトリデータを受信する宛先サービスに対してのみ課金されます。
OpenTelemetry エージェントをスケーリングするか、複数のレプリカを実行できますか?

No. マネージドエージェントは現在、固定リソース割り当て (0.5 CPU、1.5 GB RAM) を持つ単一のレプリカとして実行されます。高可用性構成は現在サポートされていません。
OpenTelemetry エージェントの正常性と状態を監視するにはどうすればよいですか?

エージェントの状態と正常性のメトリックは現在公開されていません。この機能は、将来のリリースで予定されています。

次のステップ

監視と正常性についての説明

フィードバック

このページはお役に立ちましたか?

Last updated on 2025-12-10