Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

adding docs for goal and gauge #13140

Merged
merged 2 commits into from
Jul 28, 2017
Merged

adding docs for goal and gauge #13140

merged 2 commits into from
Jul 28, 2017

Conversation

ppisljar
Copy link
Member

closes #12991

@ppisljar ppisljar added Feature:Visualizations Generic visualization features (in case no more specific feature label is available) Team:Docs review labels Jul 27, 2017
Copy link
Contributor

@thomasneirynck thomasneirynck left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lgtm

minor suggestions to improve language

[[goal-chart]]
== Goal and Gauge

A goal visualization displays how your metric progresses toward a fixed goal. Gauge visualization displays in which
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A gauge visualization displays in which predefined range your metric falls


include::y-axis-aggs.asciidoc[]

You can click the *Advanced* link to display more customization options:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Open the *Advanced* link for more customization options.


Click the *Options* tab to change the following options:

- *Gauge Type* you can select between arc, circle and metric display type.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

select between arc, circle and metric display type.

- *Gauge Type* you can select between arc, circle and metric display type.
- *Percentage Mode* will show all values as percentages
- *Vertical Split* will put the gauges one under another instead of one next to another
- *Show Labels* selects if you want to show the labels or not
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

selects whether you want to show or hide labels

- *Vertical Split* will put the gauges one under another instead of one next to another
- *Show Labels* selects if you want to show the labels or not
- *Sub Text* text for the label that appears below the value
- *Auto Extend Range* automatically grows the gauge if value is over its extents.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

... if the value exceeds the configured range.

- *Sub Text* text for the label that appears below the value
- *Auto Extend Range* automatically grows the gauge if value is over its extents.
- *Ranges* you can add custom ranges. Each range will get assigned a color. If value falls within that range it will get
assigned that color. Chart with single range is called goal chart. Chart with multiple ranges is called gauge chart.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

`A chart with a single range is called a goal chart. A chart with multiple ranges is called a gauge chart.

- *Color Options* define how to color your ranges (which color schema to use). Color options are only visible if more than
one range is defined.
- *Style - Show Scale* shows or hides the scale
- *Style - Color Labels* should the labels get the color of the current values range
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

whether the labels should have the same color as the range where the value falls in

@ppisljar ppisljar merged commit 1e6ce85 into elastic:master Jul 28, 2017
ppisljar added a commit that referenced this pull request Jul 28, 2017
* adding docs for goal and gauge
ppisljar added a commit that referenced this pull request Jul 28, 2017
* adding docs for goal and gauge
ppisljar added a commit that referenced this pull request Jul 28, 2017
* adding docs for goal and gauge
ppisljar added a commit that referenced this pull request Jul 28, 2017
* adding docs for goal and gauge
@ppisljar
Copy link
Member Author

backports:
6.x: 7454a52
6.0: acfcdd3
5.6: b71f541
5.5: 26f33e5

@ppisljar ppisljar removed the review label Jul 28, 2017
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Feature:Visualizations Generic visualization features (in case no more specific feature label is available) Team:Docs v5.5.2 v6.0.0
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Gauge and Goal charts need documentation
2 participants