abrahamvilchesdelacruz/ididntcatchthat/api-observability
Claude Code and agent skill by abrahamvilchesdelacruz/ididntcatchthat
- community
Checking that the SKILL.md file is still in the repository.
Logger interface, pino, métricas Prometheus, OTel traces en apps/api/. Trigger: Al añadir logging en use cases, configurar métricas Prometheus, o setup de OpenTelemetry.
Install
npx vskill@latest install abrahamvilchesdelacruz/ididntcatchthat/api-observabilitySKILL.md
The same SKILL.md was published earlier as abrahamvilchesdelacruz/ididntcatchthat/api-observability.
When to Use
- Al añadir logging en un use case, subscriber o filter
- Al decidir qué nivel de log usar (info/warn/error/debug)
- Al añadir métricas de negocio custom
Leereferences/docs.mdpara skills relacionadas, ADRs y documentación externa.
Leereferences/implementations.mdparaPinoLogger,MetricsService, logging en subscribers y enHttpExceptionFilter.Setup de infraestructura (Loki, Prometheus, Grafana, OTel): verresources/setup.md.
Las 3 señales
| Signal | Qué captura | Storage | Consultado en | |
|---|---|---|---|---|
| Logs | Qué pasó y cuándo | Loki | Grafana | |
| Metrics | Cuánto y con qué frecuencia | Prometheus | Grafana | |
| Traces | Cómo viajó un request por dentro | Tempo | Grafana |
OpenTelemetry es el SDK que instrumenta y exporta — no es un storage.
Logger Interface (domain)
| Método | Cuándo | |
|---|---|---|
info | Acción de negocio completada (flashcard creada, sesión iniciada) | |
warn | Situación inesperada pero recuperable (retry, fallback) | |
error | Error que impacta al usuario o rompe el flujo | |
debug | Detalle técnico — solo en desarrollo |
AppMetrics Interface (domain)
Solo tiene increment — todos los contadores de negocio son Counter de Prometheus. No hay gauge ni histogram en la interfaz de dominio: el MetricsInterceptor gestiona los histogramas HTTP directamente.
| Métrica | Labels | Dónde se incrementa | |
|---|---|---|---|
app_flashcards_created_total | — | FlashcardCreator | |
app_games_started_total | — | GameStarter | |
app_games_completed_total | — | GameCompleter | |
app_audio_generated_total | provider | FlashcardAudioGenerator | |
app_auth_logins_total | provider | UserAuthenticator | |
app_auth_registrations_total | provider | UserRegistrar |
Inyección en use case
APP_METRICSse inyecta igual queLOGGER_SERVICE— el móduloObservabilityModulelo exporta como global.
Dónde loguear
Use Case — eventos de negocio
Contexto siempre útil
Reglas
LoggeryAppMetricsinterfaces viven enshared/domain/— nunca importar pino, prom-client u OTel en domain/application- Loguear eventos de negocio en use cases (
info) - Incrementar métricas de negocio en use cases con
this.metrics.increment('app_<metric>_total') - Loguear errores con el objeto `Error` completo — preserva stack trace
- No loguear en controllers — el filter e interceptor lo hacen automáticamente
- Re-throw en subscribers después de loguear — para retry y DLQ
APP_METRICSse registra enObservabilityModule, no enSharedModule
Security
- Security scanPassed, 90 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/api-observability/SKILL.md
Popularity
- 7-day trend score
- 0
Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/abrahamvilchesdelacruz/ididntcatchthat/api-observability)