Observe Agents

BeeAI provides observability tools to monitor and debug your agents through logging, telemetry, and integration with external monitoring systems.

​

View Agent Logs

Stream real-time logs from any running agent:

beeai logs <agent-name>

What you’ll see:

• Agent startup and initialization
• Request processing steps
• Error messages and stack traces
• Container lifecycle events

​

Telemetry Collection

BeeAI includes OpenTelemetry instrumentation to collect traces and metrics. Telemetry data helps with performance monitoring, error tracking, usage analytics, and debugging agent interactions.

​

Default Configuration

By default, BeeAI sends telemetry to:

• Local Phoenix instance (if running) for trace visualization
• BeeAI telemetry service for anonymized platform improvement

The telemetry includes:

• Platform version and runtime details
• Agent execution traces
• Performance metrics
• Anonymized usage statistics

No sensitive data like prompts, responses, or personal information is collected.

​

Configure Telemetry Sharing

To disable external telemetry sharing:

beeai platform start --no-telemetry-sharing

To re-enable telemetry sharing:

# Omit --no-telemetry-sharing
beeai platform start

This controls whether anonymized usage data is sent to help improve BeeAI.

​

Integration with Phoenix

Arize Phoenix provides visualization for OpenTelemetry traces from your agents.

beeai platform start --set phoenix.enabled=true

beeai run chat "Hello"

​

Instrumenting with OpenInference

To enable full traceability of your BeeAI agents, you can instrument them using OpenInference. This guide walks you through the installation and setup process for both Python and JavaScript frameworks.

Before you begin, make sure the Phoenix server is running.

pip install beeai-framework openinference-instrumentation-beeai

from openinference.instrumentation.beeai import BeeAIInstrumentor

BeeAIInstrumentor().instrument()

pip install beeai-framework openinference-instrumentation-beeai

from openinference.instrumentation.beeai import BeeAIInstrumentor

BeeAIInstrumentor().instrument()

npm install --save @arizeai/openinference-instrumentation-beeai beeai-framework

import { BeeAIInstrumentation } from "@arizeai/openinference-instrumentation-beeai";
import * as beeaiFramework from "beeai-framework";

const beeAIInstrumentation = new BeeAIInstrumentation();
beeAIInstrumentation.manuallyInstrument(beeaiFramework);