Telemetry
Since version 3.2.0
quantum
supports :telemetry
metrics.
Overview
The :telemetry
library allows you to emit events at various stages of an application's lifecycle. You can then respond to these events by, among other things, aggregating them as metrics and sending the metrics data to a reporting destination.
Telemetry stores events by their name in an ETS table, along with the handler for each event. Then, when a given event is executed, Telemetry looks up its handler and invokes it.
Telemetry Events
Many Elixir libraries (including Quantum) are already using
the :telemetry
package as a
way to give users more insight into the behavior of their
applications, by emitting events at key moments in the
application lifecycle.
A Telemetry event is made up of the following:
name
- A string (e.g."my_app.worker.stop"
) or a list of atoms that uniquely identifies the event.measurements
- A map of atom keys (e.g.:duration
) and numeric values.metadata
- A map of key/value pairs that can be used for tagging metrics.
Quantum Telemetry Events
The following events are published by Quantum with the following measurements and metadata:
[: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()}
- Measurement:
[: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()}
- Measurement:
[: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()}
- Measurement:
[:quantum, :job, :add]
- dispatched when a job is added- Measurement:
%{}
- Metadata:
%{job: Quantum.Job.t(), scheduler: atom()}
- Measurement:
[:quantum, :job, :update]
- dispatched when a job is updated- Measurement:
%{}
- Metadata:
%{job: Quantum.Job.t(), scheduler: atom()}
- Measurement:
[:quantum, :job, :delete]
- dispatched when a job is deleted- Measurement:
%{}
- Metadata:
%{job: Quantum.Job.t(), scheduler: atom()}
- Measurement: