› › ›

API получения статистики кросс-кластерной репликации

Получение статистики кросс-кластерной репликации.

Запрос

resp = client.ccr.stats()
print(resp)

const response = await client.ccr.stats();
console.log(response);

GET /_ccr/stats

Предварительные условия

Если включены функции безопасности Elasticsearch, необходимо иметь monitor права кластера на кластере, содержащем индекс-фолловера. Подробнее см. Права доступа к безопасности.

Описание

Этот API получает статистику кросс-кластерной репликации. API вернёт все статистические данные, относящиеся к кросс-кластерной репликации. В частности, этот API возвращает статистику по автоматическому слежению и возвращает ту же статистику на уровне фрагментов, что и API получения статистики фолловера.

Параметры запроса

timeout: (Необязательно, время) Управляет временем ожидания результатов. По умолчанию не ограничено.
master_timeout: (Необязательно, единицы измерения времени) Период ожидания мастер-узла. Если мастер-узел недоступен до истечения таймаута, запрос завершается ошибкой. По умолчанию 30s. Также может быть установлено значение -1, чтобы указать, что запрос никогда не должен истекать.

Тело ответа

auto_follow_stats

(объект) Объект, представляющий статистику для координатора автоматического слежения.

Свойства auto_follow_stats

number_of_failed_follow_indices: (целое число) Количество индексов, которые координатор автоматического слежения не смог автоматически отследить. Причины недавних ошибок отражаются в журналах избранного мастер-узла и в поле auto_follow_stats.recent_auto_follow_errors.
number_of_failed_remote_cluster_state_requests: (целое число) Количество попыток, когда координатор автоматического слежения не смог извлечь состояние кластера из удалённого кластера, зарегистрированного в наборе шаблонов автоматического слежения.
number_of_successful_follow_indices: (целое число) Количество индексов, которые координатор автоматического слежения успешно отследил.
recent_auto_follow_errors: (массив) Массив объектов, представляющих ошибки координатора автоматического слежения.

follow_stats

(объект) Объект, представляющий статистику на уровне фрагментов для индексов-фолловеров; см. подробности ответа в API получения статистики фолловера.

Примеры

В этом примере извлекается статистика кросс-кластерной репликации:

resp = client.ccr.stats()
print(resp)

const response = await client.ccr.stats();
console.log(response);

GET /_ccr/stats

API возвращает следующие результаты:

{
  "auto_follow_stats" : {
    "number_of_failed_follow_indices" : 0,
    "number_of_failed_remote_cluster_state_requests" : 0,
    "number_of_successful_follow_indices" : 1,
    "recent_auto_follow_errors" : [],
    "auto_followed_clusters" : []
  },
  "follow_stats" : {
    "indices" : [
      {
        "index" : "follower_index",
        "total_global_checkpoint_lag" : 256,
        "shards" : [
          {
            "remote_cluster" : "remote_cluster",
            "leader_index" : "leader_index",
            "follower_index" : "follower_index",
            "shard_id" : 0,
            "leader_global_checkpoint" : 1024,
            "leader_max_seq_no" : 1536,
            "follower_global_checkpoint" : 768,
            "follower_max_seq_no" : 896,
            "last_requested_seq_no" : 897,
            "outstanding_read_requests" : 8,
            "outstanding_write_requests" : 2,
            "write_buffer_operation_count" : 64,
            "follower_mapping_version" : 4,
            "follower_settings_version" : 2,
            "follower_aliases_version" : 8,
            "total_read_time_millis" : 32768,
            "total_read_remote_exec_time_millis" : 16384,
            "successful_read_requests" : 32,
            "failed_read_requests" : 0,
            "operations_read" : 896,
            "bytes_read" : 32768,
            "total_write_time_millis" : 16384,
            "write_buffer_size_in_bytes" : 1536,
            "successful_write_requests" : 16,
            "failed_write_requests" : 0,
            "operations_written" : 832,
            "read_exceptions" : [ ],
            "time_since_last_read_millis" : 8
          }
        ]
      }
    ]
  }
}

© 2023-2025 Elasticsearch
As of September 2024, Elasticsearch is available under a choice of three licenses: the Server Side Public License (SSPL), the Elastic License, or the AGPLv3 (OSI approved).
Elasticsearch and the Elasticsearch logo are trademarks of Elasticsearch B.V., registered in the U.S. and in other countries.
https://www.elastic.co/guide/en/elasticsearch/reference/8.17/ccr-get-stats.html