claude-live-logs

Analyze Claude Code execution logs in Elasticsearch by task_id, pipeline_run_id, or agent_name.

Updated Sep 22, 2025
One-click install
npx skills add https://github.com/tinkermonkey/switchyard --skill claude-live-logs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: claude-live-logs
Source: https://github.com/tinkermonkey/switchyard/tree/main/.claude/skills/claude-live-logs
Command: npx skills add https://github.com/tinkermonkey/switchyard --skill claude-live-logs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Claude Code live execution logs are scattered across platforms; this skill centralizes search and analysis of tool calls, API usage, and errors in Elasticsearch to speed debugging and performance tuning.

Core Features & Use Cases

  • Live log querying by task_id, pipeline_run_id, or agent_name to inspect a specific run.
  • Contextual timelines of tool results and API calls for quick diagnosis.
  • Recent activity monitoring within a time window for near real-time visibility.
  • Cross-resource correlation between agent lifecycle events and OTEL logs for pipeline troubleshooting.

Quick Start

Query Elasticsearch for logs related to a specific task_id, pipeline_run_id, or agent_name and summarize the findings.

Frequently Asked Questions about claude-live-logs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I analyze Claude Code live execution logs stored in Elasticsearch?

To analyze Claude Code live execution logs in Elasticsearch, query the logs-claude.otel-default and agent-events indices using a specific task_id, pipeline_run_id, or agent_name. This returns structured fields like timestamp, event_type, and pipeline_run_id for diagnosis.

What is the best way to monitor recent Claude Code agent activity in Elasticsearch?

Monitoring recent Claude Code agent activity in Elasticsearch involves querying the agent-events index with an optional recent activity time window. This provides near real-time visibility into tool results and API calls for quick performance tuning.

How can I diagnose pipeline run issues using Claude live logs?

Diagnosing pipeline run issues with Claude live logs requires querying Elasticsearch by pipeline_run_id to cross-correlate agent lifecycle events and OTEL logs. This contextual timeline of tool results isolates specific failures within the pipeline execution.

Do I need specific Elasticsearch indices to search Claude Code execution logs?

Searching Claude Code execution logs requires access to specific Elasticsearch indices: logs-claude.otel-default and agent-events. These indices store the structured fields, such as event_type and agent_name, needed to centralize debugging and performance analysis.

Can I query Claude Code logs by agent_name to troubleshoot errors?

You can query Claude Code logs by agent_name in Elasticsearch to troubleshoot errors and inspect specific runs. This filters the live execution logs to display contextual timelines of tool calls and API usage relevant to that agent.

What structured fields are returned when querying Claude live logs in Elasticsearch?

Querying Claude live logs in Elasticsearch returns structured fields including timestamp, event_type, agent_name, and pipeline_run_id. These fields enable cross-resource correlation between agent lifecycle events and OTEL logs for pipeline troubleshooting.