Документацияbreadcrumb arrow Grafanabreadcrumb arrow Документация GlaberGraphbreadcrumb arrow Администрированиеbreadcrumb arrow Миграцияbreadcrumb arrow Migrate to Grafana Cloud using the Grafana Cloud Migration Assistant

Grafana Cloud Migration Assistant

Grafana Cloud Migration Assistant автоматически переносит ресурсы из вашего экземпляра Grafana OSS/Enterprise в Grafana Cloud. Он предоставляет следующие возможности:

  • Безопасно подключать ваш самостоятельно развёрнутый экземпляр к экземпляру Grafana Cloud.
  • Переносить такие ресурсы, как дашборды, источники данных и папки, в ваш облачный экземпляр за несколько простых шагов.
  • Отслеживать состояние миграции ресурсов в реальном времени.

Некоторые преимущества ассистента миграции:

Простота использования
Следуйте шагам, предлагаемым в интерфейсе, чтобы легко перенести все свои ресурсы в Grafana Cloud без использования API Grafana или скриптов.
Безопасность
Шифрование и безопасный перенос ваших ресурсов в подключённый экземпляр Grafana Cloud.
Скорость
Перенос всех ресурсов за считанные минуты и ускорение перехода на Grafana Cloud.

Поддерживаемые ресурсы

Ассистент миграции поддерживает следующие ресурсы:

  • Дашборды
  • Папки
  • Источники данных
  • Плагины приложений
  • Плагины панелей
  • Библиотечные панели
  • Ресурсы Grafana Alerting

Прежде чем начать

Чтобы воспользоваться ассистентом миграции Grafana, вам потребуется:

  • Самостоятельно развёрнутый экземпляр Grafana.
  • Grafana Cloud Stack, в который вы собираетесь перенести ресурсы.
  • Доступ уровня Admin к Grafana Cloud Stack. Чтобы проверить свой уровень доступа, перейдите по адресу https://grafana.com/orgs/<YOUR-ORG-NAME>/members.
  • Доступ администратора сервера Grafana к вашему существующему самостоятельно развёрнутому экземпляру Grafana. Чтобы проверить свой уровень доступа, перейдите по адресу https://<GRAFANA-ONPREM-URL>/admin/users.
  • Доступ в интернет с вашего существующего самостоятельно развёрнутого экземпляра Grafana.
  • Если Grafana запущена в конфигурации высокой доступности, мы рекомендуем сократить число реплик Grafana до одной, чтобы избежать известной ошибки.
  • Если в вашей сети внешние сервисы должны быть добавлены в список разрешённых для доступа, добавьте в этот список следующие IP-адреса и URL-адреса:

Доступ к ассистенту миграции

В Grafana OSS доступ к ассистенту миграции ограничен администратором сервера.

В Grafana Enterprise администратор сервера имеет доступ к ассистенту миграции по умолчанию. Вы также можете предоставить доступ другим администраторам, используя роль управления доступом на основе ролей (RBAC), которая позволяет другим администраторам экземпляра Grafana просматривать данные, создавать снимки и загружать ресурсы в Grafana Cloud.

Предоставление доступа в Grafana Enterprise

Note

Прежде чем предоставлять другим администраторам доступ к Grafana Migration Assistant, необходимо настроить RBAC.

Чтобы предоставить другим администраторам доступ к ассистенту миграции в Grafana Enterprise:

  1. Войдите в Grafana как администратор сервера.

  2. В боковом меню Grafana перейдите в Home > Administration > Users and access > Users.

  3. Нажмите на администратора.

  4. В разделе Organizations нажмите Change role.

  5. В меню выбора ролей в разделе Migration Assistant выберите Organization resource migrator.

    Роль Organization resource migrator в средстве выбора ролей

  6. Нажмите Apply.

Использование ассистента миграции

Вы можете использовать ассистент миграции, чтобы создать токен миграции в вашем экземпляре Grafana Cloud, с помощью этого токена подключить самостоятельно развёрнутый экземпляр Grafana к экземпляру Grafana Cloud, создать снимки самостоятельно развёрнутого экземпляра Grafana и загрузить эти снимки в Grafana Cloud.

Создание токена миграции в целевом облачном экземпляре

  1. В облачном экземпляре, в который вы собираетесь перенести ресурсы, перейдите в Home > Administration > General > Migrate to Grafana Cloud.
  2. Нажмите кнопку Generate a migration token.
  3. Скопируйте токен миграции в буфер обмена. Этот токен необходим для аутентификации вашего самостоятельно развёрнутого экземпляра в Grafana Cloud Stack.

