README.ca.md

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

⚠️ Aquesta traducció és un esborrany generat de manera assistida. Es valoren les revisions de parlants natius a través d'un pull request.

Checkmate

Una aplicació de codi obert per a la monitorització de disponibilitat i infraestructura

Aquest repositori conté tant el frontend com el backend de Checkmate, una eina de monitorització de codi obert i auto-allotjable per fer el seguiment del maquinari del servidor, la disponibilitat, els temps de resposta i els incidents en temps real amb visualitzacions atractives. Checkmate comprova regularment si un servidor o lloc web és accessible i funciona correctament, i ofereix alertes i informes en temps real sobre la disponibilitat, les caigudes i els temps de resposta dels serveis monitoritzats.

Checkmate també disposa d'un agent anomenat Capture per recuperar dades de servidors remots. Tot i que Capture no és necessari per executar Checkmate, proporciona informació addicional sobre l'estat de la CPU, la RAM, el disc i la temperatura dels servidors. Capture pot executar-se a Linux, Windows, Mac, Raspberry Pi o qualsevol dispositiu capaç d'executar Go.

Checkmate s'ha provat sota càrrega amb més de 1.000 monitors actius sense cap problema o coll d'ampolla notable.

📚 Taula de continguts

• 📦 Demo
• 🔗 Guia d'usuari
• 🛠️ Instal·lació
• 🚀 Rendiment
• 💚 Preguntes i idees
• 🧩 Funcionalitats
• 🏗️ Captures de pantalla
• 🏗️ Stack tecnològic
• 🔗 Alguns enllaços
• 🤝 Contribuir

Demo

Pots veure la darrera versió de Checkmate en acció.

L'usuari és demouser@demo.com i la contrasenya és Demouser1! (Nota: actualitzem el servidor de demostració de tant en tant; si no funciona, escriu-nos al canal Discussions).

Guia d'usuari

Pots trobar les instruccions d'ús aquí.

Requisits previs

• Docker instal·lat
• Git instal·lat

Instal·lació

Consulta les instruccions d'instal·lació al portal de documentació de Checkmate.

Alternativament, també pots utilitzar Coolify, Elestio, K8s, Sive Host (Sud-àfrica), Cloudzy o Pikapods per posar en marxa ràpidament una instància de Checkmate. Si vols monitoritzar la infraestructura de servidors, necessitaràs l'agent Capture. El repositori de Capture també conté les instruccions d'instal·lació.

Utilitzar una CA personalitzada

Si necessites monitoritzar punts HTTPS interns amb certificats d'autoritats certificadores privades (com Smallstep), consulta la nostra Guia de confiança per a CA personalitzades per a les opcions de configuració de Docker.

Per a més documentació, consulta el directori docs.

Rendiment

Gràcies a una optimització exhaustiva, Checkmate funciona amb un consum de memòria excepcionalment baix, requerint un mínim de RAM i CPU. Aquí tens l'ús de memòria d'una instància de Node.js en un servidor que monitoritza 323 servidors cada minut:

Aquí pots veure la petjada de memòria de MongoDB i Redis al mateix servidor (398 MB i 15 MB) per al mateix nombre de servidors:

Preguntes i idees

Si tens preguntes, suggeriments o comentaris, tens diverses opcions:

• Canal de Discord (preferit)
• GitHub Discussions (hi entrem de tant en tant)

No dubtis a preguntar o compartir les teves idees — ens encantarà tenir notícies teves!

Funcionalitats

• Totalment de codi obert, desplegable als teus servidors o dispositius domèstics (per ex. Raspberry Pi 4 o 5)
• Diverses opcions de monitorització: disponibilitat, Docker, ping, SSL, port, servidor de jocs
• Monitorització de velocitat de pàgina
• Monitorització d'infraestructura (memòria, ús de disc, rendiment de CPU, xarxa, etc.) — requereix l'agent Capture
  • Monitorització selectiva de disc amb selecció de punts de muntatge
• Incidents amb un cop d'ull
• Pàgines d'estat amb 4 temes elegants
• Notificacions per correu electrònic, webhooks, Discord, Slack, PagerDuty, Matrix, Microsoft Teams, Telegram, Pushover, Twilio (SMS)
• Manteniment programat
• Monitorització mitjançant consultes JSON
• Suport multilingüe per a àrab, xinès (simplificat), xinès (tradicional, Taiwan), txec, anglès, finès, francès, alemany, japonès, portuguès (Brasil), rus, espanyol, tailandès, turc, ucraïnès i vietnamita

Cicle de vida d'un monitor

1. Un monitor executa una comprovació (HTTP / ping / port / maquinari mitjançant l'agent Capture)
2. El resultat es desa (èxit/fracàs + temps de resposta)
3. Els resultats recents s'avaluen contra el llindar de canvi d'estat configurat al monitor
4. Si s'assoleix el llindar i l'estat actual difereix de l'anterior, l'estat del monitor canvia (per ex. initializing, up, down, breached)
5. En un canvi d'estat, es crea o resol un incident, segons l'estat actual del monitor
6. Es disparen les notificacions segons la configuració

Captures de pantalla

Stack tecnològic

• ReactJs
• MUI (framework de React)
• Node.js
• MongoDB
• Recharts
• I molts altres components de codi obert!

Alguns enllaços

• Si vols donar-nos suport, considera donar-nos una ⭐ i prémer "watch".
• Tens alguna pregunta o suggeriment per al roadmap o les funcionalitats? Visita el nostre canal de Discord o el fòrum de Discussions.
• Vols rebre una notificació quan hi hagi una nova versió? Utilitza Newreleases, un servei gratuït per seguir versions.
• Mira un vídeo d'instal·lació i ús de Checkmate

Contribuir

Som l'Alex (líder d'equip), en Gorkem, l'Aryaman, en Mert i la Karen, i ajudem persones i empreses a monitoritzar la seva infraestructura i els seus servidors.

Ens enorgullim de construir vincles forts amb els col·laboradors a tots els nivells. Tot i ser un projecte jove, Checkmate ja ha aconseguit més de 7.000 estrelles i ha atret més de 90 col·laboradors d'arreu del món.

El nostre repositori té estrelles d'empleats 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 i NEC — no t'estiguis de res: uneix-te, contribueix i aprèn amb nosaltres!

Així pots contribuir:

0. Posa una estrella a aquest repositori :)
1. Consulta la guia per a col·laboradors. Recomanem als principiants revisar l'etiqueta good-first-issue.
2. Llegeix una estructura detallada de Checkmate si vols aprofundir en l'arquitectura.
3. Obre una issue si creus que has trobat un error.
4. Mira els good-first-issue si ets nou.
5. Fes una pull request per afegir noves funcionalitats, millores de qualitat o solucions a errors.
6. Fes una ullada al recorregut interactiu del codi de Checkmate a CodeCanvas aquí. Per refinar simulacions de flux de dades existents o crear-ne de noves, segueix el tutorial ràpid aquí.