skills.rest
petekp
petekpCOMMUNITY
Explore all skills by this author →
Website𝕏@petekpGitHub

agent-telemetry

Implement JSON-based structured logging and queryable telemetry endpoints for coding agents.

42|11|Updated Dec 26, 2025
Search Tags:#debugging#logging#observability#structured logs#telemetry#agent access
One-click install
npx skills add https://github.com/petekp/claude-code-setup --skill agent-telemetry
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agent-telemetry
Source: https://github.com/petekp/claude-code-setup/tree/main/skills/agent-telemetry
Command: npx skills add https://github.com/petekp/claude-code-setup --skill agent-telemetry

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill makes application runtime behavior queryable by coding agents, enabling them to debug issues by understanding what actually happened.

Core Features & Use Cases

  • Structured Logging: Implements JSON-based logging for better machine readability.
  • Log Exposure: Provides mechanisms (log files, dev endpoints, CLI tools) for agents to access logs.
  • Documentation: Guides users on how to document log access for agents in CLAUDE.md or equivalent.
  • Use Case: When an agent is asked to debug a bug but has no visibility into the application's runtime state, this skill can be used to set up structured logging and an accessible query endpoint, allowing the agent to pinpoint the error.

Quick Start

Use the agent-telemetry skill to add structured logging and a queryable endpoint to the application.

Frequently Asked Questions about agent-telemetry

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

FAQPage Schema
How do I make application runtime behavior visible to coding agents for debugging?▼

Make application behavior visible to agents by implementing structured JSON logging and telemetry query endpoints. This provides the runtime visibility agents need to diagnose issues by reading actual execution behavior.

What's the best way to set up structured logs for agent access during development?▼

Set up structured logs for agent access by implementing JSON-based logging and exposing it through log files, development-specific query endpoints, or CLI tools, ensuring coding agents can query runtime behavior.

How do I document telemetry endpoints so coding agents can discover them?▼

Document telemetry endpoints for agent discoverability by adding clear instructions to project files like CLAUDE.md, specifying how to access structured logs and query endpoints to enable effective debugging.

Can I use telemetry endpoints with various application frameworks to expose structured logs?▼

Yes, this telemetry approach supports various application frameworks by providing flexible mechanisms for log exposure, including log file access, development query endpoints, and CLI tools for structured log retrieval.

Why does my coding agent fail to debug issues without structured logging?▼

Coding agents fail to debug without structured logging because they lack visibility into the application's runtime state, making it impossible to pinpoint errors. Implementing telemetry endpoints solves this access problem.

When do I need to implement telemetry query endpoints for agent debugging?▼

Implement telemetry query endpoints when an agent needs to debug an issue but lacks visibility into the application's runtime state, requiring structured logs and accessible query mechanisms to pinpoint errors.

Related Skills

Explore More Software Engineering Skills→
apacheapache
79

magpie-setup-isolated-setup-doctor

Diagnose secure-agent setup restrictions with live probes for SSH, ports, and runtime sockets.

Official
Intermediate
lgzarturolgzarturo
3

debug:spring-boot

Diagnoses and resolves Spring Boot errors with actionable steps.

Community
Advanced
ivegamsftivegamsft

observability

Implement logs, metrics, and traces with OpenTelemetry instrumentation.

Community
Intermediate
tswrtswr
1

observability

Diagnose distributed production system behavior using external telemetry signals.

Community
Advanced