mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-09-30 05:30:51 +00:00
e8a5804e76
* update presentations * CLICKHOUSE-2936: redirect from clickhouse.yandex.ru and clickhouse.yandex.com * update submodule * lost files * CLICKHOUSE-2981: prefer sphinx docs over original reference * CLICKHOUSE-2981: docs styles more similar to main website + add flags to switch language links * update presentations * Less confusing directory structure (docs -> doc/reference/) * Minify sphinx docs too * Website release script: fail fast + pass docker hash on deploy * Do not underline links in docs * shorter * cleanup docker images * tune nginx config * CLICKHOUSE-3043: get rid of habrastorage links * Lost translation * CLICKHOUSE-2936: temporary client-side redirect * behaves weird in test * put redirect back * CLICKHOUSE-3047: copy docs txts to public too * move to proper file * remove old pages to avoid confusion * Remove reference redirect warning for now * Refresh README.md * Yellow buttons in docs * Use svg flags instead of unicode ones in docs * fix test website instance * Put flags to separate files * wrong flag * Copy Yandex.Metrica introduction from main page to docs * Yet another home page structure change, couple new blocks (CLICKHOUSE-3045) * Update Contacts section * CLICKHOUSE-2849: more detailed legal information * CLICKHOUSE-2978 preparation - split by files * More changes in Contacts block * Tune texts on index page * update presentations * One more benchmark * Add usage sections to index page, adapted from slides * Get the roadmap started, based on slides from last ClickHouse Meetup * CLICKHOUSE-2977: some rendering tuning * Get rid of excessive section in the end of getting started * Make headers linkable * CLICKHOUSE-2981: links to editing reference - https://github.com/yandex/ClickHouse/issues/849 * CLICKHOUSE-2981: fix mobile styles in docs * Ban crawling of duplicating docs * Open some external links in new tab * Ban old docs too * Lots of trivial fixes in english docs * Lots of trivial fixes in russian docs * Remove getting started copies in markdown * Add Yandex.Webmaster * Fix some sphinx warnings * More warnings fixed in english docs * More sphinx warnings fixed * Add code-block:: text * More code-block:: text * These headers look not that well * Better switch between documentation languages * merge use_case.rst into ya_metrika_task.rst * Edit the agg_functions.rst texts * Add lost empty lines
124 lines
6.5 KiB
ReStructuredText
124 lines
6.5 KiB
ReStructuredText
system.replicas
|
||
---------------
|
||
|
||
Содержит информацию и статус для реплицируемых таблиц, расположенных на локальном сервере.
|
||
Эту таблицу можно использовать для мониторинга. Таблица содержит по строчке для каждой Replicated*-таблицы.
|
||
|
||
Пример:
|
||
|
||
.. code-block:: sql
|
||
|
||
SELECT *
|
||
FROM system.replicas
|
||
WHERE table = 'visits'
|
||
FORMAT Vertical
|
||
|
||
Row 1:
|
||
──────
|
||
database: merge
|
||
table: visits
|
||
engine: ReplicatedCollapsingMergeTree
|
||
is_leader: 1
|
||
is_readonly: 0
|
||
is_session_expired: 0
|
||
future_parts: 1
|
||
parts_to_check: 0
|
||
zookeeper_path: /clickhouse/tables/01-06/visits
|
||
replica_name: example01-06-1.yandex.ru
|
||
replica_path: /clickhouse/tables/01-06/visits/replicas/example01-06-1.yandex.ru
|
||
columns_version: 9
|
||
queue_size: 1
|
||
inserts_in_queue: 0
|
||
merges_in_queue: 1
|
||
log_max_index: 596273
|
||
log_pointer: 596274
|
||
total_replicas: 2
|
||
active_replicas: 2
|
||
|
||
Столбцы:
|
||
|
||
.. code-block:: text
|
||
|
||
database: имя БД
|
||
table: имя таблицы
|
||
engine: имя движка таблицы
|
||
|
||
is_leader: является ли реплика лидером
|
||
|
||
В один момент времени, не более одной из реплик является лидером. Лидер отвечает за выбор фоновых слияний, которые следует произвести.
|
||
Замечу, что запись можно осуществлять на любую реплику (доступную и имеющую сессию в ZK), независимо от лидерства.
|
||
|
||
is_readonly: находится ли реплика в режиме "только для чтения"
|
||
Этот режим включается, если в конфиге нет секции с ZK; если при переинициализации сессии в ZK произошла неизвестная ошибка; во время переинициализации сессии с ZK.
|
||
|
||
is_session_expired: истекла ли сессия с ZK.
|
||
В основном, то же самое, что и is_readonly.
|
||
|
||
future_parts: количество кусков с данными, которые появятся в результате INSERT-ов или слияний, которых ещё предстоит сделать
|
||
|
||
parts_to_check: количество кусков с данными в очереди на проверку
|
||
Кусок помещается в очередь на проверку, если есть подозрение, что он может быть битым.
|
||
|
||
zookeeper_path: путь к данным таблицы в ZK
|
||
replica_name: имя реплики в ZK; разные реплики одной таблицы имеют разное имя
|
||
replica_path: путь к данным реплики в ZK. То же самое, что конкатенация zookeeper_path/replicas/replica_path.
|
||
|
||
columns_version: номер версии структуры таблицы
|
||
Обозначает, сколько раз был сделан ALTER. Если на репликах разные версии, значит некоторые реплики сделали ещё не все ALTER-ы.
|
||
|
||
queue_size: размер очереди действий, которых предстоит сделать
|
||
К действиям относятся вставки блоков данных, слияния, и некоторые другие действия.
|
||
Как правило, совпадает с future_parts.
|
||
|
||
inserts_in_queue: количество вставок блоков данных, которых предстоит сделать
|
||
Обычно вставки должны быстро реплицироваться. Если величина большая - значит что-то не так.
|
||
|
||
merges_in_queue: количество слияний, которых предстоит сделать
|
||
Бывают длинные слияния - то есть, это значение может быть больше нуля продолжительное время.
|
||
|
||
Следующие 4 столбца имеют ненулевое значение только если активна сессия с ZK.
|
||
|
||
log_max_index: максимальный номер записи в общем логе действий
|
||
log_pointer: максимальный номер записи из общего лога действий, которую реплика скопировала в свою очередь для выполнения, плюс единица
|
||
Если log_pointer сильно меньше log_max_index, значит что-то не так.
|
||
|
||
total_replicas: общее число известных реплик этой таблицы
|
||
active_replicas: число реплик этой таблицы, имеющих сессию в ZK; то есть, число работающих реплик
|
||
|
||
Если запрашивать все столбцы, то таблица может работать слегка медленно, так как на каждую строчку делается несколько чтений из ZK.
|
||
Если не запрашивать последние 4 столбца (log_max_index, log_pointer, total_replicas, active_replicas), то таблица работает быстро.
|
||
|
||
Например, так можно проверить, что всё хорошо:
|
||
|
||
.. code-block:: sql
|
||
|
||
SELECT
|
||
database,
|
||
table,
|
||
is_leader,
|
||
is_readonly,
|
||
is_session_expired,
|
||
future_parts,
|
||
parts_to_check,
|
||
columns_version,
|
||
queue_size,
|
||
inserts_in_queue,
|
||
merges_in_queue,
|
||
log_max_index,
|
||
log_pointer,
|
||
total_replicas,
|
||
active_replicas
|
||
FROM system.replicas
|
||
WHERE
|
||
is_readonly
|
||
OR is_session_expired
|
||
OR future_parts > 20
|
||
OR parts_to_check > 10
|
||
OR queue_size > 20
|
||
OR inserts_in_queue > 10
|
||
OR log_max_index - log_pointer > 10
|
||
OR total_replicas < 2
|
||
OR active_replicas < total_replicas
|
||
|
||
Если этот запрос ничего не возвращает - значит всё хорошо.
|