Информация об устаревших API

GET /_migration/deprecations

GET /<target>/_migration/deprecations

Вы можете использовать следующие настройки для управления поведением API информации об устаревших функциях:

deprecation.skip_deprecated_settings (Динамическая) По умолчанию пустой список. Устанавливается в список имён настроек, которые должны игнорироваться API информации об устаревших функциях. Любые устаревшие функции, связанные с настройками в этом списке, не будут возвращаться API. Поддерживается простое сопоставление с шаблонами.

Чтобы увидеть список нарушений в кластере, отправьте GET-запрос на _migration/deprecations конечную точку:

GET /_migration/deprecations

Пример ответа:

{
  "cluster_settings" : [
    {
      "level" : "critical",
      "message" : "Cluster name cannot contain ':'",
      "url" : "https://www.elastic.co/guide/en/elasticsearch/reference/7.17/breaking-changes-7.0.html#_literal_literal_is_no_longer_allowed_in_cluster_name",
      "details" : "This cluster is named [mycompany:logging], which contains the illegal character ':'."
    }
  ],
  "node_settings" : [ ],
  "index_settings" : {
    "logs:apache" : [
      {
        "level" : "warning",
        "message" : "Index name cannot contain ':'",
        "url" : "https://www.elastic.co/guide/en/elasticsearch/reference/7.17/breaking-changes-7.0.html#_literal_literal_is_no_longer_allowed_in_index_name",
        "details" : "This index is named [logs:apache], which contains the illegal character ':'."
      }
    ]
  },
  "ml_settings" : [ ]
}

Ответ детализирует все несовместимые с будущими версиями настройки, которые необходимо исправить перед обновлением кластера. Любые проблемные настройки представлены как предупреждение об устаревании.

Вот пример предупреждения об устаревании:

{
  "level" : "warning",
  "message" : "This is the generic descriptive message of the breaking change",
  "url" : "https://www.elastic.co/guide/en/elasticsearch/reference/6.0/breaking_60_indices_changes.html",
  "details" : "more information, like which nodes, indices, or settings are to blame"
}

Как показано, существует свойство level, которое описывает важность проблемы.

Свойство message и необязательное свойство details предоставляют описательную информацию о предупреждении об устаревании. Свойство url предоставляет ссылку на документацию по изменениям, где вы можете найти дополнительную информацию об этом изменении.

Любые предупреждения об устаревании на уровне кластера можно найти по ключу cluster_settings. Аналогично, предупреждения на уровне узлов находятся по ключу node_settings. Так как только определённый подмножество ваших узлов может включать эти настройки, важно прочитать раздел details, чтобы получить дополнительную информацию о затронутых узлах. Предупреждения об индексах разделены по индексу и могут быть отфильтрованы с помощью шаблона индекса в запросе. Этот раздел включает предупреждения для базовых индексов потоков данных, указанных в пути запроса. Предупреждения об устаревании, связанные с машинным обучением, можно найти по ключу ml_settings.

Следующий пример запроса показывает только предупреждения об устаревании на уровне индекса для всех logstash-* индексов:

GET /logstash-*/_migration/deprecations