Communitygithub.com

link0-o/PerfLens

Kit de herramientas de análisis de rendimiento de Linux basado en evidencia, con CLI, servidor MCP y Skill de Codex para diagnóstico de puntos críticos y validación de optimización.

¿Qué es PerfLens?

PerfLens es un kit de herramientas de análisis de rendimiento de Linux que se destaca por su enfoque basado en evidencia. A diferencia de herramientas tradicionales que solo recopilan métricas, PerfLens correlaciona datos de múltiples fuentes (como perf, strace, /proc) para identificar con precisión cuellos de botella en CPU, memoria, E/S y red. Su utilidad principal radica en acelerar el ciclo de diagnóstico y optimización: un desarrollador puede ejecutar un comando CLI para obtener un informe de hotspots en segundos, o un agente de IA (como Claude Code o Cline) puede usar el MCP server o el Codex Skill para analizar problemas de rendimiento de forma autónoma. La herramienta está diseñada para plataformas Linux (con kernel 4.14+) y es especialmente útil en entornos de desarrollo, staging y producción donde se requiere un análisis rápido y reproducible. Su arquitectura modular permite extenderlo con nuevos recolectores de datos y analizadores, haciéndolo adaptable a diferentes cargas de trabajo.

Compatible con~Claude Code✓Codex CLI~Cursor
npx skills add link0-o/PerfLens

Preguntar en tu IA favorita

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

Documentación

¿Qué hace PerfLens?

Kit de herramientas de análisis de rendimiento de Linux basado en evidencia, con CLI, servidor MCP y Skill de Codex para diagnóstico de puntos críticos y validación de optimización.

¿Qué es PerfLens?

PerfLens es un asistente de análisis de rendimiento para Linux que:

  • Recopila evidencia de múltiples fuentes del sistema (perf, strace, /proc, etc.)
  • Correlaciona datos para identificar la causa raíz de los cuellos de botella
  • Proporciona recomendaciones basadas en patrones conocidos de optimización

Características principales

  • Diagnóstico de hotspots: Identifica funciones, llamadas al sistema y procesos que consumen más recursos
  • Análisis de contención: Detecta bloqueos de bloqueos, condiciones de carrera y contención de caché
  • Validación de optimizaciones: Compara el rendimiento antes y después de los cambios
  • Múltiples interfaces: CLI para humanos, MCP server para agentes de IA, Skill de Codex para entornos de desarrollo

Instalación

# Instalar desde pip
pip install perflens

# O desde el código fuente
git clone https://github.com/link0-o/PerfLens.git
cd PerfLens
pip install -e .

Uso rápido

CLI

# Analizar un proceso específico
perflens hotspot --pid 1234

# Análisis completo del sistema
perflens syscheck

# Validar optimización
perflens diff --before before.data --after after.data

MCP Server

Configura el servidor MCP para permitir que agentes de IA (como Claude Code) ejecuten análisis:

{
  "mcpServers": {
    "perflens": {
      "command": "perflens-mcp",
      "args": ["--port", "8080"]
    }
  }
}

Codex Skill

Para usar en Cursor o Codex:

@perflens ¿Cuál es la causa de la alta latencia en el endpoint /api/users?

Licencia

MIT

Skills relacionados