diff --git a/website/source/guides/nomad-metrics.html.md b/website/source/guides/nomad-metrics.html.md new file mode 100644 index 000000000..c66ce0c3e --- /dev/null +++ b/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. +