API устаревших сведений

GET /_migration/deprecations

GET /<target>/_migration/deprecations

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

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

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

resp = client.migration.deprecations()
print(resp)

response = client.migration.deprecations
puts response

const response = await client.migration.deprecations();
console.log(response);

GET /_migration/deprecations

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

{
  "cluster_settings" : [
    {
      "level" : "critical",
      "message" : "Cluster name cannot contain ':'",
      "url" : "https://www.elastic.co/guide/en/elasticsearch/reference/7.0/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.0/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-* индексов:

resp = client.migration.deprecations(
    index="logstash-*",
)
print(resp)

response = client.migration.deprecations(
  index: 'logstash-*'
)
puts response

const response = await client.migration.deprecations({
  index: "logstash-*",
});
console.log(response);

GET /logstash-*/_migration/deprecations