All registered devices for a given customer are listed on the Devices page (a.k.a. Device Management) of the Kentik portal (choose Admin from the Kentik navbar, then Devices from the sidebar at left). The Devices page is covered in the following topics:

Filter field: Filters the Device List to show only rows containing the entered text in one of the following columns: Name, Type, Flow Type, or IP. You can also enter a site name to return the rows for devices in a given site.

Group-by selector: Allows you to choose how the Device List table will be organized:
- None: Lists all devices, without categorization.
- Site: Shows devices categorized by site (see About Sites), where each site is shown as a collapsible list with its associated devices.
- Plan: Shows devices categorized by plan (see About Plans), where each plan is shown as a collapsible list with its associated devices.
- Type: Shows devices categorized by type, where each type is shown as a collapsible list with its associated devices (see Supported Device Types).
- Label: Shows devices categorized by label (see Device Labels), where each type is shown as a collapsible list with its associated devices.

Show selector: Allows you to choose which view of the Device List is displayed (see Device List Views).

Add Device button: Links to an Add Device dialog where you can add a device to Kentik Detect (see Device Admin Dialogs).

The Device List is a table that shows information about the listed devices as well as available actions. By default the list (or each group if group-by is Site, Plan, or Type) is ordered alphabetically by name (ascending). To change the sort order of the list, click on a heading to choose a sort column, and on the resulting blue up or down arrow to choose the sort direction (ascending or descending).

Notes:
- Click on a column heading to sort the list (ascending or descending).
- To see additional information about a given device, click anywhere in the row for that device, which opens a Edit Device dialog in which you can review and (in some cases) edit settings (see Editing a Device).
- To remove a device, click the device’s row to open the Edit Device dialog, then click Remove at bottom left.

The following columns of the Device List appear (left to right) in both the Device Stats view and the Device Details view:

Flow: Indicates whether Kentik Detect is receiving flow from the device. If no flow is detected, the indicator is light gray. If flow is detected, then the indicator is green if the flow is coming directly from a router or blue if the flow is coming via the Kentik agent.

SNMP: Indicates whether Kentik Detect is able to successfully poll the device for SNMP information. If yes, the indicator is green; if no it’s light gray.

Name/ID: Indicates the following:
- Name (top line): Name of the device as specified at the time the device was registered with Kentik Detect.
- ID (bottom line): System-generated numeric ID assigned to the device when it was registered with Kentik Detect.

IP: The IP address(es) from which the device sends data to Kentik Detect.

BGP Status: Indicates the BGP Peering status for IP v4 (top) and v6 (bottom):
- Enabled and established: BGP is turned on for this device and a session is currently established directly.
- Enabled through another device: BGP is turned on for this device and a session is currently established indirectly (via another device).
- Enabled but not established: BGP is turned on for this device, but a session is not currently established, either directly or indirectly.
- Not enabled: BGP is turned off for this device.Note: To change BGP settings, see Editing a Device.

Pre-Cap FPS 2h: The 99th percentile rate, expressed in flows per second, at which the device has been sending data to Kentik Detect over the last two hours. This rate does not include the effect of any limits imposed on the device by the flow cap in the service agreement.

Max FPS 5m: The maximum rate, expressed in flows per second, at which the device has sent data to Kentik Detect during the last 5 minutes. This rate reflects the effect of any limits imposed on the device by the flow cap in the service agreement.

Sample Rate 24h: If the device’s flow protocol includes a sample rate field (sFlow or NetFlow v5), the 95th percentile sample rate reported in the last 24 hours, else the device’s sample rate setting in the portal.Note: If the flow from a given device is dynamically downsampled by Kentik to keep FPS within limits specified in the device’s plan, then this number will be the downsampled rate.

Device options: Indicates whether the following settings are enabled (green checkmark) or disabled (gray disc):
- CDN attribution: Enabled if the device is a host and its Contribute to CDN Attribution switch is on (see Device General Settings).
- Flowspec: Enabled if the device’s BGP Flowspec Compatible switch is on (see Device BGP Settings).
- RTBH: Enabled if the device is assigned to an RTBH mitigation platform (see RTBH Platform Settings).

Plan & Site: Shows the following:
- Plan (top line): The ID of the plan to which the device belongs (see About Plans).
- Site (bottom line): The name of the site to which the device is assigned (see About Sites).

The Current and Historical Traffic dialog, opened via the View in Chart button, displays a chart of the total volume of flows (source and destination) for a given device, both historically and over the last 24 hours.

The dialog includes the following UI elements:

Close buttons: To close the dialog, click the X in the upper right corner or the Close button at lower right.

View Type: A drop-down menu used to set the type of visualization used for the graph (defaults to Line Chart); for descriptions of the options see Chart View Types.

Chart: The visualization of traffic (using the current view type).

View in Explorer button: Opens Data Explorer for further exploration of the device’s traffic. The sidebar will be set so that query results will show the same traffic that is shown in the dialog.

The Kentik portal uses device admin dialogs to collect the information required for Kentik to connect with the device to receive flow, poll SNMP, and establish BGP peering (when applicable). The required information is entered into the fields of either of the following dialogs:

Each device admin dialog is broken into the tabs covered in the topics below, each of which is made up of a number of fields. The tabs that are visible at any given moment, and the fields on those tabs, varies depending on the type (router or host) of the device, and whether the device is being added or edited.

