-

dde187e1 · Valentin Skripnikov · 658ee5b8 · dde187e1
Commit dde187e1 authored Nov 24, 2017 by Valentin Skripnikov
Show whitespace changes
Inline Side-by-side

Showing with 225 additions and 170 deletions

docs/dashboards.rst docs/dashboards.rst +225 -170

No files found.
--- a/docs/dashboards.rst
+++ b/docs/dashboards.rst
@@ -358,9 +358,9 @@ Kibana позволяет создавать следующие типы диа
 1.  Выбор типа диаграммы.
 2.  Выбор источника данных шаблона индекса.
-В одной диаграмме возможно использование только одного шаблона,
+    В одной диаграмме возможно использование только одного шаблона,
-поэтому для использования в одной диаграмме данных документов по
+    поэтому для использования в одной диаграмме данных документов по
-нескольким формам, необходимо использовать alias-ы.
+    нескольким формам, необходимо использовать alias-ы.
    .. note:: Этот шаг отсутствует для диаграммы *Markdown widget*
@@ -450,91 +450,105 @@ Kibana позволяет создавать следующие типы диа
    - *Custom label* - отображаемое название параметра.
->> Для каждого используемого параметра, независимо от того, используется
+Для каждого используемого параметра, независимо от того, используется
 ли он в разделах *Metrics* или *Buckets*, доступна дополнительная
 настройка, отображаемая при нажатии на лейбл **Advanced**:
->> ![JSON Input](resources/img/integration/dashboards/json_input.png)
+.. figure:: _static/img/dashboards/json_input.png
->> Она представляет собой текстовое поле, в которое можно добавить
+    JSON Input
+Она представляет собой текстовое поле, в которое можно добавить
 специальные свойства в формате `JSON`, например:
->> `{ "script" : "doc['grade'].value * 1.2" }`
+.. code-block:: js
+      { "script" : "doc['grade'].value * 1.2" }
 В настоящем документе процесс создания диаграмм и дашбордов
 будет рассмотрен на примере анализа данных формы "Заявка":
