# Track values

## Content
# Track values

`track/4` (or `track/5` with options) increments counters for all configured granularities.

:::signature Trifle.Stats.track
key | String | required |  | Metric key (e.g., `"event::logs"`).
at | DateTime | required |  | Timestamp of the sample.
values | map | required |  | Nested maps allowed, all leaf values must be numeric.
config | Trifle.Stats.Configuration | optional | `nil` | Overrides global config.
opts | keyword | optional | `[]` | Supports `untracked: true` to use `__untracked__` for system tracking.
:::

## Examples

:::tabs
@tab Basic
```elixir
Trifle.Stats.track("event::logs", DateTime.utc_now(), %{count: 1, duration: 2, lines: 241})
```

@tab Multiple increments
```elixir
Trifle.Stats.track("event::logs", DateTime.utc_now(), %{count: 1, duration: 1})
Trifle.Stats.track("event::logs", DateTime.utc_now(), %{count: 1, duration: 5})
```

@tab Nested values
```elixir
Trifle.Stats.track("event::logs", DateTime.utc_now(), %{
  count: 1,
  duration: 30,
  breakdown: %{ parse: 21, upload: 9 }
})
```

@tab Untracked system key
```elixir
Trifle.Stats.track("event::logs", DateTime.utc_now(), %{count: 1}, untracked: true)
```
:::

## Verify values

```elixir
now = DateTime.utc_now()
Trifle.Stats.values("event::logs", now, now, "1d")
```