- 重要な情報
- はじめに
- 用語集
- ガイド
- エージェント
- インテグレーション
- OpenTelemetry
- 開発者
- API
- CoScreen
- アプリ内
- Service Management
- インフラストラクチャー
- アプリケーションパフォーマンス
- 継続的インテグレーション
- ログ管理
- セキュリティ
- UX モニタリング
- 管理
このガイドを使用して、Azure サブスクリプションから Datadog へのロギングを設定します。
Datadog では、Azure から Datadog へログを送信するには、Agent または DaemonSet を使うことを推奨しています。一部のリソースではできない場合があります。その場合、Azure Event Hub を使いログ転送パイプラインを作成し、Azure プラットフォームログを収集することができます。Azure プラットフォームログを Event Hub にストリーミングできないリソースには、Blob Storage 転送オプションを使用できます。
全サイト: すべての Datadog サイトは、このページの手順を使用して、Azure ログを Datadog に送信することができます。
US3: 組織が Datadog US3 サイト上にある場合、Azure Native インテグレーションを使用して、Azure ログ転送の構成を簡素化することができます。Datadog では、可能な限りこの方法を使用することを推奨しています。構成は、Azure の Datadog リソースを通じて行います。これは、ログ転送のための Azure Event Hub プロセスを置き換えます。詳細は Azure Native ロギングガイドを参照してください。
開始するには、以下のボタンをクリックし、Azure Portal のフォームに入力します。Datadog アカウントにアクティビティログをストリーミングするために必要な Azure リソースが、自動的にデプロイされます。
あるいは、Datadog は、Azure アクティビティログと Azure プラットフォームログ (リソースログを含む) の送信に使用できる自動化スクリプトを提供しています。
以下の手順に従って、アクティビティログを Datadog アカウントにストリーミングするために必要な Azure リソースを作成および構成するスクリプトを実行します。これらのリソースには、アクティビティログの診断設定、Azure Functions、Event Hub ネームスペース、および Event Hub が含まれます。
アクティビティログステップ 1
(New-Object System.Net.WebClient).DownloadFile("https://raw.githubusercontent.com/DataDog/datadog-serverless-functions/master/azure/eventhub_log_forwarder/activity_logs_deploy.ps1", "activity_logs_deploy.ps1")
スクリプトの内容を表示することもできます。
<API_KEY>
を Datadog API トークンに、<SUBSCRIPTION_ID>
を Azure サブスクリプション ID に置き換えてスクリプトを起動します。Optional Parameters を追加して、デプロイを構成します。アクティビティログステップ 2
./activity_logs_deploy.ps1 -ApiKey <API_KEY> -SubscriptionId <SUBSCRIPTION_ID>
Azure プラットフォームのログ (リソースログを含む) を送信するには、Event Hub とログフォワーダー関数のペアをデプロイします。 デプロイ後、ログを Datadog にストリーミングするために、各ログソースの診断設定を作成します。
Azure ポータルで、Cloud Shell に移動します。
以下の Powershell コマンドを実行して、自動化スクリプトを Cloud Shell 環境にダウンロードします。
プラットフォームログステップ 1
(New-Object System.Net.WebClient).DownloadFile("https://raw.githubusercontent.com/DataDog/datadog-serverless-functions/master/azure/eventhub_log_forwarder/resource_deploy.ps1", "resource_deploy.ps1")
スクリプトの内容を表示することもできます。
<API_KEY>
を Datadog API トークンに、<SUBSCRIPTION_ID>
を Azure サブスクリプション ID に置き換えてスクリプトを起動します。また、その他のオプションのパラメーターを追加して、デプロイを構成することもできます。Optional Parameters を参照してください。プラットフォームログステップ 2
./resource_deploy.ps1 -ApiKey <API_KEY> -SubscriptionId <SUBSCRIPTION_ID>
プラットフォームログパイプライン用にデプロイされたすべての Azure リソースには、デフォルト名に追加された ResourceGroup-Location が含まれています。例: datadog-eventhub-westus
。ただし、パラメーターをオーバーライドすれば、この規則を変更できます。
注: リソースは同じ Azure リージョン内の Event Hub にのみストリーミングできるため、リソースログをストリーミングするリージョンごとにステップ 2 を繰り返す必要があります。
アクティビティログとリソースログの両方をストリーミングするには、オプションのパラメーター -ResourceGroupLocation 1
を含む最初のスクリプトを実行します。アクティビティログはサブスクリプションレベルのソースなので、どのリージョンでもパイプラインを作成できます。これがデプロイされたら、westus
でリソースに診断設定を追加して、同じイベントハブを通してリソースログを送信します。
注: このインテグレーションは、イベントを収集しません。
注: 以下のパラメーターをカスタマイズするときは、カスタムリソース名が一意であることを確認してください。リソース名が他の Azure リソースのリスト内にまだ存在していないことを確認します。
-Flag <Default Parameter> | 説明 |
---|---|
-DatadogSite <datadoghq.com> | このフラグを別の Datadog サイトを使用してパラメーターとして追加して、Datadog インスタンスをカスタマイズします。Datadog サイト:
|
-Environment <AzureCloud> | このフラグをパラメーターとして追加して、Azure 独立クラウドのストレージを管理します。追加のオプションは、AzureChinaCloud 、AzureGermanCloud 、AzureUSGovernment です。 |
-ResourceGroupLocation <westus2> | 更新された Azure-region を使用してこのフラグを追加することにより、Azure リソースグループとリソースがデプロイされるリージョンを選択できます。 |
-ResourceGroupName <datadog-log-forwarder-rg> | 更新されたパラメーターを使用してこのフラグを追加することにより、Azure リソースグループの名前をカスタマイズします。 |
-EventhubNamespace <datadog-ns-4c6c53b4-1abd-4798-987a-c8e671a5c25e> | 更新済みのパラメーターでこのフラグを追加し、Azure Event Hub の名前空間をカスタマイズします。デフォルトで、datadog-ns-<globally-unique-ID> が生成されています。 |
-EventhubName <datadog-eventhub> | 更新されたパラメーターを使用してこのフラグを追加することにより、Azure Event Hub の名前をカスタマイズします。 |
-FunctionAppName <datadog-functionapp-1435ad2f-7c1f-470c-a4df-bc7289d8b249> | 更新済みのパラメーターでこのフラグを追加し、Azure 関数の名前をカスタマイズします。デフォルトで、datadog-functionapp-<globally-unique-ID> が生成されています。 |
-FunctionName <datadog-function> | 更新されたパラメーターを使用してこのフラグを追加することにより、Azure Function の名前をカスタマイズします。 |
-DiagnosticSettingName <datadog-activity-logs-diagnostic-setting> | 更新されたパラメーターを使用してこのフラグを追加することにより、Azure 診断設定の名前をカスタマイズします。(アクティビティログの送信にのみ関連) |
インストールでエラーが発生した場合は、自動ログ収集でよくあるエラーケースを参照してください。
Azure から Datadog にログを送信するには、以下の手順に従ってください。
以下の手順では、Azure Portal を使用した基本的な初期設定について説明します。手順はすべて、Azure ドキュメントを参照し、CLI、Powershell、リソーステンプレートで実行できます。
Azure Event Hub を作成:
以下の手順に従って、新しいネームスペースを作成するか、既存のネームスペースに新しいイベントハブを追加します。
イベントハブをイベントハブネームスペースに追加します。
Datadog-Azure 関数を Event Hub トリガーでセットアップし、Datadog へログを転送します。
新しい関数アプリを作成するか、既存の関数アプリを使用して、次のセクションにスキップします。
イベントハブトリガーテンプレートを使用して、関数アプリに新しい関数を追加します。
イベントハブトリガーを Datadog にポイントします。
DD_API_KEY
環境変数を作成して API キーを追加するか、22 行目の <DATADOG_API_KEY>
を置き換えて関数コードにコピーします。DD_SITE
で Datadog サイトを設定するか、23 行目の関数コードにサイトパラメーターをコピーしてください。eventHubMessages
に設定されている。
b. Event Hub Cardinality が Many
に設定されている。
c. Event Hub Data Type が空のままになっている。診断設定を作成し、Azure サービスが Event Hub へログを転送するように構成する。
Datadog では、Azure ログ収集に Event Hub セットアップを使用することを推奨しています。ただし、以下の手順に従って、Blob ストレージからすべての Azure App Services ログを転送することもできます。
Azure 関数に馴染みのない方は、Azure 関数入門をご覧ください。
Microsoft.Azure.WebJobs.Extensions.EventHubs
拡張機能をインストールします。index.js
ファイルを作成し、Datadog-Azure 関数コードを追加します (<DATADOG_API_KEY>
はご使用の Datadog API キーに置き換えます)。blobContent
に設定し、保存をクリックします。Azure Native インテグレーションを使用している場合でも、Azure Blob Storage にログをアーカイブするには、App Registration が必要です。Azure Blob Storage にログをアーカイブするには、設定手順に従って、App Registration を使用してインテグレーションを構成します。アーカイブ目的で作成された App Registration には、Monitoring Reader
ロールを割り当てる必要はありません。
App Registration を構成したら、Azure Blob Storage に書き込むログアーカイブを作成することができます。
注: ストレージバケットが Azure Native インテグレーションで監視されているサブスクリプションにある場合、Azure Integration Tile に App Registration が冗長である旨の警告が表示されます。この警告は無視することができます。
お役に立つドキュメント、リンクや記事: