diff --git a/docs/sources/enterprise/enterprise-configuration.md b/docs/sources/enterprise/enterprise-configuration.md index 9faa61fbafe..98d4ff00ad2 100644 --- a/docs/sources/enterprise/enterprise-configuration.md +++ b/docs/sources/enterprise/enterprise-configuration.md @@ -326,3 +326,22 @@ A list of headers that are stripped from the outgoing data source and alerting r ### cookie_drop_list A list of cookies that are stripped from the outgoing data source and alerting requests. + +## [caching] + +> **Note:** Available in Grafana Enterprise v7.5 and later versions. +> **Note:** Redis and memcached sections are in the defaults.ini setting, but Redis and Memcached backends are unavailable in Grafana Enterprise v7.5 + +When query caching is enabled, Grafana temporarily stores the results of data source queries and serves cached responses to similar requests. + +### backend + +The caching backend to use when storing cached queries. Options: memory + +### enabled + +Setting 'enabled' to true enables caching datasource queries for all data sources. + +### ttl + +The default TTL (time to live) if no other TTL is available. diff --git a/docs/sources/enterprise/query-caching.md b/docs/sources/enterprise/query-caching.md new file mode 100644 index 00000000000..9085cd8f52e --- /dev/null +++ b/docs/sources/enterprise/query-caching.md @@ -0,0 +1,24 @@ ++++ +title = "Query caching" +description = "Grafana Enterprise data source query caching" +keywords = ["grafana", "plugins", "query", "caching"] +weight = 110 ++++ + +# Query caching + +> **Note:** Query caching is available behind a feature flag in Grafana Enterprise 7.5+. + +When query caching is enabled, Grafana temporarily stores the results of data source queries. When you or another user submit the exact same query again, the results will come back from the cache instead of from the data source (like Splunk or ServiceNow) itself. + +Query caching currently works for all backend data sources. You can enable the cache globally or per data source, and you can configure the cache duration per data source. The cache is in-memory only. + +## Query caching benefits + +- Faster dashboard load times, especially for popular dashboards. +- Reduced API costs. +- Reduced likelihood that APIs will rate-limit or throttle requests. + +## Enable query caching + +To enable and configure query caching, please refer the the [Query caching section of Enterprise Configuration]({{< relref "./enterprise-configuration.md#query-caching" >}}).