diff --git a/website/source/docs/agent/config.html.md b/website/source/docs/agent/config.html.md
index efa755493..d75b51abf 100644
--- a/website/source/docs/agent/config.html.md
+++ b/website/source/docs/agent/config.html.md
@@ -180,6 +180,8 @@ nodes, unless otherwise specified:
automatically bootstrap itself using Consul. For more details see the [`consul`
section](#consul_options).
+
+
* `telemetry`: Used to control how the Nomad agent exposes telemetry data to
external metrics collection servers. This is a key/value mapping and supports
the following keys:
diff --git a/website/source/docs/agent/telemetry.html.md b/website/source/docs/agent/telemetry.html.md
index 63b4e135c..278e2f3f2 100644
--- a/website/source/docs/agent/telemetry.html.md
+++ b/website/source/docs/agent/telemetry.html.md
@@ -22,6 +22,9 @@ getting a better view of what Nomad is doing.
Telemetry information can be streamed to both [statsite](https://github.com/armon/statsite)
as well as statsd based on providing the appropriate configuration options.
+To configure the telemetry output please see the [agent
+configuration](/docs/agent/config.html#telemetry_config).
+
Below is sample output of a telemetry dump:
```text
diff --git a/website/source/docs/jobops/resources.html.md b/website/source/docs/jobops/resources.html.md
index c9028c907..2f66563ae 100644
--- a/website/source/docs/jobops/resources.html.md
+++ b/website/source/docs/jobops/resources.html.md
@@ -6,4 +6,63 @@ description: |-
Learn how to see resource utilization of a Nomad Job.
---
-# Operating a Job
+# Determing Resource Utilization
+
+Understanding the resource utilization of your application is important for many
+reasons and Nomad supports reporting detailed statistics in many of its drivers.
+The main interface for seeing resource utilization is with the [`alloc-status`
+command](/docs/commands/alloc-status.html) by specifying the `-stats` flag.
+
+In the below example we are running `redis` and can see its resource utilization
+below:
+
+```
+$ nomad alloc-status c3e0
+ID = c3e0e3e0
+Eval ID = 617e5e39
+Name = example.cache[0]
+Node ID = 39acd6e0
+Job ID = example
+Client Status = running
+
+Task "redis" is "running"
+Task Resources
+CPU Memory Disk IOPS Addresses
+957/1000 30 MiB/256 MiB 300 MiB 0 db: 127.0.0.1:34907
+
+Memory Stats
+Cache Max Usage RSS Swap
+32 KiB 79 MiB 30 MiB 0 B
+
+CPU Stats
+Percent Throttled Periods Throttled Time
+73.66% 0 0
+
+Recent Events:
+Time Type Description
+06/28/16 16:43:50 UTC Started Task started by client
+06/28/16 16:42:42 UTC Received Task received by client
+```
+
+Here we can see that we are near the limit of our configured CPU but we have
+plenty of memory headroom. We can use this information to alter our job's
+resources to better reflect is actually needs:
+
+```
+resource {
+ cpu = 2000
+ memory = 100
+}
+```
+
+Adjusting resources is very important for a variety of reasons:
+
+* Ensuring your application does not get OOM killed if it hits its memory limit.
+* Ensuring the application performs well by ensuring it has some CPU allowance.
+* Optimizing cluster density by reserving what you need and not over-allocating.
+
+While single point in time resource usage measurements are useful, it is often
+more useful to graph resource usage over time to better understand and estimate
+resource usage. Nomad supports outputting resource data to statsite and statsd
+and is the recommended way of monitoring resources. For more information about
+outputing telemetry see [here](/docs/agent/telemetry.html).