-![Форма "Заявка"](resources/img/integration/dashboards/request_form.png)
+.. figure:: _static/img/dashboards/request_form.png
+    Форма "Заявка"
-##### Pie chart {#sec.dashboards_pie_chart}
+Pie chart
+"""""""""
-![Создание диаграммы Pie chart](resources/img/integration/dashboards/pie_chart_creation.png)
+.. figure:: _static/img/dashboards/pie_chart_creation.png
+    Создание диаграммы Pie chart
 Для диаграммы Pie chart возможно два способа организации
 используемых параметров:
 - **Split Slices**: параметр будет отображен на диаграмме как
-новый уровень секторов:
+  новый уровень секторов:
+.. figure:: _static/img/dashboards/pie_chart_split_slices.png
-> ![Заявки по офисам и клиентам](resources/img/integration/dashboards/pie_chart_split_slices.png)
+    Заявки по офисам и клиентам
-> На этом примере в разделе *Buckets* в качестве первого
+На этом примере в разделе *Buckets* в качестве первого
 параметра использовано поле "Центр решений" - результаты этой
 агрегации на диаграмме отображены во внутреннем круге.
-> В качестве второго параметра используется поле "Клиент/проект",
+В качестве второго параметра используется поле "Клиент/проект",
 и результаты этой агрегации отображаются во внешнем круге.
->> **Примечание:**
+.. note:: Такая последовательность была выбрана в силу специфики
+          входных данных: известно, что один центр решений занимается
+          несколькими проектами, но одним проектом занимается ровно
+          один центр решений.
->> Такая последовательность была выбрана в силу специфики
+Итоговая диаграмма позволяет оценить распределение объема
-входных данных: известно, что один центр решений занимается
-несколькими проектами, но одним проектом занимается ровно
-один центр решений.
-> Итоговая диаграмма позволяет оценить распределение объема
 заявок как по центрам решений, так и по отдельным проектам.
 - **Split Chart**: для нового параметра будет построена
 отдельная диаграмма:
-> ![Заявки по офисам и клиентам](resources/img/integration/dashboards/pie_chart_split_charts.png)
+.. figure:: _static/img/dashboards/pie_chart_split_charts.png
+    Заявки по офисам и клиентам
-> Здесь для каждого центра решений (поле выбрано первым
+Здесь для каждого центра решений (поле выбрано первым
 параметром с типом *Split Chart*) отрисована отдельная
 диаграмма, в которой показано распределение заявок по
 проектам этих центров (второй параметр с типом *Split Slices*).
 Видно, что три центра решений оставляли заявки только по одному
 из своих проектов.
->> **Примечание:**
+.. note:: Kibana допускает использование *Split Chart* только в
+          сочетании с *Split Slices*, причем в этом случае параметр
->> Kibana допускает использование *Split Chart* только в
+          со *Split Chart* обязательно должен располагаться выше, чем
-сочетании с *Split Slices*, причем в этом случае параметр
+          параметр со *Split Slices* (сначала разделить данные по
-со *Split Chart* обязательно должен располагаться выше, чем
+          отдельным диаграммам, а потом разделять данные внутри каждой
-параметр со *Split Slices* (сначала разделить данные по
+          диаграммы).
-отдельным диаграммам, а потом разделять данные внутри каждой
-диаграммы).
 Добавить новый параметр можно, нажав на кнопку **Add sub-buckets**.
 Вкладка **Options** для этого типа диаграмм содержит три
 параметра:
-![Вкладка "Опции" диаграммы Pie chart](resources/img/integration/dashboards/pie_chart_options.png)
+.. figure:: _static/img/dashboards/pie_chart_options.png
+    Вкладка "Опции" диаграммы Pie chart
 - Вид диаграммы: если чекбокс *Donut* включен, диаграмма
-принимает вид кольцевой, если отключен - круговой (по
+  принимает вид кольцевой, если отключен - круговой (по
-умолчанию).
+  умолчанию).
 - Расположение легенды: по умолчанию справа от диаграммы.
 - Показывать всплывающие подсказки при наведении на часть
-диаграммы: отображаются, если включен чекбокс *Show Tooltip*.
+  диаграммы: отображаются, если включен чекбокс *Show Tooltip*.
+Data table
+""""""""""
-##### Data table {#sec.dashboards_data_table}
+.. figure:: _static/img/dashboards/data_table_creation.png
-![Создание диаграммы Data table](resources/img/integration/dashboards/data_table_creation.png)
+    Создание диаграммы Data table
 В разделе *Metrics* необходимо указать одну или несколько
 метрик, по которым будут агрегироваться данные в таблице.
@@ -543,55 +557,62 @@ Kibana позволяет создавать следующие типы диа
 и способы их агрегации. Для этого типа диаграмм также существует
 два способа организации входных параметров:
