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>
This commit is contained in:
1 parent
9a1b60fa2b
commit
b3b7041ee9
3 files changed
+3255
No files matched your search
@@ -10,6 +10,22 @@ devices ──514 udp/tcp──▶ logstream (Go) ──HTTP batches──▶ Vi
|
|||||||
└──── API / UI ◀─────────┘
|
└──── API / UI ◀─────────┘
|
||||||
```
|
```
|
||||||
|
|
||||||
|
## Architecture
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
- **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
|
## Getting started
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
|
|||||||
File diff suppressed because it is too large.
Load diff
Binary file not shown.
|
After Width: | Height: | Size: 597 KiB |
Reference in new issue
Block a user