dd-conf-gen

Datadog Agent チェック設定ファイルを生成する CLI ツールです。

概要

このツールは、クラウドリソース（ElastiCache、RDS など）を検索し、それらのリソース情報を元に Datadog Agent のチェック設定ファイルを生成します。テンプレートベースの柔軟な設定により、様々なリソース種別に対応できます。

インストール

go install github.com/moepig/dd-conf-gen@latest

または、リポジトリをクローンしてビルド:

git clone https://github.com/moepig/dd-conf-gen.git
cd dd-conf-gen
go build -o dd-conf-gen

使い方

基本的な使い方

dd-conf-gen -config gen-config.yaml

生成設定ファイルの構造

生成設定ファイルは YAML 形式で記述します。

トップレベル項目

項目	型	必須	説明
resources	array	○	リソース定義のリスト（最低1つ必要）
outputs	array	○	出力定義のリスト（最低1つ必要）

resources 項目

各リソース定義には以下の項目を指定します:

項目	型	必須	説明
name	string	○	リソースの識別子（outputs から参照される）
type	string	○	リソースプロバイダーの種別（例: elasticache_redis）
region	string	○	AWS リージョン（例: ap-northeast-1）
filters.tags	map	-	タグによるフィルタリング（key-value のペア）

outputs 項目

各出力定義には以下の項目を指定します:

項目	型	必須	説明
template	string	○	テンプレートファイルのパス（相対パスまたは絶対パス）
output_file	string	○	出力先ファイルのパス
data.resource_name	string	○	使用するリソースの識別子（resources の name を参照）

設定例

resources:
  - name: production_redis_nodes
    type: elasticache_redis
    region: ap-northeast-1
    filters:
      tags:
        Environment: Production
        Service: api

outputs:
  - template: templates/redis.yaml.tmpl
    output_file: /etc/datadog-agent/conf.d/redisdb.yaml
    data:
      resource_name: production_redis_nodes

詳細な設定例については、各リソースプロバイダーのドキュメントを参照してください。

テンプレートの基本

Datadog チェック設定テンプレートは Go の text/template 形式で記述します。

テンプレートで利用可能なデータ:

• .Resources: リソースプロバイダーから取得したリソースのスライス
  • .Host: ホスト名またはエンドポイント
  • .Port: ポート番号
  • .Tags: リソースのタグ（map[string]string）
  • .Metadata: リソース種別固有の追加データ（map[string]interface{}）

詳細な使い方は、各リソースプロバイダーのドキュメントを参照してください。

サポートしているリソースプロバイダー

各リソースプロバイダーの詳細（取得できるデータ、設定例、テンプレート例）については、以下のドキュメントを参照してください:

リソース種別	説明	ドキュメント
elasticache_redis	AWS ElastiCache for Redis	providers/elasticache/README.md

開発

テストの実行

# 全てのテストを実行
go test ./... -v

# 短いテストのみ実行（モックを使用したユニットテストのみ）
go test ./... -short -v

# カバレッジを確認
go test ./... -short -cover

新しいリソースプロバイダーの追加

新しいリソースプロバイダーを追加する場合は、CLAUDE.md の「新しいリソースプロバイダーの追加」セクションを参照してください。

基本的な手順:

1. providers/<provider_name>/ ディレクトリを作成
2. providers.Provider インターフェースを実装
3. main.go の init() 関数でプロバイダーを登録
4. ドキュメント（README.md）を作成

実装の詳細は、既存の実装を参考にしてください:

• providers/elasticache/provider.go - 実装例
• providers/elasticache/README.md - ドキュメント例