FieldConfig🔗
The data model used in Grafana, namely the data frame, is a columnar-oriented table structure that unifies both time series and table query results.
Each column within this structure is called a field. A field can represent a single time series or table column.
Field options allow you to change how the data is displayed in your visualizations.
Definition🔗
export interface FieldConfig {
// The display value for this field. This supports template variables blank is auto
displayName?: string;
// This can be used by data sources that return and explicit naming structure for values and labels
// When this property is configured, this value is used rather than the default naming strategy.
displayNameFromDS?: string;
// Human readable field metadata
description?: 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
path?: string;
// 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;
// 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;
// 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?: number;
// The minimum value used in percentage threshold calculations. Leave blank for auto calculation based on all series and fields.
min?: number;
// The maximum value used in percentage threshold calculations. Leave blank for auto calculation based on all series and fields.
max?: number;
// Convert input values into a display string
mappings?: dashboard.ValueMapping[];
// Map numeric values to states
thresholds?: dashboard.ThresholdsConfig;
// Panel color configuration
color?: dashboard.FieldColor;
// The behavior when clicking on a result
links?: dashboard.DashboardLink[];
// Alternative to empty string
noValue?: string;
// custom is specified by the FieldConfig field
// in panel plugin schemas.
custom?: any;
}
Methods🔗
No methods.