2026: OpenClaw Gateway — метрики Prometheus и панели Grafana: сбор /metrics 7×24 на удалённом физическом Mac, пороги алертов и разбор ложных срабатываний (готовые scrape, запросы панелей и FAQ)

2. Три типовых боли

1. Ограничение: адрес привязки и место Prometheus. Шлюз слушает только 127.0.0.1, а Prometheus в контейнере или на другой машине — скрейпы падают (up=0), хотя локальный curl на Mac успешен.
2. Скрытая цена: высокая кардинальность и агрессивный scrape_interval. Сырые пути или фрагменты ключей в метках раздувают кардинальность TSDB; скрейп каждую 1 с по Wi‑Fi или туннелю превращает джиттер в «шерсть» на графиках Grafana.
3. Стабильность и ложные тревоги: энергосбережение macOS и окна деплоя. Сон дисплея, сон диска или горячая перезагрузка кратко поднимают p95; алерты с for: 0s будят дежурного из-за шума.

3. Матрица: скрейп и алерты

Перед продом зафиксируйте «кто из какого сетевого пространства скрейпит» и нужно ли учитывать рабочие часы в алертах.

4. Семишаговый runbook (удалённый физический Mac)

1. Подтвердите endpoint и bind. Включите метрики в конфиге шлюза; проверьте metrics_path (часто /metrics) и IP прослушивания. Для удалённого скрейпа избегайте только 127.0.0.1, если сборщик не в том же namespace.
2. Локальный дымовой тест. curl -sS http://127.0.0.1:<port>/metrics | head -n 40 — должны быть строки HELP/TYPE для HTTP и process.
3. Выберите место сборщика. PoC на одном узле — Prometheus рядом. Много узлов — vmagent с remote-write или централизованный Prometheus с allowlist в фаерволе.
4. Опишите scrape (ниже). Используйте scrape_interval: 15s–30s, разумный scrape_timeout, стабильное relabel для instance.
5. Подключите Grafana. Добавьте datasource Prometheus; панели: суммарный RPS, p95, доля 5xx, up, длительность скрейпа.
6. Задайте алерты и маршруты. Разные for для долей ошибок и для «сырого» up; silence в Alertmanager или флаги обслуживания из CI при деплое.
7. Согласуйте настройки macOS 7×24. Предпочтительно проводное Ethernet, отключить сон диска, выровнять часовой пояс и NTP. Если скрейп зелёный, а приложение отдаёт 500 — сначала логи приложения, не Prometheus.

5. Готовые scrape, PromQL и алерты

5.1 Фрагмент scrape_configs для Prometheus

Подставьте свои targets и порт. За обратным прокси пропустите /metrics без кэширования.

scrape_configs:
  - job_name: openclaw-gateway
    scrape_interval: 15s
    scrape_timeout: 10s
    metrics_path: /metrics
    static_configs:
      - targets:
          - '127.0.0.1:18789'
        labels:
          env: prod
          role: gateway
    # relabel_configs:
    #   - source_labels: [__address__]
    #     target_label: instance

5.2 Запросы панелей Grafana (подставьте имена метрик с хоста)

• Запросов в секунду (RPS): sum(rate(http_requests_total{job="openclaw-gateway"}[5m]))
• p95 задержка (гистограмма): histogram_quantile(0.95, sum(rate(http_request_duration_seconds_bucket{job="openclaw-gateway"}[5m])) by (le))
• Доля 5xx (пример): sum(rate(http_requests_total{job="openclaw-gateway",status=~"5.."}[5m])) / sum(rate(http_requests_total{job="openclaw-gateway"}[5m]))
• Здоровье скрейпа: up{job="openclaw-gateway"} и scrape_duration_seconds{job="openclaw-gateway"}

5.3 Правила алертов (rule_files в Prometheus)

groups:
  - name: openclaw_gateway
    rules:
      - alert: GatewayScrapeDown
        expr: up{job="openclaw-gateway"} == 0
        for: 2m
        labels:
          severity: critical
        annotations:
          summary: "Эндпоинт метрик OpenClaw недоступен"
      - alert: GatewayHigh5xxRatio
        expr: sum(rate(http_requests_total{job="openclaw-gateway",status=~"5.."}[5m])) / sum(rate(http_requests_total{job="openclaw-gateway"}[5m])) > 0.05
        for: 5m
        labels:
          severity: warning
        annotations:
          summary: "Доля 5xx > 5% (подстройте метки под свою схему)"

Если вместо status используется code или свой outcome, перепишите селекторы — проверьте ненулевые векторы в Grafana Explore до включения в алерты.

6. Типичные ложные срабатывания

7. Цифры для отчётов и слайдов

• scrape_interval: 15s в проде (не ускоряйте без причины сильнее хвостовой задержки шлюза); 30s на межконтинентальных линках.
• scrape_timeout: держите ≤ ~2/3 от scrape_interval; для туннелей начните с 10s.
• for в алертах: правила доступности — с 2m; долевые — с 5m, затем ужесточайте по burn rate SLO.

8. FAQ

9. Итог и выбор узла

Когда HTTP- и процесс-метрики OpenClaw Gateway попадают в Prometheus и Grafana, сбои на узлах 7×24 перестают решаться «зайти по SSH и угадать»: видно, двигаются ли вместе up, доля ошибок и p95. Повторяющиеся темы — согласовать адрес привязки с сетевым путём скрейпа, использовать for в алертах и отфильтровать шум от энергосбережения macOS и деплоев из SLO.

Такой стек «шлюз + наблюдаемость» хорошо ложится на macOS: launchd, логи и Unix-утилиты в одном контуре; Apple Silicon в простое потребляет очень мало — удобно для постоянных шлюзов. По сравнению с компактными x86-коробками того же класса цены вы обычно получаете лучшую стабильность и энергоэффективность, а Gatekeeper, SIP и FileVault усиливают защиту учётных данных и концов туннелей — что важно операторам удалённых шлюзов.

Если нужны те же scrape и дашборды на тихом, экономичном железе, готовом к работе 7×24, Mac mini M4 в 2026 году остаётся одним из лучших по соотношению цена/качество — возьмите удалённый физический Mac через ZoneMac и введите метрики шлюза в промышленный контур за один проход.