Подключение самостоятельно развёрнутого экземпляра Grafana к Grafana Cloud Stack

  1. В вашем самостоятельно развёрнутом экземпляре Grafana перейдите в Home > Administration > General > Migrate to Grafana Cloud.

  2. Нажмите кнопку Migrate this instance to Cloud.

  3. Введите токен в поле Migration token и нажмите Connect to this Stack.

Создание снимка

После подключения к облачному стеку вы увидите пустое состояние ассистента миграции. Чтобы загрузить данные в облачный стек, необходимо создать снимок самостоятельно развёрнутого экземпляра Grafana.

  1. Установите флажок рядом с каждым ресурсом, который хотите перенести в облачный стек.

    Note

    Некоторые ресурсы нельзя загрузить в облачный стек по отдельности, поскольку они зависят от других ресурсов:

    Желаемый ресурс Требуется
    Дашборды
    • Library Elements
    • Data Sources
    • Plugins
    • Folders
    Library Elements Folders
    Data Sources Plugins
    Plugins Ничего больше
    Folders Ничего больше
    Все группы правил алертинга Все остальные ресурсы
    Alert Rules
    • Dashboards
    • Library Elements
    • Data Sources
    • Plugins
    • Folders
    • Notification Policies
    • Notification Templates
    • Contact Points
    • Mute Timings
    Notification Policies
    • Notification Templates
    • Contact Points
    • Mute Timings
    Notification Templates Ничего больше
    Contact Points Notification Templates
    Mute Timings Ничего больше

  2. Нажмите Build snapshot.

    Список ресурсов, выбранных для миграции, и кнопка Build snapshot

Загрузка ресурсов в облако

После создания снимка появляется список ресурсов со столбцами Type и Status, заполненными значением Not yet uploaded.

  1. Нажмите Upload snapshot, чтобы скопировать ресурсы в экземпляр Grafana Cloud.

  2. Отслеживайте миграцию в реальном времени с помощью ассистента. Для ресурсов, успешно скопированных в облако, состояние меняется на «Uploaded to cloud».

    Во время и после миграции вы можете группировать и сортировать ресурсы:

    • Нажмите Name, чтобы отсортировать ресурсы по алфавиту.
    • Нажмите Type, чтобы сгруппировать и отсортировать ресурсы по типу.
    • Нажмите Status, чтобы сгруппировать и отсортировать ресурсы по состоянию загрузки (ожидает загрузки, успешно загружено или возникли ошибки).

    Информация о снимке также обновляется, сообщая пользователю общее число ресурсов, количество ошибок и общее число успешно перенесённых ресурсов.

    Обновлённый список ресурсов со снимками, созданными после попытки загрузить их в Grafana Cloud

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

Снимки, создаваемые ассистентом миграции

В настоящее время ассистент миграции поддерживает лишь часть всех ресурсов, доступных в Grafana. Дополнительные сведения см. в разделе Поддерживаемые ресурсы.

При создании снимка ассистент миграции делает копию всех выбранных вами ресурсов и сохраняет их в снимке. Снимок отражает текущее состояние ресурсов на момент его создания и хранится локально в вашем экземпляре, готовый к загрузке на последнем этапе.

Ресурсы, сохранённые в снимке, строго ограничены ресурсами, хранящимися в рамках одной организации. Это важно учитывать, если в вашем экземпляре Grafana используется несколько организаций. Если вы хотите перенести несколько организаций, обратитесь к разделу Перенос нескольких организаций за дополнительной информацией и рекомендациями.

Подробности о миграции ресурсов

Во время миграции UID ресурсов сохраняются, что позволяет сопоставлять локальные и облачные ресурсы. Если вы выполните одну и ту же миграцию несколько раз, ресурсы в вашем стеке Grafana Cloud, перенесённые ранее, будут обновлены. Ассистент никогда не изменяет ваши самостоятельно развёрнутые ресурсы или облачные ресурсы, которые не были получены из снимка.

Дашборды и папки

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

Источники данных

Ваши источники данных, включая учётные данные, безопасно и без лишних усилий переносятся в ваш экземпляр Grafana Cloud, поэтому вам не придётся снова искать и вводить все учётные данные источников данных.

Плагины

