Commit 36aab3a7 by Torkel Ödegaard Committed by GitHub

Docs: Whats new updates (#21664)

* Docs: Whats new updates

* Add cloudwatch and stackdriver paragraphs

* Minor changes

* Add link helper to render gif

* Docs: what's new updates

Co-authored-by: Erik Sundell <erik.sundell87@gmail.com>
parent 685c9043
......@@ -2,10 +2,10 @@
docs:
docker pull grafana/docs-base:latest
docker run -v $(PWD)/sources:/hugo/content/docs/grafana/latest -p 3002:3002 --rm -it grafana/docs-base:latest /bin/bash -c 'npm i && make webpack && hugo server -p 3002 -D --ignoreCache --baseUrl http://localhost:3002 --bind 0.0.0.0'
docker run -v $(PWD)/sources:/hugo/content/docs/grafana/latest -p 3002:3002 --rm -it grafana/docs-base:latest /bin/bash -c 'npm i && make webpack && make docs-menu && hugo server -p 3002 -D --ignoreCache --baseUrl http://localhost:3002 --bind 0.0.0.0'
docs-no-pull:
docker run -v $(PWD)/sources:/hugo/content/docs/grafana/latest -p 3002:3002 --rm -it grafana/docs-base:latest /bin/bash -c 'npm i && make webpack && hugo server -p 3002 -D --ignoreCache --baseUrl http://localhost:3002 --bind 0.0.0.0'
docker run -v $(PWD)/sources:/hugo/content/docs/grafana/latest -p 3002:3002 --rm -it grafana/docs-base:latest /bin/bash -c 'make docs-menu && hugo server -p 3002 -D --ignoreCache --baseUrl http://localhost:3002 --bind 0.0.0.0'
docs-test:
docker pull grafana/docs-base:latest
......
......@@ -21,22 +21,29 @@ Grafana 6.6 comes with a lot of new features and enhancements:
- [**Panels:** New stat panel]({{< relref "#new-stat-panel" >}})
- [**Panels:** Auto min/max for Bar Gauge/Gauge/Stat]({{< relref "#auto-min-max" >}})
- [**Panels:** News panel]({{< relref "#news-panel" >}})
- [**TimePicker:** New design & features]({{< relref "#new-time-picker" >}})
- [**Panels:** Custom data units]({{< relref "#custom-data-units" >}})
- [**Panels:** Bar Gauge unfilled option]({{< relref "#bar-gauge-unfilled-option" >}})
- [**TimePicker:** New design & features]({{< relref "#new-time-picker" >}})
- [**Alerting enhancements**]({{< relref "#alerting-enhancements" >}})
- **Explore:** Added log message line wrapping options for logs
- [**Explore:** Added log message line wrapping options for logs]({{< relref "#explore-logs- panel-log-message-line-wrapping-options" >}})
- [**Explore:** Column with unique log labels ]({{< relref "#explore-context-logs-panel-column-with-unique-log-labels" >}})
- [**Explore:** Context tooltip]({{< relref "#explore-context-tooltip" >}})
- **Explore:** Added ability to specify step with Prometheus queries
- **Graphite:** Added Metrictank dashboard to Graphite datasource
- **Loki:** Support for template variable queries
- **Postgres/MySQL/MSSQL:** Added support for region annotations
- **Explore:** Added ability to specify step with Prometheus queries
- [**Security:** Added disabled option for cookie samesite attribute]({{< relref "#cookie-management-modifications" >}})
- **TablePanel, GraphPanel:** Exclude hidden columns from CSV
- [**Enterprise:** White labeling]({{< relref "#enterprise-white-labeling" >}})
- [**Stackdriver:** Meta labels]({{< relref "#stackdriver-meta-labels" >}})
- [**CloudWatch:** Calculate period based on time range]({{< relref "#cloudwatch-calculate-period-based-on-time-range" >}})
- [**CloudWatch:** Display partial result in graph when max DP/call limit is reached]({{< relref "#cloudwatch-display-partial-result-ingraphwhenmaxdatapointspercall-limit-is-reached" >}})
More details will be added as we're getting closer to the stable release.
## New stat panel
{{< docs-imagebox img="/img/docs/v66/stat_panel_dark.png" max-width="1024px" caption="Stat panel" >}}
{{< docs-imagebox img="/img/docs/v66/stat_panel_dark2.png" max-width="1024px" caption="Stat panel" >}}
This release adds a new panel named `Stat`. This panel is designed to replace the current `Singlestat` as the primary way
to show big single number panels along with a sparkline. This panel is of course building on our new panel
......@@ -61,21 +68,11 @@ Here is how it looks in light theme:
For the panels Gauge, Bar Gauge & Stat you can now leave the min and max settings empty. Grafana will, in that case, calculate the min & max based on
all the data.
## New time picker
The time picker has gotten a major design update. Key changes:
- Quickly access the absolute from & to input fields without an extra click.
- Calendar automatically shows when from or to inputs has focus
- A single calendar view can be used to select and show the from & to date.
- Select recent absolute ranges
{{< docs-imagebox img="/img/docs/v66/time_picker_update.png" max-width="700px" caption="New time picker" >}}
## News panel
This panel supports showing RSS feeds as news items. It is used in the updated default home dashboard. Add it to
your custom home dashboards to keep up to date with Grafana news or switch the default RSS feed to one of your choice.
It currently only supports RSS (not Atom).
{{< docs-imagebox img="/img/docs/v66/news_panel.png" max-width="600px" caption="News panel" >}}
......@@ -83,7 +80,7 @@ your custom home dashboards to keep up to date with Grafana news or switch the d
A top feature request for years is now finally here. All panels now support custom units. Just specify any text in the
unit picker and select the `Custom: <your unit>` option. By default it will be used as a suffix unit. If you want a
custom prefix just type `prefix: <your unit> ` to make the custom unit appear before the value. If you want a custom
custom prefix just type `prefix: <your unit>` to make the custom unit appear before the value. If you want a custom
SI unit (with auto SI suffixes) specify `si:Ups`. A value like 1000 will be rendered as `1 kUps`.
{{< docs-imagebox img="/img/docs/v66/custom_unit_burger1.png" max-width="600px" caption="Custom unit" >}}
......@@ -92,6 +89,24 @@ Paste a native emoji in the unit picker and pick it as a custom unit:
{{< docs-imagebox img="/img/docs/v66/custom_unit_burger2.png" max-width="600px" caption="Custom unit emoji" >}}
## Bar Gauge unfilled option
This visualization has gotten a new display option: `Unfilled`. This new option is enabled by default so it will
change how this visualization is displayed on old dashboards. If you prefer the old behavior where unfilled area
was not shown and the value is followed directly after you have to update the visualization settings.
{{< docs-imagebox img="/img/docs/v66/bar_gauge_unfilled.png" max-width="900px" caption="Bar gauge unfilled" >}}
## New time picker
The time picker has gotten a major design update. Key changes:
- Quickly access the absolute from & to input fields without an extra click.
- Calendar automatically shows when from or to inputs has focus
- A single calendar view can be used to select and show the from & to date.
- Select recent absolute ranges
{{< docs-imagebox img="/img/docs/v66/time_picker_update.png" max-width="700px" caption="New time picker" >}}
## Alerting enhancements
......@@ -101,4 +116,69 @@ Paste a native emoji in the unit picker and pick it as a custom unit:
## Cookie management modifications
In order to align with a [change in Chrome 80](https://www.chromestatus.com/feature/5088147346030592), a breaking change has been introduced. The `[security]` setting `cookie_samesite` configured to `none` now renders cookies with `SameSite=None` attribute contrary to the previous behavior where no `SameSite` attribute was added to cookies. To get back the old behavior, you must set `cookie_samesite` to `disabled`.
In order to align with a [change in Chrome 80](https://www.chromestatus.com/feature/5088147346030592), a breaking change has been introduced to Grafana's [`cookie_samesite` setting]({{< relref "../installation/configuration.md#cookie-samesite" >}}). Grafana now properly renders cookies with the `SameSite=None` attribute when this setting is `none`. The previous behavior of `none` was to omit the `SameSite` attribute from cookies. Grafana will use the previous behavior when `cookie_samesite` is set to `disabled`.
## Explore/Logs Panel: Log message line wrapping options
We are introducing wrap-lines option for logs, as for some of our users it's more efficient to see one line per log message.The wrapped-line option is set as a default, unwrapped setting results in horizontal scrolling.
{{< docs-imagebox img="/img/docs/v66/explore_wrap_lines.gif" max-width="800px" caption="Log message line wrapping" >}}
## Explore/Logs Panel: Column with unique log labels
After feedback from our community, we have decided to reintroduce a labels column. However, for better readability and usefulness, we have transformed it into Unique labels column and include only non-common labels, as all common labels are displayed above.
{{< docs-imagebox img="/img/docs/v66/explore_labels_column.png" max-width="800px" caption="Unique log labels column" >}}
## Explore: Context tooltip
Isolating a series from a big set of lines in a graph is important for drill-downs. That's why we have implemented context tooltip in Explore that allows interaction to copy data and labels from it to further refine the query.
{{< docs-imagebox img="/img/docs/v66/explore_context_tooltip.png" max-width="800px" caption="Explore context tooltip" >}}
## Enterprise: White labeling
This release adds new white labeling options to the grafana.ini file (can also be set via ENV variables).
```bash
[white_labeling]
# Set to complete url to override login logo
login_logo = https://my.logo.url/images/logo.png
# Set to complete css background expression to override login background
login_background = url(http://www.bhmpics.com/wallpapers/starfield-1920x1080.jpg)
# Set to complete url to override menu logo
menu_logo = https://my.logo.url/images/logo_icon.png
# Set to complete url to override fav icon (icon shown in browser tab)
fav_icon = https://my.logo.url/images/logo_icon_32px.png
# Set to complete url to override apple/ios icon
apple_touch_icon = https://my.logo.url/images/logo_icon_32px.png
# Below is an example for how to replace the default footer & help links with 2 custom links
footer_links = support guides
footer_links_support_text = Support
footer_links_support_url = http://your.support.site
footer_links_guides_text = Guides
footer_links_guides_url = http://your.guides.site
```
Customize the login page, side menu bar & footer links.
{{< docs-imagebox img="/img/docs/v66/whitelabeling_1.png" max-width="800px" caption="White labeling example" >}}
## Stackdriver: Meta labels
From now on it will be possible to utilize meta data label in group bys, filters and in the alias field. Unfortunaltey there's no API to retrieve all the labels, but the group by field dropdown comes with a pre-defined list of common system labels. User labels cannot be pre-defined, but it's possible to enter them manually in the group by field. If a meta data label, user label or system label, is included in the group by segment, it will be possible to create filters based on it and to expand its value on the alias field.
{{< docs-imagebox img="/img/docs/v66/metadatalabels.gif" max-width="800px" caption="Stackdriver meta labels" >}}
## CloudWatch: Calculate period based on time range
When the period field was left blank in Grafana 6.5, it would default to 60 seconds. In case users issued queries with a large time span, there was a high risk that they would reach the 100,800 data points per request limit in the Get Metric Data (GMD) api. When the period field is left blank in Grafana 6.6, the period will be calculated automatically based on the time range. The formula that is used is `time range in seconds / 2000`, and then we snap to next higher value in an array of pre-defined periods `[60, 300, 900, 3600, 21600, 86400]`. This will reduce the risk for receiving a `Too many datapoints requested` error in the panel.
## CloudWatch: Display partial result in graph when max data points per call limit is reached
In case all queries in a GMD call are metric stat (not using math expressions), grafana will paginate the response until all data points are received. But pagination is not supported in case a math expression is being used, so in that case it's not possible to receive more than 100,800 data points. Previously when that limit was reached, we only displayed an error message. In Grafana 6.6, we also display the 100,800 data point that were received in the graph.
......@@ -201,6 +201,9 @@
link: /guides/whats-new-in-v5-1/
- name: Version 5.0
link: /guides/whats-new-in-v5/
- name: Old versions
link: /whatsnew/
children:
- name: Version 4.6
link: /guides/whats-new-in-v4-6/
- name: Version 4.5
......@@ -219,6 +222,21 @@
link: /guides/whats-new-in-v3-1/
- name: Version 3.0
link: /guides/whats-new-in-v3/
- name: Grafana Enterprise
link: /enterprise/
children:
- name: Overview
link: /enterprise/
- name: Reporting
link: /features/reporting/
- name: Data source permissions
link: /permissions/datasource_permissions/
- link: /auth/enhanced_ldap/
name: Enhanced LDAP
- link: /auth/saml/
name: SAML
- link: /auth/team-sync/
name: Team Sync
- name: Tutorials
link: /tutorials/
children:
......@@ -312,7 +330,5 @@
children:
- name: Contributor License Agreement (CLA)
link: /contribute/cla/
- name: Grafana Enterprise
link: /enterprise/
- name: Docs Archive
link: /archive/
......@@ -44,11 +44,12 @@ export class NewsPanelEditor extends PureComponent<PanelEditorProps<NewsOptions>
<div className="gf-form">
<FormField
label="URL"
labelWidth={4}
labelWidth={7}
inputWidth={30}
value={feedUrl || ''}
placeholder={DEFAULT_FEED_URL}
onChange={this.onFeedUrlChange}
tooltip="Only RSS feed formats are supported (not Atom)."
onBlur={this.onUpdatePanel}
/>
</div>
......
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