Здоровье
GET /api/health — публичный. Тело всегда содержит ok, store, число соединений, комнат, uptime и подробности стора; код 200 при здоровом сторе и 503, если проблема со стором.
Метрики
GET /metrics — формат Prometheus, требует Authorization: Bearer $REMO_METRICS_TOKEN в production. nginx закрывает /api/metrics снаружи: снимайте метрики с loopback.
| Метрика | Что показывает |
|---|---|
remo_build_info |
версия, номер сборки, commit и версия схемы работающего сервиса |
remo_http_requests_total |
запросы по маршрутам |
remo_ws_connections_total, _active |
принятые и открытые сокеты |
remo_ws_rejected_total |
отказы в апгрейде |
remo_ws_readonly_write_attempt |
попытки записи от read-only |
remo_ws_quota_closed_total |
закрытия соединений по квоте записи; причина rate или room-full |
remo_ws_edit_audit_rows_total |
окна правок, записанные в аудит |
remo_ws_edit_audit_dropped_total |
окна правок, которые не удалось записать в аудит |
remo_rooms_active |
комнаты в памяти |
remo_store_writes_total, remo_store_write_errors_total |
записи и ошибки стора |
remo_store_compactions_total |
компакции журнала |
Журналы
journalctl -u remo-sync -f— сервис, комнаты, доступ.journalctl -u remo-sync | grep '\[agent\]'— задачи агентов и ошибки модели.journalctl -u remo-sync | grep '\[events\]'— доставка событий./var/log/nginx/error.log— проксирование и сокеты.
Продуктовые метрики
Если задан REMO_METRICS_DATABASE_URL, события продукта пишутся в отдельную базу (не в базу комнат). Без неё инструментация — no-op; REMO_METRICS=off выключает её явно.
Аудит правок
Правки через соединение попадают в аудит организации одной записью на сессию, комнату и окно 60 с: число правок и байт, id объектов и поля. Содержимое комнаты не пишется. Запись доступна администратору организации и администратору безопасности в организации → Журнал; отдельной человекочитаемой подписи у этого действия пока нет. Если запись не удалась, растёт remo_ws_edit_audit_dropped_total.
Что смотреть при жалобе
/health— жив ли сервис и виден ли стор.journalctlза окно жалобы — ошибки доступа, сокетов, агентов.- Метрики: рост отказов или попыток записи от read-only означает проблему с правами. Рост
remo_ws_quota_closed_total— слишком частые правки или заполненная комната; ростremo_ws_edit_audit_dropped_total— ошибка записи аудита. - Журнал агента и AI-журнал организации — если жалоба про задачу.
Куда дальше
Устранение неполадок — типовые симптомы и причины.