ClickHouse/docs/ru/table_engines/graphitemergetree.rst
BayoNet f17c3afef7 New part "Server configuration parameters" of the document is added.
Other changes are made related to this new part.
2017-07-03 17:00:45 +03:00

96 lines
4.7 KiB
ReStructuredText
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

.. _table_engines-graphitemergetree:
GraphiteMergeTree
-----------------
Движок предназначен для rollup (прореживания и агрегирования/усреднения) данных `Graphite <http://graphite.readthedocs.io/en/latest/index.html>`_. Он может быть интересен разработчикам, которые хотят использовать ClickHouse как хранилище данных для Graphite.
Graphite хранит в ClickHouse полные данные, а получать их может следующими способами:
* Без прореживания.
Используется движок :ref:`MergeTree <table_engines-mergetree>`.
* С прореживанием.
Используется движок ``GraphiteMergeTree``.
Движок наследует свойства `MergeTree`. Настройки прореживания данных задаются параметром :ref:`server_settings-graphite_rollup` в конфигурации сервера .
Использование движка
^^^^^^^^^^^^^^^^^^^^
Таблица с данными 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```.
Поля шаблона правил.
+---------------+----------------------------------------------------------------------------------------------------------------------------+
| Поле | Описание |
+===============+============================================================================================================================+
| ``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>