README.es.md

🇺🇸 English | 🇸🇦 العربية | 🇪🇸 Català | 🇨🇿 Čeština | 🇩🇪 Deutsch | 🇪🇸 Español | 🇫🇮 Suomi | 🇫🇷 Français | 🇮🇹 Italiano | 🇯🇵 日本語 | 🇧🇷 Português (Brasil) | 🇷🇺 Русский | 🇹🇭 ไทย | 🇹🇷 Türkçe | 🇺🇦 Українська | 🇻🇳 Tiếng Việt | 🇨🇳 简体中文 | 🇹🇼 繁體中文

Checkmate

Una aplicación de código abierto para monitorización de disponibilidad e infraestructura

Este repositorio contiene tanto el frontend como el backend de Checkmate, una herramienta de monitorización de código abierto y auto-alojable que rastrea hardware de servidores, disponibilidad, tiempos de respuesta e incidentes en tiempo real con bonitas visualizaciones. Checkmate comprueba periódicamente si un servidor o sitio web está accesible y funciona de forma óptima, y proporciona alertas e informes en tiempo real sobre la disponibilidad, el tiempo de inactividad y los tiempos de respuesta de los servicios monitorizados.

Checkmate también dispone de un agente llamado Capture para obtener datos de servidores remotos. Capture no es necesario para ejecutar Checkmate, pero aporta información adicional sobre el estado de CPU, RAM, disco y temperatura de los servidores. Capture puede ejecutarse en Linux, Windows, Mac, Raspberry Pi o cualquier dispositivo que pueda ejecutar Go.

Checkmate ha sido sometido a pruebas de carga con más de 1000 monitores activos sin presentar problemas ni cuellos de botella de rendimiento.

📚 Tabla de contenidos

• 📦 Demo
• 🔗 Guía de usuario
• 🛠️ Instalación
• 🚀 Rendimiento
• 💚 Preguntas e ideas
• 🧩 Características
• 🏗️ Capturas de pantalla
• 🏗️ Stack tecnológico
• 🔗 Algunos enlaces
• 🤝 Contribuir

Demo

Puedes ver la última versión de Checkmate en acción.

El usuario es demouser@demo.com y la contraseña es Demouser1! (ten en cuenta que actualizamos el servidor de demostración de vez en cuando; si no funciona, escríbenos en el canal Discussions).

Guía de usuario

Las instrucciones de uso están disponibles aquí.

Prerrequisitos

• Docker instalado
• Git instalado

Instalación

Consulta las instrucciones de instalación en el portal de documentación de Checkmate.

También puedes utilizar Coolify, Elestio, K8s, Sive Host (Sudáfrica), Cloudzy o Pikapods para levantar rápidamente una instancia de Checkmate. Si quieres monitorizar la infraestructura de tus servidores, necesitarás el agente Capture. El repositorio de Capture también incluye las instrucciones de instalación.

Uso de una CA personalizada

Si necesitas monitorizar endpoints HTTPS internos con certificados emitidos por autoridades certificadoras privadas (como Smallstep), consulta nuestra guía de confianza para CAs personalizadas con las opciones de configuración para Docker.

Para más documentación, consulta el directorio docs.

Rendimiento

Gracias a optimizaciones extensas, Checkmate funciona con una huella de memoria excepcionalmente baja y requiere un mínimo de memoria y CPU. A continuación se muestra el uso de memoria de una instancia de Node.js en un servidor que monitoriza 323 servidores cada minuto:

Y aquí la huella de memoria de MongoDB y Redis en el mismo servidor (398 MB y 15 MB) para la misma cantidad de servidores:

Preguntas e ideas

Si tienes preguntas, sugerencias o comentarios, dispones de varias opciones:

• Canal de Discord (preferido)
• GitHub Discussions (entramos a verlo de vez en cuando)

No dudes en preguntar o compartir tus ideas — ¡nos encantará saber de ti!

Características

• Totalmente de código abierto, desplegable en tus propios servidores o dispositivos domésticos (por ejemplo, Raspberry Pi 4 o 5)
• Varias opciones de monitorización: disponibilidad, Docker, Ping, SSL, puerto, servidor de juegos
• Monitorización de velocidad de página
• Monitorización de infraestructura (memoria, uso de disco, rendimiento de CPU, red, etc.) — requiere el agente Capture
  • Monitorización selectiva de discos con selección de puntos de montaje
• Incidentes de un vistazo
• Páginas de estado con 4 temas elegantes
• Notificaciones por correo electrónico, webhooks, Discord, Slack, PagerDuty, Matrix, Microsoft Teams, Telegram, Pushover, Twilio (SMS)
• Mantenimiento programado
• Monitorización mediante consultas JSON
• Soporte multiidioma para árabe, chino (simplificado), chino (tradicional, Taiwán), checo, inglés, finés, francés, alemán, japonés, portugués (Brasil), ruso, español, tailandés, turco, ucraniano y vietnamita

Ciclo de vida de un monitor

1. Un monitor ejecuta una comprobación (HTTP / Ping / puerto / hardware vía el agente Capture)
2. El resultado se almacena (éxito/fallo + tiempo de respuesta)
3. Los resultados recientes se evalúan frente al umbral de cambio de estado configurado para el monitor
4. Si se alcanza el umbral y el estado actual difiere del anterior, el estado del monitor cambia (por ejemplo, initializing, up, down, breached)
5. Al cambiar de estado, se crea o resuelve un incidente según el estado actual del monitor
6. Las notificaciones se disparan según la configuración

Capturas de pantalla

Stack tecnológico

• ReactJs
• MUI (framework de React)
• Node.js
• MongoDB
• Recharts
• ¡Y muchos otros componentes de código abierto!

Algunos enlaces

• Si quieres apoyarnos, dale a ⭐ y pulsa "watch".
• ¿Tienes una pregunta o sugerencia sobre la hoja de ruta o las funcionalidades? Pásate por nuestro canal de Discord o el foro de Discussions.
• ¿Quieres una notificación cuando salga una nueva versión? Usa Newreleases, un servicio gratuito para seguir releases.
• Mira un vídeo de instalación y uso de Checkmate

Contribuir

Somos Alex (team lead), Gorkem, Aryaman, Mert y Karen, y ayudamos a personas y empresas a monitorizar su infraestructura y sus servidores.

Nos enorgullecemos de construir relaciones sólidas con la comunidad de contribuidores de cualquier nivel. A pesar de ser un proyecto joven, Checkmate ya ha conseguido más de 7000 estrellas y reúne a 90+ contribuidores de todo el mundo.

Nuestro repositorio cuenta con estrellas de empleados de Google, Microsoft, Intel, Cisco, Tencent, Electronic Arts, ByteDance, JP Morgan Chase, Deloitte, Accenture, Foxconn, Broadcom, China Telecom, Barclays, Capgemini, Wipro, Cloudflare, Dassault Systèmes y NEC — así que no te cortes: únete, contribuye y aprende con nosotros.

Cómo puedes contribuir:

0. Pon una estrella a este repo :)
1. Revisa la guía de contribución. Si es tu primera vez, te recomendamos mirar la etiqueta good-first-issue.
2. Lee la estructura detallada de Checkmate si quieres profundizar en la arquitectura.
3. Abre un issue si crees que has encontrado un bug.
4. Busca good-first-issue si eres nuevo en el proyecto.
5. Abre un pull request para añadir nuevas funciones, mejoras o correcciones de bugs.
6. Echa un vistazo a este recorrido interactivo del código de Checkmate en CodeCanvas aquí. Para mejorar las simulaciones de flujo de datos existentes o crear nuevas, sigue el tutorial rápido aquí.