Communitygithub.com

YepAPI/skills

Registro estructurado, seguimiento de errores con Sentry, integración con Axiom/Datadog, niveles de registro y alertas.

¿Qué es skills?

Esta habilidad proporciona un marco completo para el registro estructurado y la monitorización de aplicaciones en entornos de producción. Está diseñada para desarrolladores que trabajan con Node.js, Next.js y otras plataformas modernas, ofreciendo integraciones directas con herramientas como Pino para logging rápido y eficiente, Sentry para la captura de excepciones no manejadas y almacenamiento de contexto de usuario, y Axiom/Datadog para el envío de logs y métricas personalizadas. La habilidad impone reglas claras para los niveles de registro (error, warn, info, debug) y la correlación de logs mediante IDs de solicitud (UUID), lo que facilita la depuración y el análisis de rendimiento en sistemas distribuidos. Además, incluye patrones de código listos para usar, configuración de puntos finales de salud y estrategias de alerta basadas en umbrales de tasa de error y tiempos de respuesta (p50, p95, p99), ayudando a evitar la fatiga de alertas y garantizando una observabilidad efectiva. Es compatible con plataformas como Claude Code, Cursor y Codex, y se enfoca en buenas prácticas como la redacción de campos sensibles y la minimización del ruido en los registros.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/YepAPI/skills/tree/HEAD/skills/logging-monitoring

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Registro y Monitorización

Reglas

  • Registro estructurado: formato JSON con campos timestamp, level, message, requestId, userId
  • Niveles de registro: error (roto), warn (degradado), info (eventos de negocio), debug (solo desarrollo)
  • Usa Pino para logging en Node.js — rápido, estructurado, JSON por defecto
  • Sentry para seguimiento de errores: inicializar temprano, capturar excepciones no manejadas, agregar contexto de usuario y migas de pan
  • Correlacionar logs con IDs de solicitud — generar un UUID por solicitud, pasar a través de todas las llamadas de servicio
  • Nunca registrar secretos, contraseñas, tokens o números de tarjeta de crédito completos — redactar campos sensibles
  • Alertar sobre picos en la tasa de error, no sobre errores individuales — usar umbrales (p. ej., >5% de tasa de error en 5 minutos)
  • Axiom/Datadog: enviar logs mediante OTLP o SDK nativo, agregar métricas personalizadas para KPIs de negocio
  • Punto final de verificación de salud: GET /health que devuelve { status: "ok" } con verificación de conectividad a la base de datos
  • Monitorizar tiempos de respuesta en p50, p95, p99 — alertar sobre degradación en p95

Patrones

// Registro estructurado con Pino
import pino from "pino";
const logger = pino({ level: process.env.LOG_LEVEL || "info" });

logger.info({ userId, action: "checkout", orderId }, "Pedido realizado");
logger.error({ err, requestId }, "El procesamiento del pago falló");
// Inicialización de Sentry (Next.js)
import * as Sentry from "@sentry/nextjs";
Sentry.init({ dsn: process.env.SENTRY_DSN, tracesSampleRate: 0.1 });

Evitar

  • console.log en producción — usar un registrador estructurado
  • Registrar cada cuerpo de solicitud — registrar resúmenes, no cargas útiles
  • Ignorar rechazos de promesas no manejadas — siempre capturarlos
  • Fatiga de alertas por alertas ruidosas — ajustar umbrales, agrupar errores similares

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

YepAPI/skills

WCAG 2.1 AA — semantic HTML, keyboard navigation, screen readers.

YepAPI/skills

Experiment setup, variant splitting, statistical significance, and feature flag integration.

YepAPI/skills

CRUD generators, data tables, user management, role-based access, and bulk operations.

YepAPI/skills

Monitor what ChatGPT and Gemini say about your brand using YepAPI.

YepAPI/skills

Queue workers with BullMQ/Inngest/Trigger.dev, job retries, dead letter queues, concurrency.

YepAPI/skills

Commander.js, interactive prompts with Clack, spinners, colors, config files, exit codes, and npm publishing.

YepAPI/skills

cmdk integration, Cmd+K trigger, fuzzy search, grouped actions, keyboard navigation, and dynamic action registration.

YepAPI/skills

Content planning with trend and sentiment data from YepAPI.

YepAPI/skills

Content calendar, keyword-driven planning, and content briefs.

YepAPI/skills

Theme switching with CSS variables, system preference detection, next-themes, and persistence.

YepAPI/skills

Threaded comments, @mentions, reactions, moderation queue, optimistic UI, and cursor pagination.

YepAPI/skills

Competitive analysis between domains using YepAPI.

YepAPI/skills

Layout grids, KPI cards, data tables with sorting/filtering, sidebar navigation, and responsive breakpoints.

YepAPI/skills

Data encryption — TLS everywhere, AES-256-GCM for PII, bcrypt passwords, encrypted backups.

YepAPI/skills

Chart patterns with Recharts/Nivo/D3, responsive containers, color scales, and accessibility.

YepAPI/skills

Drizzle schema definition, push vs migrate, type-safe queries, relations, transactions, and prepared statements.

YepAPI/skills

Upload handling, resize/compress, CDN delivery, blur placeholders, and next/image patterns.

YepAPI/skills

Local business and Google Maps research using YepAPI.

YepAPI/skills

Cursor-based pagination, IntersectionObserver, virtualized lists with @tanstack/react-virtual, and scroll position restoration.

YepAPI/skills

Chat UI components, streaming responses with AI SDK, context window management, and RAG patterns.

Skills relacionados