Datadog の OCI QuickStart は、わずか数回のクリックで OCI インフラストラクチャーとアプリケーションを監視できる、完全管理型で単一フローのセットアップエクスペリエンスです。OCI QuickStart は、メトリクス、ログ、およびリソースデータを Datadog に転送するために必要なインフラストラクチャーを作成し、データ収集のために新しいリソースや OCI コンパートメントを自動的に検出します。

次の場合は QuickStart セットアップを選択してください…

• OCI インテグレーションを初めてセットアップする。
• UI ベースのワークフローを好み、必要なリソースの作成と構成にかかる時間を最小限に抑えたい。
• スクリプトや CI/CD パイプラインでセットアップ手順を自動化したい。

QuickStart セットアップの前提条件

• これらの手順を完了するには、OCI ユーザーアカウントに Identity Domain Administrator ロールが必要です。
• インテグレーションを行うテナンシーで OCI にログインしている必要があります。
• 画面右上で Home Region が選択された状態で OCI にログインしている必要があります。
• お使いの OCI ユーザーアカウントが、ログインしている ID ドメイン (指定されている場合はターゲットドメイン) 内でユーザー、ユーザーグループ、および動的グループを作成可能でなければなりません。ターゲットドメインの OCID を指定する場合、お使いの OCI ユーザーアカウントはそのドメインにおける管理者権限を持っている必要があります。
• お使いの OCI ユーザーアカウントが、root コンパートメントでポリシーを作成可能でなければなりません。

QuickStart セットアップ手順

Datadog へのメトリクスおよびログ転送用のインフラストラクチャーをセットアップするには、以下の手順に従います。

• Datadog OCI インテグレーションタイルを設定する
• QuickStart ORM スタックをデプロイする
• Datadog でセットアップを完了する
• メトリクスが送信されていることを確認する
• メトリクスまたはログの収集を設定する (オプション)
• リソース収集を設定する (オプション)

このインテグレーションでは、Oracle Service Connector Hubs を使用してデータを Datadog に転送する必要があります。セットアップを完了する前に、サービス制限の引き上げをリクエストすることをお勧めします。必要な Service Connector Hubs のおおよその数は次のとおりです。

$$\text"Service Connector Hubs" = \text"Number of compartments in tenancy" / \text"5"$$

Datadog OCI インテグレーションタイルを設定する

1. Datadog OCI インテグレーションタイルに移動し、[Add New Tenancy] をクリックします。

2. インテグレーションに使用する Datadog API キーを選択するか、作成します。

3. Datadog アプリケーションキーを作成します。

4. トグルを使用して、ログを有効または無効にします。

5. トグルを使用して、イベント収集を有効または無効にします。

6. [Create OCI Stack] をクリックします。これにより、Oracle Resource Manager (ORM) スタックに移動し、デプロイを完了できます。
   注: このスタックは、テナンシーごとに 1 回だけデプロイしてください。

QuickStart ORM スタックをデプロイする

1. Oracle 利用規約に同意します。

2. カスタム Terraform プロバイダーを使用するオプションは未選択のままにします。

3. デフォルトの作業ディレクトリを使用してスタックをデプロイするか、必要に応じて別のディレクトリを選択します。

4. [Next] をクリックします。

5. Datadog では、このテナンシーの各リージョンに仮想クラウドネットワーク (VCN) とサブネットを新規作成するために、(Optional) Choose specific subnet(s) セクションを空白のままにすることを推奨しています。

   オプションで、Datadog QuickStart スタック用に既存のサブネット (OCI リージョンあたり最大 1 つ) を選択できます。その場合は、スタックにサブネット OCID を指定する必要があります。OCID を 1 行に 1 つずつ、カンマなしで入力します。Datadog QuickStart スタックは、各サブネットに対応するリージョンにデプロイされます。各サブネットの OCID は、ocid1.subnet.oc[0-9].* の形式である必要があります。例: ocid1.subnet.oc1.iad.abcedfgh。
   注: 既存の VCN とサブネットを使用する場合、各リージョンの VCN が以下を満たしていることを確認してください。

   • NAT Gateway を経由した HTTP の外向き通信が許可されている。
   • “Oracle Services Network のすべてのサービス” をサポートするサービスゲートウェイを持っている。
   • NAT Gateway と Service Gateway を許可するルートテーブルのルールが設定されている。
   • HTTP リクエストを送信するためのセキュリティルールが設定されている。

