Přeskočit na obsah
Vladimír Urík
Všechny projektyVedlejší projekt, 5 min čtení

Monitoring pro Laravel na vlastním serveru, který rozumí stejnému protokolu jako Laravel Nightwatch a SDK od Sentry. Aplikace tak posílá telemetrii k vám a v kódu přitom nezměníte ani řádek.

Role
Autor
Začátek
Listopad 2026
Backend
Rust, axum, tokio, ClickHouse, SQLite
Frontend
React Router 7 s renderováním na serveru

Monitoring vidí všechno: obsah požadavků, dotazy, ID uživatelů i výjimky s celým kontextem. U hostované služby tohle všechno odchází z vašeho serveru, takže jí buď věříte, nebo trávíte čas mazáním citlivých údajů. darkluna všechno nechává u vás: jeden kontejner vedle ClickHouse, žádné tarify a žádné kvóty.

Dashboard darkluna s požadavky, chybami serveru, časem odezvy p95, otevřenými problémy, grafy provozu a chyb a prací na pozadí
Dashboard po týdnu provozu.

Balíček Nightwatch pro Laravel je pod licencí MIT, a tak jsem si ho prošel i s přibaleným agentem. Aplikace s cloudem nekomunikuje přímo. Na konci každého požadavku nebo příkazu otevře TCP spojení s lokálním agentem a pošle mu malý rámec s polem záznamů v JSONu. Agent je sbírá do bufferu, zkomprimuje gzipem a odešle dál.

<length>:v1:<tokenHash>:<body>    app to agent, one frame per connection
2:OK                              agent to app, then the socket closes
Lokální rámec. tokenHash je prvních sedm znaků hashe XXH3-128 z tokenu.
  1. 01

    Laravel aplikace

    Nightwatch nebo Sentry SDK, beze změny

  2. 02

    Agent

    PHP agent nebo agent darkluny, lokální TCP

  3. 03

    darkluna

    Ingest v Rustu, omezené buffery

  4. 04

    ClickHouse

    Sloupcové úložiště s TTL

Stávajícího agenta nasměrujte na darklunu, nebo ho nahraďte nativním agentem v Rustu.

A v tom je celý trik: stačí změnit NIGHTWATCH_BASE_URL a token a původní agent začne všechno posílat do darkluny. Samotná Laravel aplikace zůstane beze změny.

  • Požadavky, joby, příkazy, plánované úlohy, dotazy, cache, odchozí HTTP volání, e-maily, notifikace a logy, s celkovými počty, průměry a p95
  • Problémy k roztřídění: stav, priorita, řešitel, komentáře a regrese
  • Upozornění do e-mailu, Slacku, Discordu, Telegramu nebo na podepsaný webhook, s prodlevou proti opakovanému spouštění
  • Výkonnostní problémy, když route, job nebo příkaz překročí svůj limit pro p95
  • N+1 dotazy a lazy loading, nejhorší jako první
  • Živé aktualizace přes WebSocket a MCP server, přes který AI asistent čte problémy, ale jen s vašimi oprávněními
Problém s výjimkou deadlocku, popisem, vysokou prioritou, řešitelem a komentářem
Jeden pomalý požadavek s jeho fázemi a všemi voláními cache a dotazy na časové ose
Problém během třídění a jeden požadavek se všemi fázemi, voláními cache a dotazy na časové ose.
Přehled N+1 dotazů s tím, kolikrát se opakují v jednom běhu, a s jejich celkovým časem
Pravidla upozornění na nové výjimky, regrese, chybovost, pomalé požadavky, selhané joby a chybějící provoz
N+1 dotazy od nejhorších a pravidla upozornění i s kanály, kam chodí.

Backend je rozdělený podle domén, ne podle vrstev: ingest, analytika, autentizace, úložiště metadat, ClickHouse. V produkčním kódu žádný unwrap. Vstup se převádí na typy hned na hranici systému. Každý kanál i buffer má pevný limit, takže proces pod zátěží nikdy nespadne. Při SIGTERM se buffery před ukončením vyprázdní do ClickHouse.

událostí za sekundu při ingestu, měřeno na notebooku
88k
paměti v nečinnosti
32 MB
disku za týden s milionem událostí
75 MB
kontejner a k tomu ClickHouse
1

© 2026 Vladimír Urík