Skip to content

histogram

grafonnet.panel.histogram

Subpackages

Index

Fields

fn new

new(title)

PARAMETERS:

  • title (string)

Creates a new histogram panel with a title.

obj fieldConfig

obj fieldConfig.defaults

obj fieldConfig.defaults.custom
fn fieldConfig.defaults.custom.withAxisBorderShow
fieldConfig.defaults.custom.withAxisBorderShow(value=true)

PARAMETERS:

  • value (boolean)
    • default value: true
fn fieldConfig.defaults.custom.withAxisCenteredZero
fieldConfig.defaults.custom.withAxisCenteredZero(value=true)

PARAMETERS:

  • value (boolean)
    • default value: true
fn fieldConfig.defaults.custom.withAxisColorMode
fieldConfig.defaults.custom.withAxisColorMode(value)

PARAMETERS:

  • value (string)
    • valid values: "text", "series"

TODO docs

fn fieldConfig.defaults.custom.withAxisGridShow
fieldConfig.defaults.custom.withAxisGridShow(value=true)

PARAMETERS:

  • value (boolean)
    • default value: true
fn fieldConfig.defaults.custom.withAxisLabel
fieldConfig.defaults.custom.withAxisLabel(value)

PARAMETERS:

  • value (string)
fn fieldConfig.defaults.custom.withAxisPlacement
fieldConfig.defaults.custom.withAxisPlacement(value)

PARAMETERS:

  • value (string)
    • valid values: "auto", "top", "right", "bottom", "left", "hidden"

TODO docs

fn fieldConfig.defaults.custom.withAxisSoftMax
fieldConfig.defaults.custom.withAxisSoftMax(value)

PARAMETERS:

  • value (number)
fn fieldConfig.defaults.custom.withAxisSoftMin
fieldConfig.defaults.custom.withAxisSoftMin(value)

PARAMETERS:

  • value (number)
fn fieldConfig.defaults.custom.withAxisWidth
fieldConfig.defaults.custom.withAxisWidth(value)

PARAMETERS:

  • value (number)
fn fieldConfig.defaults.custom.withFillOpacity
fieldConfig.defaults.custom.withFillOpacity(value=80)

PARAMETERS:

  • value (integer)
    • default value: 80

Controls the fill opacity of the bars.

fn fieldConfig.defaults.custom.withGradientMode
fieldConfig.defaults.custom.withGradientMode(value="none")

PARAMETERS:

  • value (string)
    • default value: "none"
    • valid values: "none", "opacity", "hue", "scheme"

TODO docs

fn fieldConfig.defaults.custom.withHideFrom
fieldConfig.defaults.custom.withHideFrom(value)

PARAMETERS:

  • value (object)

TODO docs

fn fieldConfig.defaults.custom.withHideFromMixin
fieldConfig.defaults.custom.withHideFromMixin(value)

PARAMETERS:

  • value (object)

TODO docs

fn fieldConfig.defaults.custom.withLineWidth
fieldConfig.defaults.custom.withLineWidth(value=1)

PARAMETERS:

  • value (integer)
    • default value: 1

Controls line width of the bars.

fn fieldConfig.defaults.custom.withScaleDistribution
fieldConfig.defaults.custom.withScaleDistribution(value)

PARAMETERS:

  • value (object)

TODO docs

fn fieldConfig.defaults.custom.withScaleDistributionMixin
fieldConfig.defaults.custom.withScaleDistributionMixin(value)

PARAMETERS:

  • value (object)

TODO docs

fn fieldConfig.defaults.custom.withStacking
fieldConfig.defaults.custom.withStacking(value)

PARAMETERS:

  • value (object)

TODO docs

fn fieldConfig.defaults.custom.withStackingMixin
fieldConfig.defaults.custom.withStackingMixin(value)

PARAMETERS:

  • value (object)

TODO docs

obj fieldConfig.defaults.custom.hideFrom
# fn fieldConfig.defaults.custom.hideFrom.withLegend
fieldConfig.defaults.custom.hideFrom.withLegend(value=true)

PARAMETERS:

  • value (boolean)
    • default value: true
