Logs

Search log records and navigate from a log entry to its parent trace.

AgentVista stores structured log records ingested via the OTLP endpoint. The dashboard API lets you search logs with full-text and field-level filters, and follow a log entry directly to its parent trace.

To ingest log data, use the OTLP ingestion endpoint. The endpoints on this page are read-only dashboard endpoints.

---

Search logs

Full-text search

curl "https://api.agentvista.dev/api/v1/dashboard/logs/search?q=connection+refused&severity=error&limit=50" \
  -H "Authorization: Bearer av_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

GET /dashboard/logs/search

Searches log records for the authenticated user using full-text search on the log body and exact-match filters on structured fields. Results are ordered newest-first.

Query parameters

q · string

Full-text search query run against the log body field using PostgreSQL full-text search.

service_name · string

Exact match filter on the service_name field.

severity · string

Exact match filter on severity level. One of trace, debug, info, warn, error, fatal.

trace_id · string

Filter logs linked to a specific trace UUID. Returns only logs emitted during that trace.

start · string

ISO 8601 datetime. Only logs at or after this time are returned.

end · string

ISO 8601 datetime. Only logs at or before this time are returned.

limit · number · default: "100"

Maximum number of records to return.

offset · number · default: "0"

Pagination offset. Use with limit to page through results.

Response — 200

total · number

Total number of matching log records (before pagination).

logs · object[]

Matching log records for the current page, ordered newest-first.

Show log record fields

id · string

UUID of the log record.

timestamp · string

ISO 8601 timestamp when the log was emitted.

severity · string

Severity level: trace, debug, info, warn, error, or fatal.

service_name · string

Name of the service that emitted this log (from the OTLP service.name resource attribute).

body · string

The log message body.

attributes · object

Key-value attributes attached to this log record.

trace_id · string | null

UUID of the trace this log was emitted during, or null if the log has no trace context.

span_id · string | null

UUID of the span this log was emitted during, or null.

trace_url · string | null

Computed navigation URL for the linked trace: /traces/{trace_id}. null when trace_id is null.

Example response

{
  "total": 1523,
  "logs": [
    {
      "id": "3a7f8c2d-1e4b-4a9d-b8e2-5f6c7d8e9f0a",
      "timestamp": "2024-01-15T12:05:23.441Z",
      "severity": "error",
      "service_name": "api-gateway",
      "body": "connection refused: upstream timeout after 30s",
      "attributes": {
        "http.method": "POST",
        "http.url": "https://internal-service/classify"
      },
      "trace_id": "550e8400-e29b-41d4-a716-446655440000",
      "span_id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
      "trace_url": "/traces/550e8400-e29b-41d4-a716-446655440000"
    }
  ]
}

---

Get trace link for a log

cURL

curl https://api.agentvista.dev/api/v1/dashboard/logs/3a7f8c2d-1e4b-4a9d-b8e2-5f6c7d8e9f0a/trace \
  -H "Authorization: Bearer av_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

GET /dashboard/logs/{log_id}/trace

Returns trace navigation data for a specific log record. Use this to jump from a log entry to the full trace waterfall. Returns 404 if the log record does not exist, does not belong to the authenticated user, or has no trace_id.

Path parameters

log_id · string · required

UUID of the log record.

Response — 200

trace_id · string

UUID of the trace this log was emitted during.

trace_url · string

Navigation URL for the trace: /traces/{trace_id}.

{
  "trace_id": "550e8400-e29b-41d4-a716-446655440000",
  "trace_url": "/traces/550e8400-e29b-41d4-a716-446655440000"
}