DashboardBuilder🔗

Constructor🔗

new DashboardBuilder(string $title)

Methods🔗

build🔗

Builds the object.

build()

annotation🔗

Contains the list of annotations that are associated with the dashboard.

Annotations are used to overlay event markers and overlay event tags on graphs.

Grafana comes with a native annotation store and the ability to add annotation events directly from the graph panel or via the HTTP API.

See https://grafana.com/docs/grafana/latest/dashboards/build-dashboards/annotate-visualizations/

@param \Grafana\Foundation\Cog\Builder<\Grafana\Foundation\Dashboard\AnnotationQuery> $annotation

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

annotations🔗

Contains the list of annotations that are associated with the dashboard.

Annotations are used to overlay event markers and overlay event tags on graphs.

Grafana comes with a native annotation store and the ability to add annotation events directly from the graph panel or via the HTTP API.

See https://grafana.com/docs/grafana/latest/dashboards/build-dashboards/annotate-visualizations/

@param array<\Grafana\Foundation\Cog\Builder<\Grafana\Foundation\Dashboard\AnnotationQuery>> $annotations

annotations(array $annotations)

description🔗

Description of dashboard.

description(string $description)

editable🔗

Whether a dashboard is editable or not.

editable()

fiscalYearStartMonth🔗

The month that the fiscal year starts on. 0 = January, 11 = December

fiscalYearStartMonth(int $fiscalYearStartMonth)

gnetId🔗

ID of a dashboard imported from the https://grafana.com/grafana/dashboards/ portal

gnetId(string $gnetId)

id🔗

Unique numeric identifier for the dashboard.

id is internal to a specific Grafana instance. uid should be used to identify a dashboard across Grafana instances.

id(int $id)

link🔗

Links with references to other dashboards or external websites.

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

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

links🔗

Links with references to other dashboards or external websites.

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

links(array $links)

liveNow🔗

When set to true, the dashboard will redraw panels at an interval matching the pixel width.

This will keep data "moving left" regardless of the query refresh rate. This setting helps

avoid dashboards presenting stale live data

liveNow(bool $liveNow)

preload🔗

When set to true, the dashboard will load all panels in the dashboard when it's loaded.

preload(bool $preload)

readonly🔗

Whether a dashboard is editable or not.

readonly()

refresh🔗

Refresh rate of dashboard. Represented via interval string, e.g. "5s", "1m", "1h", "1d".

refresh(string $refresh)

revision🔗

This property should only be used in dashboards defined by plugins. It is a quick check

to see if the version has changed since the last time.

revision(int $revision)

snapshot🔗

Snapshot options. They are present only if the dashboard is a snapshot.

@param \Grafana\Foundation\Cog\Builder<\Grafana\Foundation\Dashboard\Snapshot> $snapshot

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

tags🔗

Tags associated with dashboard.

@param array $tags

tags(array $tags)

time🔗

Time range for dashboard.

Accepted values are relative time strings like {from: 'now-6h', to: 'now'} or absolute time strings like {from: '2020-07-10T08:00:00.000Z', to: '2020-07-10T14:00:00.000Z'}.

time(string $from, string $to)

timepicker🔗

Configuration of the time picker shown at the top of a dashboard.

@param \Grafana\Foundation\Cog\Builder<\Grafana\Foundation\Dashboard\TimePickerConfig> $timepicker

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

timezone🔗

Timezone of dashboard. Accepted values are IANA TZDB zone ID or "browser" or "utc".

timezone(string $timezone)

title🔗

Title of dashboard.

title(string $title)

tooltip🔗

Configuration of dashboard cursor sync behavior.

Accepted values are 0 (sync turned off), 1 (shared crosshair), 2 (shared crosshair and tooltip).

tooltip(\Grafana\Foundation\Dashboard\DashboardCursorSync $graphTooltip)

uid🔗

Unique dashboard identifier that can be generated by anyone. string (8-40)

uid(string $uid)

variables🔗

Configured template variables

@param array<\Grafana\Foundation\Cog\Builder<\Grafana\Foundation\Dashboard\VariableModel>> $variables

variables(array $variables)

version🔗

Version of the dashboard, incremented each time the dashboard is updated.

version(int $version)

weekStart🔗

Day when the week starts. Expressed by the name of the day in lowercase, e.g. "monday".

weekStart(string $weekStart)

withPanel🔗

@param \Grafana\Foundation\Cog\Builder<\Grafana\Foundation\Dashboard\Panel> $panel

withPanel(\Grafana\Foundation\Cog\Builder $panel)

withRow🔗

@param \Grafana\Foundation\Cog\Builder<\Grafana\Foundation\Dashboard\RowPanel> $rowPanel

withRow(\Grafana\Foundation\Cog\Builder $rowPanel)

withVariable🔗

Configured template variables

@param \Grafana\Foundation\Cog\Builder<\Grafana\Foundation\Dashboard\VariableModel> $variable

withVariable(\Grafana\Foundation\Cog\Builder $variable)

Examples🔗

Building a dashboard🔗

use Grafana\Foundation\Common;
use Grafana\Foundation\Dashboard\DashboardBuilder;
use Grafana\Foundation\Dashboard\RowBuilder;
use Grafana\Foundation\Prometheus;
use Grafana\Foundation\Timeseries;

require_once __DIR__.'/vendor/autoload.php';

$builder = (new DashboardBuilder(title: 'Sample dashboard'))
    ->uid('generated-from-php')
    ->tags(['generated', 'from', 'php'])
    ->refresh('1m')
    ->time('now-30m', 'now')
    ->timezone(Common\Constants::TIME_ZONE_BROWSER)
    ->withRow(new RowBuilder('Overview'))
    ->withPanel(
        (new Timeseries\PanelBuilder())
            ->title('Network received')
            ->unit('bps')
            ->min(0)
            ->withTarget(
                (new Prometheus\DataqueryBuilder())
                    ->expr('rate(node_network_receive_bytes_total{job="integrations/raspberrypi-node", device!="lo"}[$__rate_interval]) * 8')
                    ->legendFormat('{{ device }}')
            )
    )
;

echo(json_encode($builder->build(), JSON_PRETTY_PRINT).PHP_EOL);

See also🔗

• Dashboard