dt-obs-network-devices

网络设备技能

在 Dynatrace 中分析由 SNMP 监控的网络基础设施，包括交换机、路由器、防火墙、负载均衡器、接入点，以及由 网络设备扩展轮询的任何其他设备（SNMP 通用扩展和厂商 SNMP 扩展）。此技能涵盖设备和接口数据模型，并将每个问题引导至相应的参考文件。所有 DQL 均位于参考文件中，并已通过 dtctl query 在实时租户中验证。

网络设备监控能告诉你什么

SNMP 扩展会轮询网络硬件，并在 Dynatrace 中将其呈现为三层数据：

• 拓扑 — 设备及其接口的清单，作为 Smartscape 节点（EXT_NETWORK_DEVICE、EXT_NETWORK_INTERFACE）呈现，包含属性（厂商、型号、操作系统／固件、位置、联系人、IP、MAC、链路速度）和关系（接口所属设备；通过 LLDP/CDP 相邻的设备）。
• 指标 — 设备健康状况（CPU、内存、运行时间）和各接口健康状况（运行／管理状态、入／出吞吐量、错误、丢弃、数据包类型）的时间序列，位于 com.dynatrace.extension.network_device.* 命名空间下。
• 日志 — 事件驱动的记录：SNMP 陷阱（链路启用／停用、硬件故障）、syslog 消息（配置更改、身份验证、接口事件）以及自动发现活动（每个轮询周期发现的设备和相邻设备）。

这可以回答诸如以下问题：哪些接口已停用？哪些链路已饱和？这台路由器的 CPU 是否已满载？哪些设备重启过？这台交换机连接了什么？这台设备发送了哪些陷阱？哪些 syslog 错误反复出现？

三层数据（以及它们如何关联）

层	使用以下方式查询	粒度	关键字段
拓扑	smartscapeNodes "EXT_NETWORK_DEVICE" / smartscapeNodes "EXT_NETWORK_INTERFACE"	每个设备／接口一行（当前清单）	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. 大多数实际问题都会结合多个层面（例如 “核心路由器上哪些接口已停用” = 筛选出单台设备的指标状态，并关联接口名称）。metrics 和 logs 参考文件展示了这些关联查询。

相关技能

网络设备监控是 Dynatrace 网络可观测性的一部分。如果问题与设备／接口运行状况或拓扑无关，请转到其他技能：

用户想要……	使用
实体之间的流量、流量最高的通信方、通信会话、连接运行状况（流经网络的流量）	dt-obs-network-flows — 包括这些相同设备导出的 NetFlow/IPFIX/sFlow
由 OneAgent 监控的主机上的主机 NIC 吞吐量／丢包（不是 SNMP 设备）	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 — 已验证。 三种日志来源：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）、这三种来源的字段参考，以及用于显示近期陷阱及设备名称、按 OID 统计陷阱频率、错误 syslog、主要事件模式、按设备组合视图和 LLDP/CDP 邻居发现日志的 DQL。