Timeline Report

The Timeline report shows various types of KPIs within one graph so you can easily visualize certain events that might have occurred throughout the test.

• View Timeline Report
• Explanation of the KPIs
• View KPIs by Labels
• View KPIs from APM Integrations 
• Download Timeline Report KPI Data

View Timeline Report

As soon as your test starts to collect data, the Timeline Report graph shows. 

Follow these steps:

1. In the Performance tab, select Reports. The most recent reports are shown on top.
   Tip: You can enter a report name in the search field to view the top five reports sorted by execution date.
   
2. Click Show all reports and select a report to view its details.
   A test report overview opens.
3. Click the Timeline Report tab.
   

In the Timeline Report window, the KPI selection panel is on the left.

Explanation of the KPIs

• VIRTUAL USERS shows how many virtual users are currently active.
• HITS (Hits per second) is the number of HTTP/s requests per second that are generated by the test.
• RESPONSE TIME is the amount of time from the first byte sent to the server to the last byte received on the client side.
• LATENCY TIME is the time from sending the request and processing it on the server side, to the time the client received the first byte.
• BYTES is the average bandwidth consumption that’s generated by the test per second.
• ERRORS show how many errors occurred.
• RESPONSE CODES are the response codes received.

View KPIs by Labels

To view KPIs by labels, click the arrow next to each KPI and select the required label from the different options that open.

Example: Hits of Login in the following image.

You can see the KPIs that are available for every label in your test.

You can filter the view of KPIs to save a lot of time and manual effort if you have some tests with many labels. If you type a KPI name in the KPI Selection textbox and click Select All, all the labels under this KPI are selected. The  KPI Selection textbox is case-insensitive.

Response Time Filter

The response time KPI includes many metrics, such as avg, max, min, P90, and so on. If you type a KPI name and a metric in the KPI Selection textbox and click Select All, all the labels under this KPI, together with the specified metric are selected.

If you type response time in the KPI Selection textbox, the Response Time KPI expands. By default, the Avg metric is selected for All.

If you click Select All, the Avg metric checkbox is selected for all labels, and the graph updates accordingly.

You can type the name of any available metric in the KPI Selection textbox. If you type max and click Select All, the Max metric is selected for all labels.

Let's say that at the All level, Avg and Min are selected. You type response time max into KPI Selection and click Select All. At the All level, Avg and Min remain selected.

To clear your selection, click Unselect All. To restore the default settings, click Reset to Default.
You can only enter one metric name at a time in the KPI Selection textbox. 
A new selection adds to an existing selection and does not remove it. Let's say that you enter a metric name in the KPI Selection textbox such as response time max and click Select All. You then replace response time max with response time min and click Select All again. For each label, all the Max checkboxes remain selected, and all the Min checkboxes are selected.

View KPIs from APM Integrations 

KPIs from APM Integration profiles that you included in your test configuration will appear at the bottom of the list, after the built-in KPIs.

Download Timeline Report KPI Data

You can download the KPI data that BlazeMeter uses to build the Timeline Report via a call to the following API:

https://a.blazemeter.com/api/v4/data/kpis?interval={{seconds}}&kpis[]={{kpi}}&ops[]={{operand}}&master_ids[]={{masterId}}&labels[]={{label}}

The above API call includes the following options:

• {{seconds}} 
  The number of seconds between each data point generated.
• {{kpi}}
  The KPI you want to view. This parameter can be used multiple times in the same request to cover as many KPIs as you are interested in.  The list of values is as follows:
  • na: Number of Active threads
  • ec: Error Count
  • t: Response time
  • n: Number of hits per second
  • lt: Latency
  • ts: Timestamp in epoch format
  • by: Bytes per second
  • ct: Connect Time
• {{operand}}
  This is how you find the average, minimum, or maximum values for applicable KPIs. The list of acceptable values is as follows:
  • avg
  • min
  • max
• {{masterId}}
  The master ID of the report you want to see the data from.
• {{label}}
  The label ID of the label you're interested in.

Note: Use of the BlazeMeter API requires authentication per the instructions found in the article Authorization. 

Jump to next section:

• Request Stats Report