# fn fieldConfig.defaults.custom.hideFrom.withTooltip
fieldConfig.defaults.custom.hideFrom.withTooltip(value=true)

PARAMETERS:

  • value (boolean)
    • default value: true
# fn fieldConfig.defaults.custom.hideFrom.withViz
fieldConfig.defaults.custom.hideFrom.withViz(value=true)

PARAMETERS:

  • value (boolean)
    • default value: true
obj fieldConfig.defaults.custom.scaleDistribution
# fn fieldConfig.defaults.custom.scaleDistribution.withLinearThreshold
fieldConfig.defaults.custom.scaleDistribution.withLinearThreshold(value)

PARAMETERS:

  • value (number)
# fn fieldConfig.defaults.custom.scaleDistribution.withLog
fieldConfig.defaults.custom.scaleDistribution.withLog(value)

PARAMETERS:

  • value (number)
# fn fieldConfig.defaults.custom.scaleDistribution.withType
fieldConfig.defaults.custom.scaleDistribution.withType(value)

PARAMETERS:

  • value (string)
    • valid values: "linear", "log", "ordinal", "symlog"

TODO docs

obj fieldConfig.defaults.custom.stacking
# fn fieldConfig.defaults.custom.stacking.withGroup
fieldConfig.defaults.custom.stacking.withGroup(value)

PARAMETERS:

  • value (string)
# fn fieldConfig.defaults.custom.stacking.withMode
fieldConfig.defaults.custom.stacking.withMode(value)

PARAMETERS:

  • value (string)
    • valid values: "none", "normal", "percent"

TODO docs

obj libraryPanel

fn libraryPanel.withName

libraryPanel.withName(value)

PARAMETERS:

  • value (string)

Library panel name

fn libraryPanel.withUid

libraryPanel.withUid(value)

PARAMETERS:

  • value (string)

Library panel uid

obj options

fn options.withBucketCount

options.withBucketCount(value=30)

PARAMETERS:

  • value (integer)
    • default value: 30

Bucket count (approx)

fn options.withBucketOffset

options.withBucketOffset(value=0)

PARAMETERS:

  • value (number)
    • default value: 0

Offset buckets by this amount

fn options.withBucketSize

options.withBucketSize(value)

PARAMETERS:

  • value (integer)

Size of each bucket

fn options.withCombine

options.withCombine(value=true)

PARAMETERS:

  • value (boolean)
    • default value: true

Combines multiple series into a single histogram

fn options.withLegend

options.withLegend(value)

PARAMETERS:

  • value (object)

TODO docs

fn options.withLegendMixin

options.withLegendMixin(value)

PARAMETERS:

  • value (object)

TODO docs

fn options.withTooltip

options.withTooltip(value)

PARAMETERS:

  • value (object)

TODO docs

fn options.withTooltipMixin

options.withTooltipMixin(value)

PARAMETERS:

  • value (object)

TODO docs

obj options.legend

fn options.legend.withAsTable
options.legend.withAsTable(value=true)

PARAMETERS:

  • value (boolean)
    • default value: true
fn options.legend.withCalcs
options.legend.withCalcs(value=[])

PARAMETERS:

  • value (array)
    • default value: []
fn options.legend.withCalcsMixin
options.legend.withCalcsMixin(value=[])

PARAMETERS:

  • value (array)
    • default value: []
fn options.legend.withDisplayMode
options.legend.withDisplayMode(value="list")

PARAMETERS:

  • value (string)
    • default value: "list"
    • valid values: "list", "table", "hidden"

TODO docs Note: "hidden" needs to remain as an option for plugins compatibility

fn options.legend.withIsVisible
options.legend.withIsVisible(value=true)

PARAMETERS:

  • value (boolean)
    • default value: true
fn options.legend.withPlacement
options.legend.withPlacement(value="bottom")

PARAMETERS:

  • value (string)
    • default value: "bottom"
    • valid values: "bottom", "right"

TODO docs

fn options.legend.withShowLegend
options.legend.withShowLegend(value=true)

PARAMETERS:

  • value (boolean)
    • default value: true
fn options.legend.withSortBy
options.legend.withSortBy(value)

PARAMETERS:

  • value (string)
fn options.legend.withSortDesc
options.legend.withSortDesc(value=true)

