langchain.callbacks.tracers.logging
.LoggingCallbackHandler¶
- class langchain.callbacks.tracers.logging.LoggingCallbackHandler(logger: Logger, log_level: int = 20, extra: Optional[dict] = None, **kwargs: Any)[source]¶
Tracer that logs via the input Logger.
Initialize the tracer.
- Parameters
_schema_format –
Primarily changes how the inputs and outputs are handled. For internal use only. This API will change.
’original’ is the format used by all current tracers. This format is slightly inconsistent with respect to inputs and outputs.
’streaming_events’ is used for supporting streaming events, for internal usage. It will likely change in the future, or be deprecated entirely in favor of a dedicated async tracer for streaming events.
’original+chat’ is a format that is the same as ‘original’ except it does NOT raise an attribute error on_chat_model_start
kwargs (Any) – Additional keyword arguments that will be passed to the superclass.
logger (Logger) –
log_level (int) –
extra (Optional[dict]) –
Attributes
ignore_agent
Whether to ignore agent callbacks.
ignore_chain
Whether to ignore chain callbacks.
ignore_chat_model
Whether to ignore chat model callbacks.
ignore_custom_event
Ignore custom event.
ignore_llm
Whether to ignore LLM callbacks.
ignore_retriever
Whether to ignore retriever callbacks.
ignore_retry
Whether to ignore retry callbacks.
log_missing_parent
name
The name of the tracer.
raise_error
Whether to raise an error if an exception occurs.
run_inline
Whether to run the callback inline.
Methods
__init__
(logger[, log_level, extra])Initialize the tracer.
get_breadcrumbs
(run)Get the breadcrumbs of a run.
get_parents
(run)Get the parents of a run.
on_agent_action
(action, *, run_id[, ...])Run on agent action.
on_agent_finish
(finish, *, run_id[, ...])Run on the agent end.
on_chain_end
(outputs, *, run_id[, inputs])End a trace for a chain run.
on_chain_error
(error, *[, inputs])Handle an error for a chain run.
on_chain_start
(serialized, inputs, *, run_id)Start a trace for a chain run.
on_chat_model_start
(serialized, messages, *, ...)Start a trace for an LLM run.
on_custom_event
(name, data, *, run_id[, ...])Override to define a handler for a custom event.
on_llm_end
(response, *, run_id, **kwargs)End a trace for an LLM run.
on_llm_error
(error, *, run_id, **kwargs)Handle an error for an LLM run.
on_llm_new_token
(token, *[, chunk, ...])Run on new LLM token.
on_llm_start
(serialized, prompts, *, run_id)Start a trace for an LLM run.
on_retriever_end
(documents, *, run_id, **kwargs)Run when the Retriever ends running.
on_retriever_error
(error, *, run_id, **kwargs)Run when Retriever errors.
on_retriever_start
(serialized, query, *, run_id)Run when the Retriever starts running.
on_retry
(retry_state, *, run_id, **kwargs)Run on retry.
on_text
(text, *, run_id[, parent_run_id])Run on an arbitrary text.
on_tool_end
(output, *, run_id, **kwargs)End a trace for a tool run.
on_tool_error
(error, *, run_id, **kwargs)Handle an error for a tool run.
on_tool_start
(serialized, input_str, *, run_id)Start a trace for a tool run.
- __init__(logger: Logger, log_level: int = 20, extra: Optional[dict] = None, **kwargs: Any) None [source]¶
Initialize the tracer.
- Parameters
_schema_format –
Primarily changes how the inputs and outputs are handled. For internal use only. This API will change.
’original’ is the format used by all current tracers. This format is slightly inconsistent with respect to inputs and outputs.
’streaming_events’ is used for supporting streaming events, for internal usage. It will likely change in the future, or be deprecated entirely in favor of a dedicated async tracer for streaming events.
’original+chat’ is a format that is the same as ‘original’ except it does NOT raise an attribute error on_chat_model_start
kwargs (Any) – Additional keyword arguments that will be passed to the superclass.
logger (Logger) –
log_level (int) –
extra (Optional[dict]) –
- Return type
None
- get_breadcrumbs(run: Run) str ¶
Get the breadcrumbs of a run.
- Parameters
run (Run) – The run to get the breadcrumbs of.
- Returns
A string with the breadcrumbs of the run.
- Return type
str
- on_agent_action(action: AgentAction, *, run_id: UUID, parent_run_id: Optional[UUID] = None, **kwargs: Any) Any ¶
Run on agent action.
- Parameters
action (AgentAction) – The agent action.
run_id (UUID) – The run ID. This is the ID of the current run.
parent_run_id (UUID) – The parent run ID. This is the ID of the parent run.
kwargs (Any) – Additional keyword arguments.
- Return type
Any
- on_agent_finish(finish: AgentFinish, *, run_id: UUID, parent_run_id: Optional[UUID] = None, **kwargs: Any) Any ¶
Run on the agent end.
- Parameters
finish (AgentFinish) – The agent finish.
run_id (UUID) – The run ID. This is the ID of the current run.
parent_run_id (UUID) – The parent run ID. This is the ID of the parent run.
kwargs (Any) – Additional keyword arguments.
- Return type
Any
- on_chain_end(outputs: Dict[str, Any], *, run_id: UUID, inputs: Optional[Dict[str, Any]] = None, **kwargs: Any) Run ¶
End a trace for a chain run.
- Parameters
outputs (Dict[str, Any]) – The outputs for the chain.
run_id (UUID) – The run ID.
inputs (Optional[Dict[str, Any]]) – The inputs for the chain. Defaults to None.
kwargs (Any) – Additional arguments.
- Returns
The run.
- Return type
- on_chain_error(error: BaseException, *, inputs: Optional[Dict[str, Any]] = None, run_id: UUID, **kwargs: Any) Run ¶
Handle an error for a chain run.
- Parameters
error (BaseException) – The error.
inputs (Optional[Dict[str, Any]]) – The inputs for the chain. Defaults to None.
run_id (UUID) – The run ID.
kwargs (Any) – Additional arguments.
- Returns
The run.
- Return type
- on_chain_start(serialized: Dict[str, Any], inputs: Dict[str, Any], *, run_id: UUID, tags: Optional[List[str]] = None, parent_run_id: Optional[UUID] = None, metadata: Optional[Dict[str, Any]] = None, run_type: Optional[str] = None, name: Optional[str] = None, **kwargs: Any) Run ¶
Start a trace for a chain run.
- Parameters
serialized (Dict[str, Any]) – The serialized chain.
inputs (Dict[str, Any]) – The inputs for the chain.
run_id (UUID) – The run ID.
tags (Optional[List[str]]) – The tags for the run. Defaults to None.
parent_run_id (Optional[UUID]) – The parent run ID. Defaults to None.
metadata (Optional[Dict[str, Any]]) – The metadata for the run. Defaults to None.
run_type (Optional[str]) – The type of the run. Defaults to None.
name (Optional[str]) – The name of the run.
kwargs (Any) – Additional arguments.
- Returns
The run.
- Return type
- on_chat_model_start(serialized: Dict[str, Any], messages: List[List[BaseMessage]], *, run_id: UUID, tags: Optional[List[str]] = None, parent_run_id: Optional[UUID] = None, metadata: Optional[Dict[str, Any]] = None, name: Optional[str] = None, **kwargs: Any) Run ¶
Start a trace for an LLM run.
- Parameters
serialized (Dict[str, Any]) – The serialized model.
messages (List[List[BaseMessage]]) – The messages to start the chat with.
run_id (UUID) – The run ID.
tags (Optional[List[str]]) – The tags for the run. Defaults to None.
parent_run_id (Optional[UUID]) – The parent run ID. Defaults to None.
metadata (Optional[Dict[str, Any]]) – The metadata for the run. Defaults to None.
name (Optional[str]) – The name of the run.
kwargs (Any) – Additional arguments.
- Returns
The run.
- Return type
- on_custom_event(name: str, data: Any, *, run_id: UUID, tags: Optional[List[str]] = None, metadata: Optional[Dict[str, Any]] = None, **kwargs: Any) Any ¶
Override to define a handler for a custom event.
- Parameters
name (str) – The name of the custom event.
data (Any) – The data for the custom event. Format will match the format specified by the user.
run_id (UUID) – The ID of the run.
tags (Optional[List[str]]) – The tags associated with the custom event (includes inherited tags).
metadata (Optional[Dict[str, Any]]) – The metadata associated with the custom event (includes inherited metadata).
kwargs (Any) –
- Return type
Any
New in version 0.2.15.
- on_llm_error(error: BaseException, *, run_id: UUID, **kwargs: Any) Run ¶
Handle an error for an LLM run.
- Parameters
error (BaseException) – The error.
run_id (UUID) – The run ID.
kwargs (Any) – Additional arguments.
- Returns
The run.
- Return type
- on_llm_new_token(token: str, *, chunk: Optional[Union[GenerationChunk, ChatGenerationChunk]] = None, run_id: UUID, parent_run_id: Optional[UUID] = None, **kwargs: Any) Run ¶
Run on new LLM token. Only available when streaming is enabled.
- Parameters
token (str) – The token.
chunk (Optional[Union[GenerationChunk, ChatGenerationChunk]]) – The chunk. Defaults to None.
run_id (UUID) – The run ID.
parent_run_id (Optional[UUID]) – The parent run ID. Defaults to None.
kwargs (Any) – Additional arguments.
- Returns
The run.
- Return type
- on_llm_start(serialized: Dict[str, Any], prompts: List[str], *, run_id: UUID, tags: Optional[List[str]] = None, parent_run_id: Optional[UUID] = None, metadata: Optional[Dict[str, Any]] = None, name: Optional[str] = None, **kwargs: Any) Run ¶
Start a trace for an LLM run.
- Parameters
serialized (Dict[str, Any]) – The serialized model.
prompts (List[str]) – The prompts to start the LLM with.
run_id (UUID) – The run ID.
tags (Optional[List[str]]) – The tags for the run. Defaults to None.
parent_run_id (Optional[UUID]) – The parent run ID. Defaults to None.
metadata (Optional[Dict[str, Any]]) – The metadata for the run. Defaults to None.
name (Optional[str]) – The name of the run.
kwargs (Any) – Additional arguments.
- Returns
The run.
- Return type
- on_retriever_end(documents: Sequence[Document], *, run_id: UUID, **kwargs: Any) Run ¶
Run when the Retriever ends running.
- on_retriever_error(error: BaseException, *, run_id: UUID, **kwargs: Any) Run ¶
Run when Retriever errors.
- Parameters
error (BaseException) – The error.
run_id (UUID) – The run ID.
kwargs (Any) – Additional arguments.
- Returns
The run.
- Return type
- on_retriever_start(serialized: Dict[str, Any], query: str, *, run_id: UUID, parent_run_id: Optional[UUID] = None, tags: Optional[List[str]] = None, metadata: Optional[Dict[str, Any]] = None, name: Optional[str] = None, **kwargs: Any) Run ¶
Run when the Retriever starts running.
- Parameters
serialized (Dict[str, Any]) – The serialized retriever.
query (str) – The query.
run_id (UUID) – The run ID.
parent_run_id (Optional[UUID]) – The parent run ID. Defaults to None.
tags (Optional[List[str]]) – The tags for the run. Defaults to None.
metadata (Optional[Dict[str, Any]]) – The metadata for the run. Defaults to None.
name (Optional[str]) – The name of the run.
kwargs (Any) – Additional arguments.
- Returns
The run.
- Return type
- on_retry(retry_state: RetryCallState, *, run_id: UUID, **kwargs: Any) Run ¶
Run on retry.
- Parameters
retry_state (RetryCallState) – The retry state.
run_id (UUID) – The run ID.
kwargs (Any) – Additional arguments.
- Returns
The run.
- Return type
- on_text(text: str, *, run_id: UUID, parent_run_id: Optional[UUID] = None, **kwargs: Any) None [source]¶
Run on an arbitrary text.
- Parameters
text (str) – The text.
run_id (UUID) – The run ID. This is the ID of the current run.
parent_run_id (UUID) – The parent run ID. This is the ID of the parent run.
kwargs (Any) – Additional keyword arguments.
- Return type
None
- on_tool_end(output: Any, *, run_id: UUID, **kwargs: Any) Run ¶
End a trace for a tool run.
- Parameters
output (Any) – The output for the tool.
run_id (UUID) – The run ID.
kwargs (Any) – Additional arguments.
- Returns
The run.
- Return type
- on_tool_error(error: BaseException, *, run_id: UUID, **kwargs: Any) Run ¶
Handle an error for a tool run.
- Parameters
error (BaseException) – The error.
run_id (UUID) – The run ID.
kwargs (Any) – Additional arguments.
- Returns
The run.
- Return type
- on_tool_start(serialized: Dict[str, Any], input_str: str, *, run_id: UUID, tags: Optional[List[str]] = None, parent_run_id: Optional[UUID] = None, metadata: Optional[Dict[str, Any]] = None, name: Optional[str] = None, inputs: Optional[Dict[str, Any]] = None, **kwargs: Any) Run ¶
Start a trace for a tool run.
- Parameters
serialized (Dict[str, Any]) – The serialized tool.
input_str (str) – The input string.
run_id (UUID) – The run ID.
tags (Optional[List[str]]) – The tags for the run. Defaults to None.
parent_run_id (Optional[UUID]) – The parent run ID. Defaults to None.
metadata (Optional[Dict[str, Any]]) – The metadata for the run. Defaults to None.
name (Optional[str]) – The name of the run.
inputs (Optional[Dict[str, Any]]) – The inputs for the tool.
kwargs (Any) – Additional arguments.
- Returns
The run.
- Return type