Author SHA1 Message Date
cedric 392fc645ce wip schema: arrows between containers 2026-10-02 09:17:30 +02:00
cedric 81806a6991 wip schema: straight polyline arrows 2026-10-02 09:16:59 +02:00
cedric 6abf1f47fd wip schema source 2026-10-02 09:16:02 +02:00
cedricandClaude Opus 5.5 b3b7041ee9 README: architecture diagram
Adds the logical diagram of the project (PNG and its editable Excalidraw
source in docs/) and an Architecture section after the introduction,
with a short description of the data flows.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-10-02 09:09:08 +02:00
3 changed files with 3504 additions and 0 deletions

No files matched your search

+16
View File
@@ -10,6 +10,22 @@ devices ──514 udp/tcp──▶ logstream (Go) ──HTTP batches──▶ Vi
└──── API / UI ◀─────────┘
```
## Architecture
![Schéma logique de Logstream](docs/logstream-schema-logique.png)
- **Ingestion**: syslog (UDP/TCP) and Docker container logs both go through `sink()` (reverse DNS
on IP hosts), then the `Store` queue, which sends them in batches to VictoriaLogs.
- **Live view**: `sink()` also publishes each message to the `Hub`, which streams it to the
browsers over SSE.
- **Search**: the HTTP API turns the UI filters into LogsQL queries sent to VictoriaLogs.
- **State**: tags and source settings live in `/data` (`logstream-data` volume); the logs
themselves in the `vlogs-data` volume.
The editable source of the diagram is
[`docs/logstream-schema-logique.excalidraw`](docs/logstream-schema-logique.excalidraw)
(open it on [excalidraw.com](https://excalidraw.com)).
## Getting started
```bash
File diff suppressed because it is too large. Load diff
Binary file not shown.

After

Width:  |  Height:  |  Size: 597 KiB