on_chain_start() — langchain Function Reference

Architecture documentation for the on_chain_start() function in base.py from the langchain codebase.

Function python Observability Tracers calls 3 called by 1

Entity Profile

Observability→ Tracers→ on_chain_start() — langchain Function Reference

Dependency Diagram

graph TD
  4fc30b16_7ae1_9cd3_3e1a_cab2c2a53122["on_chain_start()"]
  b3ab8001_c14c_4191_ca53_2dbabc99917f["AsyncBaseTracer"]
  4fc30b16_7ae1_9cd3_3e1a_cab2c2a53122 -->|defined in| b3ab8001_c14c_4191_ca53_2dbabc99917f
  9d98e4df_1dff_cdb6_b489_397648f5aa8a["on_chain_start()"]
  9d98e4df_1dff_cdb6_b489_397648f5aa8a -->|calls| 4fc30b16_7ae1_9cd3_3e1a_cab2c2a53122
  6f36dacc_adf3_1223_4aff_3ae256a05ed8["_start_trace()"]
  4fc30b16_7ae1_9cd3_3e1a_cab2c2a53122 -->|calls| 6f36dacc_adf3_1223_4aff_3ae256a05ed8
  0983c53e_c9c4_70ff_cd08_6f356740fd06["_on_chain_start()"]
  4fc30b16_7ae1_9cd3_3e1a_cab2c2a53122 -->|calls| 0983c53e_c9c4_70ff_cd08_6f356740fd06
  9d98e4df_1dff_cdb6_b489_397648f5aa8a["on_chain_start()"]
  4fc30b16_7ae1_9cd3_3e1a_cab2c2a53122 -->|calls| 9d98e4df_1dff_cdb6_b489_397648f5aa8a
  style 4fc30b16_7ae1_9cd3_3e1a_cab2c2a53122 fill:#6366f1,stroke:#818cf8,color:#fff

Relationship Graph

Source Code

libs/core/langchain_core/tracers/base.py lines 682–707

    async def on_chain_start(
        self,
        serialized: dict[str, Any],
        inputs: dict[str, Any],
        *,
        run_id: UUID,
        tags: list[str] | None = None,
        parent_run_id: UUID | None = None,
        metadata: dict[str, Any] | None = None,
        run_type: str | None = None,
        name: str | None = None,
        **kwargs: Any,
    ) -> None:
        chain_run = self._create_chain_run(
            serialized=serialized,
            inputs=inputs,
            run_id=run_id,
            tags=tags,
            parent_run_id=parent_run_id,
            metadata=metadata,
            run_type=run_type,
            name=name,
            **kwargs,
        )
        tasks = [self._start_trace(chain_run), self._on_chain_start(chain_run)]
        await asyncio.gather(*tasks)