概要
インフラストラクチャーリストには、Datadog によって監視されているすべてのホストが、過去 2 時間 (デフォルト) のアクティビティとともに最大 1 週間分表示されます。ホストを検索したり、タグでグループ化することができます。Datadog で Infrastructure > Hosts に移動してインフラストラクチャーリストを表示します。このリストは、インフラストラクチャーホストの請求額の概算に使用しないでください。請求に関する詳細は、請求ページをご覧ください。
ホスト
ホストのインフラストラクチャーリストに次の情報が表示されます。
- Hostname
- 優先ホスト名エイリアス (オプションメニューを使用してクラウド名またはインスタンス ID を表示します)。
- Cloud Name
- ホスト名エイリアス。
- Instance ID
- ホスト名エイリアス。
- Status
- 予想されるメトリクスが受信されると
ACTIVE
と表示され、メトリクスが受信されないと INACTIVE
と表示されます。 - CPU
- 使用された CPU の割合(アイドル以外のすべて)。
- IOWait
- IO での待機に費やされた CPU の割合(すべてのプラットフォームでレポートされるわけではありません)。
- Load 15
- 過去 15 分間のシステム負荷。
- Apps
- ホストのメトリクスをレポートする Datadog インテグレーション。
- Operating System
- 追跡対象のオペレーティングシステム
- Cloud Platform
- ホストが実行されているクラウドプラットフォーム。(例: AWS、Google Cloud、Azure など)
- Datadog Agent
- ホストでデータを収集する Agent のバージョン。
- OpenTelemetry
- ホスト上でデータを収集している OpenTelemetry Collector のバージョン。
ホスト名
Datadog Agent は、複数のソースから潜在的なホスト名を収集します。詳細については、Datadog が Agent ホスト名を決定する方法を参照してください。
注: ホスト名は、Datadog アカウント内で一意である必要があります。そうでない場合、ホストのグラフに不整合が生じる可能性があります。
検査
ホストをクリックすると、以下の詳細が表示されます。
エイリアス
Datadog は、1 つのホストに一意に識別可能な名前が複数ある場合、ホスト名のエイリアスを作成します。Agent によって収集されたこれらの名前は、選択された正規名のエイリアスとして追加されます。あたとえば、EC2 で実行している単一のホストは、インスタンス ID (i-abcd1234
)、ホストの IP アドレスに基づいて EC2 が提供する汎用ホスト名 (ip-192-0-0-1
)、および内部 DNS サーバーまたは config で管理されるホストファイルが提供するわかりやすいホスト名 (myhost.mydomain
) を持つ可能性があります。
Agent の構成
Agent は、ホスト詳細パネルの Agent Configuration
セクションに表示されるように、Datadog に自身の構成を送信することができます。
Agent 構成は、機密情報が取り除かれ、コンフィギュレーションファイルや環境変数を使って設定した構成のみが含まれます。構成の変更は 10 分ごとに更新されます。
Agent バージョン 7.47.0/6.47.0 以降では、Agent 構成ビューはデフォルトで有効になっています。Agent バージョン 7.39/6.39 以降では、手動で有効にすることができます。
構成ビューを有効または無効にするには
- Agent コンフィギュレーションファイルの
inventories_configuration_enabled
の値を true
に設定すると構成ビューが有効になり、false
に設定すると無効になります。 - または、
DD_INVENTORIES_CONFIGURATION_ENABLED
環境変数を使用して構成ビューを有効または無効にします。
エクスポート
Datadog にレポートしているホストの JSON 形式のリストを取得するには、以下のいずれかを使用してください。
Agent バージョン
Agent のバージョンを監査して、最新バージョンを実行していることを確認することが役立つ場合もあります。そのために、get_host_agent_list script を使用します。このスクリプトは、JSON パーマリンクを利用して、現在実行中の Agent をバージョン番号とともに出力します。また、JSON 出力を CSV ファイルに変換するための json_to_csv
スクリプトも用意されています。
Agent なし
JSON エクスポートのもう 1 つのユースケースは、Agent がインストールされていない Amazon EC2 (RDS を除く) インスタンスのリストを取得することです。これらのインスタンスは、Datadog AWS インテグレーションタイルで AWS アカウントを設定することにより、インフラストラクチャーリストに表示されます。以下の Python3 スクリプトを参照してください。
# 3p
import requests
# stdlib
import json
import pprint
import os
api_key = os.environ['DD_API_KEY']
app_key = os.environ['DD_APP_KEY']
url = "https://app.datadoghq.com/reports/v2/overview?\
window=3h&with_apps=true&with_sources=true&with_aliases=true\
&with_meta=true&with_tags=true&api_key=%s&application_key=%s"
infra = json.loads(requests.get(url %(api_key,app_key)).text)
for host in infra['rows']:
if (('aws' in host['apps']) and ('rds' not in host['apps']) and ('agent' not in host['apps'])):
try:
print(f'HOST: {host["name"]} - TAGS: {host["tags_by_source"]}')
except:
pass
その他の参考資料