diff --git a/docs/administration.md b/docs/administration.md
index 26c7ed7ba..94eea518c 100644
--- a/docs/administration.md
+++ b/docs/administration.md
@@ -97,3 +97,58 @@ Note: This will only work when the replication factor is >= 2
- Modify the cluster config file to replace the previous node address with the new node address.
- Restart the cluster
- Wait for the 1st sync (10 minutes) to validate Index connections
+
+#### Metrics
+
+Pilosa can be configured to emit metrics on its internal processes in 2 formats, Expvar or StatsD. Metric recording is disabled by default and enabled through the configuration file.
+Through the configuration file choose the metric type, host to receive events, and polling interval for runtime metrics.
+
+##### Tags
+StatsD Tags are in DataDog format (key:value), and we tag the following:
+
+- NodeID
+- Index
+- Frame
+- View
+- Slice
+
+##### Events
+We currently track the following events
+
+Index: The creation of a new Index.
+
+Frame: The creation of a new Frame.
+
+MaxSlice: The Creation of a new Slice.
+
+SetBit: Count of set bits on a row and column.
+
+ClearBit: Count of cleared bits a previously set bit on a row and column.
+
+ImportBit: During a bulk data import this records the count of bits created.
+
+SetRowAttrs: Count of Attributes set per row
+
+SetColumnAttrs: Count of Attributes set per collumn.
+
+Bitmap: Count of Bitmap queries run.
+
+TopN: Count of TopN queries run.
+
+Union: Count of Union queries.
+
+Intersection: Count of Intersection queries.
+
+Difference: Count of Difference queries.
+
+Count: Count of Count queries.
+
+Range: Count of Range queries.
+
+Snapshot: Event count when the snapshot process is triggered.
+
+BlockRepair: Count of data blocks that were out of sync and repaired.
+
+Garbage Collection: Event count when Garbage Collection occurs,
+
+Goroutines: Number of running Goroutines.
diff --git a/docs/configuration.md b/docs/configuration.md
index 12153dde1..9be899bf2 100644
--- a/docs/configuration.md
+++ b/docs/configuration.md
@@ -167,3 +167,36 @@ Any flag that has a value that is a comma separated list on the command line bec
[profile]
cpu-time = "30s"
```
+##### Metric Service
+* Description: which stats service to use (StatsD or ExpVar)
+* Flag: `--metric.service=statsd`
+* Env: `PILOSA_METRIC.SERVICE=statsd'
+* Config:
+
+ ```toml
+ [metric]
+ service = “statsd”
+ ```
+
+##### Metric Host
+* Description: where is the StatsD service hosted
+* Flag: `--metric.host=localhost:8125`
+* Env: `PILOSA_METRIC.HOST=localhost:8125'
+* Config:
+
+ ```toml
+ [metric]
+ host = "localhost:8125"
+ ```
+
+##### Metric Poll Interval
+
+* Description: Polling interval for runtime metrics.
+* Flag: `metric.poll-interval=”0m15s”`
+* Env: `PILOSA_METRIC.POLL_INTERVAL=0m15s`
+* Config:
+
+ ```toml
+ [metric]
+ poll-interval = "0m15s"
+ ```
\ No newline at end of file