SYSWATCHÎnapoi la home
DOCUMENTAȚIE

SysWatch Docs

Tot ce ai nevoie pentru a instala agentul, configura alertele și integra API-ul.

Quick start

1. Creează un cont la syswatch.stackfloww.com și adaugă primul server din dashboard.

2. Copiază comanda de instalare din pagina serverului:

bash <(curl -fsSL https://syswatch.stackfloww.com/api/user/install/<TOKEN>)

3. Rulează comanda pe server cu acces root. Instalarea durează aproximativ 30 de secunde și:

  • Creează serviciul systemd syswatch-agent
  • Detectează automat nginx, apache, PM2, WordPress, Caddy
  • Verifică SSL și uptime pentru fiecare site găsit
  • Pornește automat la reboot
  • 4. Agentul apare Online în dashboard-ul tău în max. 60 de secunde.

    Cerințe sistem

    CerințăDetalii
    OSLinux (Ubuntu 18+, Debian 10+, CentOS 7+)
    Shellbash
    Dependențe`curl`, `python3`
    Init systemsystemd
    Accesroot sau sudo
    RețeaOutbound HTTPS (443) — niciun port inbound necesar
    Stocare~10 MB pe disk

    Comenzi agent

    Stare agent:

    sudo systemctl status syswatch-agent

    Repornire agent:

    sudo systemctl restart syswatch-agent

    Logs agent (ultimele 50 linii):

    sudo journalctl -u syswatch-agent -n 50

    Dezinstalare completă:

    sudo systemctl stop syswatch-agent
    sudo systemctl disable syswatch-agent
    sudo rm /etc/systemd/system/syswatch-agent.service
    sudo rm -rf /opt/syswatch-agent
    sudo systemctl daemon-reload

    Alerte

    SysWatch trimite alerte prin email (și opțional WhatsApp) când:

  • Un site monitorizat cade (HTTP 5xx sau timeout)
  • Certificatul SSL expiră în mai puțin de 7 zile
  • CPU depășește pragul configurat (implicit 80%)
  • RAM depășește pragul configurat (implicit 85%)
  • Disk depășește pragul configurat (implicit 90%)
  • Configurare praguri: Pagina serverului → Setări alerte → slide pentru fiecare metric.

    Fereastră mentenanță: Alertele sunt suprimate automat în intervalul setat. Util pentru update-uri planificate.

    Webhook: Orice alertă trimite și un POST JSON la URL-ul configurat:

    {
      "serverId": "...",
      "serverLabel": "Producție",
      "type": "cpu_high",
      "value": 92.5,
      "threshold": 80,
      "timestamp": "2026-05-16T14:30:00Z"
    }

    Public API (v1)

    Toate endpoint-urile returnează JSON. Autentificare cu header:

    Authorization: Bearer sw_<your-api-key>

    Generare cheie API: Dashboard → Profil → API Keys → Cheie nouă.


    GET /api/v1/servers

    Returnează lista serverelor tale.

    [
      {
        "id": "clxxx",
        "label": "Producție",
        "hostname": "server.example.com",
        "status": "online",
        "cpuUsage": 45.2,
        "memUsage": 67.1,
        "diskUsage": 42.0,
        "lastSeenAt": "2026-05-16T14:29:00Z"
      }
    ]

    GET /api/v1/servers/:id

    Detalii server individual.


    GET /api/v1/servers/:id/metrics?hours=24

    Istoricul metricilor (max 7 zile). Parametri:

  • hours — numărul de ore de returnat (1–168, default 24)

  • GET /api/v1/sites

    Lista site-urilor monitorizate cu status SSL și uptime.


    Rate limiting: 100 req/min per cheie API.

    Pagini de status publice

    Fiecare site monitorizat poate avea o pagină de status publică la:

    https://syswatch.stackfloww.com/status/<slug>

    Configurare slug: Dashboard → Site → Editează → câmpul "Status page slug".

    Pagina publică afișează:

  • Status curent (online/offline)
  • Timp de răspuns
  • Zile SSL rămase
  • Uptime pe ultimele 30 de zile (bare colorate)
  • Istoricul incidentelor recente
  • Poți trimite link-ul clienților pentru transparență completă.

    Program de referral

    Fiecare cont are un cod de referral unic. Când un utilizator nou se înregistrează cu codul tău:

  • Tu primești €5 credit la urmatoarea factură
  • Noul utilizator primește 14 zile gratuite în plus
  • Găsește-ți codul: Dashboard → Profil → Referral code.

    Link de distribuire:

    https://syswatch.stackfloww.com/register?ref=<codul-tau>

    Facturare

    Planuri:

    PlanPrețServereSite-uriAlerte
    Free€013Email
    Pro€4.99/lunăNelimitatNelimitatEmail + WhatsApp

    Coupon codes: Introduceți codul în câmpul din pagina de checkout. Contactați support pentru coduri de discount.

    Anulare: Poți anula oricând din Dashboard → Abonament → Anulează. Accesul rămâne activ până la finalul perioadei plătite.

    Factură: Factura lunară se trimite automat pe email-ul contului la fiecare reînnoire.

    Suport

    Ticket din dashboard: Dashboard → Suport → Bilet nou. Răspundem în max. 24 ore în zilele lucrătoare.

    Email direct: [email protected]

    Urgențe (server down, date pierdute): Menționați URGENT în titlul biletului pentru prioritizare.