6. Datadog では、ユーザーとグループを新規作成するために (Optional) Choose a User セクションを空白のままにすることを推奨しています。グループとユーザーは、現在ログインしている OCI ID ドメインに作成されます (デフォルトドメインである必要はありません)。
   必要に応じて、Datadog QuickStart スタック用に既存のユーザーとグループを選択できます。この場合、Datadog はユーザーとグループのドメインを自動的に推論し、それを使用して動的グループを作成します。
   a.Group ID: Datadog 認証に使用する既存の OCI グループの OCID を指定します。これを指定する場合、[User ID] も指定する必要があります。
   b.User ID: Datadog 認証に使用する既存の OCI ユーザーの OCID を指定します。ユーザーは、指定されたグループのメンバーである必要があります。これを指定する場合、[Group ID] も指定する必要があります。

7. これらのユースケースは一般的ではないため、Datadog では (Optional) Advanced configuration セクションを空白のままにすることを推奨しています。
   必要に応じて、Datadog QuickStart スタック用に既存のコンパートメントとドメインを選択できます。
   a.Compartment: Datadog によって作成されるすべてのリソースを配置する既存のコンパートメントを選択します。
   b.Domain: ユーザーとグループが作成される場所を上書きするために、既存の ID ドメインの OCID を指定します。このフィールドは、手順 6 で既存のユーザーとグループが指定されていない場合にのみ表示されます。これを指定する場合、[User Email] も指定する必要があります。注: OCI ユーザーアカウントには、ターゲットドメインにおける Identity Domain Administrator ロールが必要です。
   c.Resource tags: Datadog QuickStart スタックによってデプロイされるすべての OCI リソースに追加する定義済みタグのリストを指定します。1 行に 1 つのタグを入力します。カンマは追加しないでください。各定義済みタグは、namespace.key:value の形式である必要があります。例: CostCenter.Environment:prod。空白のままにした場合、Datadog QuickStart スタックによってデプロイされた OCI リソースに定義済みタグは追加されません。
   

8. [Next] をクリックします。

9. [Create] をクリックし、デプロイが完了するまで最大 30 分お待ちください。

Datadog でセットアップを完了する

Datadog OCI インテグレーションタイルに戻り、[Ready!] をクリックします。

次の場合は Terraform セットアップを選択してください…

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

Terraform を使用して Datadog OCI インテグレーションをプロビジョニングできます。このガイドでは、前提条件、必須の変数、および初期化、計画、適用の正確な手順を説明します。

Terraform セットアップの前提条件

開始する前に、以下を行ってください。

• Terraform 1.x のインストールを完了する。
• 有効な Datadog API キーを用意する。
• ターゲットドメインにおける Identity Domain Administrator ロールを持つ OCI アクセス権を用意する。

Terraform セットアップ手順

Datadog へのメトリクスおよびログ転送用のインフラストラクチャーをセットアップするには、以下の手順に従います。

• OCI 設定ファイルを作成する
• Terraform モジュールを設定する
• Terraform でデプロイする
• メトリクスが送信されていることを確認する
• メトリクスまたはログの収集を設定する (オプション)
• リソース収集を設定する (オプション)

OCI 設定ファイルを作成する

~/.oci/config ファイルが、Terraform に OCI 内でリソースを作成するための権限を付与します。API キーを作成して、それを設定に追加するか、Oracle のドキュメントに従ってください。ファイルは次のようになります。

[DEFAULT]
user=<USER_OCID>
fingerprint=<USER_FINGERPRINT>
tenancy=<TENANCY_OCID>
region=<HOME_REGION>
key_file=<PATH_TO_PRIVATE_KEY_FILE>

Terraform モジュールを設定する

以下の入力項目は、Datadog OCI インテグレーションモジュールを設定します。必須フィールドは注記されています。利用可能な設定オプションの一覧については、テナンシーの追加のページを参照してください。

1. Datadog API キーを追加します。

[Select API Key] をクリックし、使用する API キーを選択します。

2. Datadog アプリケーションキーを作成します。

[Create] をクリックすると、アプリケーションキーが生成され、フィールドに追加されます。この画面を離れると再度アクセスできなくなるため、必ずこの値をコピーして安全な場所に保存してください。

3. OCI テナンシー OCID を追加します。

