› › ›

API получения статистики фолловера

Получение статистики фолловера.

Запрос

GET /<index>/_ccr/stats

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

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

Описание

Данный API получает статистику фолловера. API возвращает статистику на уровне фрагментов о следующих задачах, связанных с каждым фрагментом для указанных индексов.

Параметры пути

<index>: (Обязательно, строка) Список шаблонов индексов, разделённых запятыми.

Тело ответа

indices

(массив) Массив статистических данных индекса фолловера.

Свойства indices

fatal_exception: (объект) Объект, представляющий фатальную исключительную ситуацию, которая отменила задачу слежения. В этой ситуации задачу слежения необходимо возобновить вручную с помощью API возобновления фолловера.
index: (строка) Название индекса фолловера.

shards

(массив) Массив статистических данных задачи слежения на уровне фрагмента.

Свойства объектов в shards

bytes_read: (целое число) Общее количество переданных байтов, прочитанных из лидера.

Это приблизительное значение, и оно не учитывает сжатие, если оно включено.
failed_read_requests: (целое число) Количество неудачных чтений.
failed_write_requests: (целое число) Количество неудачных запросов массового написания, выполненных на фолловере.
follower_aliases_version: (целое число) Версия алиасов индекса, до которой синхронизирован фолловер.
follower_global_checkpoint: (целое число) Текущая глобальная контрольная точка на фолловере. Разница между leader_global_checkpoint и follower_global_checkpoint указывает на отставание фолловера от лидера.
follower_index: (строка) Название индекса фолловера.
follower_mapping_version: (целое число) Версия отображения, до которой синхронизирован фолловер.
follower_max_seq_no: (целое число) Текущее максимальное значение последовательности на фолловере.
follower_settings_version: (целое число) Версия настроек индекса, до которой синхронизирован фолловер.
last_requested_seq_no: (целое число) Начальное значение последовательности последней партии операций, запрошенных у лидера.
leader_global_checkpoint: (целое число) Текущая глобальная контрольная точка лидера, известная задаче фолловера.
leader_index: (строка) Название индекса в кластере лидера, за которым следует фолловер.
leader_max_seq_no: (целое число) Текущее максимальное значение последовательности на лидере, известное задаче фолловера.
operations_read: (целое число) Общее количество операций, прочитанных у лидера.
operations_written: (целое число) Количество операций, записанных на фолловере.
outstanding_read_requests: (целое число) Количество активных запросов чтения от фолловера.
outstanding_write_requests: (целое число) Количество активных запросов массового написания на фолловере.

read_exceptions

(массив) Массив объектов, представляющих неудачные чтения.

Свойства объектов в read_exceptions

exception: (объект) Представляет исключительную ситуацию, которая привела к сбою чтения.
from_seq_no: (целое число) Начальное значение последовательности запрошенной партии от лидера.
retries: (целое число) Количество попыток повторного выполнения партии.

remote_cluster

(строка) Удаленный кластер, содержащий индекс лидера.

shard_id

(целое число) Номер фрагмента, значения от 0 до количества реплик минус 1.

successful_read_requests

(целое число) Количество успешных извлечений.

successful_write_requests

(целое число) Количество запросов массового написания, выполненных на фолловере.

time_since_last_read_millis

(целое число) Количество миллисекунд, прошедших с момента отправки запроса чтения лидеру.

Когда фолловер догоняет лидера, это число увеличивается до настроенного значения read_poll_timeout, после чего отправляется другой запрос чтения лидеру.

total_read_remote_exec_time_millis

(целое число) Общее время, затраченное на чтение в удаленном кластере.

total_read_time_millis

(целое число) Общее время ожидания чтения, измеряемое с момента отправки запроса чтения лидеру до момента возвращения ответа фолловеру.

total_write_time_millis

(целое число) Общее время, затраченное на запись на фолловере.

write_buffer_operation_count

(целое число) Количество операций записи, находящихся в очереди на фолловере.

write_buffer_size_in_bytes

(целое число) Общее количество байтов операций, в настоящее время находящихся в очереди для записи.

Примеры

В этом примере извлекается статистика фолловера:

GET /follower_index/_ccr/stats

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

{
  "indices" : [
    {
      "index" : "follower_index",
      "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/7.17/ccr-get-follow-stats.html