AGENT SKILL

observability-and-instrumentation

Add structured logging, metrics, and tracing so systems are debuggable and operable in production. Use when implementing new services, adding important features, or improving production readiness.

License 许可
MIT
最近更新
2026-07-22
Stars
★ 7
Forks
1

01 前言 Front Matter

name
observability-and-instrumentation
description
Add structured logging, metrics, and tracing so systems are debuggable and operable in production. Use when implementing new services, adding important features, or improving production readiness.

03 SKILL.md 正文

Observability and Instrumentation

Overview

If you cannot observe it, you cannot operate it. Instrument as you build, not as an afterthought.

When to Use

  • Building new services or major features
  • Preparing for production
  • Investigating production issues (to improve future signal)
  • Defining SLOs or alerts

Core Practices

Logging

  • Structured (JSON) preferred
  • Include request/correlation IDs
  • Log at appropriate levels
  • Avoid logging secrets or high-cardinality sensitive data

Metrics

  • RED (Rate, Errors, Duration) for services
  • USE (Utilization, Saturation, Errors) for resources
  • Business metrics where they aid decisions

Tracing

  • Propagate context across service boundaries
  • Focus on critical paths first

Alerting

  • Alert on symptoms (user-impacting) more than causes
  • Make alerts actionable
  • Avoid noisy alerts that train people to ignore them

Checklist

  • [ ] Key operations have timing and error metrics
  • [ ] Logs allow tracing a request across components
  • [ ] Dashboards exist for the golden signals
  • [ ] Alerts are defined for true pain points

Verification

  • You can answer “is it working?” and “why is it slow/failing?” from the instrumentation
  • New code paths are not invisible in production

04 同仓库更多 Skills

itsual
itsual/agent-skills-collection

compliance-monitoring

Design compliance monitoring and testing programs that verify controls work in practice and surface issues before regulators do. Use when building monitoring plans, compliance testing, or continuous control monitoring.

★ 7
itsual
itsual/agent-skills-collection

complaints-handling

Operate complaints-handling processes that meet regulatory standards — logging, timely resolution, root-cause analysis, and fair outcomes. Use when designing or improving regulated complaints frameworks or analyzing complaint themes for conduct risk.

★ 7
itsual
itsual/agent-skills-collection

aml-kyc-basics

Apply AML/KYC fundamentals — customer due diligence, monitoring, suspicious activity escalation, and recordkeeping — for financial crime compliance. Use when designing onboarding controls, transaction monitoring concepts, or AML program components in financial services.

★ 7
itsual
itsual/agent-skills-collection

ai-model-compliance

Apply compliance controls to AI and automated decision systems — transparency, fairness, human oversight, documentation, and regulatory alignment. Use when deploying AI in regulated processes (credit, fraud, customer decisions) or responding to AI governance expectations.

★ 7
itsual
itsual/agent-skills-collection

data-quality-management

Manage data quality end-to-end — dimensions, rules, remediation, and prevention — beyond one-off cleaning scripts. Use when building sustained data quality programs or fixing systemic accuracy, completeness, or consistency problems.

★ 7
itsual
itsual/agent-skills-collection

data-lineage

Capture and use data lineage — where data comes from, how it transforms, and what depends on it — for impact analysis, debugging, and trust. Use when tracing metric origins, assessing change impact, or diagnosing broken pipelines.

★ 7