docs/navigation.yml
Rama main · réplica de lectura del repositorio original.
# Canonical Logfire sidebar and public route map for pydantic/unified-docs.
# Keep source paths relative to their named content root; public routes belong in slug.
# yaml-language-server: $schema=https://pydantic.dev/docs/schemas/repository-navigation.schema.json
version: 1
navigation:
- section: "Get Started"
slug: ""
contents:
- page: "Logfire"
path: "index.md"
source: "plain"
slug: "get-started"
title: "Getting started with Pydantic Logfire"
aliases:
- "guides/first_steps"
- "band-get-started"
- "logfire/get-started"
- page: "Send your first trace"
path: "first-trace.md"
source: "plain"
slug: "get-started/first-trace"
- page: "Why Logfire?"
path: "why.md"
source: "plain"
slug: "get-started/why"
aliases:
- "logfire/get-started/why"
- page: "Core Concepts"
path: "concepts.md"
source: "plain"
slug: "get-started/concepts"
aliases:
- "logfire/get-started/concepts"
- page: "FAQ"
path: "faq.md"
source: "plain"
slug: "get-started/faq"
- page: "Get Help"
path: "help.md"
source: "plain"
slug: "get-started/help"
aliases:
- "get-started/join-slack"
- section: "Choose your path"
contents:
- page: "Choose your path"
path: "get-started/choose-your-path.md"
slug: "get-started/choose-your-path"
aliases:
- "get-started/choose-your-path/choose-your-path"
- page: "For AI engineers"
path: "get-started/for-ai-engineers.md"
slug: "get-started/for-ai-engineers"
- page: "For backend & SRE"
path: "get-started/for-backend-and-sre.md"
slug: "get-started/for-backend-and-sre"
title: "For backend engineers and SREs"
- page: "For platform & security"
path: "get-started/for-platform-and-security.md"
slug: "get-started/for-platform-and-security"
aliases:
- "get-started/choose-your-path/for-platform-and-security"
title: "For platform and security engineers"
- page: "For product & growth"
path: "get-started/for-product-and-growth.md"
slug: "get-started/for-product-and-growth"
title: "For product and growth"
- page: "Solo builder"
path: "get-started/solo-builder.md"
slug: "get-started/solo-builder"
aliases:
- "get-started/choose-your-path/solo-builder"
title: "Solo builder: just me and my app"
- section: "Coding Agents & MCP"
contents:
- page: "Connect to MCP Server"
path: "how-to-guides/mcp-server.md"
slug: "guides/mcp-server"
aliases:
- "how-to-guides/mcp-server"
- page: "Coding Agent Skills"
path: "how-to-guides/skills.md"
slug: "guides/skills"
aliases:
- "how-to-guides/skills"
- page: "Export Codex Activity"
path: "how-to-guides/codex-logfire-exporter.md"
slug: "guides/codex-logfire-exporter"
aliases:
- "how-to-guides/codex-logfire-exporter"
- section: "Instrumentation"
slug: ""
contents:
- page: "Overview"
path: "instrument/index.md"
slug: "instrument"
aliases:
- "resources/languages"
- section: "Python"
contents:
- page: "Overview"
path: "guides/onboarding-checklist/index.md"
slug: "instrument/python"
aliases:
- "instrument/onboarding-checklist"
- page: "Integrate Logfire"
path: "guides/onboarding-checklist/integrate.md"
slug: "instrument/python/integrate"
aliases:
- "instrument/integrate"
- page: "Manual Tracing"
path: "guides/onboarding-checklist/add-manual-tracing.md"
slug: "instrument/python/add-manual-tracing"
aliases:
- "instrument/add-manual-tracing"
- "guides/onboarding_checklist/03_add_manual_tracing"
- page: "Auto Tracing"
path: "guides/onboarding-checklist/add-auto-tracing.md"
slug: "instrument/python/add-auto-tracing"
aliases:
- "instrument/add-auto-tracing"
title: "Auto-Tracing"
- page: "Metrics"
path: "guides/onboarding-checklist/add-metrics.md"
slug: "instrument/python/add-metrics"
aliases:
- "instrument/add-metrics"
- page: "Distributed Tracing"
path: "how-to-guides/distributed-tracing.md"
slug: "instrument/python/distributed-tracing"
aliases:
- "instrument/distributed-tracing"
- "how-to-guides/distributed-tracing"
- "logfire/instrument/distributed-tracing"
- page: "Sampling Strategies"
path: "how-to-guides/sampling.md"
slug: "instrument/python/sampling"
aliases:
- "instrument/sampling"
- "how-to-guides/sampling"
- "sampling"
- page: "Scrub Sensitive Data"
path: "how-to-guides/scrubbing.md"
slug: "instrument/python/scrubbing"
aliases:
- "instrument/scrubbing"
- "how-to-guides/scrubbing"
- page: "Suppress Spans and Metrics"
path: "how-to-guides/suppress.md"
slug: "instrument/python/suppress"
aliases:
- "instrument/suppress"
- "how-to-guides/suppress"
- page: "Advanced Scrubbing"
path: "how-to-guides/otel-collector/otel-collector-scrubbing.md"
slug: "instrument/python/otel-collector-scrubbing"
aliases:
- "instrument/otel-collector-scrubbing"
- "instrument/opentelemetry-collector/otel-collector-scrubbing"
- "how-to-guides/otel-collector/otel-collector-scrubbing"
- "guides/otel-collector/otel-collector-scrubbing"
# The TypeScript subtree is owned by pydantic/logfire-js/docs/navigation.yml.
- include: typescript
- page: "Rust"
path: "languages/rust.md"
slug: "instrument/rust"
- page: "Go"
path: "languages/go.md"
slug: "instrument/go"
- page: ".NET"
path: "languages/dotnet.md"
slug: "instrument/dotnet"
- page: "Java"
path: "languages/java.md"
slug: "instrument/java"
- page: "Ruby"
path: "languages/ruby.md"
slug: "instrument/ruby"
- page: "PHP"
path: "languages/php.md"
slug: "instrument/php"
- page: "Use Alternative Clients"
path: "how-to-guides/alternative-clients.md"
slug: "guides/alternative-clients"
aliases:
- "how-to-guides/alternative-clients"
- page: "Environments"
path: "how-to-guides/environments.md"
slug: "manage/environments"
aliases:
- "how-to-guides/environments"
- "get-started/environments"
- section: "Integrations"
slug: ""
contents:
- page: "Integrations"
path: "integrations/index.md"
slug: "integrations"
- page: "OpenTelemetry eBPF Instrumentation"
path: "integrations/obi.md"
slug: "integrations/obi"
- section: "Web Frameworks"
contents:
- page: "Web Frameworks"
path: "integrations/web-frameworks/index.md"
slug: "integrations/web-frameworks"
aliases:
- "integrations/use-cases/web-frameworks"
- "guides/advanced/capture_headers"
- page: "FastAPI"
path: "integrations/web-frameworks/fastapi.md"
slug: "integrations/web-frameworks/fastapi"
- page: "Django"
path: "integrations/web-frameworks/django.md"
slug: "integrations/web-frameworks/django"
- page: "Flask"
path: "integrations/web-frameworks/flask.md"
slug: "integrations/web-frameworks/flask"
- page: "Starlette"
path: "integrations/web-frameworks/starlette.md"
slug: "integrations/web-frameworks/starlette"
- page: "Litestar"
path: "integrations/web-frameworks/litestar.md"
slug: "integrations/web-frameworks/litestar"
- page: "AIOHTTP"
path: "integrations/web-frameworks/aiohttp.md"
slug: "integrations/web-frameworks/aiohttp"
- page: "ASGI"
path: "integrations/web-frameworks/asgi.md"
slug: "integrations/web-frameworks/asgi"
- page: "WSGI"
path: "integrations/web-frameworks/wsgi.md"
slug: "integrations/web-frameworks/wsgi"
- page: "Gunicorn"
path: "integrations/web-frameworks/gunicorn.md"
slug: "integrations/web-frameworks/gunicorn"
- section: "Databases"
contents:
- page: "Psycopg"
path: "integrations/databases/psycopg.md"
slug: "integrations/databases/psycopg"
aliases:
- "logfire/integrations/databases/psycopg"
- page: "SQLAlchemy"
path: "integrations/databases/sqlalchemy.md"
slug: "integrations/databases/sqlalchemy"
- page: "Asyncpg"
path: "integrations/databases/asyncpg.md"
slug: "integrations/databases/asyncpg"
- page: "PyMongo"
path: "integrations/databases/pymongo.md"
slug: "integrations/databases/pymongo"
- page: "MySQL"
path: "integrations/databases/mysql.md"
slug: "integrations/databases/mysql"
- page: "SQLite3"
path: "integrations/databases/sqlite3.md"
slug: "integrations/databases/sqlite3"
- page: "Redis"
path: "integrations/databases/redis.md"
slug: "integrations/databases/redis"
- page: "BigQuery"
path: "integrations/databases/bigquery.md"
slug: "integrations/databases/bigquery"
- page: "Elasticsearch"
path: "integrations/databases/elasticsearch.md"
slug: "integrations/databases/elasticsearch"
- page: "Snowflake"
path: "integrations/databases/snowflake.md"
slug: "integrations/databases/snowflake"
- page: "SurrealDB"
path: "integrations/databases/surrealdb.md"
slug: "integrations/databases/surrealdb"
- section: "HTTP Clients"
contents:
- page: "HTTPX"
path: "integrations/http-clients/httpx.md"
slug: "integrations/http-clients/httpx"
- page: "HTTPX2"
path: "integrations/http-clients/httpx2.md"
slug: "integrations/http-clients/httpx2"
- page: "Requests"
path: "integrations/http-clients/requests.md"
slug: "integrations/http-clients/requests"
- page: "AIOHTTP"
path: "integrations/http-clients/aiohttp.md"
slug: "integrations/http-clients/aiohttp"
- section: "Task Queues & Pipelines"
contents:
- page: "Airflow"
path: "integrations/event-streams/airflow.md"
slug: "integrations/event-streams/airflow"
- page: "FastStream"
path: "integrations/event-streams/faststream.md"
slug: "integrations/event-streams/faststream"
- page: "Celery"
path: "integrations/event-streams/celery.md"
slug: "integrations/event-streams/celery"
- section: "Logging"
contents:
- page: "Logging"
path: "integrations/logging.md"
slug: "integrations/logging/logging"
aliases:
- "logging"
- "integrations/logging"
- page: "Print"
path: "integrations/print.md"
slug: "integrations/logging/print"
- page: "Structlog"
path: "integrations/structlog.md"
slug: "integrations/logging/structlog"
aliases:
- "integrations/structlog"
- page: "Loguru"
path: "integrations/loguru.md"
slug: "integrations/logging/loguru"
aliases:
- "integrations/loguru"
- page: "Pytest"
path: "integrations/pytest.md"
slug: "integrations/pytest"
- page: "Pydantic"
path: "integrations/pydantic.md"
slug: "integrations/pydantic"
- page: "Pydantic Monty"
path: "integrations/monty.md"
slug: "integrations/monty"
- page: "System Metrics"
path: "integrations/system-metrics.md"
slug: "integrations/system-metrics"
- page: "Stripe"
path: "integrations/stripe.md"
slug: "integrations/stripe"
- page: "AWS Lambda"
path: "integrations/aws-lambda.md"
slug: "integrations/aws-lambda"
- page: "Codex"
path: "integrations/codex.md"
slug: "integrations/codex"
- section: "AI Engineering"
slug: ""
contents:
- page: "Overview"
path: "ai-observability.md"
source: "plain"
slug: "get-started/ai-observability"
aliases:
- "logfire/get-started/ai-observability"
- section: "Connect an SDK or platform"
contents:
- section: "No-code platforms"
contents:
- page: "Overview"
path: "integrations/no-code/index.md"
slug: "integrations/no-code"
- page: "Dify"
path: "integrations/no-code/dify.md"
slug: "integrations/no-code/dify"
- page: "Flowise"
path: "integrations/no-code/flowise.md"
slug: "integrations/no-code/flowise"
- page: "Goose"
path: "integrations/no-code/goose.md"
slug: "integrations/no-code/goose"
- page: "Langflow"
path: "integrations/no-code/langflow.md"
slug: "integrations/no-code/langflow"
- page: "LobeChat"
path: "integrations/no-code/lobe-chat.md"
slug: "integrations/no-code/lobe-chat"
- page: "n8n"
path: "integrations/no-code/n8n.md"
slug: "integrations/no-code/n8n"
- page: "Open WebUI"
path: "integrations/no-code/open-webui.md"
slug: "integrations/no-code/open-webui"
- page: "AI & LLM integrations"
path: "integrations/llms/index.md"
slug: "integrations/llms"
- page: "Pydantic AI"
path: "integrations/llms/pydanticai.md"
slug: "integrations/llms/pydanticai"
aliases:
- "integrations/pydantic-ai"
- "integrations/llms/pydantic-ai"
- page: "OpenAI"
path: "integrations/llms/openai.md"
slug: "integrations/llms/openai"
- page: "OpenRouter Broadcast"
path: "integrations/llms/openrouter.md"
slug: "integrations/llms/openrouter"
- page: "Google Gen AI"
path: "integrations/llms/google-genai.md"
slug: "integrations/llms/google-genai"
- page: "Anthropic"
path: "integrations/llms/anthropic.md"
slug: "integrations/llms/anthropic"
- page: "Claude Platform"
path: "integrations/llms/claude-platform.md"
slug: "integrations/llms/claude-platform"
- page: "LangChain"
path: "integrations/llms/langchain.md"
slug: "integrations/llms/langchain"
- page: "LiteLLM"
path: "integrations/llms/litellm.md"
slug: "integrations/llms/litellm"
- page: "DSPy"
path: "integrations/llms/dspy.md"
slug: "integrations/llms/dspy"
- page: "MCP"
path: "integrations/llms/mcp.md"
slug: "integrations/llms/mcp"
- page: "LlamaIndex"
path: "integrations/llms/llamaindex.md"
slug: "integrations/llms/llamaindex"
- page: "Mirascope"
path: "integrations/llms/mirascope.md"
slug: "integrations/llms/mirascope"
- page: "Magentic"
path: "integrations/llms/magentic.md"
slug: "integrations/llms/magentic"
- page: "Instructor"
path: "integrations/llms/instructor.md"
slug: "integrations/llms/instructor"
- page: "Pixeltable"
path: "integrations/llms/pixeltable.md"
slug: "integrations/llms/pixeltable"
- section: "Agent frameworks"
contents:
- page: "Overview"
path: "integrations/agent-frameworks/index.md"
slug: "integrations/agent-frameworks"
- page: "Support matrix"
path: "integrations/agent-frameworks/support-matrix.md"
slug: "integrations/agent-frameworks/support-matrix"
- page: "Agno"
path: "integrations/llms/agno.md"
slug: "integrations/llms/agno"
- page: "AutoGen"
path: "integrations/llms/autogen.md"
slug: "integrations/llms/autogen"
- page: "Claude Agent SDK"
path: "integrations/llms/claude-agent-sdk.md"
slug: "integrations/llms/claude-agent-sdk"
- page: "CrewAI"
path: "integrations/llms/crewai.md"
slug: "integrations/llms/crewai"
- page: "Google ADK"
path: "integrations/llms/google-adk.md"
slug: "integrations/llms/google-adk"
- page: "Haystack"
path: "integrations/llms/haystack.md"
slug: "integrations/llms/haystack"
- page: "LangGraph"
path: "integrations/llms/langgraph.md"
slug: "integrations/llms/langgraph"
- page: "Letta"
path: "integrations/llms/letta.md"
slug: "integrations/llms/letta"
- page: "Semantic Kernel (Python)"
path: "integrations/llms/semantic-kernel.md"
slug: "integrations/llms/semantic-kernel"
- page: "smolagents"
path: "integrations/llms/smolagents.md"
slug: "integrations/llms/smolagents"
- page: "Strands Agents"
path: "integrations/llms/strands.md"
slug: "integrations/llms/strands"
- page: "Eve"
path: "integrations/agent-frameworks/eve.md"
slug: "integrations/agent-frameworks/eve"
- page: "LangChain.js and LangGraph.js"
path: "integrations/agent-frameworks/langchain-js.md"
slug: "integrations/agent-frameworks/langchain-js"
- page: "LlamaIndex.TS"
path: "integrations/agent-frameworks/llamaindex-ts.md"
slug: "integrations/agent-frameworks/llamaindex-ts"
- page: "Mastra"
path: "integrations/agent-frameworks/mastra.md"
slug: "integrations/agent-frameworks/mastra"
- page: "OpenAI Agents SDK (TypeScript)"
path: "integrations/agent-frameworks/openai-agents-js.md"
slug: "integrations/agent-frameworks/openai-agents-js"
- page: "Vercel AI SDK"
path: "integrations/agent-frameworks/vercel-ai-sdk.md"
slug: "integrations/agent-frameworks/vercel-ai-sdk"
- page: "VoltAgent"
path: "integrations/agent-frameworks/voltagent.md"
slug: "integrations/agent-frameworks/voltagent"
- page: "Eino (Go)"
path: "integrations/agent-frameworks/eino.md"
slug: "integrations/agent-frameworks/eino"
- page: "Genkit (Go)"
path: "integrations/agent-frameworks/genkit-go.md"
slug: "integrations/agent-frameworks/genkit-go"
- page: "Rig (Rust)"
path: "integrations/agent-frameworks/rig.md"
slug: "integrations/agent-frameworks/rig"
- page: "Microsoft Agent Framework (.NET)"
path: "integrations/agent-frameworks/agent-framework-dotnet.md"
slug: "integrations/agent-frameworks/agent-framework-dotnet"
- page: "Semantic Kernel (.NET)"
path: "integrations/agent-frameworks/semantic-kernel-dotnet.md"
slug: "integrations/agent-frameworks/semantic-kernel-dotnet"
- section: "Observe & debug"
contents:
- page: "Agents"
path: "guides/web-ui/agents.md"
slug: "observe/agents"
- page: "LLMs and Providers"
path: "guides/web-ui/llms.md"
slug: "observe/llms"
- page: "LLM Panels"
path: "guides/web-ui/llm-panels.md"
slug: "observe/llm-panels"
- page: "Prompt Playground"
path: "guides/web-ui/prompt-playground.md"
slug: "observe/prompt-playground"
- section: "Evaluations"
contents:
- page: "Overview"
path: "evaluate/overview.md"
slug: "evaluate/overview"
- page: "Datasets & Experiments"
path: "evaluate/datasets-and-experiments.md"
slug: "evaluate/datasets-and-experiments"
aliases:
- "evaluate/datasets"
- "evaluate/datasets/ui"
- "evaluate/evals"
- page: "Manage Datasets"
path: "evaluate/manage-datasets.md"
slug: "evaluate/manage-datasets"
- page: "Review Experiments"
path: "evaluate/review-experiments.md"
slug: "evaluate/review-experiments"
- page: "Evals in Code"
path: "evaluate/evals-in-code.md"
slug: "evaluate/evals-in-code"
aliases:
- "evaluate/datasets/evaluations"
- page: "Live Evals"
path: "evaluate/live-evals.md"
slug: "evaluate/live-evals"
- page: "Human Review"
path: "evaluate/human-review.md"
slug: "evaluate/human-review"
- page: "Annotate an Agent Run"
path: "evaluate/annotate-agent-runs.md"
slug: "evaluate/annotate-agent-runs"
- page: "Datasets SDK"
path: "evaluate/datasets-sdk.md"
slug: "evaluate/datasets-sdk"
title: "SDK Reference"
aliases:
- "evaluate/datasets/sdk"
- section: "Prompt Management"
contents:
- page: "Overview"
path: "reference/advanced/prompt-management/index.md"
slug: "prompt-management"
aliases:
- "reference/advanced/prompt-management"
- page: "Core Concepts"
path: "reference/advanced/prompt-management/concepts.md"
slug: "prompt-management/concepts"
- page: "UI Guide"
path: "reference/advanced/prompt-management/ui.md"
slug: "prompt-management/ui"
- page: "Writing Templates"
path: "reference/advanced/prompt-management/templates.md"
slug: "prompt-management/templates"
aliases:
- "logfire/prompt-management/templates"
- page: "Prompt Composition Walkthrough"
path: "reference/advanced/prompt-management/composition-walkthrough.md"
slug: "prompt-management/composition-walkthrough"
- page: "Promote and Roll Out Prompts"
path: "reference/advanced/prompt-management/promotion-and-rollouts.md"
slug: "prompt-management/promotion-and-rollouts"
aliases:
- "logfire/prompt-management/promotion-and-rollouts"
- page: "Test Prompts"
path: "reference/advanced/prompt-management/scenarios.md"
slug: "prompt-management/scenarios"
- page: "Use Prompts in Your Application"
path: "reference/advanced/prompt-management/application.md"
slug: "prompt-management/application"
aliases:
- "logfire/prompt-management/application"
- page: "Template Reference"
path: "reference/advanced/prompt-management/template-reference.md"
slug: "prompt-management/template-reference"
- page: "Access and Prerequisites"
path: "reference/advanced/prompt-management/plan-requirements.md"
slug: "prompt-management/plan-requirements"
- section: "AI Gateway"
contents:
- page: "Overview"
path: "reference/advanced/gateway/index.md"
slug: "manage/ai-gateway"
aliases:
- "gateway-migration"
- "manage/gateway-migration"
- "manage/gateway"
- "reference/gateway"
- page: "Send Your First Request"
path: "reference/advanced/gateway/first-request.md"
slug: "manage/ai-gateway/first-request"
- page: "See Gateway Requests in Your Trace"
path: "reference/advanced/gateway/telemetry.md"
slug: "manage/ai-gateway/telemetry"
- page: "Add Your Own Provider"
path: "reference/advanced/gateway/byok-providers.md"
slug: "manage/ai-gateway/byok-providers"
- page: "Route Across Providers"
path: "reference/advanced/gateway/endpoints.md"
slug: "manage/ai-gateway/endpoints"
- page: "Protect Request Data"
path: "reference/advanced/gateway/protect-data.md"
slug: "manage/ai-gateway/protect-data"
- page: "Optimize Requests"
path: "reference/advanced/gateway/optimizations.md"
slug: "manage/ai-gateway/optimizations"
- page: "Control Spending"
path: "reference/advanced/gateway/spending-policies.md"
slug: "manage/ai-gateway/spending-policies"
- page: "Control Model Access"
path: "reference/advanced/gateway/model-access.md"
slug: "manage/ai-gateway/model-access"
- page: "Embeddings"
path: "reference/advanced/gateway/embeddings.md"
slug: "manage/ai-gateway/embeddings"
- page: "Audio Transcriptions"
path: "reference/advanced/gateway/transcriptions.md"
slug: "manage/ai-gateway/transcriptions"
- section: "Connect an agent"
contents:
- page: "Overview"
path: "reference/advanced/gateway/integrations/index.md"
slug: "manage/ai-gateway/integrations"
aliases:
- "manage/integrations"
- page: "Agno"
path: "reference/advanced/gateway/integrations/agno.md"
slug: "manage/ai-gateway/integrations/agno"
aliases:
- "manage/agno"
- page: "Genkit"
path: "reference/advanced/gateway/integrations/genkit.md"
slug: "manage/ai-gateway/integrations/genkit"
aliases:
- "manage/genkit"
- page: "Google ADK"
path: "reference/advanced/gateway/integrations/google-adk.md"
slug: "manage/ai-gateway/integrations/google-adk"
aliases:
- "manage/google-adk"
- page: "Haystack"
path: "reference/advanced/gateway/integrations/haystack.md"
slug: "manage/ai-gateway/integrations/haystack"
aliases:
- "manage/haystack"
- page: "Instructor"
path: "reference/advanced/gateway/integrations/instructor.md"
slug: "manage/ai-gateway/integrations/instructor"
aliases:
- "manage/instructor"
- page: "LangChain"
path: "reference/advanced/gateway/integrations/langchain.md"
slug: "manage/ai-gateway/integrations/langchain"
aliases:
- "manage/langchain"
- page: "LlamaIndex"
path: "reference/advanced/gateway/integrations/llamaindex.md"
slug: "manage/ai-gateway/integrations/llamaindex"
aliases:
- "manage/llamaindex"
- page: "Mastra"
path: "reference/advanced/gateway/integrations/mastra.md"
slug: "manage/ai-gateway/integrations/mastra"
aliases:
- "manage/mastra"
- page: "Microsoft Agent Framework"
path: "reference/advanced/gateway/integrations/microsoft-agent-framework.md"
slug: "manage/ai-gateway/integrations/microsoft-agent-framework"
aliases:
- "manage/microsoft-agent-framework"
- page: "OpenAI Agents SDK"
path: "reference/advanced/gateway/integrations/openai-agents-sdk.md"
slug: "manage/ai-gateway/integrations/openai-agents-sdk"
aliases:
- "manage/openai-agents-sdk"
- page: "OpenAI SDK"
path: "reference/advanced/gateway/integrations/openai-sdk.md"
slug: "manage/ai-gateway/integrations/openai-sdk"
aliases:
- "manage/openai-sdk"
- page: "Semantic Kernel"
path: "reference/advanced/gateway/integrations/semantic-kernel.md"
slug: "manage/ai-gateway/integrations/semantic-kernel"
aliases:
- "manage/semantic-kernel"
- page: "Smolagents"
path: "reference/advanced/gateway/integrations/smolagents.md"
slug: "manage/ai-gateway/integrations/smolagents"
aliases:
- "manage/smolagents"
- page: "Strands Agents"
path: "reference/advanced/gateway/integrations/strands-agents.md"
slug: "manage/ai-gateway/integrations/strands-agents"
aliases:
- "manage/strands-agents"
- page: "Vercel AI SDK"
path: "reference/advanced/gateway/integrations/vercel-ai-sdk.md"
slug: "manage/ai-gateway/integrations/vercel-ai-sdk"
aliases:
- "manage/vercel-ai-sdk"
- page: "VoltAgent"
path: "reference/advanced/gateway/integrations/voltagent.md"
slug: "manage/ai-gateway/integrations/voltagent"
aliases:
- "manage/voltagent"
- section: "Observability"
slug: ""
contents:
- page: "Live View"
path: "guides/web-ui/live.md"
slug: "observe/live"
aliases:
- "guides/web-ui"
- page: "Services"
path: "guides/web-ui/services.md"
slug: "observe/services"
- page: "Service Levels"
path: "guides/web-ui/service-levels.md"
slug: "observe/service-levels"
- page: "Hosts"
path: "guides/web-ui/hosts.md"
slug: "observe/hosts"
- page: "Kubernetes"
path: "guides/web-ui/kubernetes.md"
slug: "observe/kubernetes"
- section: "Fleet"
contents:
- page: "Overview"
path: "guides/web-ui/fleet/index.md"
slug: "observe/fleet"
aliases:
- "guides/fleet"
- "fleet"
- page: "Manage Collectors"
path: "guides/web-ui/fleet/collectors.md"
slug: "observe/fleet/collectors"
- page: "Connect an Existing Collector"
path: "guides/web-ui/fleet/existing-collectors.md"
slug: "observe/fleet/existing-collectors"
- page: "Manage Applications"
path: "guides/web-ui/fleet/applications.md"
slug: "observe/fleet/applications"
- page: "Change Policies"
path: "guides/web-ui/fleet/policies.md"
slug: "observe/fleet/policies"
- page: "Docker"
path: "guides/web-ui/docker.md"
slug: "observe/docker"
- page: "Metrics Explorer"
path: "guides/web-ui/metrics-explorer.md"
slug: "observe/metrics-explorer"
- page: "Public Traces"
path: "guides/web-ui/public-traces.md"
slug: "observe/public-traces"
- page: "Public Conversations"
path: "reference/advanced/public-conversations/index.md"
slug: "observe/public-conversations"
- page: "Detect Service is Down"
path: "how-to-guides/detect-service-is-down.md"
slug: "observe/detect-service-is-down"
aliases:
- "how-to-guides/detect-service-is-down"
- page: "Collect Cloud Provider Metrics"
path: "how-to-guides/cloud-metrics.md"
slug: "guides/cloud-metrics"
aliases:
- "how-to-guides/cloud-metrics"
- page: "Send AWS logs and metrics through Firehose"
path: "how-to-guides/aws-firehose.md"
slug: "guides/aws-firehose"
- section: "OpenTelemetry Collector"
contents:
- page: "Overview"
path: "how-to-guides/otel-collector/otel-collector-overview.md"
slug: "guides/otel-collector/otel-collector-overview"
aliases:
- "instrument/opentelemetry-collector/otel-collector-overview"
- "how-to-guides/otel-collector/otel-collector-overview"
- page: "Host Monitoring"
path: "how-to-guides/otel-collector/host-monitoring.md"
slug: "guides/otel-collector/host-monitoring"
aliases:
- "instrument/opentelemetry-collector/host-monitoring"
- "how-to-guides/otel-collector/host-monitoring"
- "logfire/guides/otel-collector/host-monitoring"
- section: "Kubernetes Monitoring"
contents:
- page: "Standard Setup"
path: "how-to-guides/otel-collector/kubernetes-monitoring.md"
slug: "guides/otel-collector/kubernetes-monitoring"
title: "Kubernetes monitoring with the OTel Collector"
aliases:
- "instrument/opentelemetry-collector/kubernetes-monitoring"
- "how-to-guides/otel-collector/kubernetes-monitoring"
- page: "Collect More Data"
path: "how-to-guides/otel-collector/kubernetes-collect-more.md"
slug: "guides/otel-collector/kubernetes-monitoring/collect-more"
title: "Collect more data from Kubernetes"
- page: "Reduce Data Volume"
path: "how-to-guides/otel-collector/kubernetes-reduce-volume.md"
slug: "guides/otel-collector/kubernetes-monitoring/reduce-volume"
title: "Reduce Kubernetes monitoring volume"
- page: "Custom Collector Setup"
path: "how-to-guides/otel-collector/kubernetes-manual-setup.md"
slug: "guides/otel-collector/kubernetes-monitoring/custom-collector"
title: "Build a custom Kubernetes Collector deployment"
- page: "Back up to AWS S3"
path: "how-to-guides/otel-collector/s3-backup.md"
slug: "guides/otel-collector/s3-backup"
aliases:
- "instrument/opentelemetry-collector/s3-backup"
- "how-to-guides/otel-collector/s3-backup"
- section: "Dashboards, Alerts & Query"
slug: ""
contents:
- page: "Dashboards"
path: "guides/web-ui/dashboards.md"
slug: "observe/dashboards"
- page: "Integrations"
path: "guides/web-ui/integrations.md"
slug: "observe/integrations"
- page: "Write Dashboard Queries"
path: "how-to-guides/write-dashboard-queries.md"
slug: "observe/write-dashboard-queries"
aliases:
- "how-to-guides/write-dashboard-queries"
- page: "Alerts"
path: "guides/web-ui/alerts.md"
slug: "observe/alerts"
- page: "PagerDuty"
path: "how-to-guides/pagerduty.md"
slug: "observe/pagerduty"
- page: "Slack App"
path: "how-to-guides/slack-app.md"
slug: "observe/slack-app"
- page: "Setup Slack Alerts"
path: "how-to-guides/setup-slack-alerts.md"
slug: "observe/setup-slack-alerts"
aliases:
- "how-to-guides/setup-slack-alerts"
- "guides/setup-slack-alerts"
- page: "Error Tracking"
path: "guides/web-ui/issues.md"
slug: "observe/issues"
- page: "SQL Workbench"
path: "guides/web-ui/explore.md"
slug: "observe/explore"
- page: "SQL"
path: "reference/sql.md"
slug: "reference/sql"
- page: "Query Accuracy"
path: "reference/query-accuracy.md"
slug: "reference/query-accuracy"
- page: "Saved Searches"
path: "guides/web-ui/saved-searches.md"
slug: "observe/saved-searches"
- page: "Export Data"
path: "how-to-guides/query-api.md"
slug: "manage/query-api"
aliases:
- "reference/query-api"
- "how-to-guides/query-api"
- section: "User Experience"
slug: ""
contents:
- page: "Frontend"
path: "guides/web-ui/frontend.md"
slug: "observe/frontend"
- page: "Session Replays"
path: "guides/web-ui/session-replays.md"
slug: "observe/session-replays"
- section: "Feature Flags"
contents:
- page: "Overview"
path: "reference/advanced/managed-variables/index.md"
slug: "manage/managed-variables"
aliases:
- "reference/advanced/managed-variables"
- page: "UI Guide"
path: "reference/advanced/managed-variables/ui.md"
slug: "manage/managed-variables/ui"
- page: "Templates & Composition"
path: "reference/advanced/managed-variables/templates-and-composition.md"
slug: "manage/managed-variables/templates-and-composition"
- page: "A/B Testing"
path: "reference/advanced/managed-variables/ab-testing.md"
slug: "manage/managed-variables/ab-testing"
- page: "Targeting"
path: "reference/advanced/managed-variables/targeting.md"
slug: "manage/managed-variables/targeting"
- page: "Remote Variables"
path: "reference/advanced/managed-variables/remote.md"
slug: "manage/managed-variables/remote"
aliases:
- "logfire/manage/managed-variables/remote"
- page: "External Variables & OFREP"
path: "reference/advanced/managed-variables/external.md"
slug: "manage/managed-variables/external"
- page: "Local Variables"
path: "reference/advanced/managed-variables/local.md"
slug: "manage/managed-variables/local"
- page: "Configuration Reference"
path: "reference/advanced/managed-variables/configuration-reference.md"
slug: "manage/managed-variables/configuration-reference"
- page: "Client Side flags (ofrep)"
path: "how-to-guides/client-side-feature-flags.md"
slug: "manage/client-side-feature-flags"
aliases:
- "how-to-guides/client-side-feature-flags"
title: "Feature Flags (OFREP)"
- section: "Manage Logfire"
slug: ""
contents:
- section: "Organizations & Access"
contents:
- page: "Organizations, Projects & Members"
path: "guides/web-ui/organizations-and-projects.md"
slug: "manage/organizations-and-projects"
aliases:
- "reference/organization-structure"
- page: "Create a Team"
path: "how-to-guides/convert-to-organization.md"
slug: "manage/convert-to-organization"
aliases:
- "how-to-guides/convert-to-organization"
- page: "SSO Setup"
path: "how-to-guides/sso-setup.md"
source: "plain"
slug: "deploy/sso-setup"
aliases:
- "how-to-guides/sso-setup"
- page: "SCIM Provisioning"
path: "scim-provisioning.md"
source: "plain"
slug: "deploy/scim-provisioning"
- section: "Credentials & Automation"
contents:
- page: "Write Tokens"
path: "how-to-guides/create-write-tokens.md"
slug: "manage/create-write-tokens"
aliases:
- "how-to-guides/create-write-tokens"
- page: "API Keys"
path: "reference/advanced/use-api-keys.md"
slug: "manage/use-api-keys"
- page: "OAuth Apps"
path: "how-to-guides/oauth-apps.md"
slug: "manage/oauth-apps"
- page: "MCP Access"
path: "how-to-guides/mcp-access.md"
slug: "manage/mcp-access"
title: "Control external MCP access"
- page: "Infrastructure as Code"
path: "how-to-guides/infrastructure-as-code.md"
slug: "manage/infrastructure-as-code"
aliases:
- "how-to-guides/infrastructure-as-code"
- "guides/infrastructure-as-code"
- section: "Data & Usage"
contents:
- page: "Cost & Usage"
path: "logfire-costs.md"
slug: "manage/logfire-costs"
- page: "Ingest Limits"
path: "reference/limits.md"
slug: "reference/limits"
- page: "Query Limits"
path: "reference/query-limits.md"
slug: "reference/query-limits"
- page: "Data Regions"
path: "reference/data-regions.md"
slug: "manage/data-regions"
- section: "Security & Governance"
contents:
- page: "Email Code Sign-In"
path: "how-to-guides/email-code-sign-in.md"
slug: "manage/email-code-sign-in"
- page: "Compliance"
path: "compliance.md"
source: "plain"
slug: "deploy/compliance"
- page: "Audit Logs API"
path: "audit-logs-api.md"
source: "plain"
slug: "deploy/audit-logs-api"
- section: "Deploy Logfire"
slug: ""
contents:
- page: "Deployment Options"
path: "enterprise.md"
source: "plain"
slug: "deploy/enterprise"
- page: "Dedicated Single Tenant"
path: "enterprise-single-tenant.md"
source: "plain"
slug: "deploy/enterprise-single-tenant"
aliases:
- "enterprise-single-tenant"
- section: "Self-Hosted"
contents:
- page: "Overview"
path: "reference/self-hosted/overview.md"
source: "plain"
slug: "deploy/self-hosted-deployment/overview"
aliases:
- "reference/self-hosted/overview"
- "self-hosted"
- "self-hosted/introduction"
- page: "Local Quickstart"
path: "reference/self-hosted/local-quickstart.md"
source: "plain"
slug: "deploy/self-hosted-deployment/local-quickstart"
- page: "Architecture"
path: "reference/self-hosted/architecture.md"
source: "plain"
slug: "deploy/self-hosted-deployment/architecture"
- page: "Production Requirements"
path: "reference/self-hosted/installation.md"
source: "plain"
slug: "deploy/self-hosted-deployment/installation"
aliases:
- "self-hosted/installation"
- page: "Examples"
path: "reference/self-hosted/examples.md"
source: "plain"
slug: "deploy/self-hosted-deployment/examples"
- page: "Troubleshooting"
path: "reference/self-hosted/troubleshooting.md"
source: "plain"
slug: "deploy/self-hosted-deployment/troubleshooting"
- page: "Bucket Migration"
path: "reference/self-hosted/bucket-migration.md"
source: "plain"
slug: "deploy/self-hosted-deployment/bucket-migration"
- page: "FusionFire Database Migration"
path: "reference/self-hosted/ff-database-migration.md"
source: "plain"
slug: "deploy/self-hosted-deployment/ff-database-migration"
- page: "Usage Report"
path: "reference/self-hosted/usage-report.md"
source: "plain"
slug: "deploy/self-hosted-deployment/usage-report"
- section: "Reference & Resources"
slug: ""
contents:
- section: "Reference"
contents:
- page: "Configuration"
path: "reference/configuration.md"
slug: "manage/configuration"
title: "Logfire Configuration Guide & Environment Variables"
aliases:
- "reference/configuration"
- section: "API"
contents:
- page: "Logfire"
path: "reference/api/logfire.md"
slug: "api/logfire"
aliases:
- "api"
- "reference/logfire"
- page: "Testing"
path: "reference/api/testing.md"
slug: "api/testing"
- page: "Sampling"
path: "reference/api/sampling.md"
slug: "api/sampling"
- page: "Propagate"
path: "reference/api/propagate.md"
slug: "api/propagate"
- page: "Exceptions"
path: "reference/api/exceptions.md"
slug: "api/exceptions"
- page: "Pydantic"
path: "reference/api/pydantic.md"
slug: "api/pydantic"
aliases:
- "api/integrations/pydantic"
- page: "Types"
path: "reference/api/types.md"
slug: "api/types"
- page: "Datasets"
path: "reference/api/datasets.md"
slug: "api/datasets"
aliases:
- "evaluate/datasets/sdk-reference"
- page: "Query client"
path: "reference/api/query_client.md"
slug: "api/query_client"
title: "Query Client"
- page: "CLI"
path: "reference/cli.md"
slug: "reference/cli"
aliases:
- "logfire/reference/cli"
title: "Logfire SDK CLI: SDK Command Line Interface Guide"
- page: "Examples"
path: "reference/examples.md"
slug: "reference/examples"
aliases:
- "examples"
- "reference"
title: "Logfire Examples: Practical Tracing & Metrics Demos"
- section: "Advanced"
contents:
- page: "Baggage"
path: "reference/advanced/baggage.md"
slug: "reference/baggage"
aliases:
- "reference/advanced/baggage"
title: "Pydantic Logfire OTel Baggage Reference"
- page: "Generators"
path: "reference/advanced/generators.md"
slug: "reference/generators"
title: "Pydantic Logfire Generators References"
- page: "Aggregating Metrics in Spans"
path: "reference/advanced/metrics-in-spans.md"
slug: "reference/metrics-in-spans"
title: "Aggregating Metrics in Spans with Logfire"
- page: "Testing Logfire Instrumentation"
path: "reference/advanced/testing.md"
slug: "reference/testing"
- page: "Migrating Projects"
path: "reference/advanced/migrate-to-new-project.md"
slug: "reference/migrate-to-new-project"
title: "How to Migrate to a New Logfire Project"
- page: "Link to Code Source"
path: "how-to-guides/link-to-code-source.md"
slug: "guides/link-to-code-source"
aliases:
- "how-to-guides/link-to-code-source"
title: "Logfire GitHub Integration Guide: Link to Code Source"
- page: "Use Alternative Backends"
path: "how-to-guides/alternative-backends.md"
slug: "guides/alternative-backends"
aliases:
- "reference/advanced/alternative-backends"
- "how-to-guides/alternative-backends"
- "logfire/guides/alternative-backends"
title: "How to use Alternative Backends with Logfire"
- page: "Multiple Configurations"
path: "how-to-guides/different-configurations.md"
slug: "manage/different-configurations"
aliases:
- "how-to-guides/different-configurations"
title: "Combining Multiple Configurations in Logfire"
- section: "Cookbook"
contents:
- page: "Overview"
path: "cookbook/index.md"
slug: "cookbook"
- page: "Instrument & evaluate an agent"
path: "cookbook/evaluate-an-agent.md"
slug: "cookbook/evaluate-an-agent"
- page: "Debug a slow endpoint"
path: "cookbook/debug-a-slow-endpoint.md"
slug: "cookbook/debug-a-slow-endpoint"
- page: "Debug a slow tool call"
path: "cookbook/debug-a-slow-tool-call.md"
slug: "cookbook/debug-a-slow-tool-call"
- page: "Roll out a prompt safely"
path: "cookbook/roll-out-a-prompt-safely.md"
slug: "cookbook/roll-out-a-prompt-safely"
- page: "Track & alert on LLM cost"
path: "cookbook/track-llm-cost.md"
slug: "cookbook/track-llm-cost"
# The head-to-head comparison pages (vs Datadog, Grafana, …) moved to the
# public marketing site (pydantic.dev/logfire/vs-*); the docs redirect the
# old URLs there. This section is about *migrating* to Logfire — pointing an
# existing OpenTelemetry pipeline (SDKs or a Collector distribution) at us —
# plus the Braintrust eval-data migration guide (slug kept unchanged so its
# existing links and alias keep working).
- section: "Migrating"
contents:
- page: "Overview"
path: "migrating/overview.md"
slug: "migrate/overview"
title: "Migrate to Logfire from another OpenTelemetry backend"
- page: "From Datadog"
path: "migrating/datadog.md"
slug: "migrate/datadog"
title: "Migrate from Datadog to Logfire"
- page: "From Grafana Cloud"
path: "migrating/grafana.md"
slug: "migrate/grafana"
title: "Migrate from Grafana Cloud to Logfire"
- page: "From Honeycomb"
path: "migrating/honeycomb.md"
slug: "migrate/honeycomb"
title: "Migrate from Honeycomb to Logfire"
- page: "From New Relic"
path: "migrating/new-relic.md"
slug: "migrate/new-relic"
title: "Migrate from New Relic to Logfire"
- page: "From Dynatrace"
path: "migrating/dynatrace.md"
slug: "migrate/dynatrace"
title: "Migrate from Dynatrace to Logfire"
- page: "From Splunk"
path: "migrating/splunk.md"
slug: "migrate/splunk"
title: "Migrate from Splunk Observability Cloud to Logfire"
- page: "From Elastic"
path: "migrating/elastic.md"
slug: "migrate/elastic"
title: "Migrate from Elastic to Logfire"
- page: "From AWS (CloudWatch / X-Ray)"
path: "migrating/aws.md"
slug: "migrate/aws"
title: "Migrate from AWS to Logfire"
- page: "Move from Braintrust"
path: "comparisons/migrate-from-braintrust.md"
source: "plain"
slug: "get-started/comparisons/migrate-from-braintrust"
title: "Move from Braintrust to Logfire"
aliases:
- "get-started/comparisons/save-me-from-braintrust"
- page: "Roadmap"
path: "roadmap.md"
source: "plain"
slug: "resources/roadmap"
aliases:
- "logfire/resources/roadmap"
- page: "Release Notes"
path: "release-notes.md"
source: "plain"
slug: "resources/release-notes"
aliases:
- "release_notes"
- "release-notes"
redirects:
# Exact internal redirects live as aliases on their destination pages. These
# rules stay top-level because they use wildcards, fragments, or external targets.
- from: "gateway-migration/*"
to: "manage/ai-gateway"
- from: "manage/gateway-migration/*"
to: "manage/ai-gateway"
- from: "deploy/self-hosted-deployment/scaling"
to: "deploy/self-hosted-deployment/installation#sizing-and-storage"
- from: "guides/web-ui/*"
to: "observe/:splat"
- from: "legal/service_level_agreement"
to: "https://pydantic.dev/legal/terms-of-service"
- from: "legal/terms_of_service"
to: "https://pydantic.dev/legal/terms-of-service"
- from: "legal/data_processing_addendum"
to: "https://pydantic.dev/legal/data-processing-addendum"
- from: "legal/cloud_subprocessors"
to: "https://pydantic.dev/legal/cloud-subprocessors"
- from: "legal/terms-of-service"
to: "https://pydantic.dev/legal/terms-of-service"
- from: "legal/privacy"
to: "https://pydantic.dev/legal/privacy-policy"
- from: "legal/data-processing-addendum"
to: "https://pydantic.dev/legal/data-processing-addendum"
- from: "legal/cloud-subprocessors"
to: "https://pydantic.dev/legal/cloud-subprocessors"
- from: "api/integrations/structlog"
to: "api/logfire#logfire.StructlogProcessor"
- from: "api/integrations/logging"
to: "api/logfire#logfire.LogfireLoggingHandler"
- from: "reference/self-hosted/scaling"
to: "deploy/self-hosted-deployment/installation#sizing-and-storage"