# `Insider.Collector.Telemetry`
[🔗](https://github.com/hiivemarkets/insider/blob/v0.1.0/lib/insider/collector/telemetry.ex#L1)

Bounded, allowlist-only ingestion of `:telemetry` events.

Telemetry executes handlers synchronously in the emitting process. The
installed handler therefore performs bounded scalar projection and one
fixed-slot ETS write; this process drains records and maintains bounded
lifecycle-pair health away from the caller's hot path.

Each accepted event is attributed to the bounded PID of its synchronous
emitter, allowing consumers to distinguish subject-correlated evidence from
ambient events.

With `rich: true` the handler records every metadata key as a rendered,
bounded payload, and every measurement unless the policy selects some,
with credentials masked. The live session's rich disclosure profile uses
it; the policy's metadata allowlist then does not apply.

# `child_spec`

Returns a specification to start this module under a supervisor.

See `Supervisor`.

# `flush`

```elixir
@spec flush(GenServer.server()) :: {:ok, map()} | {:error, :unavailable}
```

# `seal`

```elixir
@spec seal(GenServer.server()) ::
  {:ok, %{handler: atom(), status: map()}} | {:error, :unavailable}
```

Detaches the handler, drains the inbox, records every pending summary
interval, and stops: the stop a sealed session's last read relies on.
Returns the handler cleanup and the collector's final status.

# `start_link`

```elixir
@spec start_link(
  {Insider.Recorder.Handle.t(), Insider.Collector.Telemetry.Policy.t(),
   keyword()}
) ::
  GenServer.on_start()
```

# `start_link`

```elixir
@spec start_link(
  Insider.Recorder.Handle.t(),
  Insider.Collector.Telemetry.Policy.t(),
  keyword()
) ::
  GenServer.on_start()
```

# `status`

```elixir
@spec status(GenServer.server()) :: {:ok, map()} | {:error, :unavailable}
```

# `stop`

```elixir
@spec stop(GenServer.server()) :: {:ok, map()} | {:error, :unavailable}
```

---

*Consult [api-reference.md](api-reference.md) for complete listing*