PARAMETERS:

  • value (boolean)
    • default value: true
fn options.legend.withWidth
options.legend.withWidth(value)

PARAMETERS:

  • value (number)

obj options.tooltip

fn options.tooltip.withMaxHeight
options.tooltip.withMaxHeight(value)

PARAMETERS:

  • value (number)
fn options.tooltip.withMaxWidth
options.tooltip.withMaxWidth(value)

PARAMETERS:

  • value (number)
fn options.tooltip.withMode
options.tooltip.withMode(value)

PARAMETERS:

  • value (string)
    • valid values: "single", "multi", "none"

TODO docs

fn options.tooltip.withSort
options.tooltip.withSort(value)

PARAMETERS:

  • value (string)
    • valid values: "asc", "desc", "none"

TODO docs

obj panelOptions

fn panelOptions.withDescription

panelOptions.withDescription(value)

PARAMETERS:

  • value (string)

Panel description.

fn panelOptions.withGridPos

panelOptions.withGridPos(h="null", w="null", x="null", y="null")

PARAMETERS:

  • h (number)
    • default value: "null"
  • w (number)
    • default value: "null"
  • x (number)
    • default value: "null"
  • y (number)
    • default value: "null"

withGridPos configures the height, width and xy coordinates of the panel. Also see grafonnet.util.grid for helper functions to calculate these fields.

All arguments default to null, which means they will remain unchanged or unset.

panelOptions.withLinks(value)

PARAMETERS:

  • value (array)

Panel links.

fn panelOptions.withLinksMixin

panelOptions.withLinksMixin(value)

PARAMETERS:

  • value (array)

Panel links.

fn panelOptions.withMaxPerRow

panelOptions.withMaxPerRow(value)

PARAMETERS:

  • value (number)

Option for repeated panels that controls max items per row Only relevant for horizontally repeated panels

fn panelOptions.withRepeat

panelOptions.withRepeat(value)

PARAMETERS:

  • value (string)

Name of template variable to repeat for.

fn panelOptions.withRepeatDirection

panelOptions.withRepeatDirection(value="h")

PARAMETERS:

  • value (string)
    • default value: "h"
    • valid values: "h", "v"

Direction to repeat in if 'repeat' is set. h for horizontal, v for vertical.

fn panelOptions.withTitle

panelOptions.withTitle(value)

PARAMETERS:

  • value (string)

Panel title.

fn panelOptions.withTransparent

panelOptions.withTransparent(value=true)

PARAMETERS:

  • value (boolean)
    • default value: true

Whether to display the panel without a background.

obj queryOptions

fn queryOptions.withDatasource

queryOptions.withDatasource(type, uid)

PARAMETERS:

  • type (string)
  • uid (string)

withDatasource sets the datasource for all queries in a panel.

The default datasource for a panel is set to 'Mixed datasource' so panels can be datasource agnostic, which is a lot more interesting from a reusability standpoint. Note that this requires query targets to explicitly set datasource for the same reason.

fn queryOptions.withDatasourceMixin

queryOptions.withDatasourceMixin(value)

PARAMETERS:

  • value (object)

Ref to a DataSource instance

fn queryOptions.withHideTimeOverride

queryOptions.withHideTimeOverride(value=true)

PARAMETERS:

  • value (boolean)
    • default value: true

Controls if the timeFrom or timeShift overrides are shown in the panel header

fn queryOptions.withInterval

queryOptions.withInterval(value)

PARAMETERS:

  • value (string)

The min time interval setting defines a lower limit for the $__interval and $__interval_ms variables. This value must be formatted as a number followed by a valid time identifier like: "40s", "3d", etc. See: https://grafana.com/docs/grafana/latest/panels-visualizations/query-transform-data/#query-options

fn queryOptions.withMaxDataPoints

queryOptions.withMaxDataPoints(value)

PARAMETERS:

  • value (number)

The maximum number of data points that the panel queries are retrieving.

fn queryOptions.withQueryCachingTTL

queryOptions.withQueryCachingTTL(value)

PARAMETERS:

  • value (number)

Overrides the data source configured time-to-live for a query cache item in milliseconds

