インフラストラクチャーリスト

概要

インフラストラクチャーリストには、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 のバージョン。

ホスト名

Datadog Agent は、複数のソースから潜在的なホスト名を収集します。詳細については、Datadog が Agent ホスト名を決定する方法を参照してください。

注: ホスト名は、Datadog アカウント内で一意である必要があります。そうでない場合、ホストのグラフに不整合が生じる可能性があります。

検査

ホストをクリックすると、以下の詳細が表示されます。

エイリアス

Datadog は、1 つのホストに一意に識別可能な名前が複数ある場合、ホスト名のエイリアスを作成します。Agent によって収集されたこれらの名前は、選択された正規名のエイリアスとして追加されます。あたとえば、EC2 で実行している単一のホストは、インスタンス ID (i-abcd1234)、ホストの IP アドレスに基づいて EC2 が提供する汎用ホスト名 (ip-192-0-0-1)、および内部 DNS サーバーまたは config で管理されるホストファイルが提供するわかりやすいホスト名 (myhost.mydomain) を持つ可能性があります。

Agent の構成

Join the Beta!

Agent 構成ビューは公開ベータ版で、Agent バージョン 7.39/6.39 以降で利用可能です。 Agent バージョン 7.47/6.47 以降、この機能はデフォルトで有効になっています。

Agent は、ホスト詳細パネルの Agent Configuration セクションに表示されるように、Datadog に自身の構成を送信することができます。

Agent 構成は、機密情報が取り除かれ、コンフィギュレーションファイルや環境変数を使って設定した構成のみが含まれます。構成の変更は 10 分ごとに更新されます。

この機能は、Agent バージョン 7.47.0/6.47.0 以降でデフォルトで有効になっています。

この動作を変更するには、Agent コンフィギュレーションファイルの inventories_configuration_enabled の値を true に設定すると構成が送信され、false に設定すると無効になります。

あるいは、DD_INVENTORIES_CONFIGURATION_ENABLED 環境変数を使って、この機能を有効または無効にすることができます。

エクスポート

Datadog にレポートしているホストの JSON 形式のリストについては、次のいずれかを使用します。

インフラストラクチャーリストの上部にある JSON API パーマリンク。
検索ホスト API エンドポイント - 例については、開発者ガイドを参照してください。

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