observability

Configure structured logs, metrics, and traces for Trebuchet actors with CloudWatch export.

Updated Jan 27, 2026
One-click install
npx skills add https://github.com/briannadoubt/trebuchet-plugin --skill observability-briannadoubt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: observability
Source: https://github.com/briannadoubt/trebuchet-plugin/tree/main/skills/observability
Command: npx skills add https://github.com/briannadoubt/trebuchet-plugin --skill observability-briannadoubt

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides production-grade observability for Trebuchet distributed actors by delivering structured logging, metrics, and distributed tracing with CloudWatch integration and sensitive data redaction to help you monitor, debug, and optimize live systems.

Core Features & Use Cases

  • Structured Logging: Rich, redacted metadata to diagnose issues without exposing secrets.
  • Metrics & Tracing: Counters, gauges, histograms, and distributed traces across actor boundaries.
  • CloudWatch & Export: Seamless export to AWS CloudWatch for centralized monitoring.

Quick Start

Initialize and enable the observability stack in a Trebuchet project by configuring a TrebuchetLogger, InMemoryMetricsCollector, and TracingMiddleware, then observe logs, metrics, and traces from sample actor invocations.

Frequently Asked Questions about observability

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

FAQPage Schema
How do I add structured logging and distributed tracing to Swift distributed actors?

To gain observability for Swift distributed actors, configure a logger, metrics collector, and tracing middleware to emit redacted logs and distributed traces across actor boundaries. This provides the necessary integration points for monitoring live systems.

What is the best way to monitor Swift distributed actor performance in production?

The best way to monitor distributed actor performance is by collecting counters, gauges, histograms, and distributed traces. This Skill integrates a metrics collector and tracing middleware to observe actor invocations and identify bottlenecks across boundaries.

Can I export Swift metrics and logs to AWS CloudWatch?

Yes, you can export Swift metrics and logs to AWS CloudWatch. This Skill provides seamless CloudWatch export functionality for centralized monitoring, allowing you to aggregate structured logs and metrics from your distributed actor systems.

How do I redact sensitive data in Swift production logs?

To redact sensitive data in Swift production logs, configure structured logging with rich metadata that automatically masks secrets. This Skill enables redacted structured logging to diagnose issues without exposing sensitive information.

Do I need AWS CloudWatch to use this observability stack?

AWS CloudWatch is not strictly required to use this observability stack. While it provides seamless CloudWatch export for centralized monitoring, the core logging, metrics collection, and tracing components function independently to provide local visibility.