Other
Custom Logging
Configure custom loggers and formatters for your Agno setup.
You can provide your own logging configuration to Agno, to be used instead of the default ones.
This can be useful if you need your system to log in any specific format.
Install the SDK and model provider used by the examples:
uv pip install -U agno openaiSet OpenAI Key
Set your OPENAI_API_KEY as an environment variable. You can get one from OpenAI.
export OPENAI_API_KEY=sk-***configure_agno_logging() controls Agno logging. The response panel printed by print_response() is separate console output and does not go through these log handlers.
Specifying a custom logging configuration
You can configure Agno to use your own logging configuration by using the configure_agno_logging function.
import logging
from agno.agent import Agent
from agno.utils.log import configure_agno_logging, log_info
# Set up a custom logger
custom_logger = logging.getLogger("custom_logger")
handler = logging.StreamHandler()
formatter = logging.Formatter("[CUSTOM_LOGGER] %(levelname)s: %(message)s")
handler.setFormatter(formatter)
custom_logger.addHandler(handler)
custom_logger.setLevel(logging.INFO)
custom_logger.propagate = False
# Configure Agno to use the custom logger
configure_agno_logging(
custom_default_logger=custom_logger,
custom_agent_logger=custom_logger,
)
# Agno helper calls and agent operations use this logger
log_info("This is using our custom logger!")
agent = Agent()
agent.print_response("What is 2+2?")custom_default_logger selects the current helper logger. Set custom_agent_logger too so agent debug mode uses the same destination. With debug mode off, agent initialization updates the agent logger level but can leave the current helper logger unchanged. Teams and workflows also have their own logger settings; helper selection is shared state, not isolation by component.
Logging to a File
You can configure Agno to log to a file instead of the console:
import logging
from pathlib import Path
from agno.agent import Agent
from agno.utils.log import configure_agno_logging, log_info
# Create a custom logger that writes to a file
custom_logger = logging.getLogger("file_logger")
# Ensure tmp directory exists
log_file_path = Path("tmp/log.txt")
log_file_path.parent.mkdir(parents=True, exist_ok=True)
# Use FileHandler to write to file
handler = logging.FileHandler(log_file_path)
formatter = logging.Formatter("%(levelname)s: %(message)s")
handler.setFormatter(formatter)
custom_logger.addHandler(handler)
custom_logger.setLevel(logging.INFO)
custom_logger.propagate = False
# Configure Agno to use the file logger
configure_agno_logging(
custom_default_logger=custom_logger,
custom_agent_logger=custom_logger,
)
# Agno helper calls and agent operations write to tmp/log.txt
log_info("This is using our file logger!")
agent = Agent()
agent.print_response("Tell me a fun fact")Multiple Loggers
You can configure different loggers for your Agents, Teams and Workflows:
import logging
from agno.agent import Agent
from agno.team import Team
from agno.workflow import Workflow
from agno.workflow.step import Step
from agno.utils.log import configure_agno_logging, log_info
# Create custom loggers for different components
custom_agent_logger = logging.getLogger("agent_logger")
custom_team_logger = logging.getLogger("team_logger")
custom_workflow_logger = logging.getLogger("workflow_logger")
# Configure handlers and formatters for each
for logger in [custom_agent_logger, custom_team_logger, custom_workflow_logger]:
handler = logging.StreamHandler()
handler.setFormatter(logging.Formatter("[%(name)s] %(levelname)s: %(message)s"))
logger.addHandler(handler)
logger.setLevel(logging.INFO)
logger.propagate = False
# Workflow logs at DEBUG level when debug_mode is enabled
# Set workflow logger to DEBUG to see these logs
custom_workflow_logger.setLevel(logging.DEBUG)
# Apply the configuration
configure_agno_logging(
custom_default_logger=custom_agent_logger,
custom_agent_logger=custom_agent_logger,
custom_team_logger=custom_team_logger,
custom_workflow_logger=custom_workflow_logger,
)
# All logging will now use the custom agent logger by default
log_info("Using custom loggers!")
# Create agent and team
agent = Agent()
team = Team(members=[agent])
# Agent will use custom_agent_logger
agent.print_response("What is 2+2?")
# Team operations select custom_team_logger; non-debug members may retain it
team.print_response("Tell me a short joke")
# Workflow will use custom_workflow_logger
workflow = Workflow(
debug_mode=True,
steps=[Step(name="step1", agent=agent)]
)
workflow.print_response("Tell me a fun fact")Using Named Loggers
As is standard in Python, you can provide custom loggers just by giving them specific names. This is useful when you set up logging through configuration files.
Agno automatically recognizes and uses these logger names:
agnowill be used for all Agent logsagno-teamwill be used for all Team logsagno-workflowwill be used for all Workflow logs
import logging
from agno.agent import Agent
from agno.team import Team
from agno.workflow import Workflow
from agno.workflow.step import Step
# Set up named loggers BEFORE creating agents/teams/workflows
logger_configs = [
("agno", "agent.log"),
("agno-team", "team.log"),
("agno-workflow", "workflow.log"),
]
for logger_name, log_file in logger_configs:
logger = logging.getLogger(logger_name)
logger.setLevel(logging.INFO)
logger.handlers.clear() # Remove Agno's default console handler
handler = logging.FileHandler(log_file)
handler.setFormatter(logging.Formatter("%(asctime)s - %(name)s - %(levelname)s - %(message)s"))
logger.addHandler(handler)
logger.propagate = False
# Agno will automatically detect and use these loggers
agent = Agent()
agent.print_response("Hello from agent!") # Agent logs will go to agent.log
team = Team(members=[agent])
team.print_response("Hello from team!") # Team logs will go to team.log
# Workflow requires debug mode to use the workflow logger
workflow = Workflow(
debug_mode=True,
steps=[Step(name="step1", agent=agent)]
)
workflow.run("Hello from workflow!") # Workflow logs will go to workflow.logInclude tracebacks
Warnings and errors omit exception tracebacks by default. Enable them in configuration:
configure_agno_logging(enable_log_tracebacks=True)Or set AGNO_LOG_TRACEBACKS=true before importing Agno. set_log_tracebacks(True) from agno.utils.log changes the setting at runtime. This affects log_warning() and log_error() inside exception handlers; log_exception() always includes a traceback.