Pydantic AI

Permitech supports logging traces from Pydantic AI applications using OpenTelemetry.

Set up OpenTelemetry

To log Pydantic AI applications using Permitech, the first step is to set up OpenTelemetry.

Install the required packages

Add the Permitech Python SDK and Pydantic AI to your Python environment.

pip install pydantic-ai \
      permitech \
      opentelemetry-api \
      opentelemetry-sdk

Create environment variables for your Permitech settings

Set environment variables for your Permitech settings, for example in a .env file:

# Your Permitech API key
PERMITECH_API_KEY="your-permitech-api-key"

# Your Permitech project name
PERMITECH_PROJECT="your-permitech-project-name"

# The name of the Log stream you want to use for logging
PERMITECH_LOG_STREAM="your-permitech-log-stream "

Get your endpoint

The OTel endpoint is different from Permitech’s regular API endpoint and is specifically designed to receive telemetry data in the OTLP format.If you are using:

Permitech Cloud at permi.tech, then you don’t need to provide a custom OTel endpoint. The default endpoint https://permi.tech/api/otel/traces will be used automatically.
A self-hosted Permitech deployment, replace the https://permi.tech/api/otel/traces endpoint with your deployment URL. The format of this URL is based on your console URL, replacing console with api and appending /otel/traces.

For example:

if your console URL is https://console.permitech.example.com, the OTel endpoint would be https://api.permitech.example.com/otel/traces
if your console URL is https://console-permitech.apps.mycompany.com, the OTel endpoint would be https://api-permitech.apps.mycompany.com/otel/traces

Configure the OpenTelemetry tracer provider

Use the following code to configure OpenTelemetry with Permitech. This sets up the tracer provider and enables instrumentation for all Pydantic AI agents.

Python

from permitech import otel
from opentelemetry import trace
from opentelemetry.sdk.trace import TracerProvider
from pydantic_ai import Agent

# Create and configure the tracer provider
provider = TracerProvider()
trace.set_tracer_provider(provider)

# Add the Permitech span processor
otel.add_permitech_span_processor(
    tracer_provider=provider,
    processor=otel.PermitechSpanProcessor()
)

# Enable instrumentation on all agents
Agent.instrument_all()

What gets logged

Pydantic AI spans are automatically detected and normalized by Permitech’s OpenTelemetry extension. The following span types are supported:

Agent runs: Complete agent executions with input/output messages
Chat completions: LLM calls with messages and responses
Tool executions: Individual tool invocations with arguments and results
Tool workflows: Parent spans that group multiple tool executions

For a complete working example, see the .

⌘I

Overview

Get Started

Observability

Evaluation Metrics

Signals

AI Assistant

Luna Studio

Experiments

Agent Control

Annotations

Integrations

Security

References

Set up OpenTelemetry

What gets logged

​Set up OpenTelemetry

​What gets logged

Set up OpenTelemetry

What gets logged