From 98ba3f34a6105df377aefff9836336d1122b115d Mon Sep 17 00:00:00 2001 From: kay delaney <45561153+kaydelaney@users.noreply.github.com> Date: Mon, 8 Jul 2019 16:48:47 +0100 Subject: [PATCH] Docs: Documents new features available with Loki data source in Explore (#17984) * Docs: Documents new features available with Loki data source in Explore Closes #17898 * Docs: Formats note as a quote and adds additional detail regarding live tailing --- docs/sources/features/datasources/loki.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/docs/sources/features/datasources/loki.md b/docs/sources/features/datasources/loki.md index 11c336b7a44..07c69d375a0 100644 --- a/docs/sources/features/datasources/loki.md +++ b/docs/sources/features/datasources/loki.md @@ -92,6 +92,23 @@ Example queries: * `{name="kafka"} tsdb-ops.*io:2003` * `{instance=~"kafka-[23]",name="kafka"} kafka.server:type=ReplicaManager` +## Live Tailing + +To view your logs live as they are added, choose `Live` from the refresh dropdown, and you should see your logs be displayed in real time. + +Note that Live Tailing relies on two Websocket connections: one between the browser and the Grafana server, and another between the Grafana server and the Loki server. If you run any reverse proxies, please configure them accordingly. + + +> Note: This feature is only available in Grafana v6.3+ + +## Log Context + +When using a search expression as detailed above, you now have the ability to retrieve the context surrounding your filtered results. +By clicking the `Show Context` link on the filtered rows, you'll be able to investigate the log messages that came before and after the +log message you're interested in. + +> Note: This feature is only available in Grafana v6.3+ + ## Templating Template variables are not yet supported by Loki.