dt-obs-network-devices

ネットワークデバイススキル

Dynatrace で SNMP によって監視されているネットワークインフラストラクチャを分析します。対象はスイッチ、ルーター、ファイアウォール、ロードバランサー、アクセスポイント、およびネットワークデバイス拡張機能（SNMP 汎用拡張機能とベンダー SNMP 拡張機能）によってポーリングされるその他すべてのデバイスです。このスキルでは、デバイスとインターフェースのデータモデルを扱い、質問に応じて適切なリファレンスファイルを参照します。DQL はすべてリファレンスファイルに記載されており、実際のテナントに対して dtctl query で検証済みです。

ネットワークデバイスの監視でわかること

SNMP 拡張機能はネットワーク機器をポーリングし、Dynatrace で3 つのレイヤーとして公開します。

• トポロジー — Smartscape ノード（EXT_NETWORK_DEVICE、EXT_NETWORK_INTERFACE）として、デバイスとそのインターフェースのインベントリを提供します。属性（ベンダー、モデル、OS／ファームウェア、場所、連絡先、IP、MAC、リンク速度）と関係（どのインターフェースがどのデバイスに属するか、LLDP／CDP を介してどのデバイス同士が隣接しているか）も含まれます。
• メトリクス — デバイスの健全性（CPU、メモリ、稼働時間）およびインターフェースごとの健全性（運用／管理ステータス、入出力スループット、エラー、破棄、パケット構成）を示す時系列データです。名前空間は com.dynatrace.extension.network_device.* です。
• ログ — イベントによって記録されるデータです。SNMP トラップ（リンクのアップ／ダウン、ハードウェア障害）、syslog メッセージ（設定変更、認証、インターフェースイベント）、自動検出アクティビティ（ポーリングサイクルごとに検出されたデバイスと隣接デバイス）が含まれます。

次のような質問に答えられます。ダウンしているインターフェースはどれですか？飽和状態のリンクはどれですか？このルーターの CPU 使用率は上限に達していますか？再起動したデバイスはどれですか？このスイッチには何が接続されていますか？このデバイスはどのようなトラップを送信しましたか？繰り返し発生している syslog エラーは何ですか？

3 つのレイヤーとその結合方法

レイヤー	クエリ方法	粒度	主なフィールド
トポロジー	smartscapeNodes "EXT_NETWORK_DEVICE" ／ smartscapeNodes "EXT_NETWORK_INTERFACE"	デバイス／インターフェースごとに 1 行（現在のインベントリ）	id、name、monitoring_mode、device_type、location、ip、speed、belongs_to ／ calls を介したエッジ
メトリクス	timeseries … com.dynatrace.extension.network_device.*	デバイス／インターフェースごとの時系列データ	dt.smartscape.ext_network_device でグループ化。インターフェースメトリクスでは dt.smartscape.ext_network_interface でもグループ化
ログ	fetch logs | filter dt.openpipeline.source == "…"	個々のログレコード（トラップ、syslog、自動検出）	デバイスの ip[] 配列を展開し、device.address ／ dt.ingest.source.ip と照合してトポロジーと結合します。references/logs.md を参照してください。

結合キーは Smartscape ID です。 すべてのメトリクスに dt.smartscape.ext_network_device ディメンションが含まれます（インターフェースメトリクスには dt.smartscape.ext_network_interface も含まれます）。lookup [smartscapeNodes …] を使うと、メトリクスの結果に人が読みやすいデバイス名／インターフェース名を付加したり、インベントリ一覧に最新のメトリクスを付加したりできます。どちらのリファレンスファイルにも、このパターンが記載されています。

監視モードによって存在するデータが決まります

各デバイスには monitoring_mode があります。まず最初に確認してください。メトリクスが存在するかどうかは、この値によって決まります。

monitoring_mode	意味	メトリクスあり？	すべての属性あり？
Extension	SNMP 拡張機能によって直接ポーリングされています	はい — com.dynatrace.extension.network_device.* の完全なセット	はい
Discovery	ネットワーク上で検出されていますが、直接ポーリングされていません	いいえ	一部
Neighbor	ポーリング対象デバイスが LLDP／CDP の隣接デバイスとして認識しているだけです	いいえ	最小限（名前、シャーシ MAC）

デバイスにメトリクスがない場合、データが欠落していると判断する前に monitoring_mode を確認してください。ポーリングされるのは Extension モードのデバイスだけです。「監視対象デバイス」を一覧表示する場合は、Neighbor（通常は Discovery も）を除外してください。

