mirror of https://github.com/grafana/grafana
Docs: Override content (#34859)
* content updates * Update panel-editor.md * Update panel-editor.md * content updates * edits * Update field-overrides.md * Delete field-options-and-overrides.md * link updates * Update field-overrides.md * Update field-overrides.md * Update field-overrides.md * fixing links * reordering * Update docs/sources/panels/field-overrides.md Co-authored-by: achatterjee-grafana <70489351+achatterjee-grafana@users.noreply.github.com> * Update docs/sources/panels/panel-editor.md Co-authored-by: achatterjee-grafana <70489351+achatterjee-grafana@users.noreply.github.com> * Update docs/sources/panels/panel-editor.md Co-authored-by: achatterjee-grafana <70489351+achatterjee-grafana@users.noreply.github.com> * Update docs/sources/panels/panel-editor.md Co-authored-by: achatterjee-grafana <70489351+achatterjee-grafana@users.noreply.github.com> * Update docs/sources/panels/panel-editor.md Co-authored-by: achatterjee-grafana <70489351+achatterjee-grafana@users.noreply.github.com> * Update docs/sources/panels/visualizations/table/_index.md Co-authored-by: achatterjee-grafana <70489351+achatterjee-grafana@users.noreply.github.com> * Update docs/sources/panels/visualizations/table/_index.md Co-authored-by: achatterjee-grafana <70489351+achatterjee-grafana@users.noreply.github.com> Co-authored-by: achatterjee-grafana <70489351+achatterjee-grafana@users.noreply.github.com>pull/34951/head
parent
b391e43472
commit
66e2624ae0
@ -1,36 +0,0 @@ |
||||
+++ |
||||
title = "Field options and overrides" |
||||
keywords = ["grafana", "field options", "documentation", "format fields"] |
||||
aliases = ["/docs/grafana/latest/panels/field-configuration-options/", "/docs/grafana/latest/panels/field-options/"] |
||||
weight = 500 |
||||
+++ |
||||
|
||||
# Field options and overrides |
||||
|
||||
This section explains what field options and field overrides in Grafana are and how to use them. It also includes [examples](#examples) if you need an idea of how this feature might be useful in the real world. |
||||
|
||||
The data model used in Grafana, the [data frame]({{< relref "../../developers/plugins/data-frames.md" >}}), 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. Options and overrides that you apply do not change the data, they change how Grafana displays the data. |
||||
|
||||
## Field options |
||||
|
||||
_Field options_, both standard and custom, can be found in the Field tab in the panel editor. Changes on this tab apply to all fields (i.e. series/columns). For example, if you change the unit to percentage, then all fields with numeric values are displayed in percentages. Learn how to apply a field option in [Configure all fields]({{< relref "configure-all-fields.md" >}}). |
||||
|
||||
## Field overrides |
||||
|
||||
_Field overrides_ can be added in the Overrides tab in the panel editor. There you can add the same options as you find in the Field tab, but they are only applied to specific fields. Learn how to apply an override in [Configure specific fields]({{< relref "configure-specific-fields.md" >}}). |
||||
|
||||
## Available field options and overrides |
||||
|
||||
Field option types are common to both field options and field overrides. The only difference is whether the change will apply to all fields (apply in the Field tab) or to a subset of fields (apply in the Overrides tab). |
||||
|
||||
- [Standard options]({{< relref "../standard-options.md" >}}) apply to all panel visualizations that allow transformations. |
||||
- [Table field options]({{< relref "../visualizations/table/table-field-options.md" >}}), which only apply to table panel visualizations. |
||||
|
||||
## Examples |
||||
|
||||
Here are some examples of how you might use this feature: |
||||
|
||||
- [Field option example]({{< relref "configure-all-fields.md#field-option-example" >}}) |
||||
- [Field override example]({{< relref "configure-specific-fields.md#field-override-example" >}}) |
||||
@ -1,51 +0,0 @@ |
||||
+++ |
||||
title = "Configure all fields" |
||||
keywords = ["grafana", "field options", "documentation", "format fields", "change all fields"] |
||||
weight = 200 |
||||
+++ |
||||
|
||||
# Configure all fields |
||||
|
||||
To change how all fields display data, you can change an option in the Field tab. In the Overrides tab, you can then override the field options for [specific fields]({{< relref "configure-specific-fields.md" >}}). |
||||
|
||||
For example, you could change the number of decimal places shown in all fields by changing the **Decimals** option. For more information about options, refer to: |
||||
- [Standard options]({{< relref "../standard-options.md" >}}), apply to all visualizations that allow transformations. |
||||
- [Table field options]({{< relref "../visualizations/table/table-field-options.md" >}}), which only apply to table panel visualizations. |
||||
|
||||
## Change a field option |
||||
|
||||
You can change as many options as you want to. |
||||
|
||||
1. Navigate to the panel you want to edit, click the panel title, and then click **Edit**. |
||||
1. Click the **Field** tab. |
||||
1. Find the option you want to change. You can define: |
||||
- [Standard options]({{< relref "../standard-options.md" >}}), which apply to all panel visualizations that allow transformations. |
||||
- [Table field options]({{< relref "../visualizations/table/table-field-options.md" >}}), which only apply to table panel visualizations. |
||||
1. Add options by adding values in the fields. To return options to default values, delete the white text in the fields. |
||||
1. When finished, click **Save** to save all panel edits to the dashboard. |
||||
|
||||
## Field option example |
||||
|
||||
Let’s assume that our result set is a data frame that consists of two fields: time and temperature. |
||||
|
||||
| time | temperature | |
||||
| :-----------------: | :---------: | |
||||
| 2020-01-02 03:04:00 | 45.0 | |
||||
| 2020-01-02 03:05:00 | 47.0 | |
||||
| 2020-01-02 03:06:00 | 48.0 | |
||||
|
||||
Each field (column) of this structure can have field options applied that alter the way its values are displayed. This means that you can, for example, set the Unit to Temperature > Celsius, resulting in the following table: |
||||
|
||||
| time | temperature | |
||||
| :-----------------: | :---------: | |
||||
| 2020-01-02 03:04:00 | 45.0 °C | |
||||
| 2020-01-02 03:05:00 | 47.0 °C | |
||||
| 2020-01-02 03:06:00 | 48.0 °C | |
||||
|
||||
While we're at it, the decimal place doesn't add anything to this display. You can change the Decimals from `auto` to zero (`0`), resulting in the following table: |
||||
|
||||
| time | temperature | |
||||
| :-----------------: | :---------: | |
||||
| 2020-01-02 03:04:00 | 45 °C | |
||||
| 2020-01-02 03:05:00 | 47 °C | |
||||
| 2020-01-02 03:06:00 | 48 °C | |
||||
Loading…
Reference in new issue