Метрики Prometheus

NORA публикует Prometheus-совместимые метрики на эндпоинте /metrics. Аутентификация не требуется.

curl http://localhost:4000/metrics

HTTP-метрики

Метрика	Тип	Метки	Описание
`nora_http_requests_total`	Counter	`registry`, `method`, `status`	Всего обработано HTTP-запросов
`nora_http_request_duration_seconds`	Histogram	`registry`, `method`	Задержка запроса (корзины: от 1 мс до 10 с)

Метка registry определяется по пути запроса:

Префикс пути	Метка
`/v2*`	`docker`
`/npm*`	`npm`
`/simple`, `/packages`	`pypi`
`/maven2*`	`maven`
`/cargo*`	`cargo`
`/go/*`	`go`
`/raw/*`	`raw`
`/gems/*`	`gems`
`/terraform/*`	`terraform`
`/ansible/*`	`ansible`
`/nuget/*`	`nuget`
`/pub/*`	`pub`
`/conan/*`	`conan`
`/ui*`	`ui`
(прочие пути)	`other`

Метрики кэша

Метрика	Тип	Метки	Описание
`nora_cache_requests_total`	Counter	`registry`, `result`	Обращения к кэшу (`hit` или `miss`)

Метрики хранилища

Метрика	Тип	Метки	Описание
`nora_storage_operations_total`	Counter	`operation`, `status`	Операции хранилища (`get`, `put`, `delete`, `list`) со статусом `ok` или `error`
`nora_artifacts_total`	Gauge	`registry`	Количество артефактов, хранящихся в данный момент по каждому реестру (растёт и уменьшается вместе с GC)
`nora_storage_bytes`	Gauge	`registry`	Объём хранимых артефактов в байтах по каждому реестру (метка `total` = полный объём, включая метаданные)
`nora_storage_get_bytes`	Histogram	`registry`	Размер тела буферизованных чтений `Storage::get()` (корзины: от 1 КБ до 512 МБ)
`nora_storage_verify_duration_seconds`	Histogram	`registry`	Время проверки целостности SHA-256 по «настенным» часам на каждое буферизованное чтение, включая время ожидания в очереди блокирующего пула

Метрики предохранителя (circuit breaker)

Доступны при NORA_CB_ENABLED=true.

Метрика	Тип	Метки	Описание
`nora_circuit_breaker_state`	Gauge	`registry`	Текущее состояние: `0` = closed, `1` = open, `2` = half-open
`nora_circuit_breaker_rejections_total`	Counter	`registry`	Запросы, отклонённые открытым предохранителем

Метрики сборки мусора

Метрика	Тип	Описание
`nora_gc_blobs_removed_total`	Counter	Осиротевшие blob-объекты, удалённые сборкой мусора
`nora_gc_bytes_freed_total`	Counter	Байты, освобождённые сборкой мусора
`nora_gc_duration_seconds`	Histogram	Длительность запусков GC (корзины: от 0.1 с до 300 с)
`nora_gc_last_run_timestamp`	Gauge	Unix-метка времени последнего запуска GC
`nora_gc_metadata_phantoms_total`	Counter	Фантомные записи версий, очищенные из метаданных
`nora_gc_stat_failures_total`	Counter	Осиротевшие объекты, для которых GC не смог выполнить `stat` (сохранены, возраст неизвестен) — ненулевое значение означает, что GC, возможно, не может освободить место; настройте на это алерт

Метрики политик хранения

Метрика	Тип	Описание
`nora_retention_versions_deleted_total`	Counter	Версии, удалённые политиками хранения
`nora_retention_bytes_freed_total`	Counter	Байты, освобождённые политиками хранения
`nora_retention_duration_seconds`	Histogram	Длительность запусков политик хранения (корзины: от 0.1 с до 300 с)
`nora_retention_last_run_timestamp`	Gauge	Unix-метка времени последнего запуска политик хранения

Метрики трафика

Метрика	Тип	Метки	Описание
`nora_downloads_total`	Counter	`registry`	Всего скачиваний артефактов
`nora_uploads_total`	Counter	`registry`	Всего загрузок артефактов

Метрики вышестоящего прокси

