[docs] How to write to multiple M3DB clusters

docs/coordinator/api/remote.md

@@ -30,6 +30,10 @@ docs/common/headers_optional_read_write.md
 
 Binary [snappy compressed](http://google.github.io/snappy/) Prometheus [WriteRequest protobuf message](https://github.com/prometheus/prometheus/blob/10444e8b1dc69ffcddab93f09ba8dfa6a4a2fddb/prompb/remote.proto#L22-L24).
 
+### Available Tuning Params 
+
+Refer [here](https://prometheus.io/docs/practices/remote_write/) for an up to date list of remote tuning parameters. 
+
 ### Sample Call
 
 There isn't a straightforward way to Snappy compress and marshal a Prometheus WriteRequest protobuf message using just shell, so this example uses a specific command line utility instead. 

docs/operational_guide/multiple_m3db_clusters.md

@@ -0,0 +1,125 @@
+## Write to multiple M3DB clusters via M3Coordinator
+
+### Overview:
+
+Default M3 architecture has the M3Coordinator writing to and aggregating meterics from a single M3DB cluster. If wanting to add more than one, follow the below instructions. 
+
+Use case(s):
+- Sending metrics to different namespaces for different retention periods, etc.
+
+### Instructions: 
+
+**Note:** Adding mutliple M3DB clusters to m3coordinator using the m3aggregator requires clusterManagement
+
+**Note:** When making API requests, an environment header needs to be set. 
+
+1. Add clusterManagement to congfig file:
+
+Example of clusterManagement config:
+
+```bash
+clusterManagement:
+  etcd:
+    env: default_env
+    zone: embedded
+    service: m3db
+    cacheDir: /data/m3kv_default
+    etcdClusters:
+      - zone: embedded
+        endpoints:
+          - 10.33.131.173:2379
+          - 10.33.131.174:2379
+          - 10.33.131.175:2379
+  ``` 
+
+Example config file with clusterManagement: 
+
+```bash
+  - namespaces:
+       - namespace: 21d
+         retention: 504h
+         type: unaggregated
+     client:
+       config:
+         service:
+           env: default_env
+           zone: embedded
+           service: m3db
+           cacheDir: /data/m3kv_default
+           etcdClusters:
+             - zone: embedded
+               endpoints:
+                 - 10.33.131.173:2379
+                 - 10.33.131.174:2379
+                 - 10.33.131.175:2379
+       writeConsistencyLevel: majority
+       readConsistencyLevel: unstrict_majority
+       writeTimeout: 10s
+       fetchTimeout: 15s
+       connectTimeout: 20s
+       writeRetry:
+         initialBackoff: 500ms
+         backoffFactor: 3
+         maxRetries: 2
+         jitter: true
+       fetchRetry:
+         initialBackoff: 500ms
+         backoffFactor: 2
+         maxRetries: 3
+         jitter: true
+       backgroundHealthCheckFailLimit: 4
+       backgroundHealthCheckFailThrottleFactor: 0.5
+   - namespaces:
+       - namespace: 90d
+         retention: 2160h
+         type: aggregated
+         resolution: 10m
+       - namespace: 500d
+         retention: 12000h
+         type: aggregated
+         resolution: 1h
+     client:
+       config:
+         service:
+           env: lts_env
+           zone: embedded
+           service: m3db
+           cacheDir: /data/m3kv_lts
+           etcdClusters:
+             - zone: embedded
+               endpoints:
+                 - 10.33.131.173:2379
+                 - 10.33.131.174:2379
+                 - 10.33.131.175:2379
+       writeConsistencyLevel: majority
+       readConsistencyLevel: unstrict_majority
+       writeTimeout: 10s
+       fetchTimeout: 15s
+       connectTimeout: 20s
+       writeRetry:
+         initialBackoff: 500ms
+         backoffFactor: 3
+         maxRetries: 2
+         jitter: true
+       fetchRetry:
+         initialBackoff: 500ms
+         backoffFactor: 2
+         maxRetries: 3
+         jitter: true
+       backgroundHealthCheckFailLimit: 4
+       backgroundHealthCheckFailThrottleFactor: 0.5
+tagOptions:
+  idScheme: quoted
+clusterManagement:
+  etcd:
+    env: default_env
+    zone: embedded
+    service: m3db
+    cacheDir: /data/m3kv_default
+    etcdClusters:
+      - zone: embedded
+        endpoints:
+          - 10.33.131.173:2379
+          - 10.33.131.174:2379
+          - 10.33.131.175:2379
+```