Skip to content

ホストエージェント設定ファイル(configuration.yaml) ガイド

Instana Agentのconfiguration.yamlファイルの全184設定項目を初心者向けに網羅的に解説するドキュメント集です。

IBM Bobを使った初版のドキュメントのため、一部誤った説明やリンクが含まれる場合があります。 指摘箇所はGitHubのIssueにて以下情報とあわせてご連絡ください。

1
2
Title : Instana configuration.yamlの修正依頼
Description : 指摘ページのURLと指摘内容を記載ください。

📁 リポジトリ構成

1
2
3
4
5
6
7
instana-guide/
├── README.md                   # このファイル（概要と目次）
└── configutations/                       # 詳細ドキュメント（27ファイル）
    ├── secrets.md              # シークレット管理
    ├── process.md              # プロセス管理
    ├── host.md                 # ホスト監視
    └── ...                     # その他24ファイル

🚀 クイックスタート

初めての方へ

  1. 目次 から必要なセンサーのドキュメントを選択
  2. 基本情報 を読んで、configuration.yamlの基本を理解
  3. 設定例をコピー して、自分の環境に合わせて調整
  4. トラブルシューティング が必要な場合は各ドキュメントの該当セクションを参照

📋 目次

基本設定

  1. シークレット管理 - パスワード、APIキー、Vault統合
  2. プロセス管理 - プロセス監視、ブラックリスト
  3. ホスト監視 - CPU、メモリ、ディスク監視
  4. ファイル監視 - ログファイル、設定ファイル監視
  5. ハードウェア・ゾーン設定 - 物理環境、ゾーン設定

クラウド・コンテナ

  1. クラウドサービス監視 - AWS、Azure、GCP
  2. コンテナ・オーケストレーション - Docker、Kubernetes
  3. 仮想化・ハイパーバイザー - VMware、Hyper-V

ミドルウェア

  1. データベースセンサー - MySQL、PostgreSQL、MongoDB等
  2. メッセージングシステム - Kafka、RabbitMQ、ActiveMQ
  3. アプリケーションサーバー - Tomcat、JBoss、Nginx
  4. キャッシュ・ストレージシステム - Redis、Memcached

エンタープライズ

  1. IBM製品監視 - WebSphere、MQ、Db2
  2. ビッグデータ・分析 - Elasticsearch、Hadoop、Spark

監視・統合

  1. トレーシング設定 - 分散トレーシング、OpenTelemetry
  2. Synthetic監視 - 合成監視、可用性チェック
  3. EUM（End User Monitoring） - エンドユーザー体験監視
  4. メトリクス収集・統合 - Prometheus、StatsD
  5. 監視ツール統合 - 他の監視ツールとの連携

高度な設定

  1. ネットワーク・プロキシ - HAProxy、ロードバランサー
  2. アクション設定 - 自動アクション、通知
  3. その他の特殊センサー - カスタムセンサー

リファレンス

  1. クイックリファレンス - よく使う設定の早見表
  2. ベストプラクティス - 推奨設定パターン
  3. トラブルシューティング - よくある問題と解決方法
  4. FAQ - よくある質問
  5. 参考リンク - 公式ドキュメント、関連リソース

基本情報

configuration.yamlとは

Instana Agentの動作を制御する設定ファイルです。センサーの有効化、認証情報、収集頻度などを定義します。

ファイルの場所: 

1
/opt/instana/agent/etc/instana/configuration.yaml

ファイルの基本構造

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
# コメント行は '#' で始まります
# 設定を有効にするには、行頭の '#' を削除してください

# グローバル設定
com.instana.secrets:
  matcher: 'contains-ignore-case'
  list:
    - 'password'

# センサー設定
com.instana.plugin.mysql:
  user: 'monitoring_user'
  password: 'secure_password'
  enabled: true

重要なポイント

✅ インデント: スペース2つでインデント（タブは使用不可）
✅ コメント: # で始まる行はコメント
✅ 有効化: 設定を有効にするには行頭の # を削除
✅ ホットリロード: ほとんどの設定は保存後自動的に反映
✅ 複数ファイル: configuration-*.yaml で設定を分割可能

設定ファイルの分割

大規模な環境では、設定を複数のファイルに分割することを推奨します：

1
2
3
4
5
/opt/instana/agent/etc/instana/
├── configuration.yaml           # メイン設定
├── configuration-database.yaml  # データベース設定
├── configuration-cloud.yaml     # クラウド設定
└── configuration-custom.yaml    # カスタム設定

設定の優先順位

  1. 環境変数（最優先）
  2. configuration.yaml
  3. デフォルト値

セキュリティのベストプラクティス

⚠️ 機密情報の管理

  • ❌ パスワードやAPIキーを直接記述しない
  • ✅ HashiCorp Vaultなどのシークレット管理ツールを使用
  • ✅ 環境変数を活用
  • ✅ .gitignoreに機密情報を含むファイルを追加

詳細は シークレット管理 を参照してください。

📚 情報ソース

このドキュメントは信頼できる情報源を基に作成されています：

  • IBM公式ドキュメント - 最優先の情報源
  • Instana Agent GitHub - 実際の設定例とコミュニティの知見
  • 公式PDF資料 - オフライン参照用の包括的なドキュメント

🔗 関連リンク

公式リソース