- In the custom dashboard, add a tile (Add Tile) if necessary and click to open the Tile Configurator.
- Click the tile to open the Tile Configurator.
- Optionally, enter a chart Title.
- Click a tile icon to select a chart type. See Chart Types below for descriptions.
- Specify the configuration details depending on the chart type—choose tests and metrics. See Tile Configuration Details below. Some tiles have Additional Configuration Details.
- When you have selected tests and metrics for your tile, optionally, click Advanced settings to specify a tile-specific time frame and chart resolution (data bucketing).
- Click Done.
|Dual axis line/stacked bar chart||Display data series with different units. The left y-axis displays the data series as a line chart and the right y-axis displays a stacked bar chart. To create only a line chart (with no bar chart), assign a metric to the left y-axis only. If you choose more than one metric, or one metric split by some factor, the bar chart is stacked. You can select multiple metrics for each y-axis as long as they share the same unit, e.g., DNS time and response time. If you choose two metrics with different units for the same y-axis, the second one will be dropped. The x-axis represents a time period. You can use this chart to display trends, e.g., performance and availability.|
|Dual axis bar/line chart||Display data series with different units. The left y-axis displays the data series as a bar chart (unstacked) and the right y-axis displays a line chart. To create only a bar chart (with no line chart), assign a metric to the left y-axis only. You can select multiple metrics for each y-axis as long as they share the same unit, e.g., DNS time and response time. If you choose two metrics with different units for the same y-axis, the second one will be dropped. The x-axis represents a time period. You can use this chart to display trends, e.g., performance and availability.|
|Dual axis stacked bar/line chart||Display data series with different units. The left y-axis displays the data series as a stacked bar chart and the right y-axis displays a line chart. To create only a stacked bar chart (with no line chart), assign metrics to the left y-axis only. If you choose more than one metric, or one metric split by some factor, the bar chart is stacked. You can select multiple metrics for each y-axis as long as they share the same unit, e.g., DNS time and response time. If you choose two metrics with different units for the same y-axis, the second one will be dropped. The x-axis represents a time period. You can use this chart to display trends, e.g., performance and availability.|
|Stacked percentage bar chart||Compare parts of a whole over time by viewing them as a percentage. Choose multiple metrics that constitute a whole, or view a single metric split by some dimension, e.g., view user experience times for a multi-page test split by page. The stacked percentage bar for each data point will show the UX time for each page as a percentage.|
|Pie chart||Plot a compound metric and its components as a snapshot of a time period. For example, view total network time split by page to see the portion of network time taken by each page over the last hour (or other time period).|
|Area chart||View a trend as a shaded area rather than a line. When you apply multiple tests, metrics, or split a metric, the resulting series are visualized on top of each other as independent values.|
|Stacked area chart||Visualize the percentage of each part of a data series as a shaded area. For multiple metrics that constitute a whole, or a single metric split by some dimension, visualize a trend as shaded areas, where each part is expressed as the percentage of a whole.|
|Meter chart||Visualize comparisons between measures in side-by-side bar charts. Use this chart to graph comparisons of average values, e.g., the average network time (for a given time range) for different tests, or multiple metrics for multiple tests, e.g., total time and user time for two separate tests.|
|Gauge chart||Chart a single series to show where its average value lies on a gauge between its maximum and minimum values. You can only choose one test and one metric (with no splitting) or you will see the error "Maximum of 1 series exceeded."|
|Scatter chart||View data points for test runs so you can quickly isolate outliers and identify patterns for performance, network time, or any other metric.|
|Measure chart||Display a trend as well as an average (or maximum/minimum) value for a single metric. You can only choose one test and one metric (with no splitting) or you will see the error "Maximum of 1 series exceeded."|
|Synthetic tests||Display average availability, average response time, severity status, number of failures, and test steps for selected tests. For each test, you can also quickly identify service (TxP, MWP, or ApP) and browser. Severity status thresholds are the same as used for the Operational summary. See Custom Dashboard Workflows for drill-downs available from this chart. There is no limit to the number of tests you can add to the tile, but we recommend adding no more than 100.|
|Image||Display an image of any format (JPG, PNG, GIF, etc.). The image must be hosted on the Internet. You can configure the image as a link to a URL, so that clicking the image opens a new tab displaying the target web page (enter the URL of the web page in the Link URL field). If the image size is greater than the tile size, the image is scaled down to fit the tile.|
Tile configuration details
Chart tiles offer configuration options for choosing tests and metrics, and for splitting up metric data by available dimensions. For example, you can view availability over a time period for the whole test or for individual pages in the test (splitting by page).
In advanced settings, you can optionally choose a tile-specific time frame and resolution (data bucketing)—if not, the chart defaults to the dashboard time range and the corresponding automatic resolution.
The Keynote Portal makes several metrics available via the NextGen API for graphing.
Select a chart type from the tile icons.
The Synthetic Tests tile only requires test selection; metric selection and configuration details below do not apply.
The Image tile allows for displaying an image; test and metric selection and configuration details below do not apply.
Optionally, type a display name in the Title field.
Select a test(s).
Click Add test to display a list of tests.
Use the Optional filter to view tests of specific services—TxP, MwP, and ApP.
Tests are listed in alphanumeric order. Filter the list further by any string to find a test. Click to select tests; click again to deselect a test; Ctrl-click to select multiple tests.
Selected tests are highlighted; the tile preview displays how many tests are selected.
Select a metric.
Click Next to display the metrics list.
Click to select a metric—you can select one metric at a time.
The dual-axis chart types allow you to define different metrics for each y-axis—see Additional Configuration Details.
If data is available for the time period chosen you can see a Preview of the graph.
It's a good idea to check the Operational summary when configuring a chart tile to see if data is available for your selected tests and time range.
Configure the metric.
Click Next to display the Edit measure screen.
Select the Splitting factor. Splitting groups or splits the data by the selected factor. For example, in a trend graph, if you choose to split total time by city, you will see a trend line for total time in each available city.
If you choose to view total time in a pie chart split by page, the pie chart shows the pages as slices of the total network time.
In pie charts, be sure to choose a splitting factor that adds up to the metric value. For example, the network time (total time) of pages in a test add up to the network time of the test as a whole. Splitting by city, however, does not make sense in a pie chart as the network time in different cities do not add up to the network time of the test as a whole.
While, most chart types allow for a maximum of 20 series (tests x metrics x splitting factors), note that it doesn't always make sense to have more than one test (as in the pie chart or stacked area chart).
The gauge and measure charts only allow a single series.
There is no limit on the number of tests you can add to the Synthetic tests tile. However, we recommend no more than 100.
Optionally, provide a Display name to replace the metric name in the chart. If you do not choose a display name, the full metric name is shown in the chart legend. If you do not want the metric (or display) name in the legend, toggle Prepend measure/display name in legend off.
Click Done to finish configuring your metric. The Preview pane shows the completed chart.
The configuration pane displays the test(s) and number of metrics defined for the chart. From this screen, you can:
- Add tests (Add test )
- Add metrics (click on the measure link) as appropriate for your chart tile
- Change the color of chart series (click on the measure link)
See Edit a Chart Tile below for adding tests or metrics to your tile or changing the default color of chart series.
Some chart types have additional options in this workflow (such as defining different metrics for each y-axis in dual-axis charts)—see Additional Configuration Details below.
Configure the tile time range and resolution in advanced settings (see below).
Click Done to finish configuring the chart tile before resuming creating/editing your dashboard.
Additional configuration details
These chart types have additional configuration details:
Dual axis line/stacked bar, dual-axis bar/line, and dual-axis stacked bar/line charts have two y axes, where you can map metrics with different units. When you first configure these tiles, you pick a metric for the left y-axis. To add a metric:
Click the measure link.
Select Left y-axis or Right y-axis. Optionally, rename the axis, e.g., if selecting an error count, change the axis name to "Count."
Click Add to add a metric for the selected axis.
Pie and meter charts allow you to specify the Displayed items limit, i.e., the maximum number of pie wedges or meters to show. The chart displays the top (n-1) values, and groups the remaining data in "Other."
Enter a Value label to display under the calculated value.
Toggle Show chart to display/hide the trend line (Measure chart only).
Advanced settings appear once you have finished selecting at least one test and metric when configuring a tile, or when you edit a tile after creation. Advanced settings allow you to specify a time range for the chart and resolution, or data bucketing.
You can choose the same time range as the dashboard (default option)—Use dashboard time frame.
Select a Tile specific time frame. The time range controls are the same as in the Operational summary, giving you choices between preset, relative, and absolute time ranges. In view mode, any tile-specific time range is called out at top right.
Chart resolution—choose bucketing, which is the data aggregation interval. The intervals available depend on the time range chosen. Any data points within the interval (bucket) are aggregated. If you do not choose a custom interval, the Auto setting is used.
Edit a chart tile
In dashboard edit mode, click a chart tile to edit it.
Edit tests. If the list is not displayed, click the tests link to display it.
- Click X next to a test name to delete it.
- Add tests: Click Add test to display the list of tests, then select one or more tests, and click Done.
If you remove all tests, metric selections are also removed; you must have at least one test selected for your metric selections to be retained.
Edit metrics. If the list is not displayed, click the measures linkto display it.
Click X next to a metric name to delete it.
Click Add measure to display the list of available measures, then select and configure the measure as described above.
Edit metric configuration: Click the Edit icon for the measure to configure it in the Edit measure screen as described above.
Edit series colors: Click the arrow next to a metric name to show the graph colors associated with its series, e.g., total time grouped by city. Then click the color chip to display the color selector.