Device Metrics Dimensions
The following topics list dimensions, related to devices and interfaces, that are 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).
- The categorization of dimensions in the topics below corresponds to the categories by which the dimensions are shown in the Dimension Selector Dialog (part of the ad hoc filter controls in the Filtering Options dialog).
- Except where noted, the dimensions listed in the tables below are available for both filtering and group-by.
- The value type refers to the data type (text, integer, etc.) of the dimension value.
- The column type refers to whether the dimension is literally stored in KDE (native) or derived at query-time from other KDE-stored information (virtual); see KDE Query Efficiency.
- The KDE name(s) given below represent the KDE column(s) corresponding to each dimension.
- Some columns are native (actually stored in the backend) while others are virtual (derived from other information). In general, filtering with dimensions based on native columns will return results faster than filtering with dimensions based on virtual columns.
- 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 (Metrics Dialog UI). |
Dimensions derived from SNMP are covered in the following topics:
About SNMP Dimensions
If SNMP polling is enabled on a router (see SNMP OID Polling) then 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 allocation of data to the columns of the Kentik Data Engine. See also 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: value column |
Direction |
| Interface | The Name and Description of the interface (see Interface Field Definitions) stated in the form of "name: description". | string UDR |
Non-directional |
| Device | The Kentik-registered name for the device (see Device General Settings). | int UDR |
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. Notes: - Supported operators for WHERE clause: case-insensitive equality, LIKE, IN, and regex matching. - Site assignments in the table may lag Admin settings by up to 10 minutes. |
string UDR |
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 UDR |
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 UDR |
Non-directional |
| Network Boundary | The network boundary value (internal or external) of the source/destination interface of this flow (see Network Boundary Attribute). | string UDR |
Non-directional |
| Interface Capacity | The speed of the device interface through which flow ingressed/egressed (see Interface Field Definitions). | integer UDR |
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: value column |
Direction |
| Error | An error string associated with failed polls (used for troubleshooting). | string UDR |
Non-directional |
| Component | The name of the component that reports CPU or memory utilization. Examples: "Routing Engine," "FPC: QFX5100-48S-6Q @ 0/*/*," "Processor" |
int UDR |
Non-directional |
| Uptime | The time (in hundredths of a second) since the network management portion of the system was last re-initialized. | string UDR |
Non-directional |
| Device | The Kentik-registered name for the device (see Device General Settings). | string UDR |
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. Notes: - Supported operators for WHERE clause: case-insensitive equality, LIKE, IN, and regex matching. - 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 (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).