Azure

Microsoft Entra ID ユーザーには、次の権限が必要です。

アプリ登録を作成する権限

ユーザーは次のいずれかに該当している必要があります。

• Users can register applications が Yesに設定されている
• ユーザーに アプリケーション開発者ロールがある

サブスクリプション内の管理者ロール

監視するサブスクリプション内で、次のいずれかを持っている必要があります。

• Owner ロール
• Contributor ロールと User Access Admin ロールの両方

Graph API 権限を追加および承諾する権限

必要な権限は特権ロール管理者ロールに含まれています。

Datadog

Datadog Admin Role、または azure_configurations_manage 権限を持つ他のいずれかのロール。

次の場合はクイックスタートセットアップ方法を選択

• 初めて Datadog をセットアップする。
• UI ベースのワークフローが希望で、必要な監視権限を持つサービスプリンシパルを作成するのにかかる時間を最小限に抑えたい。
• スクリプトや CI/CD パイプラインでセットアップ手順を自動化したい。

手順

1. Azure インテグレーションタイルで、+ Add New App registration をクリックし、Quickstart を選択します。
2. セットアップスクリプトをコピーし、Azure Cloud Shell で実行します。
3. Datadog UI に戻ります。セットアップスクリプトの右上隅に CONNECTED と表示されているはずです。
4. データを収集するサブスクリプションと管理グループを選択します。
5. 必要に応じて、メトリクス収集トグルをクリックして Azure からのすべてのメトリクス収集を無効にします。Advanced Configuration ドロップダウンを展開して、メトリクスを次の基準でフィルタリングすることもできます。
   • リソースプロバイダー
   • タグ
   • ホスト
   • アプリサービスプラン
   • コンテナアプリ

また、クリックすることで、Azure Application Insights からのカスタムメトリクスの収集を有効にし、使用量メトリクスの収集を無効にすることもできます。

6. 必要に応じて、リソース収集トグルをクリックして Azure リソースからの構成情報の収集を無効にします。

7. ログ収集を有効にして、ログを Datadog に転送するために必要なサービスと診断設定をセットアップおよび構成します。

   1. テナントにログフォワーダーがすでに存在する場合は、そのスコープが変更されて拡張されます。変更された設定は、既存のものに加え、新たに選択されたサブスクリプションや管理グループにも適用されます。
   2. 新しいログフォワーダーを作成する場合は次のようにします。
      1. ログフォワーダーのコントロールプレーンを保存するリソースグループの名前を入力します。
      2. ログ転送オーケストレーション (LFO) のコントロールプレーンサブスクリプションを選択します。
      3. コントロールプレーンのリージョンを選択します。
         注: リソースグループ名、コントロールプレーンサブスクリプション、およびリージョンのフィールドは、新しいログフォワーダーを作成する際にのみ表示されます。
   3. 必要に応じて、Log filtering options を開いてタグでログをフィルタリングするか、正規表現を使用して特定の情報 (PII など) についてのフィルタリングを適用します。

   このアーキテクチャの詳細については、自動ログ転送ガイドのアーキテクチャのセクションを参照してください。

8. Confirm をクリックしてセットアップを完了します。

次の場合は Terraform セットアップ方法を選択

• インフラストラクチャーをコードとして管理し、Datadog Azure インテグレーションをバージョン管理下に置きたい。
• 再利用可能な provider ブロックを使用して、複数のテナントまたはサブスクリプションを一貫して構成する必要がある。
• Terraform 管理環境に応じた繰り返し可能で監査可能なデプロイメントプロセスを確立したい。

手順

次の手順に従って、Terraform で Datadog Azure インテグレーションをデプロイします。

resource "datadog_integration_azure" "sandbox" {
  tenant_name   = "<AZURE_TENANT_NAME>"
  client_id     = "<AZURE_CLIENT_ID>"
  client_secret = "<AZURE_CLIENT_SECRET_KEY>"
}

複数のサブスクリプションまたはテナントの管理

複数のサブスクリプションまたはテナントにまたがって Terraform リソースを管理するために、エイリアスを持つ複数の provider ブロックを使用できます。詳しくは Provider Configuration をお読みください。

インテグレーションステータスの監視

インテグレーションが構成された後、Azure 環境から重要な監視データを収集するために、Datadog で Azure API への連続的な呼び出しが開始されます。これらの呼び出しはエラーを返すことがあります (たとえば、提供された資格情報が期限切れの場合など)。それらのエラーにより、Datadog による監視データの収集が抑制される可能性があります。

重大なエラーが発生すると、Azure インテグレーションは Datadog イベントエクスプローラーにイベントを生成し、5 分ごとに再パブリッシュします。これらのイベントが検出されたときにトリガーし、適切なチームに通知するイベントモニターを構成することができます。

