docs: Updates telemetry documentation to include span changes (#482)

Co-authored-by: Isaac Sanders <[email protected]>

Author: isaacsanders

pages/telemetry.md

@@ -32,42 +32,20 @@ A Telemetry event is made up of the following:
   * `metadata` - A map of key/value pairs that can be used
     for tagging metrics.
 
-### A Quantum Example
-
-Here is an example of an event from your endpoint:
-
-* `[:quantum, :job, :stop]` - dispatched whenever a job
-  execution is done
-
-  * Measurement: `%{duration: native_time}`
-
-  * Metadata: `%{job: Quantum.Job.t(), node: Node.t(), scheduler: atom()}`
-
-This means that after each job execution, `Quantum`, via `:telemetry`,
-will emit a "stop" event, with a measurement of how long it
-took to execute the job:
-
-```elixir
-:telemetry.execute([:quantum, :job, :start], %{system_time: system_time}, %{
-  job: job,
-  node: node,
-  scheduler: scheduler
-})
-```
-
 ### Quantum Telemetry Events
 
 The following events are published by Quantum with the following measurements and metadata:
 
-* `[:quantum, :job, :start]` - dispatched on job execution start
-  * Measurement: `%{system_time: system_time}`
-  * Metadata: `%{job: Quantum.Job.t(), node: Node.t(), scheduler: atom()}`
-* `[:quantum, :job, :exception]` - dispatched on job execution fail
-  * Measurement: `%{duration: native_time}`
-  * Metadata: `%{job: Quantum.Job.t(), node: Node.t(), scheduler: atom(), reason: term(), stacktrace: __STACKTRACE__}`
-* `[:quantum, :job, :stop]` - dispatched on job execution end
-  * Measurement: `%{duration: native_time}`
-  * Metadata: `%{job: Quantum.Job.t(), node: Node.t(), scheduler: atom(), result: term()}`
+* `[:quantum, :job]` - A span generated by `:telemetry.span/3` around the execution of a job
+  * `[:quantum, :job, :start]` - dispatched on job execution start
+    * Measurement: `%{system_time: native_time}`
+    * Metadata: `%{telemetry_span_context: term(), job: Quantum.Job.t(), node: Node.t(), scheduler: atom()}`
+  * `[:quantum, :job, :exception]` - dispatched on job execution fail
+    * Measurement: `%{duration: native_time}`
+    * Metadata: `%{telemetry_span_context: term(), job: Quantum.Job.t(), node: Node.t(), scheduler: atom(), kind: :throw | :error | :exit, reason: term(), stacktrace: list()}`
+  * `[:quantum, :job, :stop]` - dispatched on job execution end
+    * Measurement: `%{duration: native_time}`
+    * Metadata: `%{telemetry_span_context: term(), job: Quantum.Job.t(), node: Node.t(), scheduler: atom(), result: term()}`
 * `[:quantum, :job, :add]` - dispatched when a job is added
   * Measurement: `%{}`
   * Metadata: `%{job: Quantum.Job.t(), scheduler: atom()}`