Device Metrics Dimensions
Dimensions based on data collected via SNMP polling or Streaming Telemetry data collection from devices and interfaces are covered in the following topics:
Notes:
- Dimension categories below match those in the Dimension Selector Dialog.
- Dimensions below are available for filtering and group-by, except where noted.
- Value type indicates the data type (e.g., text, integer) of the dimension value.
- Column type shows if a dimension is native (stored) or virtual (derived), see KDE Query Efficiency.
- In general, native columns offer faster filtering than virtual ones.
- As of May 1st, 2025, the Query SQL Method has been deprecated and is no longer supported.
SNMP Dimensions
| Note: Queries using SNMP dimensions are subject to the following restrictions: - SNMP dimensions cannot be mixed with dimensions from any other category. - Results will return only if the query's metrics are from the SNMP category in the Available Metrics list (see Metrics Dialog UI). |
Dimensions derived from SNMP are covered in the following topics:
About SNMP Dimensions
With SNMP polling enabled on a router (see SNMP OID Polling), Kentik enriches the KDE with SNMP-derived dimensions as Universal Data Records (UDR), allowing flexible data allocation in the Kentik Data Engine (see Information SNMP OIDs).
Note: UDR dimensions lack persistent KDE columns.
SNMP Interface Dimensions
Kentik derives the following dimensions from interfaces using Kentik-polled SNMP OIDs:
| Dimension name (portal) |
Description | Type: value column |
Direction |
| Interface | Name and description in "name: description" format (see Interface Field Definitions). | string UDR |
Non-directional |
| Device | Kentik-registered device name (see Device General Settings). | int UDR |
Non-directional |
| Site | Assigned site name (see About Sites). Returns an empty string if unassigned. Notes: - Supports case-insensitive equality, LIKE, IN, and regex matching in WHERE clause - Site assignments in the table may lag Admin settings by up to 10 minutes. |
string UDR |
Non-directional |
| Provider | Provider for interface traffic to the Internet (see About Provider Classification). | string UDR |
Non-directional |
| Connectivity Type | Type of connectivity, e.g., transit, IX peering, (see Connectivity Type Attribute). | string UDR |
Non-directional |
| Network Boundary | Internal or external network boundary value (see Network Boundary Attribute). | string UDR |
Non-directional |
| Interface Capacity | Speed of the interface for ingress/egress flow (see Interface Field Definitions). | integer UDR |
SNMP Device Dimensions
Kentik derives the following dimensions from devices using Kentik-polled SNMP OIDs:
| Dimension name (portal) |
Description | Type: value column |
Direction |
| Error | Error associated with failed polls (used for troubleshooting). | string UDR |
Non-directional |
| Component | Component name reporting CPU or memory utilization, e.g., "Routing Engine," "FPC: QFX5100-48S-6Q @ 0/*/*," "Processor" | int UDR |
Non-directional |
| Uptime | Time (in hundredths of a second) since the network management system was last re-initialized. | string UDR |
Non-directional |
| Device | Kentik-registered name for the device (see Device General Settings). | string UDR |
Non-directional |
| Site | Assigned site name (see About Sites). Returns an empty string if unassigned. Notes: - Supports case-insensitive equality, LIKE, IN, and regex matching in WHERE clause. - Site assignments in the table may lag Admin settings by up to 10 minutes. |
string UDR |
Non-directional |
Streaming Telemetry Dimensions
| Note: Queries using Streaming Telemetry dimensions are subject to the following restrictions: - Streaming Telemetry dimensions cannot be mixed with dimensions from any other category. - Results will return only if the query's metrics are from the Streaming Telemetry category in the Available Metrics list (see Metrics Dialog UI). |
If streaming telemetry publishing is enabled on a router (see Streaming Telemetry Device Support) then you can run queries in the portal that use streaming telemetry interface dimensions. The dimensions that are available for these ST queries have the same names as the dimensions listed in the SNMP Dimensions table above, but they appear in the Streaming Telemetry Interface section of the list in the portal's Group By Dimensions dialog (e.g. in Data Explorer).
Note: Streaming Telemetry is discussed above in relation to Kentik's non-NMS ST implementation. For information about ST for Kentik NMS, see NMS via Streaming Telemetry).