---
title: "Device Metrics Dimensions"
slug: "device-metrics-dimensions"
description: "Explore SNMP and Streaming Telemetry dimensions in Kentik's data engine, enhancing device and interface insights for effective network management."
tags: ["Kentik Data Engine", "SNMP Dimensions", "Streaming Telemetry"]
updated: 2025-08-15T18:43:44Z
published: 2025-08-15T18:43:44Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://kb.kentik.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Device Metrics Dimensions

This article discusses dimensions related to devices and interfaces based on data collected via SNMP polling or Streaming Telemetry.

> [!NOTE]
> **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**](/v1/docs/nms-setup#nms-via-streaming-telemetry)).
> - As of May 1st, 2025, the [**Query SQL Method**](/v1/docs/query-api#query-sql-method) has been deprecated and is no longer supported.

## SNMP Dimensions

> [!NOTE]
> **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**](/v1/docs/metrics-settings#metrics-dialog-ui)).

If SNMP polling is enabled on a router (see [**SNMP OID Polling**](/v1/docs/router-configuration#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**](/v1/docs/kde-tables#universal-data-records) (UDR), allowing flexible data allocation to the columns of the Kentik Data Engine (see [**Information SNMP OIDs**](/v1/docs/router-configuration#information-snmp-oids)).

> [!NOTE]
> **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**](/v1/docs/router-configuration#kentikpolled-snmp-oids).

| Dimension name (portal) | Description | Type: value column | Direction |
| --- | --- | --- | --- |
| Interface | The Name and Description of the interface (see [**Interface Field Definitions**](/v1/docs/interfaces#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**](/v1/docs/device-settings#device-general-settings)). | int UDR | Non-directional |
| Site | Name of the site to which the device has been assigned (see [**About Sites**](/v1/docs/sites#about-sites)). If the device hasn't been assigned to a site, returns an empty string. > [!NOTE] > **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**](/v1/docs/interface-classification#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**](/v1/docs/classification-overview#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**](/v1/docs/classification-overview#network-boundary-attribute)). | string UDR | Non-directional |
| Interface Capacity | The speed of the device interface through which flow ingressed/egressed (see [**Interface Field Definitions**](/v1/docs/interfaces#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**](/v1/docs/router-configuration#kentikpolled-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**](/v1/docs/device-settings#device-general-settings)). | string UDR | Non-directional |
| Site | Name of the site to which the device has been assigned (see [**About Sites**](/v1/docs/sites#about-sites)). If the device hasn't been assigned to a site, returns an empty string. > [!NOTE] > **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]
> **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**](/v1/docs/metrics-settings#metrics-dialog-ui)).

If streaming telemetry publishing is enabled on a router (see [**Streaming Telemetry Device Support**](/v1/docs/snmp-and-streaming-telemetry#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**](/v1/docs/device-metrics-dimensions#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]
> **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**](/v1/docs/nms-setup#nms-via-streaming-telemetry)).
