How to use FieldConfig units setting in my datasource

christianramirez · August 23, 2023, 9:41pm

Does anyone have an idea how to use the FieldConfig units property? I have a datasource which pulls from a backend service. I want to set the default units setting in the dataframe. Does anyone have some sample code on how to make that happen?

github.com

grafana/grafana/blob/eeefa7dd2217cd0d14211afaaa940c8d43a8a910/packages/grafana-data/src/types/dataFrame.ts#L70


      
           * True if data source can write a value to the path.  Auth/authz are supported separately
           */
          writeable?: boolean;
          
          /**
           * True if data source field supports ad-hoc filters
           */
          filterable?: boolean;
          
          // Numeric Options
          unit?: string;
          decimals?: DecimalCount; // Significant digits (for display)
          min?: number | null;
          max?: number | null;
          
          // Interval indicates the expected regular step between values in the series.
          // When an interval exists, consumers can identify "missing" values when the expected value is not present.
          // The grafana timeseries visualization will render disconnected values when missing values are found it the time field.
          // The interval uses the same units as the values.  For time.Time, this is defined in milliseconds.
          interval?: number | null;

Any assistance would be greatly appreciated.

cwb · June 10, 2025, 8:32am

This doesnt seem to be addressed anywhere.. Which is quite annoying.

The best i was able to find was this:

but it gives you very few examples, i.e: currency:EUR basically works, and percent - but only if the percentage is in [0-100] - not how to use the [0-1] variant

Topic		Replies	Views
How to render gaps for null values? Grafana Plugin Development	3	2762	March 16, 2023
Help with Field > Standard Options > Unit Time Series Panel	0	1323	January 31, 2021
Dynamically assign Field Config units to multiple timeseries Time Series Panel azure , transformations , time-series	0	236	February 23, 2024
Set custom display processor from plugin Grafana Plugin Development	2	37	August 29, 2024
Extracting individual units out of query InfluxDB Time Series Panel	0	1032	November 10, 2022

How to use FieldConfig units setting in my datasource

Related topics