Plugins 〉Nominal

Data Source

commercial

Nominal

Overview
Installation
Change log
Related content

Nominal

The Nominal data source for Grafana connects dashboards, Explore, template variables, and alert rules to Nominal time-series data. Use it to search for Nominal assets, choose data scopes and channels, and visualize numeric or string channel values alongside the rest of your Grafana telemetry.

Requirements

Grafana 12.1 or later.
A Nominal API key.
Access to a Nominal API endpoint, such as https://api.gov.nominal.io/api.

Configure the Data Source

In Grafana, go to Connections > Data sources.
Add the Nominal data source.
Set Base URL to your Nominal API endpoint, including the /api path.
Enter your Nominal API key in API Key.
Select Save & test.

Grafana stores the API key securely and sends it only to the Nominal backend plugin. The health check verifies that Grafana can reach Nominal and authenticate with the configured key.

Build Queries

The query editor helps you build Nominal queries without writing raw API requests.

Search for an asset by name or paste a resource identifier directly.
Select a data scope from the asset.
Select a channel from the selected data scope.
Choose the query mode and bucket count for time-series panels.

Queries return Grafana data frames that can be used in dashboards, Explore, and alert rules.

Annotations are not supported yet.

Dashboard Variables

Nominal supports Grafana dashboard variables for assets, data scopes, and channels.

Example variable queries:

assets
assets(engine)
datascopes(${asset})
channels(${asset})
channels(${asset}, ${datascope})

Use these variables to create dashboards that can switch between Nominal assets, scopes, and channels without editing each panel.

Alerting

The plugin supports Grafana Alerting. After configuring the data source, create an alert rule from a panel that uses a Nominal query, or create a new Grafana-managed alert rule and select the Nominal data source.

Before saving an alert rule, use Grafana's preview or evaluation flow to confirm that the selected query returns the numeric series expected by the alert condition.

Troubleshooting

If Save & test fails, confirm that the Base URL includes the /api path and that the API key is valid.
If asset or channel search fails, confirm that the data source can reach Nominal and that the API key has access to the requested data.
If an alert rule does not evaluate, confirm that the query returns a numeric time series for the selected time range.

Changelog

Note: Historical entries were migrated from an internal repository; links may not resolve in this public repo.

0.11.3 (2026-05-04)

Bug Fixes

rename Grafana plugin id for public signing (#64) (94e054c)

0.11.2 (2026-05-04)

Bug Fixes

sign Grafana releases privately (#62) (ec79ee1)

0.11.1 (2026-05-01)

Bug Fixes

align plugin with Grafana best practices (#60) (ebaf216)

0.11.0 (2026-04-30)

Features

add log channel support (#52) (6419816)

Bug Fixes

address Grafana review feedback (#57) (d8b3285)
use branded plugin logo (#59) (9012c78)

0.10.0 (2026-04-22)

Features

multi-aggregation support for numeric series (#42) (4861564)

Bug Fixes

bump protobufjs to >=7.5.5 to patch CVE-2026-41242 (#55) (b155e12)

0.9.2 (2026-04-11)

Bug Fixes

replace hardcoded styles with Grafana useTheme2() design tokens (#48) (82fa1a2)
sanitize error responses and remove fallback HTTP client (#49) (d7ca9cf)

0.9.1 (2026-04-09)

Bug Fixes

unblock plugin release validation (#45) (739d7e6)

0.9.0 (2026-04-02)

Features

arrow support for bucketed numeric series (#38) (713c50c)

Bug Fixes

pin flatted to >= 3.4.2 to resolve CVE-2026-33228 (#39) (8131185)
scope QueryEditor animation styles and switch direct backend HTTP calls to the SDK client (#32) (4ebfa0e)
stop leaking caller headers through proxy (#31) (a9f8827)

0.8.0 (2026-03-19)

Features

enable front end template variable support for channel select (#28) (48517e5)

Bug Fixes

cache asset and channel lookups in inferMissingChannelDataType (backend) (#34) (beae629)
CVE-2026-32141 (#30) (a813b82)
infer string channel types for templated queries (#27) (76aea57)
use grafana's maxDataPoints to improve query performance (#33) (dd2c1e1)

Chores

deps: bump google.golang.org/grpc from 1.78.0 to 1.79.3 (#36) (825fcf3)

0.7.0 (2026-03-10)

Features

improve query build UX (#9) (261c27a)

0.6.0 (2026-02-28)

Features

add string/enum channel support (#17) (e74505d)
add template variable support for assets, data scopes, and channels; drop RID from series name (#8) (0039a1e)

Bug Fixes

deps: update github.com/nominal-io/nominal-api-go digest to 89e4ad6 (#11) (52e17d2)
update compute API imports from scout/compute/api to scout/compute/api1 (#19) (5bb74df)

0.5.1 (2026-02-26)

Bug Fixes

change renovate config (dd8c0e6)
fetch channel options dynamically on search input instead of loading static paginated list on asset selection (#15) (515824e)
force minimatch ^10.2.4 for CVE (#16) (557f881)

0.5.0 (2026-02-20)

Features

batch queries into single API call for improved performance (#5) (9136453)

0.4.0 (2026-02-06)

Features

review: add reviewer bootstrap dashboard provisioning (#3) (0d1899f)

0.3.5 (2026-02-05)

Chores

document release automation (#2) (b004e95)
public repo link + release bootstrap (9323657)

0.3.4 (2026-02-02)

Bug Fixes

add screenshots for Grafana Plugin catalog (#71) (808a686)
deps: update module github.com/grafana/grafana-plugin-sdk-go to v0.286.0 (#69) (f0a3653)

0.3.3 (2026-01-21)

Bug Fixes

use package-plugin outputs directly instead of manual packaging (#67) (a448569)

0.3.2 (2026-01-21)

Bug Fixes

read plugin ID from src/plugin.json instead of dist/plugin.json (#65) (7c414a4)

0.3.1 (2026-01-21)

Bug Fixes

use package-plugin and manual release for component-prefixed tags (#63) (f38c74e)

0.3.0 (2026-01-21)

Features

add plugin release workflow for easy client distribution (#56) (ae9913b)
add self-hosted Renovate for dependency updates (#47) (9542695)

Bug Fixes

add a networkpolicy (#28) (cac6d5b)
add package.json to release-please config and fix plugin metadata (#62) (78d10e6)
adjust config and ci (#13) (0b24ac7)
clarify base url in README (#31) (510af3f)
deps: update go dependencies (non-major) (#50) (02b1df4)
deps: update module github.com/grafana/grafana-plugin-sdk-go to v0.285.0 (#55) (21978f4)
docker build process with authentication and documentation cleanup (#12) (33585a6)
docker image build in CI (#17) (6520576)
lint and packaging warnings in docker and grafana UI (#20) (e4a9f3e)
modify docker build for images (#16) (1aa026e)
remove archive and cleanup cruft (#35) (370fd0e)
remove datasource setup (#29) (a967192)
revert updating to vendored package and latest api (#44) (00c23ed)
small issue on pathing for release please config (#14) (1678b1e)
update release workflow for release-please tag format (#60) (127662e)
update runner (#19) (8da57f5)

Chores

bump grafana versions (#38) (72111df)
release main (#15) (3469ab8)
release main (#18) (6e3b128)
release main (#21) (cc1ce58)
release main (#23) (af29f4d)
release main (#25) (f90bf60)
release main (#26) (9926f7e)
release main (#30) (220130a)
release main (#32) (4e12914)
release main (#34) (86b28db)
release main (#36) (db9f30e)
release main (#39) (94bf90f)
release main (#42) (4a5fc25)
release main (#45) (ad44182)
release main (#48) (7a1aa2f)
release main (#59) (a640525)
setup secret for plugin (#37) (42336a5)
updating to vendored package and latest api (#40) (d9ff9f1)

0.2.0 (2026-01-21)

Features

add plugin release workflow for easy client distribution (#56) (ae9913b)
add self-hosted Renovate for dependency updates (#47) (9542695)

Bug Fixes

add a networkpolicy (#28) (cac6d5b)
adjust config and ci (#13) (0b24ac7)
clarify base url in README (#31) (510af3f)
deps: update go dependencies (non-major) (#50) (02b1df4)
deps: update module github.com/grafana/grafana-plugin-sdk-go to v0.285.0 (#55) (21978f4)
docker build process with authentication and documentation cleanup (#12) (33585a6)
docker image build in CI (#17) (6520576)
lint and packaging warnings in docker and grafana UI (#20) (e4a9f3e)
modify docker build for images (#16) (1aa026e)
remove archive and cleanup cruft (#35) (370fd0e)
remove datasource setup (#29) (a967192)
revert updating to vendored package and latest api (#44) (00c23ed)
small issue on pathing for release please config (#14) (1678b1e)
update runner (#19) (8da57f5)

Chores

bump grafana versions (#38) (72111df)
release main (#15) (3469ab8)
release main (#18) (6e3b128)
release main (#21) (cc1ce58)
release main (#23) (af29f4d)
release main (#25) (f90bf60)
release main (#26) (9926f7e)
release main (#30) (220130a)
release main (#32) (4e12914)
release main (#34) (86b28db)
release main (#36) (db9f30e)
release main (#39) (94bf90f)
release main (#42) (4a5fc25)
release main (#45) (ad44182)
release main (#48) (7a1aa2f)
setup secret for plugin (#37) (42336a5)
updating to vendored package and latest api (#40) (d9ff9f1)

0.1.0 (2026-01-21)

Features

add plugin release workflow for easy client distribution (#56) (ae9913b)
add self-hosted Renovate for dependency updates (#47) (9542695)

Bug Fixes

add a networkpolicy (#28) (cac6d5b)
adjust config and ci (#13) (0b24ac7)
clarify base url in README (#31) (510af3f)
deps: update go dependencies (non-major) (#50) (02b1df4)
deps: update module github.com/grafana/grafana-plugin-sdk-go to v0.285.0 (#55) (21978f4)
docker build process with authentication and documentation cleanup (#12) (33585a6)
docker image build in CI (#17) (6520576)
lint and packaging warnings in docker and grafana UI (#20) (e4a9f3e)
modify docker build for images (#16) (1aa026e)
remove archive and cleanup cruft (#35) (370fd0e)
remove datasource setup (#29) (a967192)
revert updating to vendored package and latest api (#44) (00c23ed)
small issue on pathing for release please config (#14) (1678b1e)
update runner (#19) (8da57f5)

Chores

bump grafana versions (#38) (72111df)
release main (#15) (3469ab8)
release main (#18) (6e3b128)
release main (#21) (cc1ce58)
release main (#23) (af29f4d)
release main (#25) (f90bf60)
release main (#26) (9926f7e)
release main (#30) (220130a)
release main (#32) (4e12914)
release main (#34) (86b28db)
release main (#36) (db9f30e)
release main (#39) (94bf90f)
release main (#42) (4a5fc25)
release main (#45) (ad44182)
setup secret for plugin (#37) (42336a5)
updating to vendored package and latest api (#40) (d9ff9f1)

0.0.13 (2026-01-05)

Bug Fixes

revert updating to vendored package and latest api (#44) (00c23ed)

0.0.12 (2026-01-05)

Chores

updating to vendored package and latest api (#40) (d9ff9f1)

0.0.11 (2025-11-21)

Chores

bump grafana versions (#38) (72111df)

0.0.10 (2025-10-23)

Bug Fixes

remove archive and cleanup cruft (#35) (370fd0e)

Chores

setup secret for plugin (#37) (42336a5)

0.0.9 (2025-09-12)

Bug Fixes

0.0.8 (2025-09-12)

Bug Fixes

clarify base url in README (#31) (510af3f)

0.0.7 (2025-09-11)

Bug Fixes

remove datasource setup (#29) (a967192)

0.0.6 (2025-09-11)

Bug Fixes

add a networkpolicy (#28) (cac6d5b)
lint and packaging warnings in docker and grafana UI (#20) (e4a9f3e)

0.0.5 (2025-09-10)

Bug Fixes

0.0.4 (2025-09-10)

Bug Fixes

0.0.3 (2025-09-10)

Bug Fixes

update runner (#19) (8da57f5)

0.0.2 (2025-09-10)

Bug Fixes

docker image build in CI (#17) (6520576)
modify docker build for images (#16) (1aa026e)

0.0.1 (2025-09-10)

Bug Fixes

adjust config and ci (#13) (0b24ac7)
docker build process with authentication and documentation cleanup (#12) (33585a6)
small issue on pathing for release please config (#14) (1678b1e)