fn queryOptions.withTargets

queryOptions.withTargets(value)

PARAMETERS:

  • value (array)

Depends on the panel plugin. See the plugin documentation for details.

fn queryOptions.withTargetsMixin

queryOptions.withTargetsMixin(value)

PARAMETERS:

  • value (array)

Depends on the panel plugin. See the plugin documentation for details.

fn queryOptions.withTimeFrom

queryOptions.withTimeFrom(value)

PARAMETERS:

  • value (string)

Overrides the relative time range for individual panels, which causes them to be different than what is selected in the dashboard time picker in the top-right corner of the dashboard. You can use this to show metrics from different time periods or days on the same dashboard. The value is formatted as time operation like: now-5m (Last 5 minutes), now/d (the day so far), now-5d/d(Last 5 days), now/w (This week so far), now-2y/y (Last 2 years). Note: Panel time overrides have no effect when the dashboard’s time range is absolute. See: https://grafana.com/docs/grafana/latest/panels-visualizations/query-transform-data/#query-options

fn queryOptions.withTimeShift

queryOptions.withTimeShift(value)

PARAMETERS:

  • value (string)

Overrides the time range for individual panels by shifting its start and end relative to the time picker. For example, you can shift the time range for the panel to be two hours earlier than the dashboard time picker setting 2h. Note: Panel time overrides have no effect when the dashboard’s time range is absolute. See: https://grafana.com/docs/grafana/latest/panels-visualizations/query-transform-data/#query-options

fn queryOptions.withTransformations

queryOptions.withTransformations(value)

PARAMETERS:

  • value (array)

List of transformations that are applied to the panel data before rendering. When there are multiple transformations, Grafana applies them in the order they are listed. Each transformation creates a result set that then passes on to the next transformation in the processing pipeline.

fn queryOptions.withTransformationsMixin

queryOptions.withTransformationsMixin(value)

PARAMETERS:

  • value (array)

List of transformations that are applied to the panel data before rendering. When there are multiple transformations, Grafana applies them in the order they are listed. Each transformation creates a result set that then passes on to the next transformation in the processing pipeline.

obj standardOptions

fn standardOptions.withDecimals

standardOptions.withDecimals(value)

PARAMETERS:

  • value (number)

Specify the number of decimals Grafana includes in the rendered value. If you leave this field blank, Grafana automatically truncates the number of decimals based on the value. For example 1.1234 will display as 1.12 and 100.456 will display as 100. To display all decimals, set the unit to String.

fn standardOptions.withDisplayName

standardOptions.withDisplayName(value)

PARAMETERS:

  • value (string)

The display value for this field. This supports template variables blank is auto

fn standardOptions.withFilterable

standardOptions.withFilterable(value=true)

PARAMETERS:

  • value (boolean)
    • default value: true

True if data source field supports ad-hoc filters

standardOptions.withLinks(value)

PARAMETERS:

  • value (array)

The behavior when clicking on a result

fn standardOptions.withLinksMixin

standardOptions.withLinksMixin(value)

PARAMETERS:

  • value (array)

The behavior when clicking on a result

fn standardOptions.withMappings

standardOptions.withMappings(value)

PARAMETERS:

  • value (array)

Convert input values into a display string

fn standardOptions.withMappingsMixin

standardOptions.withMappingsMixin(value)

PARAMETERS:

  • value (array)

Convert input values into a display string

fn standardOptions.withMax

standardOptions.withMax(value)

PARAMETERS:

  • value (number)

The maximum value used in percentage threshold calculations. Leave blank for auto calculation based on all series and fields.

fn standardOptions.withMin

standardOptions.withMin(value)

PARAMETERS:

  • value (number)

The minimum value used in percentage threshold calculations. Leave blank for auto calculation based on all series and fields.

fn standardOptions.withNoValue

standardOptions.withNoValue(value)

PARAMETERS:

  • value (string)

Alternative to empty string

fn standardOptions.withOverrides

standardOptions.withOverrides(value)

PARAMETERS:

  • value (array)

Overrides are the options applied to specific fields overriding the defaults.

fn standardOptions.withOverridesMixin

standardOptions.withOverridesMixin(value)

