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:
- 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, which represent the KDE column(s) corresponding to each dimension, may be used in API queries made with the Query SQL Method.
- 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.

 

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:

 
top  |  section

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.

 
top  |  section

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
 

 
top  |  section

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).

©2014-20 Kentik

In this article: