agentcore-investigation
Investigate Bedrock AgentCore runtime sessions via CloudWatch Logs Insights — resolve session/trace IDs, query OTEL spans, filter noise, build timelines. Use when debugging AgentCore agent sessions, tracing tool calls, or analyzing latency.
Best for AgentCore runtime debuggingWorks with GitHubLow risk
⌘source
- author
@awslabs- repo
- awslabs/mcp
- language
- Python
★9kstars
1.5kforks
May 7, 2026
✦overview.md
Key Features
- ·Session-to-trace resolution via OTEL span correlation
- ·Structured and glob-style parse queries
- ·OpenTelemetry noise filtering
- ·Timeline construction with T+offset format
- ·Error, tool invocation, token usage, latency analysis
Use Cases
- →Debugging a failing AgentCore agent session by tracing tool calls
- →Investigating high latency in AgentCore runtime via CloudWatch Logs
- →Filtering out OTEL noise to focus on user-invoked spans
Best for
- ✓AgentCore runtime debugging
- ✓CloudWatch Logs querying
Not ideal for
- !Non-AWS environments
- !General-purpose logging analysis
FAQs
name
agentcore-investigation
description
Investigate Bedrock AgentCore runtime sessions via CloudWatch Logs Insights — resolve session/trace IDs, query OTEL spans, filter noise, build timelines. Use when debugging AgentCore agent sessions, tracing tool calls, or analyzing latency.
AgentCore Runtime Session Investigation
Investigate AgentCore runtime sessions by querying CloudWatch Logs Insights, filtering OpenTelemetry noise, and producing structured investigation output.
Key capabilities:
- Session-to-trace resolution via OTEL span correlation
- Structured and glob-style parse queries for both dedicated and combined log groups
- OpenTelemetry noise filtering with AgentCore-specific heuristics
- Timeline construction with T+offset format
- Error, tool invocation, token usage, and latency analysis
Reference Files
Load these files as needed for detailed guidance:
MCP:
mcp-setup.md
When: ALWAYS load before starting an investigation — ensures CloudWatch and Application Signals MCP servers are configured Contains: MCP server configuration for CloudWatch Logs and Application Signals, with setup instructions for Claude Code, Gemini, Codex, and Kiro CLI
.mcp.json
When: Load when setting up MCP servers for the first time Contains: Sample MCP configuration with both CloudWatch and Application Signals servers
otel-span-schema.md
$install
1-click copynpx skills add awslabs/mcp --skill agentcore-investigationSafety assessment
★
Clarity score
How clear and easy to understand the SKILL.md instructions are, rated from 1 to 5.
3/ 5
goodMostly clear, but there are still a few confusing or poorly structured parts.
◎
Actionability score
How directly an agent can act on the SKILL.md instructions, rated from 1 to 5.
2/ 5
lowSome hints are present, but an agent still has to guess many steps.