Test Control Center

The Test Control Center in Synthetics is used both to configure tests, which is covered in Synthetics Test Settings, and to view test results, which is covered in the following topics:

Notes:
- For information about the types of tests that you manage in the Test Control Center, see Synthetic Test Types.
- For information about how test status (Healthy, Warning, Critical) is derived from test results, see Synthetic Test Status.

The Test Control Center landing page.
 

About Test Control Center

The Test Control Center is used to manage your organization's synthetics tests. Cards across the top of the page show your current (month to date) and projected (full month, at current trends) consumption of test credits (purchased from Kentik in SyntheticPaks; see Synthetic Test Credits). A Tests List, filterable by type and by agent, provides information about your currently configured tests and gives you access to an edit page for any existing test. You can also use the Add Test button to go to the Add Test Page, where you can choose and configure a new test.

The Test Control Center is structured as follows to allow successive drill-down into the details of each test and its component subtests (see Tests and Subtests):

  • Test Control Center page: Provides an overview of all tests (see Test Control Center Page).
  • Test Details page: Provides an overview of a single test including information and status for all of the test's subtests (see Test Details Page).
  • Subtest Details page: Provides information and status details for an individual subtest (see Subtest Details Page).

Note: If your organization's test credit balance (see About Test Credits) is below zero, a notification will appear to the right of the title on the main Test Control Center Page as well as on any Add Test Page or Test Settings Page. To add more credits, click the link in the notification (see Adding Test Credits).

 

Test Control Center Page

The Test Control Center page is the home page of the test control workflow. The page includes the following main UI elements:

  • Share (on SubNav): Opens the Share dialog to enable you to share the current view (see Sharing via the Share Dialog).
  • Actions (on SubNav): A drop-down menu from which you can choose to export the current view as a visual report (PDF) covering the page’s visualizations and tables. A notification appears when the PDF is ready to download.
  • Add Test: A button that takes you to the Add Test Page.
  • Credit Utilization: Two cards that indicate your organization's current (this month) and projected (next month) usage of test credits (see Credit Utilization).
  • Tests List: A list of the currently configured tests in your organization (see Tests List).
  • Filters pane: A set of fields and checkboxes used to filter the Tests List (see Tests List Filters).

Credit Utilization

The Credit Utilization section is made up of two cards that indicate your organization's current (this month) and projected (next month) usage of test credits (see About Test Credits).

  • Current Month: A card that indicates your organization's current (month to date) usage of test credits:
    - Monthly allocation: The total credits that are available to your organization this month (e.g. the credits-per-month purchased from Kentik in a SyntheticPak).
    - Used so far: The credits your organization has actually used so far this month.
    - Projected for month: The credits Kentik expects your organization to use during this entire month based on the credits consumed by the tests that are currently active.
    - Projected surplus: The credits from your organization's allocation for this month that will go unused if your actual usage matches your projected usage.
  • Next Month Projection: A card that indicates your Kentik-projected consumption of credits for the month following the current month:
    - Projected total: The credits Kentik expects your organization to use during the entire next month based on the credits consumed by the tests that are currently active.
    - Projected surplus: The credits from your organization's allocation for next month that will go unused if your actual usage matches your projected usage.
 

Tests List

The Tests List on the Test Control Center page, which provides information about the synthetic tests currently configured in your organization, is covered in the following topics:

The Tests List is a list of all tests currently configured in your organization.
 
top  |  section

Label Controls

Kentik's labeling feature enables you to create a label (essentially a property whose value is text) and apply it to one or more of your synthetic tests, creating a group of tests that can be referred to (e.g. filtered for) collectively rather than individually. The Test Control Center includes the following label-related controls for tests, which are associated with the tests list:

  • Selection indicator: Indicates how many tests are currently selected in the tests list (see the Select checkbox in Tests List Columns).
  • Add/Manage Labels: Links to the settings page for Labels, where you can create or remove the labels that are available to apply to the selected tests (as well as to data sources such as routers).
  • Clear Labels: Clear the labels that are applied to all tests that are currently selected in the tests list.
  • Apply Labels: A drop-down list of labels from which you can choose a label to apply to all tests that are currently selected in the tests list.
  • Select All (checkbox): A checkbox for toggling the selection state of all tests in the tests list:
    - If either no checkboxes in the list itself are checked or only some are checked then clicking this checkbox will select all tests.
    - If all checkboxes in the list are checked, clicking this checkbox will deselect all tests.

Note: Labels may also be applied to and removed from tests in the Common Test Settings of the Advanced Options pane of the Test Settings Page.

 
top  |  section

Tests List Columns

The Tests List provides the following types of information for each listed test:

  • Select (checkbox): Select this test to clear or apply labels (see Label Controls).
  • Status: The status of the test and its results (see Synthetic Test Status).
  • Test: The type (see Synthetic Test Types) and name of the test.
  • Created by: The user in your organization who created the test, as well as the date created.
  • Last updated: The user in your organization who most recently modified the test, as well as the date modified.
  • Agents: The number of agents (see About Synthetics Agents) involved in the test.
  • Monthly Credits: The projected monthly consumption of test credits (see About Test Credits) by this test.
  • ID: A Kentik-assigned ID for the test.
  • Pause (icon): Suspend this test.
  • Edit (icon): Takes you to the Test Settings Page for this test.
  • Copy: Duplicate the test so that you can make a new test by modifying (editing) the duplicate rather than starting from scratch.
  • Remove (trash icon): Opens a confirming popup from which you can remove the test from your organization's collection of tests.
 
top  |  section

Tests List Filters

The Tests List can be filtered using the Filters pane at the right. The pane includes the following settings:

  • Clear all: Clear all currently applied filters.
  • Name: See only tests whose name contains the string entered in the input field.
  • Type: A list of test types. Check one or more types to see only tests of those types (when no types are checked, all tests are listed).
  • Labels: A drop-down list of labels from which you can choose (or remove) one or more labels.
  • Private Agents: A list of your organization's currently activated private agents. Check one or more agents to see only tests involving those agents (when no agents are checked, all tests are listed).
  • Global Agents: A drop-down from which you can choose global agents to see only tests involving those agents. Use the drop-down multiple times to select multiple agents.

