# SigNoz для HAN Chat

Одноузловой self-hosted SigNoz на Ubuntu 24.04 через официальный
`foundryctl` и Docker Compose. Исполняемый порядок раскатки, lockdown и
обновления — только в [docs/RUNBOOK.ru.md](docs/RUNBOOK.ru.md).

Сетевая модель:

- VM SigNoz: `192.168.0.5`;
- OTLP/gRPC: `192.168.0.5:4317`, только приватная сеть;
- OTLP/HTTP: `192.168.0.5:4318`, только приватная сеть;
- UI/API: `127.0.0.1:8080`, доступ только через SSH-туннель;
- ClickHouse, PostgreSQL и ClickHouse Keeper наружу не публикуются.

## Требования

- минимум 4 GiB RAM (для эксплуатации лучше 8 GiB);
- минимум 30 GiB свободного диска для старта;
- временный исходящий доступ в интернет на время установки и обновлений;
- рабочий приватный интерфейс с адресом `192.168.0.5`;
- доступ к ВМ по SSH через приватную сеть до отключения внешнего IP.

## Документация

- [RUNBOOK.ru.md](docs/RUNBOOK.ru.md) — раскатка ВМ3, verify, firewall,
  lockdown, обновление и rollback;
- [NETWORK.md](docs/NETWORK.md) — сеть, группа безопасности, SSH-туннель;
- [BACKEND_OTLP.md](docs/BACKEND_OTLP.md) — передача телеметрии HAN Chat;
- [SIGNOZ_RUNBOOK.md](docs/SIGNOZ_RUNBOOK.md) — ежедневная работа в UI и
  разбор инцидентов;
- [MVP_DASHBOARDS_ALERTS.md](docs/MVP_DASHBOARDS_ALERTS.md) — versioned
  спецификация первых dashboards и alerts.