Microsoft Azure

最初に、Datadog と統合する Azure アカウントにログインします。

az login

account show コマンドを実行します。

az account show

生成されたテナント ID 値を Datadog Azure インテグレーションタイルの Tenant name/ID に入力します。

次の形式を使用して、サービスプリンシパルとなるアプリケーションを作成します。

az ad sp create-for-rbac --role "Monitoring Reader" --scopes /subscriptions/{subscription_id}

• このコマンドは、監視するサブスクリプションに対する monitoring reader ロールをサービスプリンシパルに付与します。
• このコマンドによって生成されたappIDを Datadog Azure インテグレーションタイルの Client ID に入力する必要があります。
• 自分で選択した名前を使用する場合は、--name <CUSTOM_NAME> を追加します。それ以外の場合は、Azure によって一意の名前が生成されます。この名前は、セットアッププロセスでは使用されません。
• 自分で選択したパスワードを使用する場合は、--password <CUSTOM_PASSWORD> を追加します。それ以外の場合は、Azure によって一意のパスワードが生成されます。このパスワードは、Datadog Azure インテグレーションタイルの Client Secret に入力する必要があります。

最初に、Datadog と統合する Azure アカウントにログインします。

azure login

account show コマンドを実行します。

az account show

生成されたテナント ID 値を Datadog Azure インテグレーションタイルの Tenant name/ID に入力します。

名前とパスワードを作成します。

azure ad sp create -n <NAME> -p <PASSWORD>

• <NAME> は使用されませんが、セットアッププロセスの一環として必要です。
• 選択した <PASSWORD> は、Datadog Azure インテグレーションタイルの Client Secret に入力する必要があります。
• このコマンドから返されるオブジェクト ID を、次のコマンドの <OBJECT_ID> の代わりに使用します。

次の形式を使用して、サービスプリンシパルとなるアプリケーションを作成します。

azure role assignment create --objectId <オブジェクト_ID> -o "Monitoring Reader" -c /subscriptions/<サブスクリプション_ID>/

• このコマンドは、監視するサブスクリプションに対する monitoring reader ロールをサービスプリンシパルに付与します。
• このコマンドによって生成されたサービスプリンシパル名を Datadog Azure インテグレーションタイルの Client ID に入力する必要があります。
• <SUBSCRIPTION_ID> は監視対象の Azure サブスクリプションです。これは、azure account show コマンドを使用すると、またはポータルに ID として一覧表示されます。

最初に、Datadog と統合する Azure アカウントにログインします。

azure login

account show コマンドを実行します。

az account show

生成されたテナント ID 値を Datadog Azure インテグレーションタイルの Tenant name/ID に入力します。

名前、ホームページ、識別子 URI、パスワードを作成します。

azure ad app create --name "<NAME>" --home-page "<URL>" --identifier-uris "<URL>" --password "<PASSWORD>"

• name、home-page、identifier-uris は使用されませんが、セットアッププロセスの一環として必要です。
• 選択した password は、Datadog Azure インテグレーションタイルの Client Secret に入力する必要があります。
• このコマンドから返される AppId は、次のコマンドで使用します。また、Datadog Azure インテグレーションタイルの Client ID に入力する必要があります。

以下を使用して、サービスプリンシパルを作成します。

Azure cli < 0.10.2 の場合

azure ad sp create {app-id}

Azure cli >= 0.10.2 の場合

azure ad sp create -a {app-id}

• このコマンドから返されるオブジェクト ID を、次のコマンドの <OBJECT_ID> の代わりに使用します。

次の形式を使用して、Active Directory アプリケーションを作成します。

azure role assignment create --objectId <オブジェクト_ID> --roleName "Monitoring Reader" --subscription <サブスクリプション_ID>

• このコマンドは、監視するサブスクリプションに対する monitoring reader ロールをサービスプリンシパルに付与します。
• <SUBSCRIPTION_ID> は監視対象の Azure サブスクリプションです。これは、azure account show コマンドを使用すると、またはポータルに ID として一覧表示されます。

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

または、Datadog が提供する、使用できる自動スクリプトが 2 つあります。

最初のスクリプトは、アクティビティログを Datadog アカウントにストリーミングするために必要な Azure リソースを作成、構成します。これらのリソースには、アクティビティログの診断設定、Azure Functions、Event Hub ネームスペース、Event Hub が含まれます。

2 番目のスクリプトは、診断設定なしで、Event Hub と Azure Function の部分のみをデプロイするより一般的なオプションです。これは、ストリーミングソースを構成するために使用できます。いずれの場合も、Event Hub は他のストリーミングソースで使用できます。

