From 18b640fa4ba3ea0b903300218a34531fdba38b75 Mon Sep 17 00:00:00 2001
From: Xiang Dai <764524258@qq.com>
Date: Tue, 16 Apr 2019 14:03:22 +0800
Subject: [PATCH] Update troubleshooting doc

Signed-off-by: Xiang Dai <764524258@qq.com>
---
 docs/troubleshooting.md | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/docs/troubleshooting.md b/docs/troubleshooting.md
index 7b9e37169f59..8ffc71b9391b 100644
--- a/docs/troubleshooting.md
+++ b/docs/troubleshooting.md
@@ -1,5 +1,15 @@
 # Troubleshooting
 
+## "Loki: Bad Gateway. 502"
+This error can appear in Grafana when you add Loki as a datasource.
+It means that Grafana cannot connect to Loki, but Loki has not received any logs from promtail.
+This can have several reasons:
+
+- If you deploy in docker env, Grafana and Loki are not in same node, check iptables or firewalls to ensure connected.
+- If you deploy in kubernetes env, please note:
+  - Grafana and Loki are in same namespace, set Loki url as "http://$LOKI_SERVICE_NAME:$LOKI_PORT".
+  - Grafana and Loki are in different namespace, set Loki url as "http://$LOKI_SERVICE_NAME.$LOKI_NAMESPACE:$LOKI_PORT".
+
 ## "Data source connected, but no labels received. Verify that Loki and Promtail is configured properly."
 
 This error can appear in Grafana when you add Loki as a datasource.