Skip to content

PanelBuilder🔗

Constructor🔗

new PanelBuilder()

Methods🔗

build🔗

Builds the object.

build()

cacheTimeout🔗

Sets panel queries cache timeout.

cacheTimeout(string $cacheTimeout)

colorScheme🔗

Panel color configuration

@param \Grafana\Foundation\Cog\Builder<\Grafana\Foundation\Dashboard\FieldColor> $color

colorScheme(\Grafana\Foundation\Cog\Builder $color)

The behavior when clicking on a result

@param array<\Grafana\Foundation\Cog\Builder<\Grafana\Foundation\Dashboard\DashboardLink>> $links

dataLinks(array $links)

datasource🔗

The datasource used in all targets.

datasource(\Grafana\Foundation\Dashboard\DataSourceRef $datasource)

decimals🔗

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.

decimals(float $decimals)

description🔗

Panel description.

description(string $description)

displayName🔗

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

displayName(string $displayName)

gridPos🔗

Grid position.

gridPos(\Grafana\Foundation\Dashboard\GridPos $gridPos)

height🔗

Panel height. The height is the number of rows from the top edge of the panel.

height(int $h)

hideTimeOverride🔗

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

hideTimeOverride(bool $hideTimeOverride)

id🔗

Unique identifier of the panel. Generated by Grafana when creating a new panel. It must be unique within a dashboard, but not globally.

id(int $id)

infinitePan🔗

Enable infinite pan

infinitePan(bool $infinitePan)

inlineEditing🔗

Enable inline editing

inlineEditing(bool $inlineEditing)

interval🔗

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

interval(string $interval)

libraryPanel🔗

Dynamically load the panel

libraryPanel(\Grafana\Foundation\Dashboard\LibraryPanelRef $libraryPanel)

Panel links.

@param array<\Grafana\Foundation\Cog\Builder<\Grafana\Foundation\Dashboard\DashboardLink>> $links

links(array $links)

mappings🔗

Convert input values into a display string

@param array<\Grafana\Foundation\Cog\Builder<\Grafana\Foundation\Dashboard\ValueMap>|\Grafana\Foundation\Cog\Builder<\Grafana\Foundation\Dashboard\RangeMap>|\Grafana\Foundation\Cog\Builder<\Grafana\Foundation\Dashboard\RegexMap>|\Grafana\Foundation\Cog\Builder<\Grafana\Foundation\Dashboard\SpecialValueMap>> $mappings

mappings(array $mappings)

max🔗

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

max(float $max)

maxDataPoints🔗

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

maxDataPoints(float $maxDataPoints)

maxPerRow🔗

Option for repeated panels that controls max items per row

Only relevant for horizontally repeated panels

maxPerRow(float $maxPerRow)

min🔗

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

min(float $min)

noValue🔗

Alternative to empty string

noValue(string $noValue)

overrides🔗

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

@param array<\Grafana\Foundation\Cog\Builder<\Grafana\Foundation\Dashboard\DashboardFieldConfigSourceOverrides>> $overrides

overrides(array $overrides)

panZoom🔗

Enable pan and zoom

panZoom(bool $panZoom)

queryCachingTTL🔗

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

queryCachingTTL(float $queryCachingTTL)

repeat🔗

Name of template variable to repeat for.

repeat(string $repeat)

repeatDirection🔗

Direction to repeat in if 'repeat' is set.

h for horizontal, v for vertical.

repeatDirection(\Grafana\Foundation\Dashboard\PanelRepeatDirection $repeatDirection)

root🔗

The root element of canvas (frame), where all canvas elements are nested

TODO: Figure out how to define a default value for this

@param \Grafana\Foundation\Cog\Builder<\Grafana\Foundation\Canvas\CanvasOptionsRoot> $root

root(\Grafana\Foundation\Cog\Builder $root)

showAdvancedTypes🔗

Show all available element types

showAdvancedTypes(bool $showAdvancedTypes)

span🔗

Panel width. The width is the number of columns from the left edge of the panel.

span(int $w)

targets🔗

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

@param array<\Grafana\Foundation\Cog\Builder<\Grafana\Foundation\Cog\Dataquery>> $targets

targets(array $targets)

thresholds🔗

Map numeric values to states

@param \Grafana\Foundation\Cog\Builder<\Grafana\Foundation\Dashboard\ThresholdsConfig> $thresholds

thresholds(\Grafana\Foundation\Cog\Builder $thresholds)

timeFrom🔗

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

timeFrom(string $timeFrom)

timeShift🔗

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

timeShift(string $timeShift)

title🔗

Panel title.

title(string $title)

transformations🔗

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.

@param array<\Grafana\Foundation\Dashboard\DataTransformerConfig> $transformations

transformations(array $transformations)

transparent🔗

Whether to display the panel without a background.

transparent(bool $transparent)

unit🔗

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.

unit(string $unit)

withOverride🔗

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

@param array<\Grafana\Foundation\Dashboard\DynamicConfigValue> $properties

withOverride(\Grafana\Foundation\Dashboard\MatcherConfig $matcher, array $properties)

withTarget🔗

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

@param \Grafana\Foundation\Cog\Builder<\Grafana\Foundation\Cog\Dataquery> $target

withTarget(\Grafana\Foundation\Cog\Builder $target)

withTransformation🔗

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.

withTransformation(\Grafana\Foundation\Dashboard\DataTransformerConfig $transformation)

See also🔗