@application-kit/observability 0.4.0 → 0.5.1

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # @application-kit/observability
 
+## 0.5.1
+
+### Patch Changes
+
+- Updated dependencies [7d0253e]
+  - @application-kit/typeorm@0.4.0
+
+## 0.5.0
+
+### Minor Changes
+
+- 0f930bf: `metric-names.json` в пакете (вход `@application-kit/observability/metric-names.json`): имена и типы всех метрик
+  реестра — гистограмм HTTP и GraphQL и метрик процесса. По нему чарт платформы сверяет VMRule и дашборды, не
+  запуская код пакета; совпадение файла с реестром держит тест пакета.
+
 ## 0.4.0
 
 ### Minor Changes

package/README.md

@@ -39,6 +39,9 @@ Peer-зависимости: `@nestjs/common`, `@prometheus-io/client`; оста
   `start(key)` → `describe(key, document)` → `finish(key, hasErrors)`, где `key` — объект контекста запроса;
   `asMercuriusHook` оборачивает синхронный обработчик в async-хук Mercurius.
 - `DURATION_BUCKETS_SECONDS` — общие границы гистограмм, от 5 мс до 10 с.
+- `@application-kit/observability/metric-names.json` — имена и типы всех метрик реестра (обе гистограммы и метрики
+  процесса на Linux) для тех, кто строит по ним алерты и дашборды, не запуская код: чарт платформы сверяет с ним
+  VMRule и дашборды. Файл совпадает с реестром — это держит тест пакета; переименование метрики — major.
 
 Web-процесс подключает `MetricsHttpModule.forRoot({ publicRoute })` — реестр, обе гистограммы и `GET /metrics`
 (путь — `METRICS_ROUTE` входа `/logging`), — и вешает хуки после создания приложения: HTTP — `onResponse` Fastify

package/metric-names.json

@@ -0,0 +1,142 @@
+[
+  {
+    "name": "graphql_operation_duration_seconds",
+    "type": "histogram"
+  },
+  {
+    "name": "http_request_duration_seconds",
+    "type": "histogram"
+  },
+  {
+    "name": "nodejs_active_handles",
+    "type": "gauge"
+  },
+  {
+    "name": "nodejs_active_handles_total",
+    "type": "gauge"
+  },
+  {
+    "name": "nodejs_active_requests",
+    "type": "gauge"
+  },
+  {
+    "name": "nodejs_active_requests_total",
+    "type": "gauge"
+  },
+  {
+    "name": "nodejs_active_resources",
+    "type": "gauge"
+  },
+  {
+    "name": "nodejs_active_resources_total",
+    "type": "gauge"
+  },
+  {
+    "name": "nodejs_eventloop_lag_max_seconds",
+    "type": "gauge"
+  },
+  {
+    "name": "nodejs_eventloop_lag_mean_seconds",
+    "type": "gauge"
+  },
+  {
+    "name": "nodejs_eventloop_lag_min_seconds",
+    "type": "gauge"
+  },
+  {
+    "name": "nodejs_eventloop_lag_p50_seconds",
+    "type": "gauge"
+  },
+  {
+    "name": "nodejs_eventloop_lag_p90_seconds",
+    "type": "gauge"
+  },
+  {
+    "name": "nodejs_eventloop_lag_p99_seconds",
+    "type": "gauge"
+  },
+  {
+    "name": "nodejs_eventloop_lag_seconds",
+    "type": "gauge"
+  },
+  {
+    "name": "nodejs_eventloop_lag_stddev_seconds",
+    "type": "gauge"
+  },
+  {
+    "name": "nodejs_eventloop_utilization_histogram",
+    "type": "histogram"
+  },
+  {
+    "name": "nodejs_eventloop_utilization_summary",
+    "type": "summary"
+  },
+  {
+    "name": "nodejs_external_memory_bytes",
+    "type": "gauge"
+  },
+  {
+    "name": "nodejs_gc_duration_seconds",
+    "type": "histogram"
+  },
+  {
+    "name": "nodejs_heap_size_total_bytes",
+    "type": "gauge"
+  },
+  {
+    "name": "nodejs_heap_size_used_bytes",
+    "type": "gauge"
+  },
+  {
+    "name": "nodejs_heap_space_size_available_bytes",
+    "type": "gauge"
+  },
+  {
+    "name": "nodejs_heap_space_size_total_bytes",
+    "type": "gauge"
+  },
+  {
+    "name": "nodejs_heap_space_size_used_bytes",
+    "type": "gauge"
+  },
+  {
+    "name": "nodejs_version_info",
+    "type": "gauge"
+  },
+  {
+    "name": "process_cpu_seconds_total",
+    "type": "counter"
+  },
+  {
+    "name": "process_cpu_system_seconds_total",
+    "type": "counter"
+  },
+  {
+    "name": "process_cpu_user_seconds_total",
+    "type": "counter"
+  },
+  {
+    "name": "process_heap_bytes",
+    "type": "gauge"
+  },
+  {
+    "name": "process_max_fds",
+    "type": "gauge"
+  },
+  {
+    "name": "process_open_fds",
+    "type": "gauge"
+  },
+  {
+    "name": "process_resident_memory_bytes",
+    "type": "gauge"
+  },
+  {
+    "name": "process_start_time_seconds",
+    "type": "gauge"
+  },
+  {
+    "name": "process_virtual_memory_bytes",
+    "type": "gauge"
+  }
+]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@application-kit/observability",
-  "version": "0.4.0",
+  "version": "0.5.1",
   "description": "Наблюдаемость NestJS-процесса: метрики Prometheus и RED-гистограммы, health-чеки и пробы, опции pino с request-id и trace-контекстом, логирование CQRS-шин, реальный IP клиента за прокси, трейсинг OpenTelemetry",
   "keywords": [
     "cqrs",
@@ -89,6 +89,7 @@
         "default": "./dist/cjs/logging/index.js"
       }
     },
+    "./metric-names.json": "./metric-names.json",
     "./metrics": {
       "import": {
         "types": "./dist/esm/metrics/index.d.ts",
@@ -111,7 +112,8 @@
   "module": "./dist/esm/metrics/index.js",
   "types": "./dist/cjs/metrics/index.d.ts",
   "files": [
-    "dist"
+    "dist",
+    "metric-names.json"
   ],
   "scripts": {
     "build": "rm -rf ./dist && node ../../scripts/barrels.mjs create ./src/cqrs && node ../../scripts/barrels.mjs create ./src/health --entry-only=cli,graphql && node ../../scripts/barrels.mjs create ./src/http && node ../../scripts/barrels.mjs create ./src/logging && node ../../scripts/barrels.mjs create ./src/metrics && node ../../scripts/barrels.mjs create ./src/tracing && tsc --project tsconfig.build.json && tsc --project tsconfig.build.cjs.json && node ../../scripts/barrels.mjs clean ./src && node ../../scripts/mark-cjs.mjs ./dist/cjs",
@@ -120,7 +122,7 @@
     "test:unit": "vitest run"
   },
   "dependencies": {
-    "@application-kit/typeorm": "^0.3.0"
+    "@application-kit/typeorm": "^0.4.0"
   },
   "devDependencies": {
     "@nestjs/common": "^11.2.7",