Azure ログを Datadog に送信

開始するには、以下のボタンをクリックし、Azure Portal のフォームに入力します。Datadog アカウントにアクティビティログをストリーミングするために必要な Azure リソースが、自動的にデプロイされます。

あるいは、Datadog は、Azure アクティビティログと Azure プラットフォームログ (リソースログを含む) の送信に使用できる自動化スクリプトを提供しています。

Azure アクティビティログ

以下の手順に従って、アクティビティログを Datadog アカウントにストリーミングするために必要な Azure リソースを作成および構成するスクリプトを実行します。これらのリソースには、アクティビティログの診断設定、Azure Functions、Event Hub ネームスペース、および Event Hub が含まれます。

1. Azure ポータルで、Cloud Shell に移動します。

2. 以下のコマンドを実行して、自動化スクリプトを Cloud Shell 環境にダウンロードします。

(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")

スクリプトの内容を表示することもできます。

3. 以下のコマンドを実行し、<API_KEY> を Datadog API トークンに、<SUBSCRIPTION_ID> を Azure サブスクリプション ID に置き換えてスクリプトを起動します。Optional Parameters を追加して、デプロイを構成します。

./activity_logs_deploy.ps1 -ApiKey <API_KEY> -SubscriptionId <SUBSCRIPTION_ID> 

Azure プラットフォームログ

Azure プラットフォームのログ (リソースログを含む) を送信するには、Event Hub とログフォワーダー関数のペアをデプロイします。 デプロイ後、ログを Datadog にストリーミングするために、各ログソースの診断設定を作成します。

1. Azure ポータルで、Cloud Shell に移動します。

2. 以下の Powershell コマンドを実行して、自動化スクリプトを Cloud Shell 環境にダウンロードします。

   (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")

   

スクリプトの内容を表示することもできます。

3. 以下の Powershell コマンドを実行し、<API_KEY> を Datadog API トークンに、<SUBSCRIPTION_ID> を Azure サブスクリプション ID に置き換えてスクリプトを起動します。また、その他のオプションのパラメーターを追加して、デプロイを構成することもできます。Optional Parameters を参照してください。

   ./resource_deploy.ps1 -ApiKey <API_KEY> -SubscriptionId <SUBSCRIPTION_ID> 

   

4. Datadog にログを送信するすべての Azure リソースの診断設定を作成します。これらの診断設定を構成して、作成したばかりの Event Hub へストリーミングします。

プラットフォームログパイプライン用にデプロイされたすべての Azure リソースには、デフォルト名に追加された ResourceGroup-Location が含まれています。例: datadog-eventhub-westus。ただし、パラメーターをオーバーライドすれば、この規則を変更できます。

注: リソースは同じ Azure リージョン内の Event Hub にのみストリーミングできるため、リソースログをストリーミングするリージョンごとにステップ 2 を繰り返す必要があります。

アクティビティログとリソースログの設定

アクティビティログとリソースログの両方をストリーミングするには、オプションのパラメーター -ResourceGroupLocation 1 を含む最初のスクリプトを実行します。アクティビティログはサブスクリプションレベルのソースなので、どのリージョンでもパイプラインを作成できます。これがデプロイされたら、westus でリソースに診断設定を追加して、同じイベントハブを通してリソースログを送信します。

注: このインテグレーションは、イベントを収集しません。

オプションパラメーター

注: 以下のパラメーターをカスタマイズするときは、カスタムリソース名が一意であることを確認してください。リソース名が他の Azure リソースのリスト内にまだ存在していないことを確認します。

インストールでエラーが発生した場合は、自動ログ収集でよくあるエラーケースを参照してください。

Azure から Datadog にログを送信するには、以下の手順に従ってください。

1. Azure Event Hub を作成。
2. Datadog-Azure 関数を Event Hub トリガーでセットアップし、Datadog へログを転送します。
3. 診断設定を作成し、Azure サービスが Event Hub へログをストリーミングするように構成する。

以下の手順では、Azure Portal を使用した基本的な初期設定について説明します。手順はすべて、Azure ドキュメントを参照し、CLI、Powershell、リソーステンプレートで実行できます。

Azure Event Hub

Azure Event Hub を作成：

以下の手順に従って、新しいネームスペースを作成するか、既存のネームスペースに新しいイベントハブを追加します。

1. Azure ポータルで、Event Hubs 概要に移動し、Create をクリックします。
2. 名前、価格帯、サブスクリプション、リソースグループを入力します。
3. 場所を選択します。注: Event Hub とログの送信元となるリソースは同じ場所になければなりません。アクティビティログや他のアカウント全体のログソースは、その限りではありません。
4. スループット単位、アベイラビリティーゾーン、および自動インフレに必要なオプションを選択します。
5. 作成をクリックします。

イベントハブをイベントハブネームスペースに追加します。

1. Azure ポータルで、新規または既存のネームスペースに移動します。
2. + Event Hub をクリックします。
3. 名前、パーティション数、およびメッセージ保持に必要なオプションを選択します。
4. 作成をクリックします。

Datadog Azure 関数

Datadog-Azure 関数を Event Hub トリガーでセットアップし、Datadog へログを転送します。

新しい関数アプリを作成するか、既存の関数アプリを使用して、次のセクションにスキップします。

1. Azure ポータルで、Function Apps 概要に移動し、Create をクリックします。
2. サブスクリプション、リソースグループ、地域を選択し、関数アプリの名前を入力します。
3. Publish to Code, Runtime stack to Node.js, and Version to 18 LTS を選択します。
4. オペレーティングシステムとプランタイプを選択します。
5. Next:Hosting をクリックします。
6. ストレージアカウントを選択します。
7. 確認し、新しい関数アプリを作成します。
8. デプロイが完了するのを待ちます。

イベントハブトリガーテンプレートを使用して、関数アプリに新しい関数を追加します。

1. 関数アプリリストから新規/既存の関数アプリを選択します。
2. 関数メニューから Functions を選択し、Create をクリックします。
3. テンプレートメニューから Azure イベントハブトリガーを選択します。
4. Event Hub connection で、ネームスペースとイベントハブを選択します。
5. 作成をクリックします。

イベントハブトリガーを Datadog にポイントします。

1. 関数ビューから新しいイベントハブトリガーを選択します。
2. 開発者側メニューの Code + Test をクリックします。
3. Datadog-Azure 関数コードを index.js ファイルに追加します。
4. 関数アプリのコンフィギュレーションタブで DD_API_KEY 環境変数を作成して API キーを追加するか、22 行目の <DATADOG_API_KEY> を置き換えて関数コードにコピーします。
5. Datadog US1 サイトを使用していない場合は、関数アプリの構成タブにある環境変数 DD_SITE で Datadog サイトを設定するか、23 行目の関数コードにサイトパラメーターをコピーしてください。
6. 関数を保存します。
7. トリガーの Integration をクリックしてから Azure Event Hubs をクリックし、次の設定を確認します。 a. Event Parameter Name が eventHubMessages に設定されている。 b. Event Hub Cardinality が Many に設定されている。 c. Event Hub Data Type が空のままになっている。
8. 保存をクリックします。
9. 関数を実行し、Datadog ログエクスプローラーでテストメッセージをチェックし、設定が正しいことを確認します。 注: テストログイベントは、有効な JSON 形式である必要があります。

アクティビティログ

1. Azure ポータルで、Activity Log に移動します。
2. Diagnostic Settings をクリックします。
3. Add diagnostic setting をクリックします。
4. カテゴリの詳細で、Datadog に送るログのカテゴリを選択します。
5. 送信先情報で、Stream to an event hub を選択します。
6. イベントハブのネームスペースと名前を設定します。これらは、ネームスペーストリガーの作成に使用したネームスペースネームのスペースおよび名前と一致する必要があります。
7. 共有アクセスキーを設定します。このキーは送信アクセスまたは管理アクセスで構成しなければなりません。
8. 保存をクリックします。
9. Datadog ログエクスプローラーでこのリソースからのログをチェックして、正しくセットアップできたことを確認します。

リソースログ

診断設定を作成し、Azure サービスが Event Hub へログを転送するように構成する。

1. Azure ポータルで、Datadog に送るログのリソースへ移動します。
2. リソースブレードの監視セクションで、Diagnostic settings をクリックします。
3. Add diagnostic setting をクリックします。
4. カテゴリの詳細で、Datadog に送るログのカテゴリを選択します。
5. 送信先情報で、Stream to an event hub を選択します。
6. イベントハブのネームスペースと名前を設定します。これらは、ネームスペーストリガーの作成に使用したネームスペースネームのスペースおよび名前と一致する必要があります。
7. 共有アクセスキーを設定します。このキーは送信アクセスまたは管理アクセスで構成しなければなりません。
8. 保存をクリックします。
9. Datadog ログエクスプローラーでこのリソースからのログをチェックして、正しくセットアップできたことを確認します。

Datadog では、Azure ログ収集に Event Hub セットアップを使用することを推奨しています。ただし、以下の手順に従って、Blob ストレージからすべての Azure App Services ログを転送することもできます。

1. Azure ポータル、Azure ストレージエクスプローラー、Azure CLI、または Powershell から Azure BLOB ストレージをセットアップします。
2. Blob ストレージから Datadog へログを転送する Datadog-Azure 関数をセットアップします。
3. ログを Blob ストレージに転送する Azure App Service を構成します。

新しい Azure Blob ストレージ関数を作成する

Azure 関数に馴染みのない方は、Azure 関数入門をご覧ください。

1. Azure ポータルで、Function Apps 概要に移動し、Create をクリックします。
2. サブスクリプション、リソースグループ、地域を選択し、関数アプリの名前を入力します。
3. Publish to Code, Runtime stack to Node.js, and Version to 18 LTS を選択します。
4. オペレーティングシステム Windows とプランタイプを選択します。
5. Next:Hosting をクリックします。
6. ストレージアカウントを選択します。
7. 確認し、新しい関数を Create します。
8. デプロイが完了したら、関数アプリリストから新しい関数を選択します。
9. 関数をポータル内で構築するように選択し、Blog Storage トリガーテンプレートを使用します (More templates… の下)。プロンプトが表示されたら、Microsoft.Azure.WebJobs.Extensions.EventHubs 拡張機能をインストールします。
10. Storage account connection を選択するか追加し、Create を作成します。
11. index.js ファイルを作成し、Datadog-Azure 関数コードを追加します (<DATADOG_API_KEY> はご使用の Datadog API キーに置き換えます)。
12. 関数を保存します。
13. 統合で、BLOB パラメーター名を blobContent に設定し、保存をクリックします。
14. Datadog ログエクスプローラーでログをチェックして、正しくセットアップできたことを確認します。