Terraform

Supported OS Linux Windows Mac OS

概要

Datadog Terraform プロバイダーは Terraform コンフィギュレーションを介して Datadog API とのやり取りを可能にします。このコンフィギュレーションによって、ダッシュボード、モニター、ログコンフィギュレーションといった Datadog のリソースを管理することができます。

セットアップ

インストール

Datadog Terraform プロバイダーは Terraform レジストリを介して利用することができます。

構成

Terraform をインストールします。
Terraform のコンフィギュレーションファイルを含むディレクトリを作成します。例: terraform_config/
terraform_config/ ディレクトリに、以下の内容の main.tf ファイルを作成します。
```
terraform {
  required_providers {
    datadog = {
      source = "DataDog/datadog"
    }
  }
}

# Configure the Datadog provider
provider "datadog" {
  api_key = var.datadog_api_key
  app_key = var.datadog_app_key
}
```
注: Datadog US1 サイトを使用していない場合は、api_url オプションパラメーターを Datadog サイトに設定する必要があります。ページの右側にあるドキュメントサイトセレクタが正しい Datadog サイトに設定されていることを確認してから、api_url パラメーターの値として以下の URL を使用してください。
```
https://api./
```
terraform init を実行します。これにより、Terraform での利用のためにディレクトリが初期化され、Datadog プロバイダーがプルされます。
terraform_config/ ディレクトリ内に任意の .tf ファイルを作成し、Datadog リソースの作成を開始します。

モニターの作成

この例では、ライブプロセスモニターを作成する monitor.tf ファイルを示します。

```
# monitor.tf
resource "datadog_monitor" "process_alert_example" {
  name    = "Process Alert Monitor"
  type    = "process alert"
  message = "Multiple Java processes running on example-tag"
  query   = "processes('java').over('example-tag').rollup('count').last('10m') > 1"
  monitor_thresholds {
    critical          = 1.0
    critical_recovery = 0.0
  }

  notify_no_data    = false
  renotify_interval = 60
}
```

terraform apply を実行して Datadog アカウントにこのモニターを作成します。

Datadog にイベントを送信する

datadogpy をインストールすることで、Dogwrap コマンドラインツールにアクセスできるようになります。このツールを使って、任意の Terraform コマンドをラップして、カスタムイベントにバインドすることができます。

datadogpy をインストールします:

pip install datadog

詳しくは、Datadog Python ライブラリをご覧ください。

terraform apply イベントを送信します:

dogwrap -n "terraform apply" -k $DD_API_KEY --submit_mode all --tags="source:terraform" "terraform apply -no-color"

terraform destroy イベントを送信します:

dogwrap -n "terraform destroy" -k $DD_API_KEY --submit_mode all --tags="source:terraform" "terraform destroy -no-color"

収集データ

メトリクス

Terraform には、メトリクスは含まれません。

サービスチェック

Terraform には、サービスのチェック機能は含まれません。

イベント

Terraform には、イベントは含まれません。

トラブルシューティング

ご不明な点は、Datadog のサポートチームまでお問い合わせください。