- 重要な情報
- はじめに
- 用語集
- ガイド
- エージェント
- インテグレーション
- OpenTelemetry
- 開発者
- API
- CoScreen
- アプリ内
- Service Management
- インフラストラクチャー
- アプリケーションパフォーマンス
- 継続的インテグレーション
- ログ管理
- セキュリティ
- UX モニタリング
- 管理
Datadog Agent は、多くの異なるソースからホスト名の候補を収集します。Agent の status サブコマンドを実行すると、Agent が検出しているすべての名前を確認することができます。
...
Hostnames
=========
hostname: my.special.hostname
agent-hostname: my.special.hostname
ec2-hostname: ip-192-0-0-1.internal
instance-id: i-deadbeef
socket-hostname: myhost
socket-fqdn: myhost.mydomain
...
これらの名前から、ホストの標準的な名前が選択されます。Agent は、この名前を使用して Datadog に自分自身を識別します。他の名前も同様に送信されますが、エイリアシングの候補としてのみ使用されます。
ホストの正規名は、以下の規則に従って最初に一致した名前が選択されます。
hostname -f
): DNS ホスト名が EC2 のデフォルトでない場合。例: ip-192-0-0-1
名前が一般的な一意でない名前と認められる場合 (例: localhost.localdomain
)、その規則は失敗となり、次の規則に進みます。
Datadog API から AWS ホストの情報を引き出すと、アベイラビリティに応じて以下のような属性が表示されます。
属性 | 説明 |
---|---|
aws_id | インスタンス ID。インスタンス ID がない場合はホストにフォールバックする |
aws_name | クラウドの providername タグ |
display_name | 正規のホスト名 (ホスト識別子の値) |
EC2 で稼働する1台のホストは、インスタンス ID (i-abcd1234)、ホストの IP アドレスに基づいて EC2 が提供する一般的なホスト名 (ip-192-0-0-1)、内部 DNS サーバーまたは設定管理されたホストファイルによって提供される意味のあるホスト名 (myhost.mydomain) を持っているかもしれません。Datadog は、1 つのホストに対して一意に識別可能な複数の名前がある場合、ホスト名のエイリアスを作成します。
Agent によって収集された名前 (上記の詳細) は、選択された正規名のエイリアスとして追加されます。
インフラストラクチャーリストから、アカウントにあるすべてのホストのリストを見ることができます。各ホストに関連するエイリアスは、ホストの行にカーソルを置いた状態で Inspect ボタンをクリックすることでアクセスできる検査パネルで確認できます。
注: これらのエイリアスは、検索やフィルターには使用できません。これらのエイリアスは、上記の検査パネルでのみ利用可能です。
Agent v5 と Agent v6 では、ホスト名解決に違いがあります。
Agent v5 から Agent v6 へのアップグレードの際、Agent から報告されるホスト名に違いが生じる場合があります。システムホスト名を解決するために、Agent v5 は hostname -f
コマンドを使用し、Agent v6 は Golang API os.Hostname()
を使用します。アップグレードの際、Agent のホスト名が FQDN (Fully-Qualified Domain Name) から短いホスト名に変更されることがあります。
sub.domain.tld
–> sub
注: Agent v6.3 から、Agent v6 で Agent v5 と同じ動作をさせるための hostname_fqdn
構成オプションが導入されました。 バージョン 6.3+ ではこのフラグはデフォルトで無効化されています。このオプションを有効にするには、datadog.yaml の例を参照してください。
v6.3.0 以降、この変更の影響を受ける場合、Agent は以下の警告をログに記録します。
DEPRECATION NOTICE: The agent resolved your hostname as <HOSTNAME>. However in a future version, it will be resolved as <FQDN> by default. To enable the future behavior, please enable the `hostname_fqdn` flag in the configuration.
以下のいずれかに該当する場合は、影響を受けません。
DD_HOSTNAME
で設定されている。cat /proc/sys/kernel/hostname
と hostname -f
のホスト名出力が同じ。この変更の影響を受ける場合、Datadog では Agent をアップグレードする際に以下のアクションを取ることを推奨しています。
hostname_fqdn
オプションを有効にします。これにより、同じホスト名を維持することができます。hostname_fqdn
を false
に設定します。とはいえ、Datadog では、可能な限り hostname_fqdn
を true
に切り替えることを推奨しています。Agent v5 では、Windows Agent はデフォルトで未修飾ホスト名を報告しました。後方互換性を維持するために、この動作は Agent v6 で維持されます。新しいフラグ hostname_fqdn
は Windows ではデフォルトで無効のままであり、将来の v6 バージョンでもデフォルトで無効のままです。
Windows Agent は、v6.5 からこの構成フラグを尊重します。hostname_fqdn
を true に設定すると、Windows Agent は完全修飾ホスト名を報告するようになります。
デフォルトでは、推奨アクションは何もしないことです。これは、特に Agent v5 からアップグレードする場合、既存の動作を維持するものです。
Windows ホストで完全修飾ホスト名を報告させたい場合は、Agent のメインコンフィギュレーションファイルに true
に設定された hostname_fqdn
を追加します。
GCE 上で動作する Agent にのみ影響します
デフォルトでは、Agent v6 は GCE から提供されたインスタンスのホスト名を使用します。これは、Agent v5.5.1+ の datadog.conf
で gce_updated_hostname
を true に設定した場合の動作と同じです。
Agent v5 で gce_updated_hostname
が未設定または false に設定されていて、Agent のホスト名が datadog.conf
/datadog.yaml
でハードコードされていない場合、Datadog で報告されるホスト名が GCE インスタンス name
から完全な GCE インスタンス hostname
(GCE プロジェクト ID を含む) に変更されます。