diff --git a/site/kubernetes/kube-addon.md b/site/kubernetes/kube-addon.md
index 680523dd..fbb5c0b6 100644
--- a/site/kubernetes/kube-addon.md
+++ b/site/kubernetes/kube-addon.md
@@ -7,16 +7,17 @@ search_type: Documentation
The following topics are discussed:
* [Installation](#install)
- * [Upgrading Kubernetes to version 1.6](#kube-1.6-upgrade)
- * [Upgrading the Daemon Sets](#daemon-sets)
- * [CPU and Memory Requirements](#resources)
- * [Pod Eviction](#eviction)
+ * [Upgrading Kubernetes to version 1.6](#kube-1.6-upgrade)
+ * [Upgrading the Daemon Sets](#daemon-sets)
+ * [CPU and Memory Requirements](#resources)
+ * [Pod Eviction](#eviction)
* [Features](#features)
- * [Pod Network](#pod-network)
- * [Network Policy](#npc)
+ * [Pod Network](#pod-network)
+ * [Network Policy](#npc)
* [Troubleshooting](#troubleshooting)
- * [Troubleshooting Blocked Connections](#blocked-connections)
- * [Things to watch out for](#key-points)
+ * [Reading the logs](#logs)
+ * [Troubleshooting Blocked Connections](#blocked-connections)
+ * [Things to watch out for](#key-points)
* [Changing Configuration Options](#configuration-options)
@@ -190,12 +191,46 @@ definition](https://v1-7.docs.kubernetes.io/docs/api-reference/v1.7/#networkpoli
## Troubleshooting
+The first thing to check is whether Weave Net is up and
+running. The `kubectl apply` command you used to install it only
+_requests_ that it be downloaded and started; if anything goes wrong
+at startup, those details will only be visible in the [logs](#logs) of
+the container(s).
+
+To check what is running:
+
+```
+$ kubectl get pods -n kube-system -l name=weave-net
+NAME READY STATUS RESTARTS AGE
+weave-net-1jkl6 2/2 Running 0 1d
+weave-net-bskbv 2/2 Running 0 1d
+weave-net-m4x1b 2/2 Running 0 1d
+```
+
+You should see one line for each node in your cluster; each line
+should have STATUS "Running", and READY should be 2 out of 2. If you
+see a STATUS like "Error" or "CrashLoopBackoff", look in the logs of
+the container with that status.
+
+### Reading the logs
+
+Pick one of the pods from the list output by `kubectl get pods` and
+ask for the logs like this:
+
+```
+$ kubectl logs -n kube-system weave-net-1jkl6 weave
+```
+
+For easier viewing, pipe the output into a file , especially if
+it is long.
+
Many Kubernetes network issues occur at a higher level than Weave Net.
The [Kubernetes Service Debugging Guide]
(https://kubernetes.io/docs/tasks/debug-application-cluster/debug-service/)
has a detailed step-by-step guide.
-The status of Weave Net can be checked by running its CLI commands. This can be done in various ways:
+Once it is up and running, the status of Weave Net can be checked by
+running its CLI commands. This can be done in various ways:
1\. [Install the `weave` script](/site/installing-weave.md) and run: