mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-11-19 22:22:00 +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
94 lines
4.7 KiB
ReStructuredText
94 lines
4.7 KiB
ReStructuredText
GraphiteMergeTree
|
||
-----------------
|
||
|
||
Движок предназначен для rollup (прореживания и агрегирования/усреднения) данных `Graphite <http://graphite.readthedocs.io/en/latest/index.html>`_. Он может быть интересен разработчикам, которые хотят использовать ClickHouse как хранилище данных для Graphite.
|
||
|
||
Graphite хранит в ClickHouse полные данные, а получать их может следующими способами:
|
||
|
||
* Без прореживания.
|
||
|
||
Используется движок :ref:`MergeTree <table_engines-mergetree>`.
|
||
|
||
* С прореживанием.
|
||
|
||
Используется движок ``GraphiteMergeTree``.
|
||
|
||
Движок наследует свойства `MergeTree`. Настройки прореживания данных размещаются в :ref:`общей конфигурации <configuration_files>` ClickHouse (config.xml).
|
||
|
||
Использование движка
|
||
^^^^^^^^^^^^^^^^^^^^
|
||
|
||
Таблица с данными Graphite должна содержать как минимум следующие поля:
|
||
|
||
* ``Path`` - имя метрики (сенсора Graphite).
|
||
* ``Time`` - время измерения.
|
||
* ``Value`` - значение метрики в момент времени Time.
|
||
* ``Version`` - настройка, которая определяет какое значение метрики с одинаковыми Path и Time останется в базе.
|
||
|
||
Шаблон правил rollup:
|
||
.. code-block:: text
|
||
|
||
pattern
|
||
regexp
|
||
function
|
||
age -> precision
|
||
...
|
||
pattern
|
||
...
|
||
default
|
||
function
|
||
age -> precision
|
||
...
|
||
|
||
При обработке записи ClickHouse проверит правила в секции ```pattern```. Если имя метрики соответствует шаблону ```regexp```, то применяются правила из ```pattern```, в противном случае из ```default```.
|
||
|
||
Поля шаблона правил.
|
||
.. code-block:: text
|
||
|
||
+---------------+----------------------------------------------------------------------------------------------------------------------------+
|
||
| Поле | Описание |
|
||
+===============+============================================================================================================================+
|
||
| ``age`` | Минимальный возраст данных в секундах. |
|
||
+---------------+----------------------------------------------------------------------------------------------------------------------------+
|
||
| ``function`` | Имя агрегирующей функции, которую следует применить к данным, чей возраст оказался в интервале ``[age, age + precision]``. |
|
||
+---------------+----------------------------------------------------------------------------------------------------------------------------+
|
||
| ``precision`` | Точность определения возраста данных в секундах. |
|
||
+---------------+----------------------------------------------------------------------------------------------------------------------------+
|
||
| ``regexp`` | Шаблон имени метрики. |
|
||
+---------------+----------------------------------------------------------------------------------------------------------------------------+
|
||
|
||
|
||
Пример настройки:
|
||
|
||
.. code-block:: xml
|
||
|
||
<graphite_rollup>
|
||
<pattern>
|
||
<regexp>click_cost</regexp>
|
||
<function>any</function>
|
||
<retention>
|
||
<age>0</age>
|
||
<precision>5</precision>
|
||
</retention>
|
||
<retention>
|
||
<age>86400</age>
|
||
<precision>60</precision>
|
||
</retention>
|
||
</pattern>
|
||
<default>
|
||
<function>max</function>
|
||
<retention>
|
||
<age>0</age>
|
||
<precision>60</precision>
|
||
</retention>
|
||
<retention>
|
||
<age>3600</age>
|
||
<precision>300</precision>
|
||
</retention>
|
||
<retention>
|
||
<age>86400</age>
|
||
<precision>3600</precision>
|
||
</retention>
|
||
</default>
|
||
</graphite_rollup>
|