1. Datadog で監視するテナンシーの OCID を入力します。これは cloud.oracle.com/tenancy で確認できます。
2. オプションで、特定の OCI コンパートメントとサブネットを選択します。Datadog では、テナンシーの各リージョンに OCI コンパートメントと OCI Virtual Cloud Network (VCN) を新規作成するために、このセクションを空白のままにすることを推奨しています。

4. 自分の OCI ユーザー OCID を追加します。

ユーザー OCID を入力します。このユーザーには、Identity Domain Administrator ロールが必要です。これは、cloud.oracle.com/identity/domains/my-profile で確認できます。

5. ログ収集を設定します (オプション)。

テナンシーからのすべてのログ収集を無効にするには、トグルをクリックしてください。特定の OCI サービスのログ収集を無効にする場合は、セットアップ後に Datadog OCI インテグレーションタイル で設定を編集します。

6. イベント収集を設定します (オプション)。

テナンシーからのすべてのイベント収集を無効にするには、トグルをクリックしてください。セットアップ後にイベント収集を無効にする場合は、Datadog OCI インテグレーションタイル で設定を編集します。

7. 生成された Terraform モジュールの設定の詳細を確認します。

生成された Terraform モジュールは、以下の形式に従う必要があります。

module "datadog_oci" {
  source = "github.com/DataDog/oracle-cloud-integration//datadog-terraform-onboarding"

  datadog_api_key = <API_KEY>
  datadog_app_key = <APP_KEY>
  datadog_site    = <DATADOG_SITE>

  tenancy_ocid      = "<TENANCY_OCID>"
  current_user_ocid = "<CURRENT_USER_OCID>"

  logs_enabled              = true
  events_collection_enabled = true
}

Terraform でデプロイする

1. 生成された Terraform モジュールをコピーし、.tf ファイルに貼り付けます。
2. terraform init && terraform apply を実行して Terraform を初期化し、インテグレーションを作成します。変更をプレビューする場合は、plan を apply に置き換えてください。

トラブルシューティング

Timeouts

設定を変更せずに Terraform コマンドを再実行します。

プロバイダーの競合

terraform init コマンドでプロバイダーの競合が発生した場合は、ローカルのプロバイダーの設定をモジュールで要求されるバージョンに合わせて更新してください。

セットアップ直後の Datadog で警告が発生する

警告が消えるまで最大 15 分ほどお待ちください。

[Compartment Tags] セクションと [Limit Collection to Specific Resources] セクションはいずれも、カンマで区切られたkey:value OCI タグを受け付けます。タグの先頭に ! を付けると、そのタグが否定されます。カンマ区切り文字の動作は、使用するタグの種類によって異なります。

• 正のタグのみ: OR ロジック。OCI オブジェクト (コンパートメントまたは特定のリソース) がリストされたタグのいずれかを持っている場合に含められます。
• 負のタグのみ (先頭に ! を付加): OR ロジック。否定されたタグのいずれかが存在する場合に除外されます。
• 正のタグと負のタグの混合: AND ロジック。リストされたすべての条件を満たす場合に含められます。

例:

• datadog:monitored,env:prod*: いずれかのタグが存在する場合に含めます。
• !env:staging,!testing:true: いずれかのタグが存在する場合に除外します。
• datadog:monitored,!region:us-phoenix-1: datadog:monitoredタグが存在し、かつregion:us-phoenix-1 タグが存在しない場合にのみ含めます。

タグキーの形式: Datadog は、照合前に OCI タグキーを小文字の snake_case に正規化します。OCI で camelCase や PascalCase (例: deploymentType や DeploymentType) を使用して設定されたキーは、小文字の snake_case (deployment_type) に変換されて保存および照合されます。インテグレーションタイルでタグフィルターを指定する場合は、小文字の snake_case を使用してください。

前提条件: アップデートを適用する前に、OCI スタックで設定した Datadog アプリケーションキー がまだ有効であることを確認してください。キーの有効期限が切れているか、取り消されている場合、destroy ジョブは失敗します。キーを更新するには、OCI コンソールでスタック変数 datadog_app_key を編集し、有効なアプリケーションキーを指定してから続行します。

スタックを最新バージョンに更新して変更を適用するには、OCI Cloud Shell から次のコマンドを実行します。

curl -fL -o datadog-integration.zip \
  "https://github.com/DataDog/oracle-cloud-integration/releases/latest/download/datadog-integration.zip"

export STACK_ID="<YOUR_STACK_OCID>"
export OCI_CLI_REGION="<YOUR_HOME_OR_STACK_REGION>"

