github.com/smintz/nomad@v0.8.3/website/source/guides/nomad-metrics.html.md (about) 1 --- 2 layout: "guides" 3 page_title: "Setting up Nomad with Grafana and Prometheus Metrics" 4 sidebar_current: "guides-nomad-metrics" 5 description: |- 6 It is possible to collect metrics on Nomad and create dashboards with Grafana 7 and Prometheus. Nomad has default configurations for these, but it is 8 possible to build and customize these. 9 --- 10 11 # Setting up Nomad with Grafana and Prometheus Metrics 12 13 Often aggregating and displaying metrics in dashboards can lead to more useful 14 insights about a cluster. It is easy to get lost in a sea of logs! 15 16 This guide explains how to set up configuration for Prometheus and Grafana to 17 integrate with a Nomad cluster. While this introduces the basics to get a 18 dashboard up and running, Nomad exposes a wide variety of metrics, which can be 19 explored via both Grafana and Prometheus. 20 21 ## What metrics tools can be integrated with Nomad? 22 23 Nomad provides the opportunity to integrate with metrics dashboard tools such 24 as [Prometheus](https://prometheus.io/), [Grafana](https://grafana.com/), 25 [Graphite](https://graphiteapp.org/), [DataDog](https://www.datadoghq.com/), 26 and [Circonus](https://www.circonus.com ). 27 28 See Nomad's [Metrics API](/api/metrics.html) for more information on how 29 data can be exposed for other metrics tools as well. 30 31 ## Setting up metrics 32 33 Configurations for Grafana and Prometheus can be found in the 34 [integrations](https://github.com/hashicorp/nomad/tree/master/integrations) subfolder. 35 36 For Prometheus, first follow Prometheus's [Getting Started 37 Guide](https://prometheus.io/docs/introduction/getting_started/) in order to 38 set up a Prometheus server. Next, use the [Nomad Prometheus 39 Configuration](https://github.com/hashicorp/nomad/tree/master/integrations/prometheus/prometheus.yml) 40 in order to configure Prometheus to talk to a Consul agent to fetch information 41 about the Nomad cluster. See the 42 [README](https://github.com/hashicorp/nomad/tree/master/integrations/prometheus/README.md) 43 for more information. 44 45 For Grafana, follow Grafana's [Getting 46 Started](http://docs.grafana.org/guides/getting_started/) guide to set up a 47 running Grafana instance. Then, import the sample [Nomad 48 Dashboard](https://github.com/hashicorp/nomad/tree/master/integrations/grafana/sample_dashboard.json) 49 for an example Grafana dashboard. This dashboard requires a Prometheus data 50 source to be configured, see the 51 [README.md](https://github.com/hashicorp/nomad/tree/master/integrations/grafana/README.md) 52 for more information. 53 54 ## Tagged Metrics 55 56 As of version 0.7, Nomad will start emitting metrics in a tagged format. Each 57 metrics can support more than one tag, meaning that it is possible to do a 58 match over metrics for datapoints such as a particular datacenter, and return 59 all metrics with this tag. 60 61 See how [Grafana](http://docs.grafana.org/v3.1/reference/templating/) enables 62 tagged metrics easily. 63