This article discusses dimensions related to devices and interfaces based on data collected via SNMP polling or Streaming Telemetry.
Notes:
Streaming Telemetry is discussed in this article in relation to Kentik's non-NMS ST implementation. For information about ST for Kentik NMS, see NMS via Streaming Telemetry).
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).
If SNMP polling is enabled on a router (see SNMP OID Polling), Kentik is able to enrich the KDE with the SNMP-derived dimensions listed below. These dimensions are stored in Kentik using Universal Data Records (UDR), allowing flexible data allocation to the columns of the Kentik Data Engine (see Information SNMP OIDs).
Note: UDR dimensions have no persistent KDE columns.
SNMP Interface Dimensions
The dimensions listed in the table below are derived by Kentik from interfaces using the SNMP OIDs covered in Kentik-polled SNMP OIDs.
Dimension name (portal) | Description | Type: | Direction |
|---|---|---|---|
Interface | The Name and Description of the interface (see Interface Field Definitions) stated in the form of "name: description". | string | Non-directional |
Device | The Kentik-registered name for the device (see Device General Settings). | int | Non-directional |
Site | Name of the site to which the device has been assigned (see About Sites). If the device hasn't been assigned to a site, returns an empty string.
| string | Non-directional |
Provider | A string representing the provider via which source/destination traffic over a given interface reaches the Internet (see About Provider Classification). | string | Non-directional |
Connectivity Type | The connectivity type, such as transit, IX peering, etc., of the source/destination interface of this flow (see Connectivity Type Attribute). | string | Non-directional |
Network Boundary | The network boundary value (internal or external) of the source/destination interface of this flow (see Network Boundary Attribute). | string | Non-directional |
Interface Capacity | The speed of the device interface through which flow ingressed/egressed (see Interface Field Definitions). | integer |
SNMP Device Dimensions
The dimensions listed in the table below are derived by Kentik from devices using the SNMP OIDs covered in Kentik-polled SNMP OIDs.
Dimension name (portal) | Description | Type: | Direction |
|---|---|---|---|
Error | An error string associated with failed polls (used for troubleshooting). | string | Non-directional |
Component | The name of the component that reports CPU or memory utilization. | int | Non-directional |
Uptime | The time (in hundredths of a second) since the network management portion of the system was last re-initialized. | string | Non-directional |
Device | The Kentik-registered name for the device (see Device General Settings). | string | Non-directional |
Site | Name of the site to which the device has been assigned (see About Sites). If the device hasn't been assigned to a site, returns an empty string.
| string | 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).