NDM プロファイル

概要

Network Device Monitoring は、収集するメトリクスと関連タグを Datadog Agent に伝えるためにプロファイルを使用します。プロファイルとは、デバイスに関連付けられた デバイス上の一意の ID またはアドレス。ポーリング時に、その値のレスポンス コードを返します。 の集合です。

構成

Datadog では、デバイス プロファイルを有効化する方法として、推奨の GUI ベースのワークフロー (SNMP Profile Manager) と、高度な構成ベースのセットアップのいずれかを使用できます:

SNMP Profile Manager (推奨)

  • ガイド付き UI により、Network Device Monitoring Configuration ページから直接、ネットワーク デバイスから収集するメトリクスをカスタマイズできます。
  • ベンダーのドキュメントから OID を収集する必要がなくなります。関連性が高く、人間が読みやすいメトリクスのリストを自動で推奨します。
  • .yaml ファイルによる手動構成は不要です。
  • Remote Configuration を使うと、全ての Agent に対して変更をワン クリックで一括適用できます。

高度なセットアップ

  • .yaml ファイルを使ってカスタム プロファイルを手動で作成して有効化し、デバイスのメトリクスとタグを指定します。
  • 大規模または動的な環境に最適です。

デフォルトでは、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

プロファイルフォーマットの詳細については、プロファイルフォーマットリファレンスを参照してください。

その他の参考資料

お役に立つドキュメント、リンクや記事:

ネットワークデバイスモニタリングで収集されるデータDOCUMENTATION more more Datadog での SNMP モニタリングブログ more more