Datadog は、開始するためのモニターテンプレートを提供しています。モニターテンプレートを使用するには、次の手順に従います。

1. Datadog で Monitors に移動し、Browse Templates ボタンをクリックします。
2. [Azure] Integration Errors というタイトルのモニターテンプレートを検索して選択します。
3. 検索クエリやアラート条件に必要な変更を加えます。デフォルトでは、新しいエラーが検出されるたびにモニターがトリガーされ、過去 15 分間エラーが検出されなかったときに解決されます。
4. 通知および再通知メッセージを必要に応じて更新します。イベント自体にイベントに関する関連情報が含まれており、通知に自動的に含まれます。これには、スコープ、エラー応答、および修正のための一般的な手順に関する詳細情報が含まれます。
5. Azure のデータ収集に影響を与える問題についてチームにアラートが届くように、好みのチャンネル (メール、Slack、PagerDuty など) を通じて通知の構成を行います。

次の場合は既存のアプリ登録セットアップ方法を選択

• 提供されたスコープ (サブスクリプションまたは管理グループ) を Datadog で監視するための Monitoring Reader ロールを持つアプリ登録をすでに構成しており、新しいリソースを作成したくない。

Datadog 用のアプリ登録をセットアップする必要がある場合は、クイックスタートまたは Terraform のセットアップ方法を参照してください。

手順

1. Datadog Azure インテグレーションタイルで Add Existing を選択します。
2. Tenant ID フィールドに、ディレクトリ (テナント) ID を貼り付けます。
3. Client ID フィールドに、アプリケーション (クライアント) ID を貼り付けます。
4. Client Secret Value フィールドに、アプリ登録のクライアントシークレットの値を貼り付けます。
5. 必要に応じて、Monitor Automuting トグルをクリックしてモニターの自動ミュートを無効にします。
6. 必要に応じて、メトリクス収集トグルをクリックして Azure からのすべてのメトリクス収集を無効にします。Advanced Configuration ドロップダウンを展開して、メトリクスを次の基準でフィルタリングすることもできます。
   • リソースプロバイダー
   • タグ
   • ホスト
   • アプリサービスプラン
   • コンテナアプリ

また、クリックすることで、Azure Application Insights からのカスタムメトリクスの収集を有効にし、使用量メトリクスの収集を無効にすることもできます。

6. 必要に応じて、リソース収集トグルをクリックして Azure リソースからの構成情報の収集を無効にします。
7. Create Configuration をクリックします。

次の場合は自動ログ転送セットアップ方法を選択

• まだクイックスタートセットアップ方法を通じてログをセットアップしていない。
• UI ベースのワークフローが希望で、必要な監視権限を持つサービスプリンシパルを作成するのにかかる時間を最小限に抑えたい。
• スクリプトや CI/CD パイプラインでセットアップ手順を自動化したい。

手順

[Configure Log Forwarding] (ログ転送の設定) (推奨)

Configure Log Forwarding フローを使用して、Datadog で直接新しいログフォワーダーをセットアップするか既存のログフォワーダーを管理します。

1. Datadog で Integrations > Azure の順に移動します。
2. Configure Log Forwarding をクリックします。
3. 提供されたコマンドをコピーし、Azure Cloud Shell に貼り付けます。
4. ログを転送するサブスクリプションを選択します。
5. 必要に応じて、ログフィルターを追加または削除します。
6. Confirm をクリックします。

詳細については、Azure 自動ログ転送のセットアップを参照してください。

ARM テンプレート

または、Azure Resource Manager (ARM) テンプレートを使用してログ転送をデプロイします。

1. Azure で自動ログ転送 ARM テンプレートを開きます。
2. Basics タブで Azure プロジェクトとインスタンスの詳細を設定します。
3. Datadog Configuration タブで Datadog の資格情報を入力します。
4. Deployment タブでデプロイメントの警告を確認します。
5. Review + create タブでデプロイメントプロセスを開始します。

詳細については、Azure 自動ログ転送のアーキテクチャを参照してください。

.次の場合はコンテナアプリログ転送方法を選択

• ログを転送するリソースで診断設定を手動で構成する。

手順

1. 下記のボタンをクリックし、Azure ポータルのフォームに入力します。ログを Datadog アカウントに転送するために必要な Azure リソースが Datadog によって自動的にデプロイされます。

   

2. テンプレートのデプロイメントが完了したら、デプロイメント中に作成されたストレージアカウントに Azure プラットフォームログ (リソースログを含む) を送信するように各ログソースの診断設定をセットアップします。

注: リソースは同じ Azure リージョン内のストレージアカウントにのみストリーミングできます。