observability

Set up Sentry error tracking, structured logging, health checks, and alerting.

13|3|Updated Mar 2, 2026
One-click install
npx skills add https://github.com/phrazzld/agent-skills --skill observability-phrazzld
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: observability
Source: https://github.com/phrazzld/agent-skills/tree/main/core/observability
Command: npx skills add https://github.com/phrazzld/agent-skills --skill observability-phrazzld

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill addresses the challenge of setting up comprehensive observability for a project, ensuring errors are tracked, alerts are configured, and logs are structured, all with minimal services and CLI management.

Core Features & Use Cases

  • Error Tracking: Integrates Sentry for robust error monitoring and source map support.
  • Alerting: Configures essential alert rules for new errors and critical issues.
  • Logging: Implements structured JSON logging for easy parsing and analysis.
  • Health Checks: Establishes a /api/health endpoint for uptime monitoring.
  • AI Integration: Sets up webhooks or MCP servers for automated error analysis and remediation.
  • Use Case: A new production deployment experiences a critical error. Sentry immediately captures the error, an alert is sent via email and a GitHub issue is auto-created, and an AI agent analyzes the root cause using Sentry's data.

Quick Start

Run the script to audit your project's current observability setup and identify gaps.

Frequently Asked Questions about observability

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

FAQPage Schema
How do I set up complete observability infrastructure with Sentry and structured logging?

Complete observability infrastructure is established by integrating Sentry for error tracking, configuring structured JSON logging, and setting up health checks. This provides robust production monitoring and automated alerting for rapid debugging.

What is the best way to automate error analysis and remediation using AI agents?

Automated error analysis and remediation is achieved by setting up webhooks or MCP servers for AI integration. This allows an AI agent to automatically analyze root causes using Sentry data immediately after a critical production error occurs.

How do I configure alerting rules for new errors and critical issues in production?

Alerting rules for new errors and critical issues are configured alongside Sentry error tracking. This setup automatically sends email alerts and can auto-create GitHub issues to ensure rapid response during production deployments.

Does this observability setup require a heavy service architecture to run?

The observability setup operates on a minimal service architecture driven by CLI management. It avoids heavy infrastructure by focusing on essential services, structured logging, and an `/api/health` endpoint for uptime monitoring.

Why do I need structured JSON logging for application monitoring?

Structured JSON logging is needed for application monitoring to ensure logs are easily parsable and analyzable. This format facilitates rapid debugging and allows automated systems to process error data efficiently.

Can I audit my existing project to identify observability gaps before full integration?

You can audit your existing project to identify observability gaps by running a dedicated script. This evaluates your current setup against complete infrastructure standards, highlighting missing error tracking, logging, or alerting components.