add docker-cluster quickstart guide #1040
Conversation
update docker-standard quickstart guide
docs/quick-start-docker.md
Outdated
| You will also need to install version >=1.6 of [docker-compose](https://docs.docker.com/compose/) | ||
|
|
||
| ## Optional: install Go (required to run images other than **docker-standard**) | ||
|
|
||
| The metrictank binary is included in the docker-standard image, but if you would like to try the other images you will need to build metrictank. |
There was a problem hiding this comment.
I'll clarify further
docs/quick-start-docker-cluster.md
Outdated
| * `service_is_statsdaemon`: statsdaemon's own internal metrics which it sends to metrictank's carbon port. | ||
| * `metrictank`: internal stats reported by metrictank | ||
| * `stats`: metrics aggregated by statsdaemon and sent into metrictank every second. Will only show up if something actually sends | ||
| metrics into statsdaemon (e.g. if graphite receives requests directly, you send stats to statsdaemon, etc) |
There was a problem hiding this comment.
this is true for docker-standard, but different for docker-cluster, as we use a separate monitoring server (graphite) to receive all this data. you'd only see this if you first select the monitoring datasource.
but i think everything after line 83 should just be scrapped out of this guide. (minus the parts about shutting down stack, reporting issues, etc). so really just "Sending and visualizing data" and "Using pre-made dashboards"
it's going to be too much to maintain all these details for little benefit.
users new to the project should just follow the normal quickstart guide, and if they succeeded at that, they can do this one, so we don't have to go into all this detail again. as they should have learned already how to send data etc.
i suppose you could mention some pointers though. I think the main ones are:
- you now have multiple datasources to choose from. monitoring and prometheus for data about the stack, metrictank to see data in metrictank and graphite to see data in metrictank but via graphite. (and a few more users typically don't care about)
- that you now have to use the
--kafka-mdm-addr localhost:9092argument to fakemetrics and no longer carbon. because that's how you write data into the cluster
update docker-standard quickstart guide