Ассистент миграции поддерживает любые плагины, имеющиеся в каталоге плагинов. Плагин можно перенести, если он подписан или является встроенным в Grafana базовым плагином. По соображениям безопасности Grafana Cloud не поддерживает неподписанные плагины. Если вы используете неподписанные приватные плагины, найдите альтернативный плагин в каталоге или продумайте стратегию отказа от определённой функциональности в вашем самостоятельно развёрнутом экземпляре.

Обновите все плагины, которые собираетесь переносить, прежде чем использовать ассистент миграции, поскольку перенесённые плагины будут настроены в экземпляре Grafana Cloud как последняя версия этого плагина.

Caution

Если вы хотите перенести плагины Enterprise, проверьте, на каком типе тарифного плана находится ваш экземпляр Grafana Cloud и требует ли этот план дополнительного модуля Enterprise-плагинов.

Ресурсы Grafana Alerting

Ассистент миграции может перенести большую часть ресурсов Grafana Alerting в ваш экземпляр Grafana Cloud. К ним относятся:

  • Правила алертинга
  • Уведомления
  • Точки контакта
  • Интервалы отключения (mute timings)
  • Дерево политик уведомлений
  • Шаблоны уведомлений

Этого достаточно, чтобы с минимальными усилиями запустить конфигурацию алертинга в Grafana Cloud.

Ограничения ассистента миграции для ресурсов Grafana Alerting

Ассистент миграции не поддерживает перенос Silences, поэтому их нужно настраивать вручную. История алертов также недоступна для миграции.

Попытка перенести большое количество правил алертинга может привести к следующей ошибке:

Maximum number of alert rule groups reached: Delete some alert rule groups or upgrade your plan and try again.

Чтобы избежать этого, при переносе правил алертинга обратитесь к разделу Ограничения на правила алертинга в Grafana Cloud.

Предотвращение дублирования уведомлений об алертах

Успешный перенос ресурсов алертинга в ваш экземпляр Grafana Cloud может привести к появлению двух наборов уведомлений:

  1. Из вашего экземпляра OSS/Enterprise

  2. Из только что перенесённых алертов в вашем экземпляре Grafana Cloud

Чтобы избежать двойных уведомлений, новый параметр конфигурации alert_rules_state в файле custom.ini или grafana.ini управляет тем, как правила алертинга переносятся в экземпляр Grafana Cloud, и по умолчанию установлен в значение paused, чтобы вы могли просмотреть и протестировать свои ресурсы алертинга в экземпляре Grafana Cloud без дублирования уведомлений.

Доступные значения для alert_rule_state:

paused
Создаёт все правила алертинга в приостановленном состоянии в облачном экземпляре. Это помогает избежать двойных уведомлений.
unchanged
Правила алертинга сохраняют исходное состояние, полученное из исходного экземпляра.

Когда вы будете готовы начать использовать правила алертинга и уведомления из вашего экземпляра Grafana Cloud, запустите миграцию снова со значением alert_rules_state = unchanged.

Разрешения на ресурсы

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

Перенос нескольких организаций

Если вы используете функцию организаций в вашем экземпляре Grafana и планируете перейти на Grafana Cloud, вам нужно тщательно спланировать этот аспект миграции.

Grafana Cloud не поддерживает функцию организаций, но вместо этого вы можете использовать папки и RBAC для защиты ресурсов и предоставления прав доступа к ним. Рекомендуемый путь — перенести несколько организаций в один облачный стек. Это самый простой вариант, обеспечивающий наилучший пользовательский опыт.

Ассистент миграции создаёт и загружает снимки на основе ресурсов в рамках конкретной организации. Возможности перенести весь экземпляр Grafana с несколькими организациями сразу нет. Вам нужно запускать процесс миграции для каждой организации, которую хотите перенести.

Администратор сервера Grafana имеет доступ к ассистенту миграции по умолчанию. Администратор сервера может выполнять миграцию, переключаясь между организациями и каждый раз запуская ассистент миграции. Администратор сервера Grafana также может предоставлять доступ к ассистенту миграции администраторам организаций с ролью RBAC Migration Assistant:Organization resource migrator. Это позволяет этим администраторам организаций запускать процесс миграции для своих организаций.

Управление доступом и управление ресурсами в облачном экземпляре

Основной причиной создания организаций изначально является изоляция ресурсов. Чтобы добиться этого в Grafana Cloud, вы можете организовать ресурсы в папки и настроить команды и разрешения, соответствующие вашим организациям.

Дополнительные сведения о настройке команд и разрешений см. в разделе Настройка команд Grafana.