Documenso Observability

Overview

Implement comprehensive observability for Documenso integrations including metrics, logging, and distributed tracing.

Prerequisites

• Working Documenso integration
• Monitoring platform (Datadog, Prometheus, etc.)
• Logging infrastructure (ELK, CloudWatch, etc.)
• Tracing system (Jaeger, Zipkin, etc.)

Instructions

Step 1: Metrics Collection

// src/observability/metrics.ts

Step 2: Structured Logging

// src/observability/logger.ts

Step 3: Distributed Tracing

// src/observability/tracing.ts

Step 4: Health Check Endpoint

// src/api/health.ts

Step 5: Alerting Rules

groups:

Step 6: Grafana Dashboard

{

For detailed implementation code and configurations, load the reference guide: Read(${CLAUDE_SKILL_DIR}/references/implementation-guide.md)

Output

• Metrics Collection
• Structured Logging
• Distributed Tracing
• Health Check Endpoint
• Alerting Rules
• Grafana Dashboard

Error Handling

Observability Issue	Cause	Solution
Metrics not showing	Wrong scrape config	Check Prometheus config
Logs not appearing	Log level too high	Set LOG_LEVEL=debug
Traces missing	OTEL not initialized	Call initTracing()
High cardinality	Too many labels	Reduce label values

Resources

• Prometheus Best Practices
• OpenTelemetry Documentation
• Structured Logging

Next Steps

For incident response, see documenso-incident-runbook.

Examples

Basic usage: Apply documenso observability to a standard project setup with default configuration options.

Advanced scenario: Customize documenso observability for production environments with multiple constraints and team-specific requirements.