Solaris.Telemetry (Solaris v1.0.0)

Telemetry integration for the Solaris client.

Emits :telemetry events on every API request and webhook. Compatible with TelemetryMetricsPrometheus, Telemetry.Metrics.ConsoleReporter, etc.

Events

Event	Measurements	Metadata
`[:solaris, :request, :start]`	`system_time`	`method, path, attempt`
`[:solaris, :request, :stop]`	`duration`	`method, path, attempt, status, success`
`[:solaris, :request, :exception]`	`duration`	`method, path, kind, reason`
`[:solaris, :webhook, :received]`	`system_time`	`event_type, delivery_id`
`[:solaris, :webhook, :processed]`	`duration`	`event_type, success`
`[:solaris, :token, :refreshed]`	`system_time`	`expires_in`
`[:solaris, :rate_limit, :hit]`	`system_time`	—

# In application.ex start/2 or a mix task
Solaris.Telemetry.attach_default_logger(:debug)

defmodule MyApp.Metrics do
  def metrics do
    Solaris.Telemetry.metrics()
  end
end

Attaches a Logger-based telemetry handler for development/debugging.

Returns a specification to start this module under a supervisor.

Detaches the default logger handler attached by attach_default_logger/1.

metrics()

Returns a list of Telemetry.Metrics definitions.

@spec attach_default_logger(Logger.level()) :: :ok | {:error, :already_exists}

Attaches a Logger-based telemetry handler for development/debugging.

Logs every request and webhook at the specified level.

Solaris.Telemetry.attach_default_logger(:debug)

Returns a specification to start this module under a supervisor.

@spec detach_default_logger() :: :ok | {:error, :not_found}

Detaches the default logger handler attached by attach_default_logger/1.

@spec metrics() :: [struct()]

Returns a list of Telemetry.Metrics definitions.

Pass the result to your metrics reporter.