-

docs/dashboards.rst

@@ -218,3 +218,76 @@ Kibana со своим кодом, как используемое поле.
 	- ``_number``
 
 Типы данных и условия создания полей такие же, как и в текущем индексе.
+
+Визуализация данных в Kibana
+----------------------------
+
+Шаблоны индексов
+~~~~~~~~~~~~~~~~
+
+Для использования индексов Elasticsearch в диаграммах Kibana
+необходимо указать эти индексы, используя **шаблоны индексов**
+(Index patterns). Они представляют собой маску имени, которой
+должны соответствовать индексы, входящие в этот шаблон.
+
+Подробно о шаблонах индексов написано в
+`официальном руководстве по Kibana <https://www.elastic.co/guide/en/kibana/current/index-patterns.html>`_.
+
+Например, если необходимо создать шаблон для индексов ``myindex-1``,
+``myindex-2``, ``myindex-3`` и ``myindex-abc``, требуется создать
+шаблон индекса ``myindex-*``, где символ * означает подстановку
+произвольного набора символов.
+
+.. note:: Поскольку имена индексов данных форм составляются
+          на основе кодов соответствующих компонентов форм, рекомендуется присваивать
+          этим компонентам коды с учетом некоторого значащего префикса так,
+          чтобы используемые данные можно было объединить в группу по маске
+          имени.
+
+          В случае, если изменение кодов компонентов не представляется
+          возможным, можно создать шаблон индекса с маской "*". Этот шаблон
+          будет содержать все индексы Elasticsearch.
+
+          Другой способ объединения данных по форме в единый шаблон индекса -
+          создание шаблона для отдельного реестра или формы. Например, если
+          в диаграмме необходимо использовать данные реестра ``someRegistryID``,
+          нужно создать шаблон индекса с названием ``r-someRegistryID``.
+          Аналогично, для использования данных формы (в случае, если Synergy
+          не содержит реестра для этой формы) с кодом ``someFormID`` нужно
+          создать шаблон индекса ``f-someFormID``.
+
+Создание шаблонов индексов осуществляется в разделе *Management* -
+*Index Patterns*. Для создания нового шаблона нужно нажать на
+кнопку **+ Add New**. Откроется окно создания нового индекса:
+
+.. figure:: _static/img/dashboards/configure_index_pattern.png
+
+    Создание нового шаблона индексов
+
+Установленный чекбокс **Index contains time-based events** означает,
+что данные, которые входят в шаблон, содержат временн**ы**е данные.
+
+.. attention::  Не рекомендуется оставлять этот чекбокс включенным, если не
+                планируется визуализация данных во времени - например, отслеживать
+                нагрузку на сервер в настоящий момент. Без особой настройки диаграммы,
+                использующие такие поля, будут отображать только данные, соответствующие
+                текущему моменту времени.
+
+В поле **Index name or pattern** необходимо ввести имя шаблона индекса:
+
+.. figure:: _static/img/dashboards/configure_index_pattern_1.png
+
+    Создание нового шаблона индексов без временных данных
+
+В случае, если Elasticsearch содержит индексы с именами, соответствующими
+указанному шаблону, отобразится доступная кнопка **Create**. Для создания
+шаблона индекса нужно нажать на эту кнопку.
+
+.. figure:: _static/img/dashboards/index_pattern.png
+
+    Созданный шаблон индексов
+
+После создания шаблона отображается таблица со списком индексов, входящих
+в этот шаблон, и их свойствами. Эти свойства зависят от типов индексов.
+Типы, с которыми индексируются данные форм Synergy, описаны в разделе
+`Индексация данных форм <#>`_.