PARAMETERS:

  • value (array)

Overrides are the options applied to specific fields overriding the defaults.

fn standardOptions.withPath

standardOptions.withPath(value)

PARAMETERS:

  • value (string)

An explicit path to the field in the datasource. When the frame meta includes a path, This will default to `${frame.meta.path}/${field.name}

When defined, this value can be used as an identifier within the datasource scope, and may be used to update the results

fn standardOptions.withUnit

standardOptions.withUnit(value)

PARAMETERS:

  • value (string)

Unit a field should use. The unit you select is applied to all fields except time. You can use the units ID availables in Grafana or a custom unit. Available units in Grafana: https://github.com/grafana/grafana/blob/main/packages/grafana-data/src/valueFormats/categories.ts As custom unit, you can use the following formats: suffix:<suffix> for custom unit that should go after value. prefix:<prefix> for custom unit that should go before value. time:<format> For custom date time formats type for example time:YYYY-MM-DD. si:<base scale><unit characters> for custom SI units. For example: si: mF. This one is a bit more advanced as you can specify both a unit and the source data scale. So if your source data is represented as milli (thousands of) something prefix the unit with that SI scale character. count:<unit> for a custom count unit. currency:<unit> for custom a currency unit.

obj standardOptions.color

fn standardOptions.color.withFixedColor
standardOptions.color.withFixedColor(value)

PARAMETERS:

  • value (string)

The fixed color value for fixed or shades color modes.

fn standardOptions.color.withMode
standardOptions.color.withMode(value)

PARAMETERS:

  • value (string)
    • valid values: "thresholds", "palette-classic", "palette-classic-by-name", "continuous-GrYlRd", "continuous-RdYlGr", "continuous-BlYlRd", "continuous-YlRd", "continuous-BlPu", "continuous-YlBl", "continuous-blues", "continuous-reds", "continuous-greens", "continuous-purples", "fixed", "shades"

Color mode for a field. You can specify a single color, or select a continuous (gradient) color schemes, based on a value. Continuous color interpolates a color using the percentage of a value relative to min and max. Accepted values are: thresholds: From thresholds. Informs Grafana to take the color from the matching threshold palette-classic: Classic palette. Grafana will assign color by looking up a color in a palette by series index. Useful for Graphs and pie charts and other categorical data visualizations palette-classic-by-name: Classic palette (by name). Grafana will assign color by looking up a color in a palette by series name. Useful for Graphs and pie charts and other categorical data visualizations continuous-GrYlRd: ontinuous Green-Yellow-Red palette mode continuous-RdYlGr: Continuous Red-Yellow-Green palette mode continuous-BlYlRd: Continuous Blue-Yellow-Red palette mode continuous-YlRd: Continuous Yellow-Red palette mode continuous-BlPu: Continuous Blue-Purple palette mode continuous-YlBl: Continuous Yellow-Blue palette mode continuous-blues: Continuous Blue palette mode continuous-reds: Continuous Red palette mode continuous-greens: Continuous Green palette mode continuous-purples: Continuous Purple palette mode shades: Shades of a single color. Specify a single color, useful in an override rule. fixed: Fixed color mode. Specify a single color, useful in an override rule.

fn standardOptions.color.withSeriesBy
standardOptions.color.withSeriesBy(value)

PARAMETERS:

  • value (string)
    • valid values: "min", "max", "last"

Defines how to assign a series color from "by value" color schemes. For example for an aggregated data points like a timeseries, the color can be assigned by the min, max or last value.

obj standardOptions.thresholds

fn standardOptions.thresholds.withMode
standardOptions.thresholds.withMode(value)

PARAMETERS:

  • value (string)
    • valid values: "absolute", "percentage"

Thresholds can either be absolute (specific number) or percentage (relative to min or max, it will be values between 0 and 1).

fn standardOptions.thresholds.withSteps
standardOptions.thresholds.withSteps(value)

PARAMETERS:

  • value (array)

Must be sorted by 'value', first value is always -Infinity

fn standardOptions.thresholds.withStepsMixin
standardOptions.thresholds.withStepsMixin(value)

PARAMETERS:

  • value (array)

Must be sorted by 'value', first value is always -Infinity