Grafana Cloud

Подключите Grafana Cloud, чтобы агенты могли читать ваши дашборды, запрашивать источники данных и изучать алертинг Grafana.

Настройка

1. Найдите URL вашего стека в портале Grafana Cloud, например https://yourstack.grafana.net.
2. В вашем стеке Grafana откройте Administration → Users and access → Service accounts.
3. Создайте сервисный аккаунт с ролью Editor. Editor позволяет агентам читать дашборды, запрашивать источники данных и создавать аннотации, а Polylane подписываться на ваши алерты Grafana.
4. Добавьте токен к сервисному аккаунту и вставьте оба значения в Polylane. Polylane проверяет их на вашем стеке и подключается.

Ваш токен шифруется перед сохранением, и агент никогда его не видит.

Стеки бесплатного уровня Grafana Cloud засыпают при бездействии. Если проверка сообщает, что стек недоступен, откройте его один раз в браузере и повторите.

Алерты и непрерывный мониторинг

При подключении Polylane создаёт в вашем стеке точку контакта webhook и добавляет маршрут catch-all в дерево политик уведомлений. Маршрут соответствует каждому алерту и продолжает к вашим существующим маршрутам, поэтому текущая доставка не затрагивается, а правила алертов, которые вы создадите позже, уведомляют Polylane автоматически. Сработавшие алерты попадают в ваше рабочее пространство, проходят триаж и могут запускать расследования.

Polylane также читает каждый дашборд и непрерывно выполняет запрос каждой панели как проверку на аномалии, а также обнаруживает ключевые запросы для сигналов, которых нет на ваших дашбордах.

Что могут агенты

• Искать дашборды и читать определения их панелей и запросы
• Перечислять источники данных и выполнять проверки их здоровья
• Выполнять PromQL, LogQL, TraceQL и другие нативные для источника запросы через прокси запросов Grafana
• Изучать правила алертов, их текущее состояние и здоровье, а также алерты, срабатывающие прямо сейчас
• Читать аннотации графиков и создавать новые для деплоев и окон инцидентов

Отключение

Отключите Grafana Cloud в Polylane; он удалит созданные им точку контакта и маршрут политики уведомлений. Затем удалите токен сервисного аккаунта в Grafana. Если маршрут описан в Terraform, уберите его одновременно.

Ежечасная сверка поддерживает точку контакта polylane и её маршрут catch-all на месте. Ресурс grafana_notification_policy управляет всем деревом политик, поэтому Terraform apply без этого маршрута удаляет его, а сверка добавляет обратно. Держите маршрут первой политикой в вашем дереве с continue = true, чтобы ваши собственные маршруты по-прежнему получали всё, а саму точку контакта оставьте Polylane:

resource "grafana_notification_policy" "tree" {
  # ...

  policy {
    contact_point = "polylane"
    continue      = true
  }

  # your existing routes follow
}

Правилам алертов не нужна отдельная настройка: маршрут соответствует каждому алерту. Отключение интеграции удаляет точку контакта и маршрут, поэтому одновременно уберите маршрут из конфигураций Terraform.