# `LlmCore.Telemetry`
[🔗](https://github.com/fosferon/llm_core/blob/v0.3.0/lib/llm_core/telemetry.ex#L1)

Helper utilities for emitting telemetry events from llm_core.

# `metadata`

```elixir
@type metadata() :: map()
```

# `span`

```elixir
@spec span(atom(), metadata(), (-> {term(), metadata()})) :: term()
```

Executes the provided function within a telemetry span.

Emits `[:llm_core, name, :start]` and `[:llm_core, name, :stop]` events with
duration measurements in native units. If `fun` raises, an `:exception`
event is emitted with the error details.

---

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