Note: The filters applied via the Filters pane interact as follows:
- Filters are ORed within each of the categories (Name, Type, Label, Private Agent, Global Agent), so tests matching any filter value within an individual category are considered a match for that category.
- Filters are ANDed between categories, so tests must match in all specified filter categories to be included in the Tests List.

 

Test Details Page

The Test Details page for a given test, which is accessed by clicking on the name of the test in the Tests List, is covered in the following topics:

The Test Details page provides detailed information about a given test over the specified time-range.
 
top  |  section

SubNav Test Detail Controls

The Test Details page includes the following UI elements on the SubNav (light gray strip at the top of the page):

  • Edit Test: A button that takes you to the Test Settings Page for this test.
  • Pause/Resume Test: A button that does one of the following:
    - Pause: If the test is active it stops all testing related to this test.
    - Resume: If the test is paused it resumes all testing related to this test.
  • Share (on SubNav): Opens the Share dialog to enable you to share the current view (see Sharing via the Share Dialog).
  • Actions (on SubNav): A drop-down menu from which you can choose to export the current view as a visual report (PDF) covering the page’s visualizations and tables. A notification appears when the PDF is ready to download.
 
top  |  section

Main Test Details

The main part of the Test Details page (above the tabs) includes the following information:

  • Test type: The type of the test (above the test name); see Synthetic Test Types.
  • Test name: The name of the test, presented as the heading at the upper left of the page.
  • Status: The current (most recent time slice) overall status of the test (see Synthetic Test Status).
  • Time Range: An indicator that shows the current time range and also acts as a button that opens a popup that enables you to define the time range covered by the timeline (see Time Range Control).
  • Details tabs: Different views of the test results for the currently selected time slice (see Test Details Tabs).
  • Table: A table listing the individual subtests used in this test and providing information about them and their individual results (see Test Details Table).
 

Test Details Tabs

The tabbed views of the Test Details page are covered in the following topics

Note: The details pages for BGP Monitor tests are structured differently from other test types and don't have the same tabs (see BGP Monitor Details Page).

 
top  |  section

About Test Details Tabs

