UnifiApi.Network.Anomalies (UnifiApi v0.4.0)

Copy Markdown View Source

UniFi Network API (v1) — anomalies.

Returns the controller's anomaly history: client connect failures, poor signal events, channel saturation, and similar diagnostic noise the controller flags automatically.

Requires cookie + CSRF authentication. See UnifiApi.Auth.Cookie.

Anomaly fields

  • _id, time, datetime, site_id
  • anomaly — the class label, e.g. "poor_signal", "too_many_clients", "high_retries"
  • mac, ap, subsystem
  • count — occurrences in the reporting window

Note: Field set is community-documented; treat any field as optional.

Summary

Functions

list(client, site_id, opts \\ [])

@spec list(Req.Request.t(), String.t(), keyword()) ::
  {:ok, term()} | {:error, UnifiApi.Error.t()}

Lists site anomalies.

Options

  • :within_hours — return anomalies seen within the last N hours (sent as within=N).