observability-and-instrumentation
Instruments code so production behavior is visible and diagnosable
by addyosmaniFree
Description
observability-and-instrumentation is an agent skill from Addy Osmani's agent-skills collection that makes code's production behavior visible and diagnosable. Observability is the ability to answer what the system is doing and why, from the outside, using the telemetry the code emits. The skill's principle is that instrumentation is not an add-on after launch. It is written alongside the feature, the same way tests are, because if a feature ships without telemetry, the first bug a user reports becomes archaeology instead of a query. The skill applies when building any feature that will run in production, adding a service, endpoint, background job or external integration, when a production incident took too long to diagnose, when setting up or reviewing alerting rules, and when reviewing a pull request that adds I/O, retries, queues or cross-service calls. It names three things it does not cover: diagnosing a failure that is happening now, which belongs to the debugging skill; profiling and optimizing measured slowness, which belongs to the performance skill; and launch-day monitoring checklists and rollback triggers, which belong to the shipping-and-launch skill.…
Highlights
- Logging, metrics, tracing and alerting
- Instrumentation written with the feature
- Guidance for I/O, retries and queues
- Feeds the debugging and launch skills
Ratings & Reviews
No ratings yet
Be the first to rate observability-and-instrumentation.
People also visit
python-observability
Python observability patterns including structured logging, metrics
enterprise-agent-ops
Operational controls for long-lived or cloud-hosted agent systems
netdata/netdata#Netdata
Discovery, exploration, reporting and root cause analysis over Netdata metrics
observability-and-instrumentation FAQ
What does the observability-and-instrumentation skill do?
It helps instrument code so its production behavior can be seen and diagnosed, covering logging, metrics, tracing and alerting.
How do I install it?
Run: npx skills add https://github.com/addyosmani/agent-skills --skill observability-and-instrumentation
When should telemetry be added?
Alongside the feature, the same way tests are written, rather than after launch.
What does it not cover?
Diagnosing a failure happening now (the debugging skill), profiling slowness (the performance skill), and launch checklists and rollback triggers (the shipping-and-launch skill).
What security checks has it passed?
skills.sh lists three audits: Gen Agent Trust Hub Pass, Socket Pass and Snyk Pass.
What are the best observability-and-instrumentation alternatives?
Popular alternatives to observability-and-instrumentation include python-observability, dashboard-builder and enterprise-agent-ops. See all observability-and-instrumentation alternatives