diff --git a/monitoring.filebeat/README.md b/monitoring.filebeat/README.md
new file mode 100644
index 0000000..1440236
--- /dev/null
+++ b/monitoring.filebeat/README.md
@@ -0,0 +1,10 @@
+## monitoring.filebeat
+
+#### Role arguments:
+
+```yaml
+filebeat:
+  logstash:
+    # an array of logstash hosts to send logs to
+    hosts: ["logstash.example.com:5044"]
+```