Magpie.Telemetry (Magpie v0.6.0)

Copy Markdown View Source

Telemetry events emitted by Magpie's HTTP layer.

Every logical Dropbox request emits:

  • [:magpie, :request, :start]
  • [:magpie, :request, :stop]
  • [:magpie, :request, :exception] when the request raises
  • [:magpie, :request, :retry] before an automatic retry
  • [:magpie, :transfer, :progress] while bytes are uploaded/downloaded

Request metadata includes :method, :endpoint and :operation. Stop metadata also includes :status and Dropbox's :request_id when present. Measurements use native monotonic time and can be converted with System.convert_time_unit/3. Transfer measurements contain :transferred and :total, while metadata identifies the :direction and Dropbox :path.