Commit 078eb3c7 by Diana Payton Committed by GitHub

Docs: What's new in 7.2 edits (#27607)

* Update configuration.md

* Update whats-new-in-v7-2.md

* edited content

* Update whats-new-in-v7-2.md

* Update docs/sources/guides/whats-new-in-v7-2.md

Co-authored-by: Torkel Ödegaard <torkel@grafana.org>

* Update table-panel.md

* Update whats-new-in-v7-2.md

Co-authored-by: Torkel Ödegaard <torkel@grafana.org>
parent fcfd5cf0
......@@ -1395,9 +1395,9 @@ Keys of alpha features to enable, separated by space. Available alpha features a
## [date_formats]
> The date format options below are only available in Grafana v7.2+
> **Note:** The date format options below are only available in Grafana v7.2+.
This section controls system wide defaults for date formats used in time ranges, graphs and date input boxes.
This section controls system-wide defaults for date formats used in time ranges, graphs, and date input boxes.
The format patterns use [Moment.js](https://momentjs.com/docs/#/displaying/) formatting tokens.
......@@ -1407,8 +1407,8 @@ Full date format used by time range picker and in other places where a full date
### intervals
These intervals formats are used in the graph to show only a partial date or time. For example if there are only
minutes between y-axis tick labels then the `interval_minute` format is used.
These intervals formats are used in the graph to show only a partial date or time. For example, if there are only
minutes between Y-axis tick labels then the `interval_minute` format is used.
Defaults
......@@ -1423,9 +1423,8 @@ interval_year = YYYY
### use_browser_locale
Set this to `true` to have date formats be automatically be derived from browser locale. Defaults to `false`. This
is an experimental feature right now with a few problems that remain unsolved.
Set this to `true` to have date formats automatically derived from your browser location. Defaults to `false`. This is an experimental feature.
### default_timezone
Used as the default timezone for user preferences. Can be either `browser` for the browser local timezone or a timezone name from IANA Time Zone database, e.g. `UTC` or `Europe/Amsterdam` etc.
\ No newline at end of file
Used as the default time zone for user preferences. Can be either `browser` for the browser local time zone or a time zone name from the IANA Time Zone database, such as `UTC` or `Europe/Amsterdam`.
\ No newline at end of file
......@@ -36,7 +36,7 @@ Currently only Organization Admins can create reports.
* **Reply to -** (optional) The address that will appear in the **Reply to** field of the email.
* **Message -** (optional) Message body in the email with the report.
* **Time range -** (optional) Use custom time range for the report. For more information check [Report time range]({{< relref "#report-time-range" >}}).
1. **Preview PDF**to make sure the report appears as you expect. Update if necessary.
1. **Preview PDF** to make sure the report appears as you expect. Update if necessary.
1. Enter scheduling information. Options vary depending on the frequency you select.
1. Select the orientation option for generated report: **Portrait** or **Landscape**.
1. Select the layout option for generated report: **Simple** or **Grid**.
......
......@@ -14,33 +14,31 @@ weight = -16
This topic includes the release notes for the Grafana v7.2, which is currently in beta. For all details, read the full [CHANGELOG.md](https://github.com/grafana/grafana/blob/master/CHANGELOG.md).
This article is not complete yet. We will be adding new details over the coming days as we get closer to a stable
release.
This article is not complete yet. We will be adding new details over the coming days as we get closer to a stable release.
The main highlights are:
- [**Date formatting options**]({{< relref "#date-formatting-options" >}})
- [**Table column filters**]({{< relref "#table-column-filters" >}})
- [**New and improved transforms**]({{< relref "#new-and-improved-transforms" >}})
- [**Field override matchers**]({{< relref "#field-override-matchers" >}})
- [**New date formatting options added**]({{< relref "#new=date-formatting-options-added" >}})
- [**Field options are out of beta!**]({{< relref "#field-options-are-out-of-beta" >}})
- [**Added table column filters**]({{< relref "#added-table-column-filters" >}})
- [**New field override selection options**]({{< relref "#new-field-override-selection-options" >}})
- [**New transformations and enhancements**]({{< relref "#new-transformations-and-enhancements" >}})
- [**Sensitive alert channel settings are now encrypted**]({{< relref "#sensitive-alert-channel-settings-are-now-encrypted" >}})
- [**Grafana Enterprise features**]({{< relref "#grafana-enterprise-features" >}})
- [**Report time range**]({{< relref "#report-time-range" >}})
- [**Organization-wide report settings**]({{< relref "#organization-wide-report-settings" >}})
- [**Report grid layout**]({{< relref "#report-grid-layout" >}})
## Date formatting options
## New date formatting options added
Now you can finally customize how dates are formatted in Grafana. Both in the time range picker, graphs and other panels.
You can now customize how dates are formatted in Grafana. Custom date formats apply to the time range picker, graphs, and other panel visualizations.
Example:
{{< docs-imagebox img="/img/docs/v72/date_formats.png" max-width="800px" caption="Custom date time formats" >}}
This screenshot shows both a custom full date format with a 12 hour clock and am/pm suffix. The graph is also
showing same 12-hour clock format and a customized month and day format compared to the Grafana default `MM/DD` format.
The above screenshot shows both a custom full date format with a 12 hour clock and am/pm suffix. The Graph is also
showing same 12 hour clock format and a customized month and day format compared to the Grafana default `MM/DD` format.
{{< docs-imagebox img="/img/docs/v72/date_formats.png" max-width="800px" caption="Custom date time formats" >}}
Currently date formats can only be changed via [server wide settings]({{< relref
"../administration/configuration.md#date_formats" >}}) but we hope to add org and potentially user level
settings in the future.
Date formats are set for a Grafana instance by adjusting [server-wide settings]({{< relref "../administration/configuration.md#date_formats" >}}) in the Grafana configuration file. We hope to add org- and user-level settings in the future.
```
[date_formats]
......@@ -53,43 +51,49 @@ interval_month = YYYY-MM
interval_year = YYYY
```
There is also experimental support to use Browser locale/language to dynamically change the current date format
for each user. This feature is disabled by default as it needs more testing and refinement.
There is also experimental support to use the browser location and language to dynamically change the current date format for each user. This feature is disabled by default.
The [Configuration]({{< relref "../administration/configuration.md#date_formats" >}}) topic has been updated as a result of this change.
## Field options are out of beta!
After lots of testing and user feedback, we removed the beta label from the configuration options in the Field and Override tabs. This release also includes the following feature enhancements.
## Table column filters
### Added table column filters
The new column filter option allows you to dynamically apply value filters to any column. This option is disabled but
can be enabled for all or a specific column using an override rule.
You can now dynamically apply value filters to any table column. This option is can be enabled for all columns or one specific column using an override rule.
{{< docs-imagebox img="/img/docs/v72/table_column_filters.png" max-width="800px" caption="Table column filters" >}}
## New and improved transforms
### New field override selection options
Grafana 7.2 includes a new group by transform that allows you to group by multiple fields and add any number of aggregations for other fields.
You can now add override rules that use a regex matcher to choose which fields to apply rules to.
There is also an update to the labels to fields transform that allow you to pick one label and use that as the name of the value field.
The [Field options]({{< relref "../panels/field-options.md" >}}) content has been updated as a result of these changes.
The UI for transforms also has an update that now allows you to move transformations up and down.
## New transformations and enhancements
{{< docs-imagebox img="/img/docs/v72/transformations.gif" max-width="800px" caption="Group by and reordering of transformations" >}}
Grafana 7.2 includes the following transformation enhancements:
## Field override matchers
- A new [Group By]({{< relref "../panels/transformations.md#group-by">}}) transformation that allows you to group by multiple fields and add any number of aggregations for other fields.
- The [Labels to fields]({{< relref "../panels/transformations.md#labels-to-fields">}}) transformation now allows you to pick one label and use that as the name of the value field.
- You can now move transformations up and down. Remember that transformations are processed in the order they are listed in the UI, so think before you move something!
You can now add override rules that use a regex matcher and overrides that match on field type.
{{< docs-imagebox img="/img/docs/v72/transformations.gif" max-width="800px" caption="Group by and reordering of transformations" >}}
## Sensitive alert notification channel settings are now stored encrypted in the database
## Sensitive alert channel settings are now encrypted
Before Grafana v7.2 alert notification channels did not store sensitive settings/secrets such as API tokens and password encrypted in the database. In Grafana v7.2, creating a new alert notification channel will store sensitive settings encrypted in the database.
Alert notification channels now store sensitive settings and secrets, such as API tokens and passwords, encrypted in the database.
Please read the [upgrade notes]({{< relref "../installation/upgrading.md#ensure-encryption-of-existing-alert-notification-channel-secrets" >}}) for more information and how to migrate.
## Grafana Enterprise features
General features are included in the Grafana Enterprise edition software.
These features are included in the Grafana Enterprise edition software.
### Report grid layout
### Report and export dashboards in grid layout
A new layout option is available when rendering reports: the grid layout. With this option your report will use the panel layout from your dashboard so that what you see is what you get. Learn more about the [grid layout]({{< relref "../enterprise/reporting.md#layout-and-orientation.md" >}}) in the documentation.
A new layout option is available when rendering reports: the grid layout. With this option, your report uses the panel layout from your dashboard, so that what you see is what you get. Learn more about the [grid layout]({{< relref "../enterprise/reporting.md#layout-and-orientation" >}}) in the documentation.
The grid layout is also available for the [Export dashboard as PDF]({{< relref "../enterprise/export-pdf.md" >}}) feature.
......@@ -97,14 +101,18 @@ The grid layout is also available for the [Export dashboard as PDF]({{< relref "
### Report time range
A report can now be set up with a different time range from the dashboard it is based on. This means you no longer have to apply workarounds such as copying dashboards or carefully aligning report generation with the end of the month to generate reports that covers the period you want. The dashboard's stored time range remains the default option.
You can now generate a report with a different time range from the dashboard it is based on. This means that you no longer have to apply workarounds, such as copying dashboards or carefully aligning report generation with the end of the month, to generate reports that cover the period you want.
For more information, refer to [Reports time range]({{< relref "../enterprise/reporting.md#report-time-range" >}}).
### Organization-wide report settings
You can now configure organization-wide report settings, such as report branding, in the **Settings** tab on the **Reporting** page. Settings are applied to all the reports of your current organization.
You can now configure organization-wide report settings, such as report branding, in the Settings tab on the Reporting page. Settings are applied to all the reports of your current organization.
{{< docs-imagebox img="/img/docs/enterprise/reports_settings.png" max-width="500px" class="docs-image--no-shadow" caption="Reports settings" >}}
For more information, refer to [Reports settings]({{< relref "../enterprise/reporting.md#reports-settings" >}}).
## Upgrading
See [upgrade notes]({{< relref "../installation/upgrading.md" >}}).
......@@ -116,6 +124,7 @@ Check out [CHANGELOG.md](https://github.com/grafana/grafana/blob/master/CHANGELO
## What's new in other parts of the Grafana ecosystem
### ADX (Azure Data Explorer) plugin
In collaboration with Microsoft we have started to improve the usability of our ADX datasource plugin by adding a visual query builder. The goal is to make it easier for users, regardless of their previous knowledge of writing KQL (Kusto Query Language) queries, to query and visualize their data.
In collaboration with Microsoft, we have improved the usability of our ADX datasource plugin by adding a visual query builder. The goal is to make it easier for users, regardless of their previous knowledge of writing KQL (Kusto Query Language) queries, to query and visualize their data.
{{< docs-imagebox img="/img/docs/v72/adx-ds.png" max-width="800px" caption="ADX visual query builder" >}}
......@@ -15,6 +15,8 @@ The table panel is very flexible, supporting multiple modes for time series and
{{< figure src="/img/docs/v72/table_visualization.png" max-width="1200px" lightbox="true" caption="Table visualization" >}}
> **Note:** Annotations are not currently supported in the table panel.
## Data and field options
Table visualizations allow you to apply:
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment