Переменные шаблонов Zipkin
Используйте переменные шаблонов для создания динамических, многократно используемых дашбордов. Вместо жёсткого задания ID трассировок вы можете использовать переменные, чтобы позволить зрителям дашборда выбирать или вводить ID трассировок во время просмотра, что упрощает обмен дашбордами между командами.
Введение в переменные шаблонов Grafana см. в разделе Переменные.
Поддерживаемые типы переменных
Источник данных Zipkin не поддерживает переменные на основе запросов, но вы можете использовать пользовательские переменные или переменные текстового поля, чтобы параметризовать запросы по ID трассировки.
Создание переменной текстового поля
Переменная текстового поля позволяет зрителям дашборда вводить ID трассировки напрямую. Это наиболее распространённый тип переменной для Zipkin.
Чтобы создать переменную текстового поля:
- Перейдите к дашборду, который хотите обновить, и нажмите Edit.
- Нажмите значок Add new element (синий знак плюс).
- Нажмите Variable.
- Выберите Textbox в качестве типа переменной.
- Установите Name в
traceId. - Выберите опцию в раскрывающемся списке Display, чтобы управлять тем, где на дашборде отображается переменная.
- (Необязательно) Установите значение по умолчанию Value с известным ID трассировки для начального отображения.
- Нажмите Save.
- (Необязательно) Введите описание внесённых изменений.
- Нажмите Save.
- Нажмите Exit edit.
Дашборд отображает поле ввода текста, где зрители могут вставить ID трассировки.
Создание пользовательской переменной
Пользовательская переменная предоставляет предопределённый список значений. Это полезно, когда вы хотите дать зрителям набор известных ID трассировок на выбор.
Чтобы создать пользовательскую переменную:
-
Перейдите к дашборду, который хотите обновить, и нажмите Edit.
-
Нажмите значок Add new element (синий знак плюс).
-
Нажмите Variable.
-
Выберите Custom в качестве типа переменной.
-
Установите Name в
traceId. -
Выберите опцию в раскрывающемся списке Display, чтобы управлять тем, где на дашборде отображается переменная.
-
Нажмите Open variable editor, чтобы открыть диалоговое окно Custom options.
-
Введите ID трассировок в поле Values separated by comma:
efe9cb8857f68c8f,463ac35c9f6413ad48485a3953bb6124 -
Нажмите Apply.
-
Нажмите Save.
-
(Необязательно) Введите описание внесённых изменений.
-
Нажмите Save.
-
Нажмите Exit edit.
Дашборд отображает раскрывающийся список, в котором зрители могут выбрать один из предопределённых ID трассировок.
Создание переменной источника данных
Переменная источника данных позволяет зрителям переключаться между несколькими экземплярами Zipkin. Это полезно, когда у вас есть отдельные развёртывания Zipkin для разных сред.
Чтобы создать переменную источника данных:
- Перейдите к дашборду, который хотите обновить, и нажмите Edit.
- Нажмите значок Add new element (синий знак плюс).
- Нажмите Variable.
- Выберите Data source в качестве типа переменной.
- Установите Name в
zipkinDs. - Выберите опцию в раскрывающемся списке Display, чтобы управлять тем, где на дашборде отображается переменная.
- Выберите Zipkin в качестве Type.
- Нажмите Save.
- (Необязательно) Введите описание внесённых изменений.
- Нажмите Save.
- Нажмите Exit edit.
Затем в редакторе запросов вашей панели выберите ${zipkinDs} в качестве источника данных вместо конкретного экземпляра Zipkin.
Использование переменных в запросах
Вы можете использовать переменные шаблонов в поле Trace ID редактора запросов. Grafana заменяет переменную её текущим значением при выполнении запроса.
Например, если вы создаёте переменную текстового поля с именем traceId, введите ${traceId} в поле ID трассировки. Когда зритель вводит новый ID трассировки, запрос автоматически выполняется с новым значением.
Дополнительную информацию о синтаксисе переменных см. в разделе Синтаксис переменных.
Устранение проблем с переменными шаблонов
Если переменные шаблонов не работают, как ожидалось, обратитесь к разделу Устранение неполадок источника данных Zipkin.