例:

‘westus’ からアクティビティログとリソースログの両方をストリーミングする場合は、オプションのパラメーター ‘-ResourceGroupLocation westus’ を含む最初のスクリプトを実行します (アクティビティログはサブスクリプションレベルのソースであるため、任意のリージョンでパイプラインを作成できます)。これがデプロイされると、‘westus’ のリソースに診断設定を追加することで、同じ Event Hub を介してリソースログを送信できます。

注:

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

Azure から Datadog へのアクティビティログの送信

ステップ 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 に置き換えます。他のオプションのパラメーターを追加して、デプロイを構成することもできます。オプションのパラメーターを参照してください。

./activity_logs_deploy.ps1 -ApiKey <api_key> -SubscriptionId <subscription_id> 

Azure プラットフォームログを Datadog に送信

Azure プラットフォームログ (リソースログを含む) を送信するための一般的なソリューションの場合、Event Hub とログフォワーダーのみをデプロイすることもできます。 このパイプラインをデプロイした後、各ログソースの診断設定を作成し、Datadog にストリーミングするように構成できます。

ステップ 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/resource_deploy.ps1", "resource_deploy.ps1")

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

ステップ 3: 以下のコマンドを実行してスクリプトを呼び出します。<api_key> を Datadog API トークンに置き換え、<subscription_id> を Azure サブスクリプション ID に置き換えます。他のオプションのパラメーターを追加して、デプロイを構成することもできます。オプションのパラメーターを参照してください。

./resource_deploy.ps1 -ApiKey <api_key> -SubscriptionId <subscription_id> 

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

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

注: プラットフォームログパイプライン用にデプロイされたすべての Azure リソースには、デフォルト名に追加された Resource-Group-Location が含まれています。例: ‘datadog-eventhub-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 概要に移動し、Add をクリックします。
2. 名前、価格帯、サブスクリプション、リソースグループを入力します。
3. 場所を選択します。注: Event Hub とログの送信元となるリソースは同じ場所になければなりません。アクティビティログや他のアカウント全体のログソースは、その限りではありません。
4. スループット単位、アベイラビリティーゾーン、および自動インフレに必要なオプションを選択します。
5. 作成をクリックします。

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

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

Datadog Azure 関数

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

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

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

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

1. 関数アプリリストから新規/既存の関数アプリを選択します。
2. 関数メニューから Functions を選択し、Add をクリックします。
3. テンプレートメニューから Azure イベントハブトリガーを選択し、New をクリックします。
4. イベントハブ接続用のネームスペースとイベントハブを選択し、OK をクリックします。
5. Create Function をクリックします。

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

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

アクティビティログ

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 ログエクスプローラーでこのリソースからのログをチェックして、正しくセットアップできたことを確認します。

すべての Azure App Service からログを収集するには、主に以下の手順に従います。

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

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

Azure 関数に精通していない場合は、Azure Portal で初めての関数を作成するを参照してください。

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

ベーシック

既存の Datadog オーガニゼーションへのリンクを選択すると、Datadog リソースを作成するためのフォームがポータルに表示されます。

次の値を指定します。

Link to Datadog organization をクリックして Datadog の認証ウィンドウを開き、Datadog にサインインします。

デフォルトで Azure は現在の Datadog オーガニゼーションを Datadog リソースにリンクします。別のオーガニゼーションをリンクする場合は、認証ウィンドウで該当するオーガニゼーションを選択します。

oauth フローが完了したら、Datadog オーガニゼーション名が正しいことを確認します。

基本のコンフィギュレーションが完了したら、Next: Metrics and logs を選択します。

ベーシック

新しい Datadog オーガニゼーションの作成を選択すると、Datadog リソースおよび 新しい Datadog オーガニゼーションの両方を作成するためのフォームがポータルに表示されます。

次の値を指定します。

SSO

新しい Datadog オーガニゼーションを作成してSSO を構成した場合、Datadog リソースブレードを使用してログインします。これは、Azure の Datadog リソースから Datadog オーガニゼーションに直接ログインする SAML リンクです。

SSO なし

新しい Datadog オーガニゼーションを作成してSSO を構成しなかった場合、概要ブレードの Datadog オーガニゼーションリンクを使用して Datadog のパスワードを設定します。Datadog のパスワードを設定すると、このリンクが標準の Datadog URL になります。

既存の Datadog オーガニゼーションにリンクした場合は、これまでと同様の方法で Datadog オーガニゼーションにアクセスします。