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 から 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. Kafka、ゾーン冗長性、スループット、自動インフレのオプションを設定します。
5. 作成をクリックします。

Datadog-Azure 関数

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

1. Azure ポータルで、Function Apps -> Functions と移動し、Add をクリックします。
2. サブスクリプション、リソースグループ、地域を選択し、関数の名前を入力します。
3. Publish Code and Runtime stack Node.js を選択します。
4. Next:Hosting をクリックします。
5. ストレージアカウントとプランの種類を選択し、Operating System Windows を選択します。
6. 確認し、新しい関数を作成します。
7. デプロイが完了したら、関数アプリリストから新しい関数を選択します。
8. 関数をポータル内で作成し、More templates… にある Event Hub triggerテンプレートを使用することを選択します。必要に応じて、Microsoft.Azure.WebJobs.Extensions.EventHubs 拡張をインストールします。
9. Event Hub 接続、コンシューマーグループ、ログ取得元の名前を選択するか追加し、Create をクリックします。
10. index.js ファイルを作成し、Datadog-Azure 関数コードを追加します。
11. 環境変数 DD_API_KEY を作成し、Datadog API キーを値として加えます。
12. 関数を保存します。
13. Integrate で、次の設定を確認します。
    a. Event Parameter Name は eventHubMessages と設定されます。
    b. Event Hub Cardinality は Many と設定されます。
    c. Event Hub Data Type は Default (Json) と設定されます。
    注: このオプションが標準エディタで利用できない場合は、高度なエディタを使い dataType に関する設定を手動ですべて削除します。この変更は標準エディタには反映されないかもしれませんが、問題ではありません。
14. 保存をクリックします。
15. 関数を実行し、Datadog ログエクスプローラーでテストメッセージをチェックし、設定が正しいことを確認します。

診断設定

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

1. Azure ポータルで、Datadog に送るログのリソースへ移動します。
2. リソースブレードの監視セクションで、Diagnostic settings をクリックします。
3. Add diagnostic setting をクリックします。
4. カテゴリの詳細で、Datadog に送るログのカテゴリを選択します。
5. 送信先情報で、Stream to an event hub を選択します。
6. Event Hub ネームスペースと名前を設定します。これらは Event Hub ネームスペースと前のセクションの手順 9 で定義されたバインディングにある名前と一致しなければなりません。
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 ログエクスプローラーでログをチェックして、正しくセットアップできたことを確認します。