Tick Labels
The following tick (Y axis numeric labels) modes are supported:
Decimal¶
This is the default mode. Y-axis tick labels will be formatted using the metric prefix to indicate the magnitude for values that are greater than one thousand or less than one.
/api/v1/graph? e=2012-01-01T00:00 &q= name,sps,:eq, (,nf.cluster,),:by &s=e-1w &tick_labels=decimal
Really large values will fallback to scientific notation, e.g.:
/api/v1/graph? e=2012-01-01T00:00 &q= name,sps,:eq, (,nf.cluster,),:by, 1e180,:mul &s=e-1w &tick_labels=decimal
Binary¶
For values such as memory sizes it is sometimes more convenient to view the label using a power
of 1024 rather than a power of 1000. If the tick label mode is set to binary
, then the
IEC binary prefix will be used.
/api/v1/graph? e=2012-01-01T00:00 &q= name,sps,:eq, (,nf.cluster,),:by &s=e-1w &tick_labels=binary
Duration¶
Since 1.7.1.
Useful for timers or percentiles that measure latency, provides ticks with time unit suffix.
/api/v1/graph? e=2012-01-01T00:00 &q= name,requestLatency,:eq, nf.node,wii-node,:eq, :and &tick_labels=duration
Off¶
For presentations or sharing it is sometimes useful to anonymize the chart. One
way of doing that is to disable the Y-axis labels by setting the tick label mode to off
.
/api/v1/graph? e=2012-01-01T00:00 &q= name,sps,:eq, (,nf.cluster,),:by &s=e-1w &tick_labels=off
Offset Labels¶
In situations where a graph has very small changes in value that generate a significant number of digits per tick, ticks may be labeled with offsets in order to fit the labels in the layout. A base value is displayed at the bottom of the axis and positive or negative offsets from the base displayed next to the ticks.
For example, if the amount of disk space used varies by 1 byte occasionally, the ticks
will be labeled by in increments of +1.0
.
Note
It is possible for queries spanning different data sources to display offset labels due to differing schemes used to encode floating point values.
If offsets are not desirable, try adjusting the y axis bounds.