feat(core): Instrument langgraph createReactAgent#20344
Merged
andreiborza merged 8 commits intodevelopfrom Apr 29, 2026
Merged
Conversation
andreiborza
force-pushed
the
ab/langgraph-agents
branch
from
6aa24b0 to
09a4132
Compare
Contributor
size-limit report 📦
|
andreiborza
force-pushed
the
ab/langgraph-agents
branch
from
09a4132 to
e2d8d45
Compare
![cursor[bot]](https://avatars.githubusercontent.com/in/1210556?s=60&v=4){kind=small}
andreiborza
force-pushed
the
ab/langgraph-agents
branch
from
e2d8d45 to
7bcbcae
Compare
andreiborza
force-pushed
the
ab/langgraph-agents
branch
3 times, most recently
from
2dc7fd2 to
fcaa34b
Compare
andreiborza
force-pushed
the
ab/langgraph-agents
branch
from
fcaa34b to
b86d7cc
Compare
andreiborza
force-pushed
the
ab/langgraph-agents
branch
from
b86d7cc to
d4c61a2
Compare
nicohrubec
reviewed
Apr 20, 2026
![sentry[bot]](https://avatars.githubusercontent.com/in/12637?s=60&v=4){kind=small}
Add instrumentation for LangGraph's `createReactAgent` API with full span hierarchy: invoke_agent, gen_ai.chat, and execute_tool. createReactAgent wrapping: - Extract agent name, LLM model, and tools from params - Wrap compiled graph's invoke() with invoke_agent span - Wrap tool invoke() with execute_tool spans (name, type, description, arguments, result) - Inject LangChain callback handler + lc_agent_name metadata at invoke level for chat span creation and agent name propagation to all child spans - Suppress StateGraph.compile instrumentation inside createReactAgent to avoid duplicate spans LangChain callback handler improvements: - Read gen_ai.agent.name from metadata.lc_agent_name - Suppress chain and tool callback spans inside agent context to avoid duplicates with our direct instrumentation - Extract tool definitions from extraParams in handleChatModelStart - Use runName for tool name (set by LangChain's StructuredTool) - Add gen_ai.operation.name to tool spans - Extract ToolMessage .content in handleToolEnd BREAKING: addToolCallsAttributes now reads from message.tool_calls (LangChain's normalized format) instead of scanning message.content for Anthropic-style tool_use items. This fixes duplicate tool calls on Anthropic chat spans but changes the tool call format in gen_ai.response.tool_calls from Anthropic-native to LangChain- normalized (args instead of input, type: tool_call instead of tool_use). OTel module patching: - Patch @langchain/langgraph/prebuilt for createReactAgent (ESM + CJS file patches for dist/prebuilt/index.cjs) Exports: - instrumentCreateReactAgent from core, browser, cloudflare Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
andreiborza
force-pushed
the
ab/langgraph-agents
branch
from
5412f98 to
0da2278
Compare
nicohrubec
reviewed
Apr 29, 2026
| export { LANGCHAIN_INTEGRATION_NAME } from './tracing/langchain/constants'; | ||
| export type { LangChainOptions, LangChainIntegration } from './tracing/langchain/types'; | ||
| export { instrumentStateGraphCompile, instrumentLangGraph } from './tracing/langgraph'; | ||
| export { instrumentStateGraphCompile, instrumentCreateReactAgent, instrumentLangGraph } from './tracing/langgraph'; |
Member
There was a problem hiding this comment.
h: So if I understand correctly right now users need instrumentCreateReactAgent for the agent and instrumentLangGraph for the StateGraph, right? I think now that we have the separate API instrumentLangGraph for the StateGraph might actually be a bit confusing, wdyt? I guess ideally what we would probably do is to merge this into one, detect what we are given and then handle the patching internally. Can we do this with the current approach?
Member
Author
There was a problem hiding this comment.
This is certainly valid and a bit confusing. I do think it's better to have two functions here, these are for manual instrumenting, so it's clearer what they both do.
That being said, let's rename instrumentLangGraph to instrumentStateGraph as you suggested in #20584.
There was a problem hiding this comment.
Cursor Bugbot has reviewed your changes and found 1 potential issue.
❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.
Reviewed by Cursor Bugbot for commit 565b49f. Configure here.
nicohrubec
approved these changes
Apr 29, 2026
Member
nicohrubec
left a comment
nicohrubec
left a comment
There was a problem hiding this comment.
nice! thanks for the updates, lgtm
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This PR adds instrumentation for LangGraph's
createReactAgentAPI.createReactAgent wrapping
invoke()withinvoke_agentspaninvoke()withexecute_toolspans (name, type, description, arguments, result)lc_agent_name+__sentry_langgraph__metadata at invoke level for chat span creation and agent name propagation to all child spansStateGraph.compileinstrumentation insidecreateReactAgentto avoid duplicate spansLangChain callback handler improvements
gen_ai.agent.namefrommetadata.lc_agent_name(convention from newer LangGraphcreateAgent, adopted for our supported versions)metadata.__sentry_langgraph__presence) to avoid duplicates with our direct instrumentationextraParamsinhandleChatModelStartand setsgen_ai.request.available_toolson chat spansrunNamefor tool name inhandleToolStart(set by LangChain'sStructuredTool.call()) — fixesunknown_toolissuegen_ai.operation.nameto tool spans.contentfrom ToolMessage objects inhandleToolEndinstead of serializing the full wrapperaddToolCallsAttributesnow prefersmessage.tool_calls(LangChain's normalized format) over scanningmessage.contentfor Anthropic-styletool_useitems, fixing duplicate tool calls on Anthropic chat spans. Falls back tomessage.contentscanning for older LangChain versions.OTel module patching
@langchain/langgraph/prebuiltforcreateReactAgent(ESM + CJS file patches fordist/prebuilt/index.cjs)Exports
instrumentCreateReactAgentfrom core, browser, cloudflareCloses: #19372