Публикуются на пути прокси, когда NORA обращается к настроенному вышестоящему источнику.

Метрика	Тип	Метки	Описание
`nora_upstream_request_duration_seconds`	Histogram	`registry`, `status`	Задержка запроса к вышестоящему прокси (корзины: от 1 мс до 30 с)
`nora_proxy_active_downloads`	Gauge	(нет)	Загрузки blob-объектов Docker, передаваемые потоком в данный момент
`nora_proxy_download_bytes_total`	Counter	(нет)	Всего байт, скачанных из вышестоящих реестров Docker (только проверенные скачивания)

Метрики ревалидации и коалесцирования

Ревалидация по условным запросам (304) и коалесцирование запросов по схеме single-flight на пути прокси.

Метрика	Тип	Метки	Описание
`nora_proxy_upstream_304_total`	Counter	`registry`	Ответы `304 Not Modified` от вышестоящего источника при ревалидации
`nora_proxy_revalidation_bytes_saved_total`	Counter	`registry`	Байты тела, которые не пришлось скачивать заново благодаря ревалидации 304
`nora_proxy_revalidation_errors_total`	Counter	`registry`	Попытки ревалидации, завершившиеся откатом к полной загрузке
`nora_proxy_coalesced_total`	Counter	`registry`	Запросы-последователи, обслуженные от лидера single-flight без обращения к вышестоящему источнику
`nora_proxy_inflight`	Gauge	`registry`	Различные ключи, скачиваемые в данный момент в рамках коалесцирования single-flight
`nora_proxy_coalesce_fallthrough_total`	Counter	`registry`, `reason`	Последователи, которые вместо коалесцирования выполнили собственную загрузку (`reason` ∈ `leader`, `budget`)

Метрики курирования

Метрика	Тип	Метки	Описание
`nora_curation_decisions_total`	Counter	`decision`	Решения курирования по фактическому результату (`allow`, `block`, `audit`, `skip`)
`nora_quarantine_holds_total`	Counter	`registry`, `outcome`	Артефакты, задержанные карантином по дайджесту (`outcome` ∈ `blocked`, `observed`)

Метрики безопасности

Метрика	Тип	Метки	Описание
`nora_auth_namespace_scope_total`	Counter	`provider`, `decision`	Решения об энфорсменте OIDC `namespace_scope` (`allow`, `deny`, `would_deny`)
`nora_response_upstream_url_leak_total`	Counter	`registry`	Имя хоста вышестоящего источника обнаружено в теле исходящего ответа
`nora_leak_detection_skipped_total`	Counter	`reason`	Пропущенные проверки на утечки (тело слишком велико или размер неизвестен)

Метрики целостности

Метрика	Тип	Метки	Описание
`nora_cache_write_errors_total`	Counter	`registry`, `operation`	Ошибки записи в кэш в фоновых задачах кэширования
`nora_metadata_corrupt_total`	Counter	`registry`	Повреждённые метаданные, обнаруженные при публикации (ошибка разбора существующих данных)

Метрики процесса

Метрика	Тип	Метки	Описание
`nora_uptime_seconds`	Gauge	(нет)	Время работы процесса в секундах

Пример для Grafana

# Request rate by registry (5m window)
sum by (registry) (rate(nora_http_requests_total[5m]))

# Cache hit ratio
sum(rate(nora_cache_requests_total{result="hit"}[5m]))
/
sum(rate(nora_cache_requests_total[5m]))

# p99 latency per registry
histogram_quantile(0.99, sum by (le, registry) (rate(nora_http_request_duration_seconds_bucket[5m])))

# Circuit breaker alerts (open state)
nora_circuit_breaker_state == 1

# GC bytes freed per hour
increase(nora_gc_bytes_freed_total[1h])

Конфигурация сбора метрик

scrape_configs:
  - job_name: nora
    scrape_interval: 15s
    static_configs:
      - targets: ['nora:4000']
    metrics_path: /metrics

Смотрите также

Справочник по конфигурации — справочник по конфигурации сервера (эндпоинт /metrics всегда включён, без аутентификации)
Предохранитель (circuit breaker) — подробности о метриках предохранителя
Руководство по обновлению — новые метрики в v0.9