---
title: "Observability"
description: "Trace Ask AI and MCP runs with span IDs, timing, status, previews, errors, and callbacks"
canonical_url: "https://docs.farming-labs.dev/docs/customization/observability"
markdown_url: "https://docs.farming-labs.dev/docs/customization/observability.md"
last_updated: "2018-10-20"
agent:
  tokenBudget: 900
---

# Observability

## Observability task

Task: Observability

Expected result: Trace Ask AI and MCP runs with span IDs, timing, status, previews, errors, and callbacks

## Observability verification



## Observability agent guidance

Top-level `observability` covers steps inside Ask AI and MCP runs. `observability: true` writes the
`[@farming-labs/docs:observability]` stream; its console mode shows local traces, while
`observability.onEvent` forwards `DocsObservabilityEvent` objects.

Verify one trace contains a shared `traceId`, child `spanId` values, status, and `durationMs`, with
Ask AI lifecycle events or `tool.call`/`tool.result` for MCP. Built-in previews exclude raw user
text; separate raw `input` fields are omitted unless `includeInputs` is enabled. If only `page_view`,
`search_query`, `api_ai_request`, or `mcp_tool` appears, inspect `analytics.onEvent`; those are usage
events rather than runtime spans.

## Sitemap

See the full [sitemap](/sitemap.md) for all pages.
Docs-scoped sitemap: [/docs/sitemap.md](/docs/sitemap.md).
Well-known sitemap: [/.well-known/sitemap.md](/.well-known/sitemap.md).