- *Split Rows* для добавления параметра как нового столбца к
+    - *Split Rows* для добавления параметра как нового столбца к
-текущей таблице;
+      текущей таблице;
- *Split Table* для добавления параметра как отдельной таблицы.
+    - *Split Table* для добавления параметра как отдельной таблицы.
-Функциональность этих способов полностью аналогична *Split Slices*
+.. note:: Функциональность этих способов полностью аналогична *Split Slices*
-и *Split Chart* для [круговой диаграммы](#sec.dashboards_pie_chart).
+          и *Split Chart* для круговой диаграммы.
-![Настроены отображаемые данные в таблице](resources/img/integration/dashboards/data_table_result.png)
+.. figure:: _static/img/dashboards/data_table_result.png
-> В диаграмме, указанной на рисунке выше, все параметры были
+    Настроены отображаемые данные в таблице
+В диаграмме, указанной на рисунке выше, все параметры были
 добавлены как *Split Rows*. Для каждого параметра в разделе
 *Buckets* используется агрегация *Terms*.
 Вкладка **Options** для этого типа диаграмм содержит следующие
 параметры:
-![Вкладка "Опции" диаграммы Data table](resources/img/integration/dashboards/data_table_options.png)
+.. figure:: _static/img/dashboards/data_table_options.png
+    Вкладка "Опции" диаграммы Data table
 - Количество отображаемых строк на странице: по умолчанию
-отображается 10 строк. В случае, если все записи не помещаются
+  отображается 10 строк. В случае, если все записи не помещаются
-на одну страницу, в нижней части таблицы отображается переключатель
+  на одну страницу, в нижней части таблицы отображается переключатель
-страниц.
+  страниц.
 - Отображать метрики для каждой группы/уровня: если чекбокс
-включен, то для каждого столбца (в случае *Split Rows*) или
+  включен, то для каждого столбца (в случае *Split Rows*) или
-каждой таблицы (в случае *Split Table*) будет добавлен столбец
+  каждой таблицы (в случае *Split Table*) будет добавлен столбец
-с результатом агрегации из раздела *Metrics*.
+  с результатом агрегации из раздела *Metrics*.
 - Отображать частичные строки: если чекбокс включен, то в таблицу
-будут включены строки с данными, отсутствующими для выбранных
+  будут включены строки с данными, отсутствующими для выбранных
-индексов (полей). По умолчанию в таблице отображаются только
+  индексов (полей). По умолчанию в таблице отображаются только
-полностью заполненные строки.
+  полностью заполненные строки.
 - Считать метрики для каждой группы/уровня: чекбокс, недоступный
-для ручной установки. Его значение зависит от параметра
+  для ручной установки. Его значение зависит от параметра
-"Отображать метрики для каждой группы/уровня".
+  "Отображать метрики для каждой группы/уровня".
 - Отображать итоговые значения: если чекбокс включен, то на каждой
-странице таблицы для каждой отображаемой метрики будет указано
+  странице таблицы для каждой отображаемой метрики будет указано
-итоговое значение этой метрики для всех данных таблицы.
+  итоговое значение этой метрики для всех данных таблицы.
 - Функция для итогов: выбор функции для подсчета итоговых значений
-метрик. Параметр доступен только в том случае, если установлен
+  метрик. Параметр доступен только в том случае, если установлен
-чекбокс "Отображать итоговые значения".
+  чекбокс "Отображать итоговые значения".
-##### Vertical bar chart {#sec.dashboards_vertical_bar_chart}
+Vertical bar chart
+""""""""""""""""""
-![Создание диаграммы Vertical bar chart](resources/img/integration/dashboards/step3.png)
+.. figure:: _static/img/dashboards/step3.png
+    Создание диаграммы Vertical bar chart
 В диаграмме этого типа по оси Y располагаются метрики (параметры
 в *Metrics*), с по оси X - группы (параметры в *Buckets*).
@@ -605,39 +626,49 @@ Kibana позволяет создавать следующие типы диа
 - *Split Chart*
-Функциональность *Split Bars* и *Split Chart* полностью аналогична
+.. note:: Функциональность *Split Bars* и *Split Chart* полностью аналогична
-*Split Slices* и *Split Chart* для [круговой диаграммы](#sec.dashboards_pie_chart).
+          *Split Slices* и *Split Chart* для круговой диаграммы.
+.. figure:: _static/img/dashboards/split_chart_vertical_bar.png
-![Диаграмма Vertical bar chart, пример 1](resources/img/integration/dashboards/split_chart_vertical_bar.png)
+    Диаграмма Vertical bar chart, пример 1
 На примере 1 показан результат разделения параметров по диаграммам:
 отображается количество заявок, поданных разными авторами и
 выполненных разными исполнителями. Для этого исполнители расположены
 по оси Х, а для каждого автора заявок отрисована отдельная диаграмма.
-![Диаграмма Vertical bar chart, пример 2](resources/img/integration/dashboards/split_bars_vertical_bar.png)
+.. figure:: _static/img/dashboards/split_bars_vertical_bar.png
+    Диаграмма Vertical bar chart, пример 2
 На примере 2 показана простая гистограмма, визуализирующая количество
 заявок, выполненных разными исполнителями.
-##### Markdown widget {#sec.dashboards_Markdown_widget}
+Markdown widget
+"""""""""""""""
 Специфичный тип диаграммы, который не имеет раздела *Data*.
 В левой части рабочей области располагается поле ввода текста
 с использованием синтаксиса языка
-[Markdown](https://ru.wikipedia.org/wiki/Markdown), в правой
+`Markdown <https://ru.wikipedia.org/wiki/Markdown>`_, в правой
 части отображается результат разметки текста:
-![Создание Markdown widget](resources/img/integration/dashboards/markdown_widget.png)
+.. figure:: _static/img/dashboards/markdown_widget.png
+    Создание Markdown widget
 Эта диаграмма не имеет никаких особых настроек.
-##### Metric {#sec.dashboards_metric}
+Metric
+""""""
 Диаграмма *Metric* работает только с числовыми данными, поэтому
 для нее доступны только агрегации типа *Metrics*:
-![Создание Metrics](resources/img/integration/dashboards/metrics_creation.png)
+.. figure:: _static/img/dashboards/metrics_creation.png
+    Создание Metrics
 Добавить новую метрику можно, нажав на кнопку **Add metrics**.
 Новая метрика будет добавлена как новое отображаемое число.
@@ -645,22 +676,29 @@ Kibana позволяет создавать следующие типы диа
 Вкладка **Options** для этого типа диаграмм содержит только
 один параметр - размер шрифта:
-![Вкладка "Опции" диаграммы Metrics](resources/img/integration/dashboards/metrics_options.png)
+.. figure:: _static/img/dashboards/metrics_options.png
+    Вкладка "Опции" диаграммы Metrics
+Tag cloud
+"""""""""
-##### Tag cloud {#sec.dashboards_tag_cloud}
+.. figure:: _static/img/dashboards/tag_cloud_creation.png
-![Создание Tag cloud](resources/img/integration/dashboards/tag_cloud_creation.png)
+    Создание Tag cloud
 В диаграмме Tag cloud возможно использование только одной агрегации *Metrics*
 и только одного, специального способа организации данных в *Buckets* -
 *Tags*. Добавление новых метрик или новых групп недоступно.
-![Пример диаграммы Tag cloud](resources/img/integration/dashboards/tag_cloud_result.png)
+.. figure:: _static/img/dashboards/tag_cloud_result.png
+    Пример диаграммы Tag cloud
 Вкладка **Options** содержит следующие параметры:
 - зависимость размера текста от числовой метрики: линейная, логарифмическая
-или квадратичная;
+  или квадратичная;
 - ориентация тэгов: горизонтальная, вертикальная или произвольная;
@@ -668,9 +706,12 @@ Kibana позволяет создавать следующие типы диа
 - отображать название используемых параметров: чекбокс, по умолчанию выключен.
-![Вкладка "опции" диаграммы Tag cloud](resources/img/integration/dashboards/tag_cloud_options.png)
+.. figure:: _static/img/dashboards/tag_cloud_options.png
+    Вкладка "опции" диаграммы Tag cloud
-#### Создание дашбордов {#sec.dashboards_dashboards_creation}
+Создание дашбордов
+""""""""""""""""""
 Дашборд представляет собой панель, на которой располагаются
 ранее созданные диаграммы, с широкими возможностями настроек
@@ -678,18 +719,22 @@ Kibana позволяет создавать следующие типы диа
 Создание дашбордов производится в разделе **Dashboard**:
-![Kibana, раздел Dashboard](resources/img/integration/dashboards/add_dashboard.png)
+.. figure:: _static/img/dashboards/add_dashboard.png
+    Kibana, раздел Dashboard
 Панель меню этого раздела содержит пункты:
 - **New** - переход к строке поиска и созданию нового фильтра.
 - **Add** - добавить новый дашборд, содержит перечень сохраненных диаграмм
-и результатов поиска:
+  и результатов поиска:
-> ![Добавление диаграммы на дашборд](resources/img/integration/dashboards/dashboard_add_panel.png)
+.. figure:: _static/img/dashboards/dashboard_add_panel.png
-> Каждая диаграмма в списке сопровождается пиктограммой, указывающей на тип
+    Добавление диаграммы на дашборд
+Каждая диаграмма в списке сопровождается пиктограммой, указывающей на тип
 диаграммы.
 - **Save** - сохранить текущий дашборд.
@@ -697,164 +742,174 @@ Kibana позволяет создавать следующие типы диа
 - **Open** - открыть ранее сохраненный дашборд.
 - **Share** - настройки публикации дашборда. Доступны только для сохраненного
-дашборда.
+  дашборда.
 - **Options** - настройка внешнего вида дашборда, содержит единственный
-чекбокс "Использовать темную тему", по умолчанию выключен.
+  чекбокс "Использовать темную тему", по умолчанию выключен.
 - **Time range** - настройка режима отображения данных для диаграмм.
-В самой панели отображается настроенный период. По умолчанию отображаются
+  В самой панели отображается настроенный период. По умолчанию отображаются
-данные за последние 15 минут. Данная настройка актуальна, если есть
+  данные за последние 15 минут. Данная настройка актуальна, если есть
-необходимость отображения данных в режиме реального времени. Доступна
+  необходимость отображения данных в режиме реального времени. Доступна
-возможность быстрой настройки периода (за сегодня, за эту неделю,
+  возможность быстрой настройки периода (за сегодня, за эту неделю,
-за последний год), указания абсолютной (дата и время в формате
+  за последний год), указания абсолютной (дата и время в формате
-`YYYY-MM-DD HH:mm:ss.SSS`) или относительной (например, последние
+  ``YYYY-MM-DD HH:mm:ss.SSS``) или относительной (например, последние
-25 минут) настройки.
+  25 минут) настройки.
+.. figure:: _static/img/dashboards/dashboard_time_range.png
-> ![Настройки периода отображения](resources/img/integration/dashboards/dashboard_time_range.png)
+    Настройки периода отображения
-> При переходе к этой настройке в панели меню появляется дополнительный
+При переходе к этой настройке в панели меню появляется дополнительный
 пункт **Auto-refresh**. Он предназначен для настройки интервала обновления
 диаграмм:
-> ![Настройки периода обновления диаграмм](resources/img/integration/dashboards/dashboard_refresh.png)
+.. figure:: _static/img/dashboards/dashboard_refresh.png
-> Данная настройка актуальна, если данные, на основе которых построены
+    Настройки периода обновления диаграмм
+Данная настройка актуальна, если данные, на основе которых построены
 диаграммы, регулярно обновляются: например, в терминах Synergy, если необходимо
 отображать актуальные данные реестров, в которых регулярно появляются новые
 записи.
-> По умолчанию автообновление выключено.
+По умолчанию автообновление выключено.
 Для всех диаграмм на дашборде возможно одновременное применение условий
 для отображаемых данных. Для этого нужно ввести условие в панель поиска,
 располагающуюся ниже панели меню. Функциональность этой панели для
 раздела **Dashboards** аналогично панели в разделе **Visualize**.
-##### Добавление и настройка диаграмм {#sec.dashboards_add_diargam_to_panel}
+Добавление и настройка диаграмм
+"""""""""""""""""""""""""""""""
 Для добавления ранее сохраненной диаграммы на дашборд необходимо выбрать пункт
 меню **Add**. Отобразится список доступных диаграмм (илл. "Добавление диаграммы
 на дашборд" выше). Необходимо кликнуть на нужную диаграмму - она будет добавлена
 на дашборд:
-![Добавлена панель диаграммы на дашборд](resources/img/integration/dashboards/add_digramm_step1.png)
+.. figure:: _static/img/dashboards/add_digramm_step1.png
+    Добавлена панель диаграммы на дашборд
 Размер отображаемой диаграммы можно изменить, потянув за левый нижний угол панели
 диаграммы:
-![Изменение размера панели диаграммы](resources/img/integration/dashboards/add_diagramm_resize.png)
+.. figure:: _static/img/dashboards/add_diagramm_resize.png
+    Изменение размера панели диаграммы
-![Изменен размер панели диаграммы](resources/img/integration/dashboards/add_daigramm_step2.png)
+.. figure:: _static/img/dashboards/add_daigramm_step2.png
+    Изменен размер панели диаграммы
 В случае, если все данные диаграммы не помещаются на панели, в нее будет добавлен
 внутренний скролл.
-> **Примечание:**
+..note::  Если на определенном размере панели диаграммы "Облако тэгов" не помещаются все
+          данные, в ней будут отображены только наиболее популярные тэги (столько, сколько
-> Если на определенном размере панели диаграммы "Облако тэгов" не помещаются все
+          возможно уместить на указанном размере панели), и будет отображен текст, предупреждающий,
-данные, в ней будут отображены только наиболее популярные тэги (столько, сколько
+          что для отображения всех данных необходимо увеличить размер панели диаграммы:
-возможно уместить на указанном размере панели), и будет отображен текст, предупреждающий,
-что для отображения всех данных необходимо увеличить размер панели диаграммы:
-> ![](resources/img/integration/dashboards/tag_cloud_resize.png)
+          .. figure:: _static/img/dashboards/tag_cloud_resize.png
 На панели диаграммы отображаются пиктограммы управления:
- ![](resources/img/integration/dashboards/pict1.png) - изменить диаграмму (переход
+- |pict1| - изменить диаграмму (переход к настройкам отображаемых данных диаграммы в разделе **Visualize**);
-к настройкам отображаемых данных диаграммы в разделе **Visualize**);
- ![](resources/img/integration/dashboards/pict2.png) - переместить панель диаграммы
+  .. |pict1| image:: _static/img/dashboards/pict1.png
-на дашборде;
- ![](resources/img/integration/dashboards/pict3.png) - удалить панель диаграммы с
+- |pict2| - переместить панель диаграммы на дашборде;
-дашборда;
- ![](resources/img/integration/dashboards/pict4.png) - изменить размер панели диаграммы;
+  .. |pict2| image:: _static/img/dashboards/pict2.png
- ![](resources/img/integration/dashboards/pict5.png) - отобразать/свернуть источники
+- |pict3| - удалить панель диаграммы с дашборда;
-данных в виде таблицы, запроса или исходных данных Elasticsearch, а также
-статистику запроса данных для этой диаграммы;
- ![](resources/img/integration/dashboards/pict6.png) - отобразить/свернуть легенду.
+  .. |pict3| image:: _static/img/dashboards/pict3.png
-Количество диаграмм, располагаемых на дашборде, не ограничено, наложение диаграмм
+- |pict4| - изменить размер панели диаграммы;
-друг на друга не допускается.
-Пример готового дашборда:
+  .. |pict4| image:: _static/img/dashboards/pict4.png
-![Пример готового дашборда в режиме редактирования](resources/img/integration/dashboards/dashboard_kibana.png)
-Типы использованных примеров диаграмм (перечислены сверху вниз, слева направо):
+- |pict5| - отобразать/свернуть источники данных в виде таблицы, запроса или
+  исходных данных Elasticsearch, а также статистику запроса данных для этой диаграммы;
-1. *Markdown widget*
+  .. |pict5| image:: _static/img/dashboards/pict5.png
-1. *Pie chart*
+- |pict6| - отобразить/свернуть легенду.
-1. *Tag cloud*
+  .. |pict6| image:: _static/img/dashboards/pict6.png
-1. *Metric*
+.. note:: Количество диаграмм, располагаемых на дашборде, не ограничено, наложение диаграмм
+          друг на друга не допускается.
-1. *Vertical bar chart*
+Пример готового дашборда:
-1. *Pie chart*
-1. *Data table*
+.. figure:: _static/img/dashboards/dashboard_kibana.png
-> **Примечание:**
+    Пример готового дашборда в режиме редактирования
-> Применение фильтров ко всем диаграммам на дашборде дает корректные
+Типы использованных примеров диаграмм (перечислены сверху вниз, слева направо):
-результаты только в том случае, если коды используемых полей полностью
-совпадают (в том числе постфиксы). В случае, если необходимо отображение
-данных из нескольких форм, имеющих сквозные параметры (например, параметр
-"Статус"), необходимо, чтобы коды компоненов, соответствующих этому
-параметру, совпадали на всех формах, а в диаграммах использовалось одно
-и то же поле с учетом [постфикса](#sec.dashboards_form_indexator_doc_structure).
-##### Публикация дашборда {#sec.dashboards_sharing}
+#. *Markdown widget*
+#. *Pie chart*
+#. *Tag cloud*
+#. *Metric*
+#. *Vertical bar chart*
+#. *Pie chart*
+#. *Data table*
+.. warning::  Применение фильтров ко всем диаграммам на дашборде дает корректные
+              результаты только в том случае, если коды используемых полей полностью
+              совпадают (в том числе постфиксы). В случае, если необходимо отображение
+              данных из нескольких форм, имеющих сквозные параметры (например, параметр
+              "Статус"), необходимо, чтобы коды компоненов, соответствующих этому
+              параметру, совпадали на всех формах, а в диаграммах использовалось одно
+              и то же поле с учетом постфикса.
+Публикация дашборда
+"""""""""""""""""""
 Kibana предоставляет способы публикации дашборда как интерактивной диаграммы
-или как снимка его состояния на момент публикации (`shapshot`). Публикация
+или как снимка его состояния на момент публикации (``shapshot``). Публикация
 производится в меню **Share**:
-![Пункт меню "Share"](resources/img/integration/dashboards/dashboard_share.png)
+.. figure:: _static/img/dashboards/dashboard_share.png
-Встраивание как дашборда, так и его снимка возможно двумя способами:
+    Пункт меню "Share"
-1. как фрейма `html` - код для вставки содержится в поле **Embedded iframe**;
+Встраивание как дашборда, так и его снимка возможно двумя способами:
-2. как ссылки - URL страницы содержится в поле **Link**.
+#. как фрейма ``html`` - код для вставки содержится в поле **Embedded iframe**;
-> **Примечание:**
+#. как ссылки - URL страницы содержится в поле **Link**.
-> По URL, автоматически генерируемому Kibana, пользователям предоставляется
+.. hint:: По URL, автоматически генерируемому Kibana, пользователям предоставляется
-дашборд в режиме редактирования, с правом доступа ко всем разделам Kibana.
+          дашборд в режиме редактирования, с правом доступа ко всем разделам Kibana.
-Для того, чтобы предоставить пользователям доступ к дашборду только в режиме
+          Для того, чтобы предоставить пользователям доступ к дашборду только в режиме
-просмотра, необходимо в URL ссылки добавить параметр:
+          просмотра, необходимо в URL ссылки добавить параметр:
-> `&embed=true`
+          ``&embed=true``
 Один из способов публикации дашборда в Synergy - добавление его как
-[внешнего модуля](#integration.methods.web-module). При этом каждый дашборд
+`внешнего модуля <#>`_. При этом каждый дашборд
 должен быть оформлен как отдельный внешний модуль. В качестве адреса приложения
 необходимо использовать URL дашборда.
-Другой способ - включение фрейма с дашбордом в [пользовательский компонент](#integration.methods.user-component). В этом случае в качестве HTML-кода необходимо
+Другой способ - включение фрейма с дашбордом в `пользовательский компонент <#>`_.
-использовать код из поля *Embedded iframe*.
+В этом случае в качестве HTML-кода необходимо использовать код из поля *Embedded iframe*.
-> **Примечание:**
-> По умолчанию в код фрейма включены границы 800х600 пикселей. Для того, чтобы
+.. hint:: По умолчанию в код фрейма включены границы 800х600 пикселей. Для того, чтобы
-дашборд занимал все доступное место, необходимо изменить эти параметры:
+          дашборд занимал все доступное место, необходимо изменить эти параметры:
-> `height="100%" width="100%"`
+          ``height="100%" width="100%"``
-> Параметр `embed=true`, означающий доступ к дашборду только в режиме просмотра,
+          Параметр ``embed=true``, означающий доступ к дашборду только в режиме просмотра,
-включается Kibana по умолчанию.
+          включается Kibana по умолчанию.
-> **Примечание:**
+.. attention::  Обратите внимание, что для того, чтобы дашборд был доступен пользователю, у него
+                должен быть доступ к серверу, на котором запущена Kibana.
-> Обратите внимание, что для того, чтобы дашборд был доступен пользователю, у него
+.. figure:: _static/img/dashboards/dashboard.png
-должен быть доступ к серверу, на котором запущена Kibana.
-![Пример дашборда, опубликованного как внешний модуль](resources/img/integration/dashboards/dashboard.png)
+    Пример дашборда, опубликованного как внешний модуль