Each Test Details page shows the results of a test that has been configured with a Test Settings Page. The results are organized into the three main tabs listed below. The presence of a given tab on a given Test Details page depends on the type of test (see Test Details by Test Type):

  • Results: A timeline, subtabs, and tables that provide health and performance information for the test (see Test Results Details.
  • Path View: A graphical representation of traceroute data from the subtests in this test (see Test Path View).
  • Insights: A list of insights (see About Insights) related to synthetic testing that help you spot anomalies, e.g. comparing latency metrics for the last hour with the average latency observed over the last week. Click on an individual insight to see expand its row in the list, which reveals a chart illustrating the issue referred to by the insight as well as the following links:
    - View Details: Takes you to the Insight Details Page (in the Insights & Alerting module) for the insight.
    - View in Data Explorer: Takes you to Data Explorer, where the controls will be set to show the traffic that generated the insight.
 
top  |  section

Test Details by Test Type

As shown in the table below, the tabs and subtabs of a Test Details page vary depending on the test type (see Synthetic Test Types).

Test Type Results:
Sankey
Results:
Mesh
Results:
Map
Results:
Time Series
Path View Insights
Network Meshes & Grids:
Network Mesh No Yes Yes Yes Yes Yes
Network Grid No No Yes Yes Yes Yes
DNS Server Grid No No Yes Yes No Yes
Network & Routing:
IP Address No No Yes Yes Yes Yes
Hostname No No Yes Yes Yes Yes
SaaS Application No No Yes Yes Yes Yes
Agent-to-Agent No No Yes Yes Yes Yes
BGP Monitor (NO TABS) No No No No No No
Web Tests:
HTTP(S) or API No No Yes Yes Yes Yes
Page Load No No Yes Yes No No
Transaction No No Yes Yes No No
Autonomous Tests:
ASN Yes No Yes Yes Yes Yes
CDN Yes No Yes Yes Yes Yes
Country Yes No Yes Yes Yes Yes
Region Yes No Yes Yes Yes Yes
City Yes No Yes Yes Yes Yes
DNS Tests:
Server Monitor No No Yes No No Yes

 

Test Results Details

The Results tab of the Test Details pages is covered in the following topics:

 
top  |  section

Results Tab Elements

The Results tab uses the following main UI elements to convey health status and performance information about the test:

  • Health timeline: A visual representation of the currently selected time range that shows the overall status of the test for each time slice in the range (see Status Time and Scope). By default the latest time slice (far right) is selected, meaning that this is the slice for which details are given in the details tabs (see below). Hovering anywhere in the timeline changes the selection to the time slice at that point, causing a corresponding change to the information in the details tables and tabs (e.g. Table tab, Mesh tab) and opening a popup over the timeline that gives the start time and overall status of the selected slice.
  • Subtabs: A set of subtabs that display, in graphical and tabular form, the metrics of test results for the specified time range (see Results Tab Subtabs).
  • Identified Issues Table: A table listing the subtests in this test whose health status was either Warning or Critical at the currently selected time slice in the timeline. If all subtests were healthy at that point, the table is not displayed. The columns of the table are the same as the Test Details Table.
  • Test Timestamp: An indicator giving the timestamp of the currently selected time slice in the timeline.
  • Test Details Table: A table listing the subtests in this test (see Tests and Subtests) and providing performance metrics and other details about each subtest at the currently selected time slice in the timeline.
 
top  |  section

Results Tab Subtabs

Depending on the type of test (see Test Details by Test Type), subtabs with the following views may be present on the Results tab of a Test Details page:

  • Sankey: A Sankey diagram showing the site, connectivity type, provider, and target IP of the tested path.
The Sankey subtab of the Results tab.
  • Mesh: A matrix providing the latency, packet loss, and jitter status, over the selected time range, of the individual tests between all of the agents in the matrix (see Test Mesh Subtab).
  • Map: A map showing the physical location of hosted agents (private or public) used for this test and the cloud region for cloud agents.
The Map subtab shows the geographic location of the agents involved in your tests.
  • Time Series: Time series charts that show average performance from a given location over time (see Test Time Series Subtab):
    - For Transaction tests the performance chart shows total transaction time.
    - For all other tests with a Time Series subtab, there are charts for Latency, Packet Loss, and Jitter.
 
top  |  section

Test Mesh Subtab

The Mesh subtab of the Results tab on a test details page shows a matrix representing the set of agents you've chosen to monitor and for which Kentik has automatically configured the to and from testing. As with any matrix, these agents are presented on the tab in a grid in which every agent is tested to and from every other agent. Inside each cell at the intersection of two agents there are three dots, which represent the latency, packet loss, and jitter status, respectively, for those two agents over the currently selected time slice.

Hovering over a cell opens a popup with information about the subtest results in both directions (forward and reverse), including agent location, agent AS (name and number), and the latency, packet loss and jitter metrics for the current time slice. Clicking the View Details button takes you to the corresponding Subtest Details Page.

Note: The test types for which this subtab is included on the Results tab of the Test Details page are listed in Test Details by Test Type.

The Mesh subtab shows a matrix of the subtests in a test.
 
top  |  section

Test Time Series Subtab

The Time Series subtab of the Results tab features timeline charts that show average performance over time from one or more locations (agents). For Transaction tests the performance chart shows total transaction time; for all other tests with a Time Series subtab, there are individual charts for Latency, Packet Loss, and Jitter.

By default the charts show plots for all of the agents assigned to the test, but the Agents to show drop-down at the upper right of the tab enables you to choose (using the checkbox at the left of each listed agent) which agents to include.

Hovering over a timeline in the Time Series tab changes the selected segment in the main (top of page) timeline to the time slice corresponding to the hover point, and opens a popover in each timeline that gives the average metric (latency, packet loss, or jitter) during that time slice, both overall and for each agent included with the Agents to show drop-down.

A test may fail for some or all of the currently specified time range. Test failure may be caused by a timeout (the test took too long to complete) or by errors (e.g. agent or OS error). When a test fails during a given time period no results are available to plot for that period in the time series charts. The way this condition is indicated in the charts depends on the type of chart and the kind of failure:

  • For both latency and jitter the results plot will have a gap corresponding to the duration of the failure.
  • For packet loss:
    - If the failure is due to error, there will be a gap in the results plot.
    - If the failure is due to timeout, packet loss will be shown as 100%.

Note: The test types for which this subtab is included on the Results tab of the Test Details page are listed in Test Details by Test Type.

The Time Series subtab shows health metrics over time for the subtests in a test.
 

Test Path View

The Path View tab of a test details page, which shows a graphical representation of traceroute data from the subtests in a test, is covered in the following topics:

Note: The test types for which this tab is included on the Test Details page are listed in Test Details by Test Type.

 
top  |  section

Path View UI

The Path View tab includes the following UI elements:

  • Path Hops and Geo Distance: A timeline of the currently selected time range in which the average number of hops in the traceroutes for this test, as well as the average physical distance (estimated based on Geo IP) of those traceroutes, is plotted over time. Hovering over a point in the timeline shows a popover stating the average hops and distance at that point, and also determines the time slice for which paths are displayed in the Path View.
Path Hops and Geo Distance shows the average hops and distance in the traceroutes for a given time slice.
  • Path View Controls: The top pane in the tab displays the current settings for the Path View (see Path View Controls).
  • Path View: Shows the hops taken by the traceroute tests, each represented as a colored circle whose AS is identified in the key, as well as the links between those hops. See Path View Diagram.
  • Legend The key indicates, by color, the ASes to which each of the hops shown in the Path View belongs.
 
top  |  section

Path View Controls

The Path View control pane enables you to customize the way the Path View is displayed. The following settings are included:

  • Show: A drop-down that allows you to select which agents to include in the diagram (default is the first 15 agents alphabetically).
  • Group hops by: Choose how nodes are grouped when collapsed for display in the diagram:
    - No Grouping: Nodes are collapsed regardless of their AS or site.
    - ASNs: Nodes within the same AS will be jointly represented by a single rectangle rather than as individual hops. The color of the rectangle will correspond to the legend below the diagram. A slider enables you to determine where in the path the setting applies by choosing the number of ASes from each end of the diagram (after source on left; before destination at right) that will be collapsed.
    - Site: All nodes within the same site will be jointly represented by a single circle rather than as individual hops.
  • Highlight Latency: A drop-down that shows a field that allows you to specify the milliseconds of latency above which diagram elements will be highlighted.
  • Highlight Packet loss: A drop-down that shows a field that allows you to specify the percent of loss above which diagram elements will be highlighted.
  • Collapse Timeouts: If on (default) nodes from which there is no response are collapsed together in the diagram.
  • Highlight links exceeding geo latency estimate: A switch that turns on highlighting for links whose measured latency is greater than expected based on the estimated distance between hops (calculated using Geo IP).
  • Reset: Restore the Path View settings to defaults.

Note: The above settings persist for your subsequent visits to this details page.

 
top  |  section

Path View Diagram

The Path View diagram is a visualization of the nodes and links in the path taken from source to destination by the traceroutes for the subtests (e.g. from one agent to one IP in a given AS) in the test corresponding to this Test Details page. The time slice covered by the diagram is determined by the current time slice of the Path Hops and Geo Distance timeline at the top of the tab (see Path View UI). You can change the time slice by hovering over that timeline.

The diagram is structured as follows:

  • The sources (e.g. agents) are represented in the diagram as labeled rectangles at the far left.
  • The target (e.g. the IP in an IP Addresses test) is represented as a circle at the right.
  • Each hop is represented as a circle whose color identifies it as belonging to one of the ASes listed in the Path key.
  • A hop that is indicated as an empty circle is "unidentified" (non-responsive).
    Note: If the Collapse Timeouts switch is on (default) a contiguous series of unidentified hops that are in the middle of the path (neither the first two after the source nor the last two before the target) will be represented with a single circle stating the number of unidentified hops it represents.
  • Each link between hops is represented as a line, the type and color of which indicates the characteristics of the link (see Path View Lines).
  • Depending on the complexity of the diagram, when the diagram is loaded some paths may be collapsed to enhance visual clarity. Each such path is represented by a green circle that is labeled "Collapsed Path." To view the individual nodes of a collapsed path, click the circle to expand the path.

Notes:
- Links that exceed user-specified latency and hops that exceed user-specified loss may be highlighted (see Path View Controls) to draw your attention to problem areas.
- Hover over a source, target, hop, or link to open a popup with details about that link (see Path View Popups).

The Path View diagram shows the traceroutes from the subtests in a test at a given time slice.

Path View Lines

The type and color of the line representing a link between hops indicates the following characteristics of the link:

  • Both nodes identified: We have detected the IP address of the nodes at both ends of the link.
  • Threshold exceeded: The latency or packet loss on the link is in excess of a threshold determined in one of the following ways:
    - Compare packet loss with the Highlight threshold set manually by the user (see Path View Controls).
    - Compare latency with the Highlight threshold set manually by the user.
    - If the Highlight links exceeding geo latency estimate switch is on, compare latency with expected values calculated based on the distance between hops.

The table below shows how the conditions above determine the type and color of the line.

Line type and color Both nodes identified Threshold exceeded
Solid gray Yes No
Dotted gray No No
Solid red Yes Yes
Dotted red No Yes

 
top  |  section

Path View Popups

Hovering over a source, node (hop), link, or target will open an information popup. Popup contents vary depending on the type of element. For nodes the following additional factors influence the information we have available to show:

  • If this is a customer node that is sending flow data and SNMP to Kentik.
  • If it is a customer node, the SNMP metrics it is configured to send.
  • If we’re able to do a reverse DNS lookup to get the hostname.

The information popups may contain the following types information:

  • Source information:
    - Agent name: The name of the agent.
    - Details: AS name, ASN, location, and IP address.
    - Traces: The number of traces from this agent.
    - Collapse other paths: If nodes are expanded on paths other this one, collapse them.
    - Collapse this path: If nodes are expanded on this path, collapse them.
    - Show raw trace data: Opens a popup that displays the actual traceroute text on which the traces for this agent are plotted in the diagram.
  • Node information:
    - IP: The IP Address of the node.
    - Metrics: Loss and latency (the round trip time of the probe for this hop over the current time slice).
    - Details: AS name, ASN, location, and IP address.
    - Traces: The number of traces using this node.
    - More Info: Depending on availability, this pane at the right of the popup may include device name and utilization (CPU and memory), site name, ingress and egress IPs, interface information (e.g. name, type, and capacity), and hostname.
    Note: The information in the More Info pane is always as of the present moment rather than as of the time slice that's currently selected in the timeline.
  • Link information:
    - Metrics: Loss and link latency (the average round trip time of the later probe less the average round trip time of the earlier).
    - From/To: IP/CIDR of the nodes at either end of the link.
    - Traces: The number of traces using this link.
  • Target information:
    - IP: The IP Address of the target.
    - Details: AS name, ASN, location, and IP address.
    - Traces: The number of traces toward this target.
 

Test Details Table

The table on the Results tab of a Test Details page for a given test is covered in the following topics:

The Test Details table shows metrics about the subtests in the test.
 
top  |  section

About the Test Details Table

The Results tab of each Test Details page includes a Test Details table listing the subtests used in this test and providing information about them and their individual results during the current time slice (see Status Time and Scope). The content and layout of the table varies depending on the test type (see Synthetic Test Types).

Note: Subtests with no results are not included in the table.

 
top  |  section

Details Table Columns

The columns of the Test Details table vary depending on the type of the test. The tables below show which columns are included for each test type. For descriptions of the columns, see Standard Detail Columns and Additional Detail Columns.

Note: For information about the heading rows shown in the following tables, see Details Table Heading Rows.

Network Meshes & Grids

Test type Heading row info Agent Target Avg Latency Avg Jitter Packet Loss Additional columns
Network Mesh - Agent
- Agent location
- Target count
No Yes Yes Yes Yes No
Network Grid - Agent
- Agent location
- Target count
No Yes Yes Yes Yes No
DNS Server Grid - Agent
- Agent location
- Target count
No Yes No No No - Resolution Time
- DNS Results

Network & Routing Tests

Test type Heading row info Agent Target Avg Latency Avg Jitter Packet Loss Additional columns
IP Address N.A. Yes Yes Yes Yes Yes No
Hostname N.A. Yes Yes Yes Yes Yes No
SaaS Application - Agent
- Agent location
- Target count
No Yes Yes Yes Yes No
Agent-to-Agent - Agent
- Agent location
- Target count
No Yes Yes Yes Yes No
BGP Monitor - Prefix
- Counters (Announcements, Unexpected Origins, Withdrawals)
No No No No No - Type
- Prefix
- Origin AS
- AS Path
- AS Path Length
- Total
- RPKI Status
- Dataset

Web Tests

Test type Heading row info Agent Target Avg Latency Avg Jitter Packet Loss Additional columns
HTTP(S) or API N.A. Yes No Yes Yes Yes - Status Code
- Response Size
- Domain Lookup Time
- Connect Time
- Response Time
- Avg HTTP Latency
Page Load N.A. Yes No No No No - Status Code
- CSS Validation
- Response Size
- Navigation Time
- Domain Lookup Time
- Connect Time
- Response Time
- DOM Processing Time
- Avg HTTP Latency

Autonomous Tests

Test type Heading row info Agent Target Avg Latency Avg Jitter Packet Loss Additional columns
ASN - Agent
- Agent location
- Provider
- Target count
No Yes Yes Yes Yes - Provider
- Connectivity Type
- Potentially Impacted Traffic
CDN - Agent
- Agent location
- Provider
- Target count
No Yes Yes Yes Yes - Provider
- Connectivity Type
- Potentially Impacted Traffic
Country - Agent
- Agent location
- Provider
- Target count
No Yes Yes Yes Yes - Provider
- Connectivity Type
- Potentially Impacted Traffic
Region - Agent
- Agent location
- Provider
- Target count
No Yes Yes Yes Yes - Provider
- Connectivity Type
- Potentially Impacted Traffic
City - Agent
- Agent location
- Provider
- Target count
No Yes Yes Yes Yes - Provider
- Connectivity Type
- Potentially Impacted Traffic

DNS Tests

Test type Heading row info Agent Target Avg Latency Avg Jitter Packet Loss Additional columns
Server Monitor - Agent
- Agent location
- Target count
Yes Yes No No No - Resolution Time
- DNS Results

Details Table Heading Rows

For tests with subtests that originate from multiple sources (i.e. multiple agents in an ASN test) the information that would otherwise be presented in the Agents column (see Standard Detail Columns) of the Test Details table is presented in heading rows. Each heading row represents one "from" agent and precedes the set of standard rows that represent the targets of that agent's subtests, serving to group the targets by their "from" agent.

 
top  |  section

Standard Detail Columns

The following columns in the Test Details table are common to most test types:

  • Agent: Information about the "from" agent that is the source of the subtest that is represented by this row of the table, including:
    - Type (icon): The type of agent, either global (Kentik icon) or private (see About Synthetics Agents).
    - Location: The country and city of the site where the agent is hosted or, for public cloud agents, the name of the cloud region where the agent is deployed.
    - Status: The agent's current status (see Agent Status).
    - AS: The name and number of the Autonomous System in which the agent is deployed.
  • Target: A target is the network entity toward which a subtest is testing. If the targets of this test's subtests are not agents then this column will be populated with the IP addresses of those targets. If the targets are agents then this column provides type, location, status, and AS information as described above for the agent column.
  • Avg Latency: Latency on the tested path, averaged over the currently selected time slice.
  • Packet Loss: The percent of packets lost on the tested path over the currently selected time slice.
  • Avg Jitter: Jitter on the tested path, averaged over the currently selected time slice.
  • View Details: A button that takes you to the Subtest Details Page for this subtest.
 
top  |  section

Additional Detail Columns

The following topics cover additional columns that appear in the Test Details table but are specific to individual test types.

DNS Test Columns

The following columns are specific to DNS tests (Server Grid and Server Monitor):

  • Resolution Time: The average time, for DNS queries made during the current time slice, from making the query to receiving the response.
  • DNS Results: All DNS results (of the type specified in the test configuration) returned during the currently displayed time slice.
    Note: If more than one result was returned there will be an expand icon (right-facing triangle) to the left of the result shown in the table cell. Click the cell to display a drop-down with the full list.

BGP Monitor Test Columns

The following columns are specific to BGP Monitor tests:

  • Type: The type of BGP event, either route announcement, route withdrawal, or invalid origin.
  • Prefix: The prefix associated (announced, withdrawn, or invalid) with the event.
  • Origin AS: The name and number of the Autonomous System (AS) from which the event originated.
  • AS Path: The path that the event information took in getting from the origin AS to the vantage point, indicated by ASNs traversed hop-by-hop along the way.
  • AS Path Length: A count of the ASNs from and including the origin AS to the AS containing the vantage point.
  • Total: The total number of events with the same type, prefix, and AS that were observed over the time period (the last 12 hours unless a 10-minute period is currently selected in the timeline).
  • RPKI Status: The RPKI status for the prefix and the AS announcing it. The status will typically be Valid or Invalid. Other possible values are Not Found, Unknown, and Validation Error.
    Note: RPKI status is shown for announcements and unexpected origin events but not for withdrawals.
  • Dataset: The dataset from which the event was returned (see BGP Event Datasets), either "route-views" (Route Views) or “kentik” (Kentik private peers).

HTTP(S) or API Test Columns

The following columns are specific to HTTP(S) or API tests:

  • Status Code: The HTTP Return Code (see Host Traffic Dimensions) returned during the currently displayed time slice.
    Note: A subtest for which multiple status codes were returned during the time slice will be represented in the Test Details table by multiple rows.
  • Response Size: The average size, over the currently displayed time slice, of the HTTP responses returned to the source agent.
  • Domain Lookup Time: From when the domain lookup starts to when the domain lookup is finished.
  • Connect Time: From when the request to open a connection is sent to the network to when the connection is opened.
  • Response Time: From when the first byte of the response is received to when the last byte of the response is received.
  • Avg HTTP Latency: The average time, for HTTP requests made during the currently displayed time slice, from making the request to receiving the last byte of the response. This figure is the sum the columns Domain Lookup Time, Connect Time, and Response Time.

Page Load Test Columns

The following columns are specific to Page Load tests:

  • Status Code: The HTTP Return Code returned during the currently displayed time slice.
  • Navigation Time: From when the browser has received the HTTP request to when it is ready to fetch the document.
  • Domain Lookup Time: From when the domain lookup starts to when the domain lookup is finished.
  • Connect Time: From when the request to open a connection is sent to the network to when the connection is opened.
  • Response Time: From when the first byte of the response is received to when the last byte of the response is received.
  • DOM Processing Time: From when the browser starts to render the page to when the page is fully loaded. This corresponds to the time between domLoading and LoadEventEnd.
  • Avg HTTP Latency: This figure is the sum of the columns Navigation Time, Domain Lookup Time, Connect Time, Response Time, and DOM Processing Time.

Autonomous Test Columns

The following columns are specific to Autonomous tests (ASN, CDN, Country, Region, City):

  • Provider: The Provider (see Interface Classification Dimensions) of the interface corresponding to the IP address that was associated with this subtest during the currently displayed time slice.
  • Connectivity Type: The Connectivity Type (see Understanding Connectivity Types) of the interface corresponding to the IP address that was associated with this subtest during the currently displayed time slice.
  • Potentially Impacted Traffic: The volume of real-world traffic on the tested path as determined based on the flow data your organization is sending to Kentik.
    Note: This determination requires correct setup of Interface Classification. For assistance please ask Customer Support.
 

Subtest Details Page

The details pages for individual subtests are covered in the following topics:

The Subtest Details page shows details about an individual subtest in a test.

Note: There are no subtests, and thus no Subtest Details pages, for tests whose type is BGP Monitor.

 
top  |  section

Subtest Details UI

The Subtest Details page for an individual subtest includes the following UI elements:

  • Subtest SubNav controls: The Subtest Details page includes the following UI elements on the SubNav (light gray strip at the top of the page):
    - Share (on SubNav): Opens the Share dialog to enable you to share the current view (see Sharing via the Share Dialog).
    - Actions (on SubNav): A drop-down menu from which you can choose to export the current view as a visual report (PDF) covering the page’s visualizations and tables. A notification appears when the PDF is ready to download.
  • Subtest identifier: A heading at the upper left of the page identifies the test by showing what it is testing from and toward. In the case of a subtest from one global agent to another, for example, the "from" could be "Chicago, IL, United States" and the "toward" could be "New York, United States."
    Note: When the from or toward is an agent:
    - An icon to the left of the agent name indicates the agent's type (global or private).
    - A field below the agent name indicates the cloud region if the agent is in a public cloud, or the AS name and number if the agent is in a data center.
  • Status: The current (most recent time slice) overall status of the subtest (see Synthetic Test Status).
  • Time Range: The lookback period covered by the timeline.
  • Details tabs: Different views of the test results for the currently selected time slice. Depending on the type of test (see Synthetic Test Types) the following views may be available:
    - Metrics: A set of charts detailing the results from this subtest over the currently selected time range (see Subtest Metrics Tab).
    - Path view (not present for Page Load subtests): A graphical representation of traceroute data from this subtest. The layout of this tab is the same as described in Test Path View, but only the traceroute for this individual subtest is shown.
    - Insights (not present for Page Load subtests): A list of insights (see About Insights) related to synthetic testing that help you spot anomalies, e.g. comparing latency metrics for the last hour with the average latency observed over the last week (for details, see About Test Details Tabs).
    - Waterfall (Page Load and Transaction tests only): Shows the load order and load duration of each element in the DOM of a tested page (see Subtest Waterfall Tab).
    - Results (Transaction tests only): Shows the total completion time for the transaction as well as screenshots (if any are specified in the Puppeteer script) showing the state of the browser contents (see Subtest Results Tab).
 
top  |  section

Subtest Metrics Tab

The Metrics tab on the Subtest Details page for a given subtest includes the following main components:

  • Timeline: An overall timeline, representing the currently selected time range, that is present on the Metrics tab for tests of every type (see Metrics Tab Timeline).
  • Metrics charts: A set of charts, varying by test type, that detail the results from this subtest over the currently selected time range (see Metrics Tab Charts).
The Metrics tab shows charts illustrating subtest metrics.

Metrics Tab Timeline

The Metrics tab timeline is a visual representation of the currently selected time range that shows the overall status of the subtest for each time slice in the range (see Status Time and Scope). By default, the latest time slice (far right) is selected, meaning that this is the slice for which details are given in the Metrics Tab Charts. Hovering anywhere in the timeline changes the selection to the time slice at that point, causing a corresponding change to the information displayed in the charts and opening a popup over the timeline that gives the start time and overall status of the selected slice.

Metrics Tab Charts

In each of the metrics timelines, the solid line plots the metrics values measured for the time slices over the time range (see Status Time and Scope). The shaded areas, which show the rolling standard deviation in the metric over the range, are colored to indicate the metric's status during each time slice. Hovering on the timeline for a given slice opens a popup with values for that point in time on the main (top of page) timeline as well as on each of the charts on the metrics tab.

Metrics Chart Locations

As shown in the table below, the charts on the Metrics tab vary depending on the type of the test to which the subtest belongs.

Test type Traffic Latency Packet Loss Jitter Additional charts
Network Meshes & Grids:
Network Mesh No Yes Yes Yes No
Network Grid No Yes Yes Yes No
DNS Server Grid No No No No - DNS Results
- Resolution Time
Network & Routing:
IP Address Yes Yes Yes Yes No
Hostname Yes Yes Yes Yes No
SaaS Application Yes Yes Yes Yes No
Agent-to-Agent No Yes Yes Yes No
BGP Monitor (NO SUBTESTS)          
Web Tests:
HTTP(S) or API Yes Yes Yes Yes - HTTP Stages Breakdown
- HTTP Latency
- HTTP Status Code
Page Load No No No No - HTTP Stages Breakdown
- HTTP Latency
- HTTP Status Code
Transaction No No No No - Total Completion Time
- Screenshots
Autonomous:
ASN Yes Yes Yes Yes No
CDN Yes Yes Yes Yes No
Country Yes Yes Yes Yes No
Region Yes Yes Yes Yes No
City Yes Yes Yes Yes No
DNS Tests:
- Server Monitor No No No No - DNS Results
- Resolution Time

Note: For mesh and agent-to-agent tests, traffic charts are present only if the Site IP Classification setting in the Add Site/Edit Site dialog (see Manage Sites) includes at least one valid IP address in any one of the three fields.

Standard Metrics Charts

The following charts in the Metrics tab are common to most test types:

  • Traffic: The bitrate of actual inbound and outbound traffic over the currently specified time range, averaged within each time slice and plotted against a single timeline (inbound positive Yes axis, outbound negative):
    - Inbound: From the subtest's "toward" entity (e.g. hostname, ASN, etc.).
    - Outbound: To the subtest's "toward" entity.
  • Metrics timelines: Three timelines that plot the following metrics over the currently selected time range, averaged within each time slice:
    - Latency (ms): Latency on the subtest path.
    - Packet Loss (%): The percent of packets lost on the subtest path.
    - Jitter (ms): Jitter on the subtest path.

Note: A test may fail for some or all of the currently specified time range. Test failure may be caused by a timeout (the test took too long to complete) or by errors (e.g. agent or OS error). When a test fails during a given time period no results are available to plot for that period in the metrics timelines. The way this condition is indicated in the charts depends on the type of chart and the kind of failure:

  • For both latency and jitter the results plot will have a gap corresponding to the duration of the failure.
  • For packet loss:
    - If the failure is due to error, there will be a gap in the results plot.
    - If the failure is due to timeout, packet loss will be shown as 100%.

Additional Metrics Charts

The following charts are only found on the Metrics tab for a limited number of test types:

  • HTTP(S) or API tests:
    - HTTP Stages Breakdown: The stacked bar chart showing the amount of time, averaged within each time slice, spent in the key stages of an HTTP transaction: Domain Lookup Time, Connect Time, and Response Time, the sum of which is the time shown in the Avg HTTP Latency chart. Breaking HTTP Latency into component parts helps troubleshooting slow HTTP response or long page load times.
    - Avg HTTP Latency: The time, averaged within each time slice, from making an HTTP request to receiving the last byte of the response.
    - HTTP Status Code: The HTTP Return Codes (see Host Traffic Dimensions) returned over the time range.
  • Page Load tests: In addition to the charts displayed for HTTP(S) or API tests, the Metrics tab of a Page Load test may include the following additional chart:
    - CSS Selectors: If CSS selectors are configured for this test (see About Configure Request Settings) the Metrics tab will include a time series chart that shows a count of those configured selectors that were found in the loaded page. When you hover over the chart, a popup opens that shows which selectors were configured and found/not found at that point in the timeline.
  • DNS Server Monitor tests:
    - DNS Results: All DNS results (of the type specified in the test configuration) returned over the currently specified time range.
    Note: The results are not displayed against a timeline.
    - Resolution Time: The time, averaged within each time slice, from making a DNS query to receiving the response.
 
top  |  section

Subtest Waterfall Tab

The Waterfall tab shows the load order and load duration of each element in the DOM of a page tested with a page load test (see Page Load under Web Tests in Synthetic Test Types). The source of the presented information is a HAR file exported from the headless Chromium browser instance running in a ksynth App agent (see Synthetic Agent Types).

The Waterfall tab shows the load order and load duration of each element in the DOM.

Waterfall Tab UI

The Waterfall tab includes the following controls and information:

  • Timeline: Like the Metrics Tab Timeline, the timeline in the Waterfall tab is a visual representation of the selected time range, with each segment representing an increment within that range. The segment whose test results are currently displayed in the resources list is outlined in green. If the duration of the individual increments is greater than the testing frequency set for this page load test then the results shown in the list will actually be an average of the tests run during that time increment.
  • Filter: Filter the resources shown in the table to those that match the text enter in the field. The drop-down selector determines what will be matched:
    - URL: Matches text that appears in the URL of the requested resource.
    - Body: Matches text that appears in the response body of the requested resource.
  • Type Selector: Choose the resources that will be displayed in the table, either all types or one or more individual types (JavaScript, CSS, image, etc.).
  • Resources List: A list of the resources requested by the tested page (see Waterfall Resources List).

Waterfall Resources List

The list in the Waterfall tab includes the following columns that provide detailed information on the download of each resource requested by the tested page:

  • File: The name of the requested resource.
  • Status: The HTTP status returned in the response to the request for the resource.
  • Method: The HTTP method of the request for the resource.
  • Domain: The domain from which the resource was requested.
  • Type: The MIME type of resource (e.g. HTML, CSS, JavaScript, etc.).
  • Size: The size of the resource in bytes.
  • Time: The duration in milliseconds between when the resource was initially requested and when it was completely downloaded.
  • Waterfall: A visual representation of the download of each resource and of the entire page. The download for each resource is represented by a horizontal bar made up of multiple segments, each of which is colored to correspond to a different phase of the download (stalled, DNS lookup, SSL, initial connection, request sent, waiting, content downloaded). Hovering on the bar opens a popup that shows the duration of each phase as well as the total download time for the resource.
 
top  |  section

Subtest Results Tab

The Results tab on the Subtest Details page for a Transaction subtest includes the following main components:

  • Timeline: An overall timeline, representing the currently selected time range and segmented into time slices. The timeline is the same as the timeline on a Metrics tab (see Metrics Tab Timeline). Hovering on a given time slice opens a popup on the timeline with the health status for that time slice as well as a popup over the completion time chart containing completion time values for that time slice.
  • Total Transaction Completion Time: A chart that plots (as a solid line) the transaction times measured for the time slices over the time range. The shaded area around the plot shows the rolling standard deviation in completion time over the range. Both the plot and the shaded areas are colored to indicate the metric's status during each time slice.
  • Screenshots: A set of screenshots for the time slice corresponding to the currently selected segment of the timeline. The screenshots are taken at points specified in the Transaction test script (see About Transaction Test Scripts).
    Note: Screenshots will not be present for a given time slice if the health status during that time was Critical (red).
 

BGP Monitor Details Page

The details page for a BGP Monitor test is covered in the following topics:

 
top  |  section

BGP Monitor Page Overview

A details page for a BGP Monitor test includes the SubNav Test Detail Controls and the Main Test Details that together comprise the standard UI at the top of every Test Details Page. Every BGP Monitor page also includes the health timeline (see Results Tab Elements) found at the top of the Results tab on details pages for tests in the Autonomous category. The structure of the rest of the page, however, varies from the details pages for other test types. For BGP Monitor tests, the content of a details page is structured around two panes that each contain multiple elements.

Notes:
- On the details page for a BGP Monitor test, the maximum valid duration that can be set with the Time Range control (see Main Test Details) is one day.
- BGP Monitor tests have no subtests and thus no subtest details pages.

A BGP Monitor details page with one chart displayed in each of the two main content panes.

Upper Pane Elements

The upper pane contains the following main elements:

  • Reachability/Visibility: A time series chart showing the percentage of vantage points (BGP routing data collectors; see BGP Event Datasets) that are able to reach the currently specified prefixes over the currently specified time range (see Reachability Time Series).
  • AS Path Changes: A time series chart showing the number of AS path changes observed by the vantage points during the currently specified time range (see AS Path Changes Time Series).
  • BGP Events: A time series vertical bar chart showing the occurrence of BGP events over the currently specified time range (see BGP Events Time Series).

Lower Pane Elements

The lower pane contains the following main elements:

  • AS Path Visualization: A diagram showing the AS Paths at the currently specified point in the time range (see AS Path Visualization).
  • Events Table: A list of BGP events for the prefixes being monitored, grouped by AS Path per prefix (see BGP Events Table).

Note: For the elements in this pane the "currently specified time" doesn't change when you hover over the health timeline; you must click in the timeline to change the time.

 
top  |  section

Chart Display Controls

While all of the BGP Monitor elements listed above are available for display, you can determine which elements are currently displayed using two sets of controls, one for the set of three elements in the upper pane and the other for the remaining two in the lower pane.

Notes:
- The upper and lower panes can't both be hidden at the same time.
- When one of the panes is hidden, the control to show it again will be present in the control set of the other pane.

Upper Pane Controls

The first three time series elements are displayed in the upper pane below the page's main timeline. The following controls appear at the top of that pane:

  • Show: A drop-down from which you choose which of the time series elements will be displayed: all, Reachability/Visibility only, AS Path Changes only, or BGP Events only.
  • Prefix: A drop-down from which you choose the prefix whose information is displayed in all three of the time series visualizations. The prefixes available on the drop-down are those that were specified when the test was created (see Prefixes to Monitor under BGP Monitor in Network & Routing Tests).
  • Specific Prefix: A drop-down, present if the Include more specific prefixes switch was on when the test was created, from which you can choose a more specific prefix to show in the time series charts. Choose Clear to revert the charts to the more general prefix selected in the Prefix drop-down.
  • AS filter: A checkbox that appears only when an AS has been clicked in the AS Path Visualization. The checkbox is labeled with the ASN of the AS that was clicked, and it indicates that the page's time series charts, path diagram, and events table have all been filtered to include only information related to that AS. To remove the filter, uncheck the checkbox.
  • Hide Timelines: Toggle on or off the display of the entire upper pane, including the other controls and the time-series charts themselves.
Controls for the upper pane.

Lower Pane Controls

The remaining two main elements appear in the lower pane, which is controlled with the following controls:

  • Show: A drop-down from which you choose which of the lower pane elements will be displayed: Events Table only or AS Path Visualization only.
  • Filter (present only when Events Table is displayed): A set of checkboxes that enable you to include or exclude different types of events from the table: all announcements, announcements of unexpected origin, invalid RPKI, and withdrawals.
  • Hide: Toggle on or off the display of the entire lower pane, including the other controls and the content of the pane. The full label of the control varies depending on which content is currently visible in the pane:
    - Hide Events Table: Present when Events Table is displayed.
    - Hide Paths Graph: Present when AS Path Visualization is displayed.
 
top  |  section

Chart Display Mode

The way that the Reachability/Visibility and AS Path Changes charts on the BGP Monitor details page are rendered depends on the prefixes being monitored:

  • Single prefix, single AS: The chart is rendered with a single color.
  • Single prefix, multiple ASes: The chart is rendered with a different color assigned to each AS.
    Note: This mode occurs when a prefix is advertised by more than one AS, indicating a possible hijack.
  • Multiple prefixes: The chart is rendered with a different color assigned to each prefix.
    Note: Multiple-prefix monitoring occurs when the Include more specific prefixes switch was on when the test was created (see BGP Monitor in Network & Routing Tests) but no specific prefix is selected in the Specific Prefix drop-down (see Chart Display Controls).
 
top  |  section

Reachability Time Series

The BGP Monitor Reachability/Visibility time series chart shows the reachability of the target prefix over the currently specified time range. At each increment in the time range (e.g. each minute when the time range is one day) the chart shows the vantage points (public BGP routing data collectors) that are able to reach the target prefixes as a percent of all Kentik-utilized vantage points.

The way the chart is filled in depends on the Chart Display Mode:

  • Single prefix, single AS: The area below the plot line will be filled in with a single color.
  • Single prefix, multiple ASes: The area corresponding to the percent of reachability via each AS will be filled in with a different color.
  • Multiple prefixes: Each prefix is rendered in its own separate line with its own color.

Hovering at a given point in the chart opens a popup that shows the AS (or ASes, if there's been a hijack) that advertised the prefix and the reachability percent at the corresponding increment in the time range.

 
top  |  section

AS Path Changes Time Series

This time series chart shows any changes in the AS Path to a monitored prefix as observed from all vantage points. The changes are rendered as a spike extending up from the chart's timeline; the more changes at a given increment in the time range, the taller the spike. If the page is in multi-prefix mode (see Chart Display Mode) the spikes will be colored according to the prefixes involved; otherwise the spikes will be in a single color. Hovering over the chart opens a popup stating the time and the number of changes for each prefix.

Hovering on the chart opens a popup with details about the path changes at that time increment.
 
top  |  section

BGP Events Time Series

This time series chart gives a visual summary of the BGP events over the currently selected time range that are related to the ASNs and IP prefixes specified in the test (see Prefixes to Monitor under BGP Monitor in Network & Routing Tests). Each bar represents the events during the currently hovered time increment. The height of the bars represents the number of announcements or withdrawals during the time increment (the taller the bar the more events). Click on a bar to filter the BGP Events Table to show only events that occurred during that time increment.

The bars are color-coded as follows:

  • Positive axis green: Route announcements.
  • Positive axis red: Route announcements from unexpected origin ASNs.
  • Negative axis purple: Route withdrawals.
 
top  |  section

AS Path Visualization

This diagram shows the AS paths via which, at the currently selected increment in the time range, the monitored prefix was reachable from one or more vantage points. The hops (ASes) in each path are represented as shaded rectangles, with the monitored prefix on the right and the AS containing that prefix second from right. The rectangles are connected by lines that represent the links between the shown hops.

To reduce clutter, if less than three percent of the vantage points advertise an AS in their paths to the monitored prefixes then that AS is "pruned" from the diagram, meaning that neither the AS nor the upstream paths to it will be shown.

The following information is shown in the rectangle representing each AS:

  • ASN: The AS number of the hop.
  • AS name: The AS name of the hop.
  • Vantage points (binocular icon): Indicates that the AS either includes one or more vantage points itself or is the first shown AS in a path that has been pruned upstream (thereby hiding the AS in which a vantage point actually exists).

Notes:
- For this diagram (unlike the time series charts) the "currently specified increment" doesn't change when you hover over the health timeline. You must click in the timeline to update the path diagram to a new point in time.
- When an AS is clicked in the diagram, the page's time series charts, path diagram, and events table are all filtered to include only information related to that AS. A checkbox, labeled with the ASN of the clicked AS, will appear in the control set of the page's upper content pane (see AS filter in Chart Display Controls). To remove the filter, uncheck the checkbox.

AS Popup

The popup that's displayed when you hover over an AS includes the following information:

  • Vantage points: The number of vantage points in the AS.
  • Transiting paths: The number of advertised paths from a vantage point to a monitored prefix that include this AS.
  • Pruned paths: The number of paths upstream of the AS that were pruned because their ASes were advertised in less than three percent of the paths from all vantage points to the monitored prefixes.
  • Show Vantage Points: A link that pops up a list of the vantage points that exist within this AS or in an upstream AS in a pruned path for which this is the first shown AS. For each such vantage point, the list shows the following information:
    - Collector: The device (physical or virtual) with which the vantage point is peered in order to share BGP routing information. The displayed value is a concatenation of the dataset for which the device collects information and the name that the dataset provider has assigned to the device.
    - VP (peer) ASN: The AS number of the vantage point.
    - VP (peer) IP: The IP address of the vantage point.
    - AS Path: The vantage point's best route to the monitored prefix.
 
top  |  section

BGP Events Table

The Events Table on the BGP Monitor page provides additional details about the events shown in the BGP Events Time Series. The structure and behavior of this table is the same as the BGP Events List in the BGP Route Viewer.

The Events Table shows details about BGP events.
© 2014- Kentik
In this article:
×