Telemetry events emitted by ExNominatim.
Events
[:ex_nominatim, :request, :stop]
Emitted when a request completes successfully.
- Measurement:
%{duration: integer}(native time) - Metadata:
%{endpoint: atom, base_url: String.t(), status: integer}
[:ex_nominatim, :request, :exception]
Emitted when a request fails with an error (API error, transport error, etc.).
- Measurement:
%{duration: integer}(native time) - Metadata:
%{endpoint: atom, base_url: String.t(), error: term}
[:ex_nominatim, :request, :retry]
Emitted when a failed request is retried with network-level backoff.
- Measurement:
%{} - Metadata:
%{endpoint: atom, base_url: String.t(), attempt: integer, error: term}
[:ex_nominatim, :cache, :hit]
Emitted when a cached response is returned.
- Measurement:
%{} - Metadata:
%{endpoint: atom}
[:ex_nominatim, :cache, :miss]
Emitted when no cached response is found.
- Measurement:
%{} - Metadata:
%{endpoint: atom}
[:ex_nominatim, :rate_limit, :deny]
Emitted when a request is rate-limited.
- Measurement:
%{} - Metadata:
%{endpoint: atom, base_url: String.t(), retry_after_ms: integer}
[:ex_nominatim, :circuit_breaker, :state_change]
Emitted when the circuit breaker transitions to a new state.
- Measurement:
%{} - Metadata:
%{base_url: String.t(), from: atom, to: atom, reason: atom}