概要
Network Device Monitoring は、収集するメトリクスと関連タグを Datadog Agent に通知するためにプロファイルを使用します。プロファイルは、デバイスに関連付けられた OID のコレクションです。
構成
デフォルトでは、Agent コンフィギュレーションディレクトリ内のすべてのプロファイルがロードされます。コレクションの特定のプロファイルをカスタマイズするには、definition_file
でファイル名別に明示的に参照するか、definition
でインラインリストを指定します。Datadog プロファイルはいずれも名前別にリストできます。追加のカスタムプロファイルは、コンフィギュレーション内でファイルパスで参照するか、コンフィギュレーションディレクトリに配置できます。
注: 一般的なプロファイルは generic-device.yaml で、ルーターやスイッチなどのデバイスをサポートしています。
sysOID マップデバイス
プロファイルを使用すると、Network Device Monitoring は、複数のデバイスタイプまたはインスタンスにわたってメトリクス定義を再利用できます。プロファイルは、収集するメトリクスと、それらを Datadog メトリクスに変換する方法を定義します。各プロファイルは、同じベンダーの同種のデバイスを監視することを想定しています。プロファイルは、Datadog Agent がネットワークデバイスの sysObjectIds をプロファイルファイルに定義されたものと比較することで自動的に使用されます。
Datadog Agent は、すぐに使えるプロファイルを conf.d/snmp.d/default_profiles
ディレクトリに提供します。このディレクトリは、Agent のアップグレード時にクリーンアップされ、リセットされますので、そこに何も保存しないでください。conf.d/snmp.d/profiles
ディレクトリにファイルを置くことで、独自のカスタムプロファイルを作成したり、既存のプロファイルを拡張したりすることができます。
次のプロファイルの例は、sysobjectid
が 1.3.6.1.4.1.232.9.4.10
であるか、1.3.6.1.4.1.232.9.4.2.
で始まるネットワークデバイスで使用されます。
sysobjectid:
- 1.3.6.1.4.1.232.9.4.10
- 1.3.6.1.4.1.232.9.4.2.*
metrics:
- MIB: CPQHLTH-MIB
symbol:
OID: 1.3.6.1.4.1.232.6.2.8.1.0
name: cpqHeSysUtilLifeTime
同じ sysobjectid
を共有するネットワークデバイスに対して異なるメトリクスが必要な場合は、sysobjectid
なしでプロファイルを記述し、SNMP 構成で profile
オプションを構成できます。
instances:
- ip_address: 192.168.34.10
profile: my-profile1
- ip_address: 192.168.34.11
profile: my-profile2
- ip_address: 192.168.34.13
# このデバイスの場合、Agent はデバイスの sysObjectID を取得し、最も近いものを使用します
プロファイルによるメトリクス定義
プロファイルは互いに交換して使用できます。つまり、MIB 依存関係を共有するデバイスは同じプロファイルを再利用できます。たとえば、Cisco c3850 のプロファイルは多くの Cisco スイッチで使用できます。
Datadog が提供するプロファイルの詳細については、GitHub リポジトリを参照してください。
プロファイルによるメタデータ定義
プロファイルのメタデータセクションで、メタデータを収集する場所と方法を定義できます。値は、静的または OID 値に由来します。
サポートされているフィールドについては、DeviceMetadata セクションを参照してください。
Datadog Agent バージョン 7.52 以降では、デバイスメタデータ用に device_type
フィールドがあります。これはプロファイルで手動で設定でき、特定のタイプのデバイスをフィルタリングするために使用できます。設定可能な値は以下の通りです。
- access_point
- firewall
- load_balancer
- pdu
- printer
- router
- sd-wan
- sensor
- サーバー
- storage
- switch
- ups
- wlc
プロファイルフォーマットの詳細については、プロファイルフォーマットリファレンスを参照してください。
その他の参考資料