# 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" - section: "TypeScript" contents: - page: "Overview" path: "index.md" source: "typescript" slug: "instrument/typescript" aliases: - "typescript-sdk" - "integrations/javascript" - page: "Getting Started" path: "get-started.md" source: "typescript" slug: "instrument/typescript/get-started" aliases: - "typescript-sdk/get-started" - section: "Packages" contents: - page: "Core API" path: "packages/logfire.md" source: "typescript" slug: "instrument/typescript/packages/logfire" aliases: - "typescript-sdk/packages/logfire" - page: "Node.js" path: "packages/node.md" source: "typescript" slug: "instrument/typescript/packages/node" aliases: - "typescript-sdk/packages/node" - "integrations/javascript/node" - page: "Browser" path: "packages/browser.md" source: "typescript" slug: "instrument/typescript/packages/browser" aliases: - "typescript-sdk/packages/browser" - "integrations/javascript/browser" - page: "Cloudflare Workers" path: "packages/cloudflare.md" source: "typescript" slug: "instrument/typescript/packages/cloudflare" aliases: - "typescript-sdk/packages/cloudflare" - "integrations/javascript/cloudflare" - section: "Frameworks & Runtimes" contents: - page: "Express" path: "frameworks/express.md" source: "typescript" slug: "instrument/typescript/frameworks/express" aliases: - "typescript-sdk/frameworks/express" - "integrations/javascript/express" - page: "Next.js" path: "frameworks/nextjs.md" source: "typescript" slug: "instrument/typescript/frameworks/nextjs" aliases: - "typescript-sdk/frameworks/nextjs" - "integrations/javascript/nextjs" - page: "Deno" path: "frameworks/deno.md" source: "typescript" slug: "instrument/typescript/frameworks/deno" aliases: - "typescript-sdk/frameworks/deno" - "integrations/javascript/deno" - page: "Vercel AI SDK" path: "frameworks/vercel-ai.md" source: "typescript" slug: "instrument/typescript/frameworks/vercel-ai" aliases: - "typescript-sdk/frameworks/vercel-ai" - "integrations/javascript/vercel-ai" - page: "Configuration" path: "configuration.md" source: "typescript" slug: "instrument/typescript/configuration" aliases: - "typescript-sdk/configuration" - page: "Resource Attributes" path: "resource-attributes.md" source: "typescript" slug: "instrument/typescript/resource-attributes" aliases: - "typescript-sdk/resource-attributes" - page: "Sampling" path: "sampling.md" source: "typescript" slug: "instrument/typescript/sampling" aliases: - "typescript-sdk/sampling" - page: "Scrubbing" path: "scrubbing.md" source: "typescript" slug: "instrument/typescript/scrubbing" aliases: - "typescript-sdk/scrubbing" - page: "Evaluations" path: "evals.md" source: "typescript" slug: "instrument/typescript/evals" aliases: - "typescript-sdk/evals" - page: "Managed Variables" path: "managed-variables.md" source: "typescript" slug: "instrument/typescript/managed-variables" aliases: - "typescript-sdk/managed-variables" - section: "Reference" contents: - page: "CLI" path: "reference/cli.md" source: "typescript" slug: "instrument/typescript/reference/cli" aliases: - "typescript-sdk/reference/cli" - page: "Environment Variables" path: "reference/environment-variables.md" source: "typescript" slug: "instrument/typescript/reference/environment-variables" aliases: - "typescript-sdk/reference/environment-variables" - page: "API Overview" path: "reference/api.md" source: "typescript" slug: "instrument/typescript/reference/api" aliases: - "typescript-sdk/reference/api" - 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" - section: "Integrations" slug: "" contents: - page: "Integrations" path: "integrations/index.md" slug: "integrations" - 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: "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: "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: "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" - 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: "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" - 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: "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" - 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: "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" - 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" - page: "Kubernetes Monitoring" path: "how-to-guides/otel-collector/kubernetes-monitoring.md" slug: "guides/otel-collector/kubernetes-monitoring" aliases: - "instrument/opentelemetry-collector/kubernetes-monitoring" - "how-to-guides/otel-collector/kubernetes-monitoring" - 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: "Issues" 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: "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: "Configure & Operate" slug: "" contents: - page: "Organizations & Projects" path: "guides/web-ui/organizations-and-projects.md" slug: "manage/organizations-and-projects" aliases: - "reference/organization-structure" - page: "Environments" path: "how-to-guides/environments.md" slug: "manage/environments" aliases: - "how-to-guides/environments" - "get-started/environments" - 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: "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" - page: "Cost & Usage" path: "logfire-costs.md" slug: "manage/logfire-costs" - page: "Data Regions" path: "reference/data-regions.md" slug: "manage/data-regions" - page: "Ingest Limits" path: "reference/limits.md" slug: "reference/limits" - page: "Convert to Organization" path: "how-to-guides/convert-to-organization.md" slug: "manage/convert-to-organization" aliases: - "how-to-guides/convert-to-organization" - 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" - page: "SSO Setup" path: "how-to-guides/sso-setup.md" source: "plain" slug: "deploy/sso-setup" aliases: - "how-to-guides/sso-setup" - page: "Enterprise" path: "enterprise.md" source: "plain" slug: "deploy/enterprise" - page: "Single Tenant" path: "enterprise-single-tenant.md" source: "plain" slug: "deploy/enterprise-single-tenant" aliases: - "enterprise-single-tenant" - section: "Self Hosted deployment" 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: "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"