oci resource-manager stack update \
  --stack-id "$STACK_ID" \
  --config-source datadog-integration.zip \
  --region "$OCI_CLI_REGION" \
  --force

oci resource-manager job create-apply-job \
  --stack-id "$STACK_ID" \
  --execution-plan-strategy AUTO_APPROVED \
  --region "$OCI_CLI_REGION" \
  --wait-for-state SUCCEEDED

以下のようにプレースホルダーの値を置き換えます。

• <YOUR_STACK_OCID>: Datadog ORM スタックの OCID。cloud.oracle.com/resourcemanager/stacks で確認してください。

• <YOUR_HOME_OR_STACK_REGION>: テナンシーの Home Region (例: us-ashburn-1)。

前提条件: Terraform を再適用する前に、Terraform 構成内の datadog_app_key 変数に有効な Datadog アプリケーションキー が保持されていることを確認してください。キーの有効期限が切れているか、取り消されている場合、destroy コマンドは失敗します。.tf ファイル内の値を更新するか、terraform.tfvars ファイルを通じて値を指定してから続行します。

Terraform を再実行して更新されたモジュールを初期化し、最新の変更を適用します。

terraform init -upgrade && terraform apply

必要に応じて、apply の前に terraform plan を実行して変更をプレビューします。

前提条件: destroy ジョブを実行する前に、OCI スタックで構成された Datadog アプリケーションキーがまだ有効であることを確認してください。キーの有効期限が切れているか、取り消されている場合、destroy ジョブは失敗します。キーを更新するには、OCI コンソールでスタック変数を編集し、有効なアプリケーションキーを指定してから続行します。

1. OCI コンソールの Oracle Resource Manager (ORM) に移動します。

2. インストール中に作成された Datadog QuickStart スタックを見つけます。デフォルトでは、スタックには datadog-integration.zip-<NUMBER> というラベルが付けられていますが、デプロイ時にカスタム名でスタックが構成されている可能性があります。

3. スタックで Destroy ジョブを実行し、すべてのリージョンにわたってインテグレーションによって作成されたすべてのリソースを削除します。

1. 必要に応じて、破棄が完了した後に Datadog OCI スタックを削除します。

注: QuickStart スタックで destroy ジョブを 1 回実行すると、インテグレーションがデプロイされたすべてのリージョンのすべてのリソースが自動的にクリーンアップされます。

前提条件: destroy コマンドを実行する前に、datadog_app_keyTerraform の設定でその変数に有効な Datadog アプリケーションキーが保持されていることを確認します。キーの有効期限が切れているか、取り消されている場合、destroy コマンドは失敗します。.tfファイルの値を更新するか、terraform.tfvarsファイルを通じて値を指定してから続行します。

~/.oci/config 内の DEFAULT プロファイルに、対応するテナンシーのリソースを管理するためのユーザー資格情報が含まれていることを確認した上で、以下を実行します。

terraform destroy

- Allow dd-svc-admin to read all-resources in tenancy
- Allow dd-svc-admin to use tag-namespaces in tenancy
- Allow dd-svc-admin to manage serviceconnectors in Datadog compartment
- Allow dd-svc-admin to manage functions-family in Datadog compartment
- Allow dd-svc-admin to use fn-invocation in Datadog compartment
- Allow dd-svc-admin to manage buckets in Datadog compartment where target.bucket.name=/dd-*/
- Allow dd-svc-admin to manage object-family in Datadog compartment where target.bucket.name=/dd-*/
- Endorse dd-svc-admin to read objects in tenancy usage-report
- Allow dd-svc-admin to manage cloudevents-rules in tenancy where any {request.permission = 'EVENTRULE_CREATE', target.resource.tag.DatadogManaged.marker = 'true'}
- Allow dd-svc-admin to manage streams in Datadog compartment where any {request.permission = 'STREAM_CREATE', target.resource.tag.DatadogManaged.marker = 'true'}
- Allow service objectstorage-<REGION> to manage object-family in Datadog compartment where target.bucket.name=/dd-*/

注: Allow service objectstorage-<REGION> ステートメントは、サブスクライブされたリージョンごとに 1 回追加する必要があります (例: objectstorage-us-ashburn-1, objectstorage-ap-batam-1)。これにより、Datadog はオブジェクトライフサイクルポリシーを通じて、Datadog が管理するバケット内の古いデータを自動的にクリーンアップできるようになります。