From b3ce5c2e839de27ad785f0bac07c322d9e0e3fbd Mon Sep 17 00:00:00 2001
From: Fabian Affolter <fabian@affolter-engineering.ch>
Date: Tue, 26 Jan 2016 09:11:24 +0100
Subject: [PATCH] Add initial statsd docs

---
 source/_components/statsd.markdown | 34 ++++++++++++++++++++++++++++++
 1 file changed, 34 insertions(+)
 create mode 100644 source/_components/statsd.markdown

diff --git a/source/_components/statsd.markdown b/source/_components/statsd.markdown
new file mode 100644
index 00000000000..fbaa914b3ef
--- /dev/null
+++ b/source/_components/statsd.markdown
@@ -0,0 +1,34 @@
+---
+layout: component
+title: "StatsD"
+description: "Record events in StatsD."
+date: 2016-01-25 08:00
+sidebar: true
+comments: false
+sharing: true
+footer: true
+ha_category: "History"
+---
+
+The `statsd` component makes it possible to transfer all state changes to an external [StatsD](https://github.com/etsy/statsd) instance.
+
+To use the `statsd` component in your installation, add the following to your `configuration.yaml` file:
+
+```yaml
+# Example configuration.yaml entry
+statsd:
+  host: DB_HOST_IP_ADDRESS
+  port: 20000
+  prefix: DB_TO_STORE_EVENTS
+  rate: 1
+```
+
+Configuration variables:
+
+- **host** (*Optional*): IP address of your StatsD host, eg. 192.168.1.10. Defaults to `localhost`.
+- **port** (*Optional*): Port to use. Defaults to 8125.
+- **prefix** (*Optional*): Prefix to use. Defaults to `hass`.
+- **rate** (*Optional*): The sample rate. Defaults to 1.
+
+StatsD supports various [backends](https://github.com/etsy/statsd/blob/master/docs/backend.md).
+