Logging and Observability

Obtaining logs and metrics from your agents and sessions

This section of the documentation is currently work in progress. Please check back soon for updates.

Configuring log level

You can control the Pipecat logging level for your deployed agents using the PIPECAT_LOG_LEVEL environment variable. This can be set as a secret or directly in your deployment configuration.

Available log levels:

Level	Description
TRACE	The most detailed information for debugging (includes Frame logging)
DEBUG	Verbose output for debugging (default)
INFO	General operational information
WARNING	Warning messages for potential issues
ERROR	Error messages only

Agent logs

Agent logs are available via both the CLI and Dashboard. You can view logs for a specific agent by running the following command:

pipecat cloud agent logs my-agent

This command accept various filters to help you narrow down the logs you are looking for. For example, you can filter logs by severity level:

pipecat cloud agent logs my-agent -l ERROR

Session logging

We recommend using the loguru library for logging within your agent. This will ensure any logging within your agent associated to the session it is running in.

from loguru import logger

async def bot():
	logger.info("Hello, world!") # will be associated with the session id

If you are handling logging manually, you can obtain the active session ID from the PipecatRunnerArguments object (or subclass alternative) passed to your bot() method:

from pipecat.runner.types import PipecatRunnerArguments

async def bot(args: PipecatRunnerArguments):
	session_id = args.session_id

See the Session Arguments reference for more additional SessionArgument types.