Datadog の監視（パブリック プレビュー）
Instana を使用すると、IT インフラストラクチャを監視する「 Datadog 」プラットフォームを監視することができます。
Instana ホストエージェントをインストールすると、 Instana の Datadog センサーが自動的にインストールされます。 「 Datadog 」センサーの設定手順に従って設定を完了すると、 Instana のUIで、 Datadog によって監視されているホストおよび関連するメトリクスを確認できるようになります。
補足情報
サポート対象のオペレーティング・システム
Datadog センサーの対応OSは、各ホストエージェントの要件と一致しています。これについては、各ホストエージェントの「対応OS」セクションで確認できます。例えば、 「 Unix の対応OS 」などです。
Datadog センサーの設定
接続先の Datadog インスタンスのエンドポイントと API キーを使用して、 Datadog センサーを設定する必要があります。 以下のコード・スニペットは、エージェント構成ファイル <agent_install_dir>/etc/instana/configuration.yamlで構成する必要があるフィールドを示しています。
com.instana.plugin.datadog:
enabled: true
endpoint: 'https://api.datadoghq.com'
api_key: 'redacted'
application_key: 'redacted'
poll_rate: 30
以下の表に、サポートされる構成オプションを示します。
| 名前 | タイプ | 必須 | Default | 説明 |
|---|---|---|---|---|
enabled |
ブール値 | はい | false |
センサーが使用可能かどうかを制御する変数。 |
endpoint |
ストリング | はい | NA | Datadog サーバーのエンドポイント： API。 |
api_key |
ストリング | はい | NA | Datadog サーバーへの接続に使用される API キー。 |
application_key |
ストリング | はい | NA | Datadog サーバーへの接続に使用されるアプリケーションキー。 |
poll_rate |
整数 | いいえ | 30時間まで | メトリック照会の間隔 (秒数)。 この時間は、エンドポイントによって課されるレート制限を考慮した調整が必要になる場合があります。 |
target_zone |
ストリング | いいえ | NA | 「 Instana 」のインフラストラクチャマップ上で、 Datadog によって監視されているホストが表示されるジェネリックゾーンの名前。 指定しない場合、ホストは Undefined Zoneに表示されます。 |
Datadog エンドポイント
Instana Datadog センサーは、 Datadog API を使用して、 Datadog が監視しているホストに関する情報を収集します。 Datadog と通信するには、 Datadog API のエンドポイントが必要です。 通常、エンドポイントは https://api.datadoghq.comですが、何らかの理由で別のアドレスに接続する必要がある場合は、 configuration.yaml ファイルで変更できます。
Datadog API キー
Datadog API での認証には、2つの API キーが必要です。 API キーおよびアプリケーションキーの作成方法の詳細については、 『 Datadog 』のドキュメントを参照してください。
アプリケーション・キーを作成するときには、以下のスコープが含まれていることを確認してください。
events_readmetrics_readtimeseries_query
メトリックの表示
メトリックを表示するには、以下のステップを実行します。
- Instana のUIにあるナビゲーションメニューから、 「インフラストラクチャ」 を選択します。
- 特定のモニター対象ホストをクリックします。
これで、収集されたすべてのメトリックを含むリモート・ホスト・ダッシュボードを表示できます。
構成データ
- OS (名前、バージョン、アーキテクチャー、および配布)
- CPU (カウントおよびタイプ)
- メモリーの合計
- ホスト名および FQDN
- ファイルシステム容量
パフォーマンス・メトリック
- CPU 使用率 (%)
- CPU 負荷
- メモリー使用率
- 使用スワップ (Linux のみ)
- ファイル・システム使用量および i ノード使用量
- ネットワーク RX および TX バイト
イベントの表示
Datadog イベントは単発のイベントであり、継続時間はありません。 各イベントには、エラー、警告、または情報の重大度があります。 これらのイベントは、その重大度に応じて、 Instana に「Issue」（エラーおよび警告）または「Changes」（情報）として取り込まれます。
イベントを表示するには、以下のステップを実行します。
- Instana のUIにあるナビゲーションメニューから、 「イベント」 を選択します。
- 特定のタイプのイベントをフィルタリングするには、 「変更」 または 「問題」を選択します。
- Datadog からインポートされたイベントをフィルタリングするには、検索ボックスに次のクエリを入力してください：
entity.remote.host.source:Datadog
すると、 Datadog からインポートされたイベントの一覧が表示されます。
トラブルシューティング
エージェントの監視に関する問題
Datadog センサーが Datadog の API サーバーと通信できない場合、エージェントの監視に関する問題が発生します。 この問題は、どの構成パラメーターが正しくない可能性があるかを示しています。 たとえば、センサーが Datadog サーバーから HTTP 401 または 403 エラーを受信した場合、 API キーまたはアプリケーション キーが正しくないか、有効期限が切れている可能性があります。 以下の構成パラメーターが原因で、エージェント・モニターの問題が発生する可能性があります。
endpointapi_keyまたはapplication_key（ HTTP 401 または 403）poll_rate( HTTP 429)
エージェント OutOfMemoryError
多数のホストを監視している Datadog サーバーに接続している場合、 Instana エージェントの JVM ヒープサイズを増やす必要がある場合があります。 エージェントのログに OutOfMemoryError が見つかった場合は、 Instana エージェントの最大ヒープサイズを増やすことを検討してください。 詳細については、「 環境変数リファレンス 」の 環境変数 JAVA_OPTS を参照してください。