Until all required settings on a given tab are entered the tab name is preceded with a caution icon. Once a tab’s fields are complete the icon changes to a check mark.

Notes:
- Some fields that are editable when adding a device are read-only when editing a device.
- In addition to the fields used to enter information, the tabs of the device dialogs also include information used to configure a device to connect with Kentik (for routers, see Router Configuration Overview).

Enables the contribution of DNS data from this device to our CDN Attribution learning algorithms (see About CDN Attribution).Note: Only present if the device is a kprobe host.

Sending IP(s)

Editable field

Editable field

Editable field

IP address(es) from which the router sends flow to Kentik.Note: The IP must be unique except as described in IP Overloading.

Add Sending IP

Button

Button

Button

Adds a new Sending IPs field so you can add an IP.

Sample Rate

Editable field

Editable field

Editable field

Total packets transiting the device for each packet processed for flow data (see Flow Sampling).Notes:
- Kentik may dynamically downsample from this nominal sample rate as needed to keep FPS within limits specified in the plan (see About Plans) to which the device is assigned.
- For hosts, see Sample Rate for Hosts.

The address specified with Sending IPs must be unique (not used by any other device in your organization) for any device sending flow data directly to Kentik Detect. If, however, a device sends flow data via kproxy (see NetFlow Proxy Agent) then an IP specified in the Sending IPs field may be the same as that of an already registered device so long as the following is true:

The two devices do not use the same instance of kproxy.

Both instances of kproxy specify a valid site ID using the -site_id parameter in the kproxy command line (see kproxy Proxy Agent Arguments).

The value of -site_id for the two instances of kproxy is not the same.

Devices in the two categories store and report traffic differently (see Device Type), and also have some differences in portal configuration settings, most notably a BGP tab for routers that is not present for hosts. The table below shows the types of devices currently available in the portal, including the category of each.

The Sample Rate field of the Device General Settings tab of the Add Device or Edit Device dialog. This setting is required when a host device is registered in the portal.

The sample rate that is actually used is determined by the following:

If the --sample parameter is included in the command line, the CLI-provided value takes precedence over the Sample Rate field value.

If the --sample parameter is not included in the command line, the Sample Rate field value is used.

Note: If the value is not set in the command line and the Sample Rate field value is reset in the portal then the corresponding kprobe instance will exit. If kprobe is not run under a supervisor then it must be restarted manually.

The table below shows the elements of the IP & SNMP tab of the device admin dialogs.

Note: This tab is shown only when the device type is router.

Element

Add
Device

Edit
Device

Description

SNMP polling

Drop-down menu

Drop-down menu

The polling frequency for SNMP:
- If Standard, interface counter will be polled every 5 minutes and interface description every 30 minutes.
- If Minimum, interface counter won’t be polled and interface description will be polled every 6 hours.

Device SNMP IP

Editable field

Editable field

The SNMP IP address that will be polled by Kentik Detect.

SNMP Community

Editable field

Editable field

The SNMP community to use when polling the router.

Note: Not shown when SNMP v3 is enabled.

SNMP v3 Auth

Toggle switch

Toggle switch

If enabled, SNMP polling will be via SNMP V3 (see About SNMP V3). Available for routers only; overrides SNMP Community setting.

The following table shows the elements of the BGP Settings tab of the device admin dialogs:

Element

Add
Device

Edit
Device
(Router)

Edit
Device
(Host)

Description

BGP Type

Drop-down menu

Drop-down menu

Drop-down menu

Choose one of the following:
- No peer, use generic IP/ASN mapping: Generic IP/ASN mapping will be used.
- Peer with device: Kentik will BGP peer with this device.
- Use table from another peered device: the BGP table will be obtained from another device that is already set to peer with Kentik.

BGP Flowspec Compatible

Switch

Switch

Switch

Turn on if the router supports MP-BGP and is therefore compatible with BGP Flowspec.

Your IPv4 Peering Address

Editable field

Editable field

Editable field

The IPv4 address of the peering device.
- Displayed only when BGP is set to “Peer with device.”
- RFC1918 addresses are not valid.
- Cannot be an IP that is already being used to peer with a different Kentik Detect device.

Your IPv6 Peering Address

Editable field

Editable field

Editable field

The Ipv6 address of the peering device.
- Displayed only when BGP is set to “Peer with device.”
- RFC1918 addresses are not valid.
- Cannot be an IP that is already being used to peer with a different Kentik Detect device.

Your ASN

Editable field

Editable field

Editable field

The number (16- or 32-bit) of the autonomous system (AS) to which the peering device belongs.
- Displayed only when BGP is set to “Peer with device.”

BGP MD5 Password

Editable field

Editable field

Editable field

Optional shared authentication password for BGP peering; 32 alphanumeric characters.
- Displayed only when BGP is set to “Peer with device.”

Master BGP Device

Drop-down menu

Drop-down menu

Drop-down menu

The device whose BGP table will be shared with this device.
- Displayed only when BGP is set to “Use table from another peered device.”

Devices are created and edited via the Devices page of the Kentik Detect portal (choose Admin from the Kentik navbar, then Devices from the sidebar at left). The add/edit process is covered in the following sections: