mirror of https://github.com/grafana/grafana
Docs: Table update 8.0 (#35214)
* Update _index.md * Delete table-field-options.md * Update _index.md * Update _index.mdpull/35217/head
parent
1c37fc1a6f
commit
49075f235f
@ -1,36 +1,93 @@ |
||||
+++ |
||||
title = "Table panel" |
||||
title = "Table" |
||||
keywords = ["grafana", "dashboard", "documentation", "panels", "table panel"] |
||||
aliases = ["/docs/grafana/latest/reference/table/", "/docs/grafana/latest/features/panels/table_panel/"] |
||||
aliases = ["/docs/grafana/latest/reference/table/", "/docs/grafana/latest/features/panels/table_panel/", "/docs/grafana/next/panels/visualizations/table/table-field-options/"] |
||||
weight = 1000 |
||||
+++ |
||||
|
||||
# Table panel |
||||
# Table |
||||
|
||||
The table panel is very flexible, supporting multiple modes for time series and for tables, annotation, and raw JSON data. This panel also provides date formatting, value formatting, and coloring options. |
||||
The table panel visualization is very flexible, supporting multiple modes for time series and for tables, annotation, and raw JSON data. This panel also provides date formatting, value formatting, and coloring options. |
||||
|
||||
{{< figure src="/static/img/docs/tables/table_visualization.png" max-width="1200px" lightbox="true" caption="Table visualization" >}} |
||||
|
||||
## Data and field options |
||||
## Annotation support |
||||
|
||||
Annotations are not currently supported in the new table panel. This might be added back in a future release. |
||||
|
||||
Table visualizations allow you to apply: |
||||
## Sort column |
||||
|
||||
- [Data transformations]({{< relref "../../transformations/_index.md" >}}) |
||||
- [Field overrides]({{< relref "../../field-overrides.md" >}}) |
||||
- [Thresholds]({{< relref "../../thresholds.md" >}}) |
||||
Click a column title to change the sort order from default to descending to ascending. Each time you click, the sort order changes to the next option in the cycle. You can only sort by one column at a time. |
||||
|
||||
 |
||||
|
||||
## Display options |
||||
## Table options |
||||
|
||||
> **Note:** If you are using a table visualization created before Grafana 7.0, then you need to migrate to the new table version in order to see these options. To migrate, on the Panel tab, click **Table** visualization. Grafana updates the table version and you can then access all table options. |
||||
|
||||
- **Show header -** Show or hide column names imported from your data source. |
||||
- **Sort ascending/descending -** Click a column title to change the sort order from default to descending to ascending. Each time you click, the sort order changes to the next option in the cycle. You can only sort by one column at a time. |
||||
### Show header |
||||
|
||||
 |
||||
Show or hide column names imported from your data source. |
||||
|
||||
- [Table field options]({{< relref "./table-field-options.md" >}}) allow you to change table properties such as column width, alignment, and cell display mode. |
||||
- [Filter table columns]({{< relref "./filter-table-columns.md" >}}) - allow you to temporarily change how column data is displayed. For example, you can order values from highest to lowest or hide specific values. |
||||
## Column width |
||||
|
||||
## Annotation support |
||||
By default, Grafana automatically calculates the column width based on the cell contents. In this field option, can override the setting and define the width for all columns in pixels. |
||||
|
||||
Annotations are not currently supported in the new table panel. This might be added back in a future release. |
||||
For example, if you enter `100` in the field, then when you click outside the field, all the columns will be set to 100 pixels wide. |
||||
|
||||
## Column alignment |
||||
|
||||
Choose how Grafana should align cell contents: |
||||
|
||||
- Auto (default) |
||||
- Left |
||||
- Center |
||||
- Right |
||||
|
||||
## Cell display mode |
||||
|
||||
By default, Grafana automatically chooses display settings. You can override the settings by choosing one of the following options to change all fields. |
||||
|
||||
> **Note:** If you set these in the Field tab, then the display modes will apply to all fields, including the time field. Many options will work best if you set them in the Override tab. |
||||
|
||||
### Color text |
||||
|
||||
If thresholds are set, then the field text is displayed in the appropriate threshold color. |
||||
|
||||
{{< figure src="/static/img/docs/tables/color-text.png" max-width="500px" caption="Color text" class="docs-image--no-shadow" >}} |
||||
|
||||
### Color background (gradient or solid) |
||||
|
||||
If thresholds are set, then the field background is displayed in the appropriate threshold color. |
||||
|
||||
{{< figure src="/static/img/docs/tables/color-background.png" max-width="500px" caption="Color background" class="docs-image--no-shadow" >}} |
||||
|
||||
### Gradient gauge |
||||
|
||||
The threshold levels define a gradient. |
||||
|
||||
{{< figure src="/static/img/docs/tables/gradient-gauge.png" max-width="500px" caption="Gradient gauge" class="docs-image--no-shadow" >}} |
||||
|
||||
### LCD gauge |
||||
|
||||
The gauge is split up in small cells that are lit or unlit. |
||||
|
||||
{{< figure src="/static/img/docs/tables/lcd-gauge.png" max-width="500px" caption="LCD gauge" class="docs-image--no-shadow" >}} |
||||
|
||||
### JSON view |
||||
|
||||
Shows value formatted as code. If a value is an object the JSON view allowing browsing the JSON object will appear on hover. |
||||
|
||||
{{< figure src="/static/img/docs/tables/json-view.png" max-width="500px" caption="JSON view" class="docs-image--no-shadow" >}} |
||||
|
||||
### Image |
||||
|
||||
> Only available in Grafana 7.3+ |
||||
|
||||
If you have a field value that is an image URL or a base64 encoded image you can configure the table to display it as an image. |
||||
|
||||
{{< figure src="/static/img/docs/v73/table_hover.gif" max-width="900px" caption="Table hover" >}} |
||||
|
||||
## Column filter |
||||
|
||||
You can temporarily change how column data is displayed. For example, you can order values from highest to lowest or hide specific values. For more information, refer to [Filter table columns]({{< relref "./filter-table-columns.md" >}}). |
||||
|
@ -1,76 +0,0 @@ |
||||
+++ |
||||
title = "Table field options" |
||||
keywords = ["grafana", "table options", "documentation", "format tables"] |
||||
weight = 500 |
||||
+++ |
||||
|
||||
# Table field options |
||||
|
||||
This section explains all available table field options. They are listed in the same order as in Grafana. Options listed in this topic apply only to table panel visualizations. |
||||
|
||||
Most field options will not affect the visualization until you click outside of the field option box you are editing or press Enter. |
||||
|
||||
## Column alignment |
||||
|
||||
Choose how Grafana should align cell contents: |
||||
|
||||
- Auto (default) |
||||
- Left |
||||
- Center |
||||
- Right |
||||
|
||||
## Column width |
||||
|
||||
By default, Grafana automatically calculates the column width based on the cell contents. In this field option, can override the setting and define the width for all columns in pixels. |
||||
|
||||
For example, if you enter `100` in the field, then when you click outside the field, all the columns will be set to 100 pixels wide. |
||||
|
||||
## Cell display mode |
||||
|
||||
By default, Grafana automatically chooses display settings. You can override the settings by choosing one of the following options to change all fields. |
||||
|
||||
> **Note:** If you set these in the Field tab, then the display modes will apply to all fields, including the time field. Many options will work best if you set them in the Override tab. |
||||
|
||||
### Color text |
||||
|
||||
If thresholds are set, then the field text is displayed in the appropriate threshold color. |
||||
|
||||
{{< figure src="/static/img/docs/tables/color-text.png" max-width="500px" caption="Color text" class="docs-image--no-shadow" >}} |
||||
|
||||
### Color background (gradient or solid) |
||||
|
||||
If thresholds are set, then the field background is displayed in the appropriate threshold color. |
||||
|
||||
{{< figure src="/static/img/docs/tables/color-background.png" max-width="500px" caption="Color background" class="docs-image--no-shadow" >}} |
||||
|
||||
### Gradient gauge |
||||
|
||||
The threshold levels define a gradient. |
||||
|
||||
{{< figure src="/static/img/docs/tables/gradient-gauge.png" max-width="500px" caption="Gradient gauge" class="docs-image--no-shadow" >}} |
||||
|
||||
### LCD gauge |
||||
|
||||
The gauge is split up in small cells that are lit or unlit. |
||||
|
||||
{{< figure src="/static/img/docs/tables/lcd-gauge.png" max-width="500px" caption="LCD gauge" class="docs-image--no-shadow" >}} |
||||
|
||||
### JSON view |
||||
|
||||
Shows value formatted as code. If a value is an object the JSON view allowing browsing the JSON object will appear on hover. |
||||
|
||||
{{< figure src="/static/img/docs/tables/json-view.png" max-width="500px" caption="JSON view" class="docs-image--no-shadow" >}} |
||||
|
||||
### Image |
||||
|
||||
> Only available in Grafana 7.3+ |
||||
|
||||
If you have a field value that is an image URL or a base64 encoded image you can configure the table to display it as an image. |
||||
|
||||
{{< figure src="/static/img/docs/v73/table_hover.gif" max-width="900px" caption="Table hover" >}} |
||||
|
||||
## Column filter |
||||
|
||||
> **Note:** This feature is available in Grafana 7.2+. |
||||
> |
||||
Turn this on to enable table field filters. For more information, refer to [Filter table columns]({{< relref "filter-table-columns.md" >}}). |
Loading…
Reference in new issue