move user docs to their new home

docs/user-guide/logging-demo/Makefile

@@ -0,0 +1,26 @@
+# Makefile for launching synthetic logging sources (any platform)
+# and for reporting the forwarding rules for the
+# Elasticsearch and Kibana pods for the GCE platform.
+# For examples of how to observe the ingested logs please
+# see the appropriate getting started guide e.g.
+# Google Cloud Logging: https://github.com/GoogleCloudPlatform/kubernetes/blob/master/docs/getting-started-guides/logging.md
+# With Elasticsearch and Kibana logging: https://github.com/GoogleCloudPlatform/kubernetes/blob/master/docs/getting-started-guides/logging-elasticsearch.md
+
+.PHONY: up down logger-up logger-down logger10-up logger10-down
+
+up:	logger-up logger10-up
+
+down:	logger-down logger10-down
+
+logger-up:
+	kubectl create -f synthetic_0_25lps.yaml
+
+logger-down:
+	kubectl delete pod synthetic-logger-0.25lps-pod
+
+logger10-up:
+	kubectl create -f synthetic_10lps.yaml
+
+logger10-down:
+	kubectl delete pod synthetic-logger-10lps-pod
+

docs/user-guide/logging-demo/README.md

@@ -0,0 +1,32 @@
+<!-- BEGIN MUNGE: UNVERSIONED_WARNING -->
+
+<!-- BEGIN STRIP_FOR_RELEASE -->
+
+<h1>*** PLEASE NOTE: This document applies to the HEAD of the source
+tree only. If you are using a released version of Kubernetes, you almost
+certainly want the docs that go with that version.</h1>
+
+<strong>Documentation for specific releases can be found at
+[releases.k8s.io](http://releases.k8s.io).</strong>
+
+<!-- END STRIP_FOR_RELEASE -->
+
+<!-- END MUNGE: UNVERSIONED_WARNING -->
+# Elasticsearch/Kibana Logging Demonstration
+This directory contains two [pod](../../docs/pods.md) specifications which can be used as synthetic
+logging sources. The pod specification in [synthetic_0_25lps.yaml](synthetic_0_25lps.yaml)
+describes a pod that just emits a log message once every 4 seconds. The pod specification in
+[synthetic_10lps.yaml](synthetic_10lps.yaml)
+describes a pod that just emits 10 log lines per second.
+
+To observe the ingested log lines when using Google Cloud Logging please see the getting
+started instructions
+at [Cluster Level Logging to Google Cloud Logging](../../docs/getting-started-guides/logging.md).
+To observe the ingested log lines when using Elasticsearch and Kibana please see the getting
+started instructions
+at [Cluster Level Logging with Elasticsearch and Kibana](../../docs/getting-started-guides/logging-elasticsearch.md).
+
+
+<!-- BEGIN MUNGE: GENERATED_ANALYTICS -->
+[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/examples/logging-demo/README.md?pixel)]()
+<!-- END MUNGE: GENERATED_ANALYTICS -->

docs/user-guide/logging-demo/synthetic_0_25lps.yaml

@@ -0,0 +1,30 @@
+# This pod specification creates an instance of a synthetic logger. The logger
+# is simply a program that writes out the hostname of the pod, a count which increments
+# by one on each iteration (to help notice missing log enteries) and the date using
+# a long format (RFC-3339) to nano-second precision. This program logs at a frequency
+# of 0.25 lines per second. The shellscript program is given directly to bash as -c argument
+# and could have been written out as:
+#   i="0"
+#   while true
+#   do
+#     echo -n "`hostname`: $i: "
+#     date --rfc-3339 ns
+#     sleep 4
+#     i=$[$i+1]
+#   done
+apiVersion: v1
+kind: Pod
+metadata:
+  labels:
+    name: synth-logging-source
+  name: synthetic-logger-0.25lps-pod
+spec:
+  containers:
+  - name: synth-lgr
+    image: ubuntu:14.04
+    args:
+    - bash
+    - -c
+    - 'i="0"; while true; do echo -n "`hostname`: $i: "; date --rfc-3339 ns; sleep
+      4; i=$[$i+1]; done'
+    

docs/user-guide/logging-demo/synthetic_10lps.yaml

@@ -0,0 +1,30 @@
+# This pod specification creates an instance of a synthetic logger. The logger
+# is simply a program that writes out the hostname of the pod, a count which increments
+# by one on each iteration (to help notice missing log enteries) and the date using
+# a long format (RFC-3339) to nano-second precision. This program logs at a frequency
+# of 0.25 lines per second. The shellscript program is given directly to bash as -c argument
+# and could have been written out as:
+#   i="0"
+#   while true
+#   do
+#     echo -n "`hostname`: $i: "
+#     date --rfc-3339 ns
+#     sleep 4
+#     i=$[$i+1]
+#   done
+apiVersion: v1
+kind: Pod
+metadata:
+  labels:
+    name: synth-logging-source
+  name: synthetic-logger-10lps-pod
+spec:
+  containers:
+  - name: synth-lgr
+    image: ubuntu:14.04
+    args:
+    - bash
+    - -c
+    - 'i="0"; while true; do echo -n "`hostname`: $i: "; date --rfc-3339 ns; sleep
+      0.1; i=$[$i+1]; done'
+