mirror of
https://github.com/grafana/grafana.git
synced 2025-02-16 18:34:52 -06:00
fb6df56464
* Docs: rewrite data source intro - Include more than just "databases", which was overly narrow - Try to make doc a "TL;DR" of the essential information * docs, link data source to build plugin task * Reduce jargon and sentence length * Link out to different features * Data source, docs turn examples into list And trim language * Better phrasing to introduce query editor Old way implied that Grafana provides all query editors, which isn't true of custom plugins. * use relref for in-repo anchor * remove double "in" Co-authored-by: Eve Meelan <81647476+Eve832@users.noreply.github.com> * Simplify list Co-authored-by: Eve Meelan <81647476+Eve832@users.noreply.github.com> * Restructure intro, clarify plugins and their URLs * Add and configure It's sometimes both. * Apply suggestions from code review Co-authored-by: Christopher Moyer <35463610+chri2547@users.noreply.github.com> * makes prettier Co-authored-by: Eve Meelan <81647476+Eve832@users.noreply.github.com> Co-authored-by: Christopher Moyer <35463610+chri2547@users.noreply.github.com> Co-authored-by: Chris Moyer <chris.moyer@grafana.com>
85 lines
4.4 KiB
Markdown
85 lines
4.4 KiB
Markdown
---
|
|
aliases:
|
|
- data-sources/
|
|
- overview/
|
|
title: Data sources
|
|
weight: 60
|
|
---
|
|
|
|
# Data sources
|
|
|
|
Grafana comes with built-in support for many _data sources_.
|
|
If you need other data sources, you can also install one of the many data source plugins.
|
|
If the plugin you need doesn't exist, you can develop a custom plugin.
|
|
|
|
Each data source comes with a _query editor_,
|
|
which formulates custom queries according to the source's structure.
|
|
After you add and configure a data source, you can use it as an input for many operations, including:
|
|
|
|
- Query the data with [Explore]({{< relref "../explore" >}}).
|
|
- Visualize it in [panels]({{< relref "../panels-visualizations" >}}).
|
|
- Create rules for [alerts]({{< relref "../alerting" >}}).
|
|
|
|
This documentation describes how to manage data sources in general,
|
|
and how to configure or query the built-in data sources.
|
|
For other data sources, refer to the list of [datasource plugins](/grafana/plugins/).
|
|
To develop a custom plugin, refer to [Build a plugin]({{< relref "../developers/plugins/" >}}).
|
|
|
|
## Manage data sources
|
|
|
|
Only users with the [organization administrator role]({{< relref "../administration/roles-and-permissions#organization-roles" >}}) can add or remove data sources.
|
|
To access data source management tools in Grafana as an administrator, navigate to **Configuration > Data Sources** in the Grafana sidebar.
|
|
|
|
For details on data source management, including instructions on how to add data sources and configure user permissions for queries, refer to the [administration documentation]({{< relref "../administration/data-source-management" >}}).
|
|
|
|
## Use query editors
|
|
|
|
{{< figure src="/static/img/docs/queries/influxdb-query-editor-7-2.png" class="docs-image--no-shadow" max-width="1000px" caption="The InfluxDB query editor" >}}
|
|
|
|
Each data source's **query editor** provides a customized user interface that helps you write queries that take advantage of its unique capabilities.
|
|
You use a data source's query editor when you create queries in [dashboard panels]({{< relref "../panels-visualizations/query-transform-data" >}}) or [Explore]({{< relref "../explore/" >}}).
|
|
|
|
Because of the differences between query languages, each data source query editor looks and functions differently.
|
|
Depending on your data source, the query editor might provide auto-completion features, metric names, variable suggestions, or a visual query-building interface.
|
|
|
|
For example, this video demonstrates the visual Prometheus query builder:
|
|
|
|
{{< vimeo 720004179 >}}
|
|
|
|
For general information about querying in Grafana, and common options and user interface elements across all query editors, refer to [Query and transform data]({{< relref "../panels-visualizations/query-transform-data/" >}}).
|
|
|
|
## Built-in core data sources
|
|
|
|
These built-in core data sources are included in the Grafana documentation:
|
|
|
|
- [Alertmanager]({{< relref "./alertmanager/" >}})
|
|
- [AWS CloudWatch]({{< relref "./aws-cloudwatch/" >}})
|
|
- [Azure Monitor]({{< relref "./azure-monitor/" >}})
|
|
- [Elasticsearch]({{< relref "./elasticsearch/" >}})
|
|
- [Google Cloud Monitoring]({{< relref "./google-cloud-monitoring/" >}})
|
|
- [Graphite]({{< relref "./graphite/" >}})
|
|
- [InfluxDB]({{< relref "./influxdb/" >}})
|
|
- [Jaeger]({{< relref "./jaeger/" >}})
|
|
- [Loki]({{< relref "./loki/" >}})
|
|
- [Microsoft SQL Server (MSSQL)]({{< relref "./mssql/" >}})
|
|
- [MySQL]({{< relref "./mysql/" >}})
|
|
- [OpenTSDB]({{< relref "./opentsdb/" >}})
|
|
- [PostgreSQL]({{< relref "./postgres/" >}})
|
|
- [Prometheus]({{< relref "./prometheus/" >}})
|
|
- [Tempo]({{< relref "./tempo/" >}})
|
|
- [Testdata]({{< relref "./testdata/" >}})
|
|
- [Zipkin]({{< relref "./zipkin/" >}})
|
|
|
|
## Special data sources
|
|
|
|
Grafana also includes three special data sources:
|
|
|
|
- **Grafana:** A built-in data source that generates random walk data and can poll the [Testdata]({{< relref "./testdata/" >}}) data source.
|
|
This helps you test visualizations and run experiments.
|
|
- **Mixed:** An abstraction that lets you query multiple data sources in the same panel.
|
|
When you select Mixed, you can then select a different data source for each new query that you add.
|
|
- The first query uses the data source that was selected before you selected **Mixed**.
|
|
- You can't change an existing query to use the Mixed data source.
|
|
- Grafana Play example: [Mixed data sources](https://play.grafana.org/d/000000100/mixed-datasources?orgId=1)
|
|
- **Dashboard:** A data source that uses the result set from another panel in the same dashboard.
|