Документацияbreadcrumb arrow Grafanabreadcrumb arrow Документация GlaberGraphbreadcrumb arrow Обратно несовместимые измененияbreadcrumb arrow Обратно несовместимые изменения в Grafana v10.3

Обратно несовместимые изменения в Grafana v10.3

Ниже перечислены обратно несовместимые изменения, о которых следует знать при обновлении до Grafana v10.3. Сюда также включены обратно несовместимые изменения, появившиеся в релизе 10.2.3; они отмечены звёздочкой.

Для наших целей обратно несовместимым изменением является любое изменение, требующее от пользователей или операторов каких-либо действий. К ним относятся:

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

Для каждого изменения приведённая информация:

  • Помогает определить, затронуты ли вы
  • Описывает изменение или соответствующую предысторию
  • Подсказывает, как смягчить последствия изменения или выполнить миграцию
  • Предоставляет дополнительные материалы для изучения

О ключевых нововведениях и устаревших функциях см. Что нового в v10.3. Конкретные шаги, которые мы рекомендуем при обновлении до v10.3, описаны в нашем руководстве по обновлению.

Общие обратно несовместимые изменения

Transformations*

В панелях, использующих преобразование extract fields, когда одно из извлечённых имён совпадает с одним из уже существующих полей, извлечённое поле будет переименовано. Проблема #77569.

Если вы используете визуализацию Table, вы можете заметить некоторые несоответствия в своих панелях. Мы обновили правила именования столбцов таблицы. Это потенциально может затронуть преобразования полей и/или переопределения полей. Чтобы решить проблему, выполните одно из действий:

  • Обновите используемое преобразование
  • Обновите переопределение поля. Проблема #76899.

У пользователей, у которых есть преобразования с полем Time, преобразования могут перестать работать. Панели с нарушенными преобразованиями не будут отображаться. Причина в том, что мы изменили ключ поля. См. соответствующий PR: #69865. Чтобы решить проблему, выполните одно из действий:

  • Удалите затронутую панель и создайте её заново
  • Выберите поле Time снова
  • Отредактируйте поле времени как Time для преобразования в panel.json или dashboard.json. Проблема #76641.

Data source permissions*

Следующие конечные точки разрешений источников данных были удалены:

  • GET /datasources/:datasourceId/permissions
  • POST /api/datasources/:datasourceId/permissions
  • DELETE /datasources/:datasourceId/permissions
  • POST /datasources/:datasourceId/enable-permissions
  • POST /datasources/:datasourceId/disable-permissions

Вместо них используйте следующие конечные точки:

  • GET /api/access-control/datasources/:uid для получения списка разрешений источников данных
  • POST /api/access-control/datasources/:uid/users/:id, POST /api/access-control/datasources/:uid/teams/:id и POST /api/access-control/datasources/:uid/buildInRoles/:id для добавления или удаления разрешений источников данных

Если вы используете провайдер Grafana для Terraform для управления разрешениями источников данных, вам потребуется обновить провайдер до версии 2.6.0 или новее, чтобы провизионирование разрешений источников данных продолжало работать. Проблема #5880.