Update metrics documetanion

Author: ilyario

docs/en/gui.md

@@ -59,7 +59,7 @@ Logs are read from the DataFlow processor pod (container `processor`), using lab
 
 ## Backend API
 
-All endpoints return JSON except logs (plain text or SSE).
+All endpoints return JSON except logs (plain text or SSE) and metrics (Prometheus text format when operator URL is configured).
 
 | Method | Path | Description |
 |--------|------|-------------|
@@ -71,7 +71,7 @@ All endpoints return JSON except logs (plain text or SSE).
 | DELETE | `/api/dataflows/<name>?namespace=<ns>` | Delete DataFlow |
 | GET | `/api/logs?namespace=&name=&tailLines=&follow=true\|false` | Processor pod logs (text or SSE when `follow=true`) |
 | GET | `/api/status?namespace=&name=` | DataFlow status (phase, message, processedCount, errorCount, lastProcessedTime) |
-| GET | `/api/metrics?namespace=&name=` | Metrics for DataFlow (reserved for future use) |
+| GET | `/api/metrics?namespace=&name=` | Prometheus metrics for DataFlow (proxied from operator when `OPERATOR_METRICS_URL` is set; otherwise returns empty stub). In Helm, `OPERATOR_METRICS_URL` is set automatically; override via `gui.extraEnv` if operator is in a different namespace. |
 
 CORS headers (`Access-Control-Allow-Origin: *`, etc.) are set so the API can be used from a different port during local development.
 

docs/en/metrics.md

@@ -92,6 +92,31 @@ DataFlow Operator экспортирует метрики Prometheus для мо
   - Метки: `namespace`, `name`, `stage`, `error_type`
   - Возможные значения `error_type`: см. [Error types](errors.md#error-types)
 
+### 6.2 Labels
+
+Metrics use `namespace` and `name` labels to bind to DataFlow, which is convenient for filtering and aggregation in Prometheus/Grafana. All metrics include at least these two labels; additional labels (`source_type`, `sink_type`, `connector_type`, `stage`, etc.) allow for more detailed queries.
+
+Examples:
+- Filter by specific DataFlow: `dataflow_messages_received_total{namespace="default", name="my-dataflow"}`
+- Aggregate by namespace: `sum(rate(dataflow_messages_received_total[5m])) by (namespace, name)`
+
+### 6.3 Histograms
+
+Histograms use exponential buckets suitable for latency and message sizes:
+
+| Metric | Buckets | Range |
+|--------|---------|-------|
+| `dataflow_processing_duration_seconds` | ExponentialBuckets(0.001, 2, 10) | 1 ms — ~1 s |
+| `dataflow_transformer_duration_seconds` | ExponentialBuckets(0.0001, 2, 12) | 0.1 ms — ~400 ms |
+| `dataflow_task_stage_duration_seconds` | ExponentialBuckets(0.0001, 2, 14) | 0.1 ms — ~1.6 s |
+| `dataflow_task_message_size_bytes` | ExponentialBuckets(64, 2, 16) | 64 bytes — ~4 MB |
+| `dataflow_task_stage_latency_seconds` | ExponentialBuckets(0.0001, 2, 12) | 0.1 ms — ~400 ms |
+| `dataflow_task_end_to_end_latency_seconds` | ExponentialBuckets(0.001, 2, 12) | 1 ms — ~2 s |
+| `dataflow_task_queue_wait_time_seconds` | ExponentialBuckets(0.0001, 2, 12) | 0.1 ms — ~400 ms |
+
+- **Latency** (time in seconds): start from 0.1 ms or 1 ms, multiplier 2.
+- **Message sizes** (bytes): start from 64 bytes, multiplier 2.
+
 ## Настройка мониторинга
 
 ### Prometheus ServiceMonitor

docs/ru/gui.md

@@ -59,7 +59,7 @@ GUI состоит из двух частей:
 
 ## API backend
 
-Все эндпоинты отдаются в JSON (кроме логов — текст или SSE).
+Все эндпоинты отдаются в JSON (кроме логов — текст или SSE, и метрик — Prometheus text format при настроенном URL оператора).
 
 | Метод | Путь | Описание |
 |-------|------|----------|
@@ -71,7 +71,7 @@ GUI состоит из двух частей:
 | DELETE | `/api/dataflows/<name>?namespace=<ns>` | Удалить DataFlow |
 | GET | `/api/logs?namespace=&name=&tailLines=&follow=true\|false` | Логи пода процессора (текст или SSE при `follow=true`) |
 | GET | `/api/status?namespace=&name=` | Статус DataFlow (phase, message, processedCount, errorCount, lastProcessedTime) |
-| GET | `/api/metrics?namespace=&name=` | Метрики по DataFlow (зарезервировано для расширения) |
+| GET | `/api/metrics?namespace=&name=` | Prometheus-метрики по DataFlow (проксируются с оператора при заданном `OPERATOR_METRICS_URL`; иначе — пустая заглушка) |
 
 Для CORS заданы заголовки `Access-Control-Allow-Origin: *`, `Access-Control-Allow-Methods`, `Access-Control-Allow-Headers`, чтобы к API можно было обращаться с другого порта при локальной разработке.
 

docs/ru/metrics.md

@@ -92,6 +92,31 @@ DataFlow Operator экспортирует метрики Prometheus для мо
   - Метки: `namespace`, `name`, `stage`, `error_type`
   - Возможные значения `error_type`: см. [Типы ошибок](errors.md#типы-ошибок)
 
+### 6.2 Метки
+
+Метрики используют метки `namespace` и `name` для привязки к DataFlow, что удобно для фильтрации и агрегации в Prometheus/Grafana. Все метрики содержат как минимум эти две метки; дополнительные метки (`source_type`, `sink_type`, `connector_type`, `stage` и др.) позволяют детализировать запросы.
+
+Примеры:
+- Фильтрация по конкретному DataFlow: `dataflow_messages_received_total{namespace="default", name="my-dataflow"}`
+- Агрегация по namespace: `sum(rate(dataflow_messages_received_total[5m])) by (namespace, name)`
+
+### 6.3 Гистограммы
+
+Для гистограмм используются экспоненциальные buckets, подходящие для латентности и размеров сообщений:
+
+| Метрика | Buckets | Диапазон |
+|---------|---------|----------|
+| `dataflow_processing_duration_seconds` | ExponentialBuckets(0.001, 2, 10) | 1 мс — ~1 с |
+| `dataflow_transformer_duration_seconds` | ExponentialBuckets(0.0001, 2, 12) | 0.1 мс — ~400 мс |
+| `dataflow_task_stage_duration_seconds` | ExponentialBuckets(0.0001, 2, 14) | 0.1 мс — ~1.6 с |
+| `dataflow_task_message_size_bytes` | ExponentialBuckets(64, 2, 16) | 64 байт — ~4 МБ |
+| `dataflow_task_stage_latency_seconds` | ExponentialBuckets(0.0001, 2, 12) | 0.1 мс — ~400 мс |
+| `dataflow_task_end_to_end_latency_seconds` | ExponentialBuckets(0.001, 2, 12) | 1 мс — ~2 с |
+| `dataflow_task_queue_wait_time_seconds` | ExponentialBuckets(0.0001, 2, 12) | 0.1 мс — ~400 мс |
+
+- **Латентность** (время в секундах): начальное значение от 0.1 мс или 1 мс, множитель 2.
+- **Размер сообщений** (байты): начальное значение 64 байт, множитель 2.
+
 ## Настройка мониторинга
 
 ### Prometheus ServiceMonitor