mirror of
https://github.com/grafana/grafana.git
synced 2025-02-25 18:55:37 -06:00
Docs: Rich history (#22697)
* Add rich historyy documentation * Update index.md * Update docs/sources/features/explore/index.md Co-Authored-By: Diana Payton <52059945+oddlittlebird@users.noreply.github.com> * Update documentation * Update docs/sources/features/explore/index.md * Update docs/sources/features/explore/index.md * Update docs/sources/features/explore/index.md Co-Authored-By: Diana Payton <52059945+oddlittlebird@users.noreply.github.com> * Update docs/sources/features/explore/index.md Co-Authored-By: Diana Payton <52059945+oddlittlebird@users.noreply.github.com> * Update docs/sources/features/explore/index.md Co-Authored-By: Diana Payton <52059945+oddlittlebird@users.noreply.github.com> * Update docs/sources/features/explore/index.md Co-Authored-By: Diana Payton <52059945+oddlittlebird@users.noreply.github.com> * Update docs/sources/features/explore/index.md Co-Authored-By: Diana Payton <52059945+oddlittlebird@users.noreply.github.com> * Update docs/sources/features/explore/index.md Co-Authored-By: Diana Payton <52059945+oddlittlebird@users.noreply.github.com> * Update docs/sources/features/explore/index.md Co-Authored-By: Diana Payton <52059945+oddlittlebird@users.noreply.github.com> * Update docs/sources/features/explore/index.md Co-Authored-By: Diana Payton <52059945+oddlittlebird@users.noreply.github.com> * Update docs/sources/features/explore/index.md * Update docs/sources/features/explore/index.md Co-Authored-By: Diana Payton <52059945+oddlittlebird@users.noreply.github.com> * Update docs/sources/features/explore/index.md * Update docs/sources/features/explore/index.md Co-Authored-By: Diana Payton <52059945+oddlittlebird@users.noreply.github.com> * Update docs/sources/features/explore/index.md * Format table * Update docs/sources/features/explore/index.md Co-authored-by: Diana Payton <52059945+oddlittlebird@users.noreply.github.com>
This commit is contained in:
Ivana Huckova
GitHub
parent
904f88167c
commit
45a567cb8e
@ -51,6 +51,67 @@ In split view, timepickers for both panels can be linked (if you change one, the
|
||||
|
||||
You can close the newly created query by clicking on the Close Split button.
|
||||
|
||||
## Query history
|
||||
|
||||
> BETA: Query history is a beta feature.
|
||||
|
||||
Query history is a list of queries that you have used in Explore. The history is local to your browser and is not shared with others. To open and interact with your history, click the **Query history** button in Explore.
|
||||
|
||||
### View query history
|
||||
|
||||
Query history lets you view the history of your querying. For each individual query, you can:
|
||||
|
||||
- Replace Explore query for selected query by clicking on the query card.
|
||||
- Create and/or edit a comment.
|
||||
- Copy a query to the clipboard.
|
||||
- Copy a URL link with the query to the clipboard.
|
||||
- Star a query.
|
||||
|
||||
### Manage favorite queries
|
||||
|
||||
All queries that have been starred in the Query history tab are displayed in the Starred. This allows you to access your favorite queries faster and to reuse these queries without typing them from scratch.
|
||||
|
||||
### Sort query history
|
||||
|
||||
By default, query history shows you the most recent queries. You can sort your history in by date or by data source name in ascending or descending order.
|
||||
|
||||
1. Click the **Sort queries by** field.
|
||||
2. Select one of the following options:
|
||||
- Time ascending
|
||||
- Time descending
|
||||
- Data source A-Z
|
||||
- Data source Z-A
|
||||
|
||||
> Note: If you are in split mode, then the chosen sorting mode applies only to the active panel.
|
||||
|
||||
### Filter query history
|
||||
|
||||
Filter query history in Query history and Starred tab by data source name:
|
||||
|
||||
1. Click the **Filter queries for specific data source(s)** field
|
||||
2. Select the data source for which you would like to filter your history. You can select multiple data sources.
|
||||
|
||||
In **Query history** tab is is also possible to filter queries by date using the slider:
|
||||
|
||||
- Use vertical slider to filter queries by date.
|
||||
- By dragging top handle, adjust start date.
|
||||
- By dragging top handle, adjust end date.
|
||||
|
||||
> Note: If you are in split mode, filters are applied only to your currently active panel.
|
||||
|
||||
### Query history settings
|
||||
|
||||
You can customize the query history in the Settings tab. Options are described in the table below.
|
||||
|
||||
| Setting | Default value |
|
||||
| ------------------------------------------------------------- | --------------------------------------- |
|
||||
| Period of time for which Grafana will save your query history | 1 week |
|
||||
| Change the default active tab | Query history tab |
|
||||
| Only show queries for datasource currently active in Explore | False |
|
||||
| Clear query history | Permanently deletes all stored queries. |
|
||||
|
||||
> Note: Query history settings are global, and applied to both panels in split mode.
|
||||
|
||||
## Prometheus-specific Features
|
||||
|
||||
The first version of Explore features a custom querying experience for Prometheus. When a query is executed, it actually executes two queries, a normal Prometheus query for the graph and an Instant Query for the table. An Instant Query returns the last value for each time series which shows a good summary of the data shown in the graph.
|
||||
@ -69,9 +130,9 @@ The autocomplete menu can be trigger by pressing Ctrl+Space. The Autocomplete me
|
||||
|
||||
Suggestions can appear under the query field - click on them to update your query with the suggested change.
|
||||
|
||||
* For counters (monotonically increasing metrics), a rate function will be suggested.
|
||||
* For buckets, a histogram function will be suggested.
|
||||
* For recording rules, possible to expand the rules.
|
||||
- For counters (monotonically increasing metrics), a rate function will be suggested.
|
||||
- For buckets, a histogram function will be suggested.
|
||||
- For recording rules, possible to expand the rules.
|
||||
|
||||
### Table Filters
|
||||
|
||||
@ -80,6 +141,7 @@ Click on the filter button <span title="Filter for label" class="logs-label__ico
|
||||
## Logs Integration
|
||||
|
||||
Along with metrics, Explore allows you to investigate your logs with the following data sources:
|
||||
|
||||
- [Loki](../datasources/loki)
|
||||
- [InfluxDB](../datasources/influxdb)
|
||||
- [Elasticsearch](../datasources/elasticsearch)
|
||||
@ -92,9 +154,9 @@ You can customize how logs are displayed and select which columns are shown.
|
||||
|
||||
Log data can be very repetitive and Explore can help by hiding duplicate log lines. There are a few different deduplication algorithms that you can use:
|
||||
|
||||
* `exact` Exact matches are done on the whole line, except for date fields.
|
||||
* `numbers` Matches on the line after stripping out numbers (durations, IP addresses etc.).
|
||||
* `signature` The most aggressive deduping - strips all letters and numbers, and matches on the remaining whitespace and punctuation.
|
||||
- `exact` Exact matches are done on the whole line, except for date fields.
|
||||
- `numbers` Matches on the line after stripping out numbers (durations, IP addresses etc.).
|
||||
- `signature` The most aggressive deduping - strips all letters and numbers, and matches on the remaining whitespace and punctuation.
|
||||
|
||||
#### Time
|
||||
|
||||
|
||||
Loading…
Reference in New Issue
Block a user