Class AgentMonitor

java.lang.Object

dev.langchain4j.agentic.observability.AgentMonitor

All Implemented Interfaces:

AgentListener

public class AgentMonitor
extends Object
implements AgentListener

Monitors agent executions and provides observability for the LangChain4j Agentic system. Generates a self-contained HTML report visualizing the static topology of an agentic system and the dynamic execution traces.

The report includes:

• A visual tree chart of the agent hierarchy showing topology types, names, and properties
• A waterfall timeline of execution traces grouped by memory/session ID

Constructor Summary

Constructors

Constructor	Description
AgentMonitor()

Method Summary

Modifier and Type	Method	Description
void	afterAgentInvocation(AgentResponse agentResponse)
List<MonitoredExecution>	allExecutionsFor(AgenticScope agenticScope)	Returns all executions (successful, failed, and ongoing) for a given memory ID.
List<MonitoredExecution>	allExecutionsFor(Object memoryId)	Returns all executions (successful, failed, and ongoing) for a given memory ID.
Set<Object>	allMemoryIds()	Returns the set of all memory IDs that have been tracked by this monitor, including successful, failed, and ongoing executions.
void	beforeAgentInvocation(AgentRequest agentRequest)
List<MonitoredExecution>	failedExecutions()
List<MonitoredExecution>	failedExecutionsFor(AgenticScope agenticScope)
List<MonitoredExecution>	failedExecutionsFor(Object memoryId)
boolean	inheritedBySubagents()	Indicates whether this listener should be used only to the agent where it is registered (default) or also inherited by its subagents.
void	onAgentInvocationError(AgentInvocationError agentInvocationError)
MonitoredExecution	ongoingExecutionFor(AgenticScope agenticScope)
MonitoredExecution	ongoingExecutionFor(Object memoryId)
Map<Object, MonitoredExecution>	ongoingExecutions()
void	setRootAgent(AgentInstance rootAgent)
List<MonitoredExecution>	successfulExecutions()
List<MonitoredExecution>	successfulExecutionsFor(AgenticScope agenticScope)
List<MonitoredExecution>	successfulExecutionsFor(Object memoryId)

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface AgentListener

afterAgenticScopeCreated, afterAgentToolExecution, beforeAgenticScopeDestroyed, beforeAgentToolExecution

Constructor Details

AgentMonitor

public AgentMonitor()

Method Details

setRootAgent

public void setRootAgent(AgentInstance rootAgent)

beforeAgentInvocation

public void beforeAgentInvocation(AgentRequest agentRequest)

Specified by:

beforeAgentInvocation in interface AgentListener

afterAgentInvocation

public void afterAgentInvocation(AgentResponse agentResponse)

Specified by:

afterAgentInvocation in interface AgentListener

onAgentInvocationError

public void onAgentInvocationError(AgentInvocationError agentInvocationError)

Specified by:

onAgentInvocationError in interface AgentListener

inheritedBySubagents

public boolean inheritedBySubagents()

Description copied from interface: AgentListener

Indicates whether this listener should be used only to the agent where it is registered (default) or also inherited by its subagents.

Specified by:

inheritedBySubagents in interface AgentListener

Returns:

true if the listener should be inherited by sub-agents, false otherwise

ongoingExecutions

public Map<Object, MonitoredExecution> ongoingExecutions()

ongoingExecutionFor

public MonitoredExecution ongoingExecutionFor(AgenticScope agenticScope)

ongoingExecutionFor

public MonitoredExecution ongoingExecutionFor(Object memoryId)

successfulExecutions

public List<MonitoredExecution> successfulExecutions()

successfulExecutionsFor

public List<MonitoredExecution> successfulExecutionsFor(AgenticScope agenticScope)

successfulExecutionsFor

public List<MonitoredExecution> successfulExecutionsFor(Object memoryId)

failedExecutions

public List<MonitoredExecution> failedExecutions()

failedExecutionsFor

public List<MonitoredExecution> failedExecutionsFor(AgenticScope agenticScope)

failedExecutionsFor

public List<MonitoredExecution> failedExecutionsFor(Object memoryId)

allMemoryIds

public Set<Object> allMemoryIds()

Returns the set of all memory IDs that have been tracked by this monitor, including successful, failed, and ongoing executions.

allExecutionsFor

public List<MonitoredExecution> allExecutionsFor(AgenticScope agenticScope)

Returns all executions (successful, failed, and ongoing) for a given memory ID.

allExecutionsFor

public List<MonitoredExecution> allExecutionsFor(Object memoryId)

Returns all executions (successful, failed, and ongoing) for a given memory ID.