Metrics selection

The metrics selection page allows you to change the report items configuration. It can be accessed from any report item through a click on its name/header or on each one of the metrics in its legend:

Upon editing any report item, you will be redirected to the metrics selection page in a new tab:

Add/remove a metric

The bottom left section offers a list of all the metrics configured on this report item, you can click one to select it. You can then use a handful of contextual actions available on the currently selected metric:

Icon	Name	Description
	Add Metric	Adds a new metric to the report item.
	Color Picker	Opens a color picker to override the default metric color.
	Move Up	Moves the metric up in the report item.
	Move Down	Moves the metric down in the report item.
	Duplicate	Add a duplicate of this metric to the graph. Use it if you want to add a similar metric but with a different filter.
	Apply filters	Applies the filters of the currently selected metric to every other metric that supports them, the Hit / Container selection included. A metric a filter does not apply to is left untouched, so monitoring metrics keep the counter they measure. The button is disabled when the selected metric has nothing to propagate.
	Delete	Removes this metric from the report item.
	Export Item	Export this report item. Refer to the dedicated page for more info.
	Save	Save the current configuration and update the report.

Note

Metadata allows you to update the report item metadata and as such cannot be removed or duplicated.

Curve header

In the list of curves, the header of each curve shows at a glance what is customized on it:

Indicator	Meaning
Color swatch	Click it to open the color picker. Its tooltip tells whether the curve uses its default color or a custom one, and how many filter tags apply to the curve.
Axis icon	Shown when the axis of the curve is customized: dedicated axis, logarithmic scale, or both. Click it to open the Configuration panel directly on the Axes section.
Gauge	Shown when the APDEX thresholds of the curve are customized. Its tooltip gives the Satisfying and Tolerating delays.

Tooltips of the axis icon (left) and of the color swatch (right) on a detached curve:

Curve highlighting

The chart at the top of the page helps you see which curve you are working on.

The curve being edited is drawn thicker. The other curves fade but keep their colors, so every curve stays readable:

Hovering a curve in the list highlights it and greys out the others. When you move the mouse away, the chart highlights the edited curve again:

When the Configuration panel is open, all curves are drawn normally.

Multi term filter

Filters on location or virtual user contents are multi term filter, meaning you can select multiple elements from the list:

Warning

In order for the filter to work as expected, make sure to filter elements of similar nature. In other words, do not mix :

• Regions with Injectors,
• Containers with requests.

Metric type

Load

This option allows you to display values related to the number of users running during your test:

Note

The load is a real metric reported by the load generators and not a reconstruction based on your test profile. If a virtual user stops during your test you will be able to see it through this metric.

Actions/containers

This is what we call hit metrics:

• Requests refers to HTTP requests metrics,
• Containers to everything else, including plugins and other custom elements.

The complete list of hit metrics is described here.

Depending on the report item, you can select various filters:

• Location: The geographical region or the load generator,
• Virtual user: The virtual user used,
• User profile: Which user profile of the scenario the measurements come from. The same virtual user can be played by several user profiles, and the Set Up and Tear Down phases of a profile appear as their own entries,
• Action: Once you've selected a virtual user you can also filter on a single action/container.

Note

Since OctoPerf 17.0.0, a measurement is attached to your actions and virtual users by their name and their position, not by an internal identifier.

Note

Some metrics (like Received Bytes) are not available for containers. Selecting those will switch you to Requests instead.

Monitoring metrics

By default monitoring metrics are available for each load generator machine used during the load test. You may have many other monitors available if you configured monitoring connections for the server infrastructure under test.

Filters do not apply to Monitoring metrics.

Info

More information about the monitoring usage are available in the Threshold Usage page.

Axes

By default, all the curves that share a unit also share a Y axis. When their values have very different magnitudes, the smallest curves are crushed at the bottom of the chart. A typical case is the minimum, average and maximum response times shown together, or a small monitoring counter next to a large one.

The Axes section of the Configuration panel lets you fix this. It lists the Y axes of the chart, one block per axis, with the curves each axis carries. Shared axes come first, dedicated axes after them.

In the example below, the average connect time shares the Seconds axis with the latency and the response time. Its values are so small that the curve is hard to read:

Note

The Axes section is available for line charts (including the ones created from monitoring), percentiles charts and bar charts. Bar charts only support the scale setting.

Linear or logarithmic scale

Each axis can be Linear (the default) or Logarithmic. The scale applies to all the curves carried by the axis.

A logarithmic scale gives the same room to each order of magnitude (1, 10, 100, 1000...). Curves of 50 ms and 5 s become readable on the same axis. Here the Seconds axis is logarithmic, and the three curves are readable:

Warning

On a logarithmic axis, values at 0 cannot be drawn and are left out of the curve. The Axes section reminds you of it under the axis. This is why the logarithmic scale is never applied automatically.

Dedicated axis

Click Detach next to a curve to move it to an axis of its own. The curve is no longer constrained by the scale of the other curves of its unit. It then appears in a Dedicated axis block, which has its own scale setting.

Here the average connect time is detached. Its axis, titled Conn time Avg (Seconds), goes from 0 to 0.2 second, and the curve uses the full height of the chart:

Click Reattach to put the curve back on the shared axis of its unit. The curve then uses the scale of the shared axis again.

For example, to show the minimum, average and maximum response times together, detach the minimum response time: it gets its own axis, and every curve uses the full height of the chart.

On the chart

• A dedicated axis is titled after its curve, followed by the unit, for example Conn time Avg (Seconds).
• Dedicated axes alternate between the left and right sides of the chart.
• A dedicated axis fits its curve: a percentage that never goes above 80 gets an axis from 0 to 80, not from 0 to 100. The thresholds of that curve follow its axis.
• An axis that carries a single curve takes the color of that curve, custom color included. An axis shared by several curves is drawn in the text color.

The axis settings are saved with the report item, kept in report templates, and apply to the PDF export.

APDEX

A particular hit metric, the APDEX, requires additional configuration: the Satisfying and Tolerating delays.

The default values are based upon the ones in the configuration panel.