# Observability And Instrumentation

> Add or review observability. Use when adding logs, metrics, traces, audit events, health checks, alerts, or production diagnostics for features, background jobs, APIs, tools, and integrations.

- **Type:** Skill
- **Install:** `agentstack add skill-hsienw-ai-agent-engineering-playbook-observability-and-instrumentation`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [HsienW](https://agentstack.voostack.com/s/hsienw)
- **Installs:** 0
- **Category:** [Data & Analytics](https://agentstack.voostack.com/c/data-and-analytics)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [HsienW](https://github.com/HsienW)
- **Source:** https://github.com/HsienW/ai-agent-engineering-playbook/tree/master/skills-operational-hardening/observability-and-instrumentation

## Install

```sh
agentstack add skill-hsienw-ai-agent-engineering-playbook-observability-and-instrumentation
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Observability and Instrumentation

## Skill Interface

- Name: observability-and-instrumentation.
- Description: Add or review observability through logs, metrics, traces, audit events, health checks, alerts, and production diagnostics for features, background jobs, APIs, tools, and integrations.
- Parameters: Feature or workflow being observed, operator questions, success and failure paths, correlation identifiers, sensitive fields, telemetry sinks, alert thresholds, and verification method.
- Instructions: Use this skill when adding or assessing production signals. Define the questions operators need answered, choose bounded signals, redact sensitive data, include correlation, and verify emitted telemetry in the expected sink.

Instrument the questions operators need to answer. Do not add noisy logs as a
substitute for clear signals.

## Process

1. Define what "working" means for the feature.
2. Identify the questions needed during an incident.
3. Choose the signal: log, metric, trace, audit event, health check, or alert.
4. Add correlation identifiers at request, job, tool, or workflow boundaries.
5. Capture success, failure, timeout, cancellation, retry, and degraded paths.
6. Redact sensitive values.
7. Verify signals appear in the expected local or staging sink.

## Signal Guidance

- Logs: explain discrete events and decisions.
- Metrics: track rates, latency, saturation, errors, and business counters.
- Traces: connect work across services, tools, providers, queues, and retries.
- Audit events: record security-sensitive actions with actor, target, and
  outcome.
- Health checks: prove dependency readiness without exposing internals.

## Redaction Rules

Never log credentials, tokens, passwords, authorization headers, private keys,
session identifiers, full request bodies, or personal data unless a policy
explicitly allows a redacted field.

## Alert Rules

- Alert on user impact, data risk, security risk, or exhausted capacity.
- Avoid alerts that require no action.
- Include runbook context when possible.

## Verification

Confirm:

- Expected success and failure signals are emitted.
- Identifiers allow one request or workflow to be followed.
- Sensitive data is not present.
- Metric names and labels are bounded and stable.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [HsienW](https://github.com/HsienW)
- **Source:** [HsienW/ai-agent-engineering-playbook](https://github.com/HsienW/ai-agent-engineering-playbook)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-hsienw-ai-agent-engineering-playbook-observability-and-instrumentation
- Seller: https://agentstack.voostack.com/s/hsienw
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.