Мониторинг и обновления

Проверки состояния

curl --fail http://127.0.0.1:8088/health
curl --fail http://127.0.0.1:8088/ready
curl --fail http://127.0.0.1:9090/license
curl --fail http://127.0.0.1:9090/metrics

/health проверяет процесс, /ready — готовность. Admin listener предоставляет Prometheus и состояние лицензии без секретов. Доступ к нему ограничивайте инфраструктурой мониторинга.

Метрики

Prometheus включается через telemetry.metrics.prometheus.enabled. По умолчанию push выключен. Для отправки в совместимый OTLP/HTTP protobuf backend настройте:

telemetry:
  metrics:
    push:
      enabled: true
      endpoint: https://telemetry.example.com/v1/metrics
      bearer_token_env: OTLP_TOKEN
      interval: 30s

Это отправка в OTLP-приёмник, а не POST на Prometheus /metrics. Scrape и push представляют один набор измерений: не складывайте две копии данных одного экземпляра.

Наблюдайте за готовностью, ошибками источников, временем обработки, попаданиями в кэш и свободным местом. Сопоставляйте конкретные запросы по X-Request-ID.

Обновление образа

1. Проверьте новый закреплённый образ на staging с отдельным кэшем и исходниками для проверки.
2. Сохраните предыдущий image digest и рабочую конфигурацию.
3. Обновите ZORKA_IMAGE, выполните docker compose pull и docker compose up -d.
4. Проверьте /ready, статус лицензии, обработку WebP/AVIF и кэш.

Для отката верните предыдущий образ и совместимую конфигурацию. Не удаляйте volume идентификатора установки: его замена создаёт другую установку с точки зрения лицензии.

Что сохранять

Резервируйте исходные изображения, конфигурацию и файл лицензии в защищённом хранилище. Сохраняйте volume установки. Кэш можно восстановить из источников, но его потеря увеличит нагрузку при прогреве.