Claudio Ortolina
63 lines
2.5 KiB
Markdown
63 lines
2.5 KiB
Markdown
---
|
|
id: ML-161
|
|
title: pi access to production errors
|
|
status: Done
|
|
assignee: []
|
|
created_date: "2026-05-04 08:06"
|
|
updated_date: "2026-05-04 13:18"
|
|
labels:
|
|
- pi
|
|
- api
|
|
dependencies:
|
|
- ML-162
|
|
- ML-163
|
|
- ML-164
|
|
references:
|
|
- "backlog://document/doc-7"
|
|
priority: medium
|
|
ordinal: 9000
|
|
---
|
|
|
|
## Description
|
|
|
|
<!-- SECTION:DESCRIPTION:BEGIN -->
|
|
|
|
Errors in production are captured via the `error_tracker` Elixir dependency and accessed via a dedicated dashboard at `/dev/errors`. There is no built-in tooling or endpoint to pull production errors programmatically in a pi session. This task covers the investigation and implementation of the best approach to expose production error data to pi, broken into three subtasks:
|
|
|
|
1. **Expose production errors via a programmatic API (behind auth)** — Add a JSON API endpoint under `/api/v1/errors` that lists errors and shows individual error details from the error_tracker tables.
|
|
2. **Create pi tools to pull errors** — Implement `fetch_production_errors` (list with filtering/pagination) and `fetch_production_error` (single error detail) as pi tools.
|
|
3. **Create a pi extension to browse errors** — Build an interactive TUI browsing experience via a pi extension that uses the tools from subtask 2.
|
|
|
|
### Error data attributes
|
|
|
|
These are the attributes that subtask implementations must treat as the canonical data model:
|
|
|
|
**Error (from `error_tracker_errors` table):**
|
|
|
|
- `id` — UUID, unique error identifier
|
|
- `kind` — string, e.g. "error", "throw", "exit"
|
|
- `reason` — string, the error message/reason
|
|
- `source_line` — string, e.g. "lib/foo.ex:42"
|
|
- `source_function` — string, e.g. "MusicLibrary.Foo.bar/2"
|
|
- `status` — atom: `:resolved` | `:unresolved`
|
|
- `fingerprint` — hex string, deterministic hash of (kind, source_line, source_function)
|
|
- `last_occurrence_at` — UTC datetime (microsecond precision)
|
|
- `muted` — boolean
|
|
- `inserted_at` / `updated_at` — UTC datetime
|
|
|
|
**Occurrence (from `error_tracker_occurrences` table):**
|
|
|
|
- `id` — UUID
|
|
- `reason` — string, error reason at time of occurrence
|
|
- `context` — map, includes `live_view.view`, `request.path`, etc.
|
|
- `breadcrumbs` — array of strings
|
|
- `stacktrace` — embedded struct with `lines` array (each having: `application`, `module`, `function`, `arity`, `file`, `line`)
|
|
- `error_id` — FK to error
|
|
- `inserted_at` — UTC datetime
|
|
|
|
**Aggregated/per-error metadata (computed, not stored):**
|
|
|
|
- `occurrence_count` — total occurrences for this error
|
|
- `first_occurrence_at` — earliest occurrence timestamp
|
|
<!-- SECTION:DESCRIPTION:END -->
|