Merge pull request #3237 from hashicorp/d-metrics-documentation

WIP: Guide to nomad metrics integrations

website/source/guides/nomad-metrics.html.md

@@ -0,0 +1,61 @@
+---
+layout: "guides"
+page_title: "Setting up Nomad with Grafana and Prometheus Metrics"
+sidebar_current: "guides-nomad-metrics"
+description: |-
+  It is possible to collect metrics on Nomad and create dashboards with Grafana
+  and Prometheus. Nomad has default configurations for these, but it is
+  possible to build and customize these.
+---
+
+# Setting up Nomad with Grafana and Prometheus Metrics
+
+Often aggregating and displaying metrics in dashboards can lead to more useful
+insights about a cluster. It is easy to get lost in a sea of logs!
+
+This guide explains how to set up configuration for Prometheus and Grafana to
+integrate with a Nomad cluster. While this introduces the basics to get a
+dashboard up and running, Nomad exposes a wide vareity of metrics, which can be
+explored via both Grafana and Prometheus.
+
+## What are Prometheus and Grafana?
+
+Amongst other great metrics visualization tools, Prometheus and Grafana both
+aggregate data and provide an easy eay to visuqlize data.
+
+In addition to these tools, [Graphite](https://graphiteapp.org/) and
+[DataDog](https://www.datadoghq.com/) are also great tools to consider.
+
+## Setting up metrics
+
+Configurations for Grafana and Prometheus can be found in the
+[integrations](https://github.com/hashicorp/nomad/integrations) subfolder.
+
+For Prometheus, first follow Prometheus's [Getting Started
+Guide](https://prometheus.io/docs/introduction/getting_started/) in order to
+set up a Prometheus server. Next, use the (Nomad Prometheus
+Configuration)[https://github.com/hashicorp/noamd/integrations/prometheus/prometheus.yml]
+in order to configure Prometheus to talk to a Consul agent to fetch information
+about the Nomad cluster. See the
+[README](https://github.com/hashicorp/nomad/integrations/prometheus/README.md)
+for more information.
+
+For Grafana, follow Grafana's [Getting
+Started](http://docs.grafana.org/guides/getting_started/) guide to set up a
+running Grafana instance. Then, import the sample [Nomad
+Dashboard](https://github.com/hashicorp/nomad/integrations/grafana/sample_dashboard.json)
+for an example Grafana dashboard. This dashboard requires a Prometheus data
+source to be configured, see the
+[README.md](https://github.com/hashicorp/nomad/integrations/grafana/README.md)
+for more information.
+
+## Tagged Metrics
+
+As of version 0.7, Nomad will start emitting metrics in a tagged format. Each
+metrics can support more than one tag, meaning that it is possible to do a
+match over metrics for datapoints such as a particular datacenter, and return
+all metrics with this tag.
+
+See how [Grafana](http://docs.grafana.org/v3.1/reference/templating/) enables
+tagged metrics easily.
+