ルーティング

1. インベントリ、属性、またはトポロジー（デバイスの一覧表示、デバイスのインターフェイスの検索、隣接デバイスのマッピング、モデル／ファームウェア／場所の読み取り）→ references/topology-model.md。
2. ヘルスまたはパフォーマンス（CPU、メモリ、稼働時間、インターフェイスのアップ／ダウン、スループット、飽和、エラー）→ references/metrics.md。
3. イベント駆動型シグナル（SNMP トラップ、syslog メッセージ、ディスカバリーアクティビティ）→ references/logs.md。
4. 実際の質問の多くは複数のレイヤーを組み合わせます（例：「コアルーター上でダウンしているインターフェイスはどれか」＝1 台のデバイスに絞り込んだメトリクスのステータスを、インターフェイス名と結合）。メトリクスとログのリファレンスでは、こうした結合クエリを紹介しています。

関連スキル

ネットワークデバイスの監視は、Dynatrace のネットワークオブザーバビリティの一部です。質問がデバイス／インターフェイスのヘルスやトポロジーに関するものでない場合は、適切な別の場所を参照してください。

ユーザーが求めている内容…	使用するもの
エンティティ間のトラフィック、通信量の多い上位エンティティ、通信、接続のヘルス（ネットワークを通過するフロー）	dt-obs-network-flows — これらの同じデバイスがエクスポートする NetFlow／IPFIX／sFlow も含みます
OneAgent で監視されるホスト（SNMP デバイスではありません）のホスト NIC スループット／パケットドロップ	dt-obs-hosts → references/host-metrics.md
サービスのリクエストレート、レイテンシー、エラーレート	dt-obs-services
拡張機能のセットアップまたは設定（このスキルが扱うのは拡張機能の作成方法ではなく、生成されるデータモデルです）	dt-obs-extensions
一般的な Smartscape のトラバーサル構文（traverse、smartscapeEdges、references[…]）	dt-dql-essentials

ネットワークデバイスとネットワークフローの違い。 このスキルでは*「デバイス本体とポートの状態はどうなっているか」（SNMP デバイス／インターフェイスのヘルスとトポロジー）を扱います。dt-obs-network-flows では「ネットワークをどのようなトラフィックが通過しているか」*（通信、バイト数、通信量の多いエンティティ）を扱います。同じルーターが両方に登場します。ここではインターフェイスカウンターを持つ EXT_NETWORK_DEVICE として、あちらでは NetFlow エクスポーターとして扱われます。将来的にはマクロ dt-obs-network スキルで統合される可能性があります。それまでは相互にリンクしてください。

リファレンスファイル

• references/topology-model.md — 検証済み。 Smartscape モデル：EXT_NETWORK_DEVICE と EXT_NETWORK_INTERFACE のノードタイプと、すべてのフィールドリファレンス、監視モード、および belongs_to／calls エッジを説明します。デバイスインベントリ（モード／タイプ／場所／ベンダーによるフィルタリングを含む）、デバイスのインターフェイス一覧、インターフェイスからデバイスへの解決、デバイス／インターフェイスの隣接トポロジーのマッピングに関する DQL を紹介します。
• references/metrics.md — 検証済み。 com.dynatrace.extension.network_device.* メトリクスカタログと、単位、ディメンション、フィールドの型付けルールを説明します。デバイスのヘルス（CPU 使用率の上位、フォールバックを含むメモリ使用率、稼働時間と再起動の検出）およびインターフェイスのヘルス（ダウンしているインターフェイス、リンク速度と比較したスループットおよび飽和、エラー／破棄数、デバイスごとのインターフェイス詳細）に関する DQL を、それぞれデバイス名／インターフェイス名との結合とともに紹介します。
• references/logs.md — 検証済み。 3 つのログソースを説明します。SNMP トラップ（extension:com.dynatrace.extension.snmp-traps-generic）、syslog（extension:syslog）、自動検出アクティビティ（extension:com.dynatrace.extension.snmp-auto-discovery）です。IP と Smartscape の結合パターン（device.address／dt.ingest.source.ip → snmp.ip）、3 つすべてのソースのフィールドリファレンス、デバイス名を含む直近のトラップ、OID ごとのトラップ頻度、エラー syslog、上位のイベントパターン、デバイスごとの統合ビュー、LLDP／CDP 隣接デバイス検出ログに関する DQL を紹介します。