Документацияbreadcrumb arrow Grafanabreadcrumb arrow Документация GlaberGraphbreadcrumb arrow Визуализация данныхbreadcrumb arrow Панели и визуализацииbreadcrumb arrow Настройка стандартных параметров

Настройка стандартных параметров

Standard options (стандартные параметры) на панели редактора панели позволяют изменить способ отображения данных полей в ваших визуализациях. Применяемые параметры не изменяют сами данные — они меняют только то, как Grafana отображает эти данные.

Когда вы задаёте стандартный параметр, изменение применяется ко всем полям или рядам. Например, если задать для параметра Unit значение Percentage, все поля с числовыми значениями будут отображаться в процентах.

Для более точного управления отображением полей обратитесь к разделу Настройка переопределений.

Поддерживаемые визуализации

Стандартные параметры можно настроить для следующих визуализаций:

Стандартные параметры

В этом разделе описаны все доступные стандартные параметры.

Чтобы задать эти параметры, разверните раздел Standard options на панели редактора панели. Большинство параметров поля не влияют на визуализацию, пока вы не щёлкнете вне редактируемого поля параметра или не нажмёте Enter.

Note

Не все перечисленные параметры применимы ко всем визуализациям, поддерживающим стандартные параметры.

Unit

Этот параметр позволяет выбрать, какие единицы измерения должно использовать поле. Щёлкните в поле Unit и продолжайте раскрывать список, пока не найдёте нужную единицу. Выбранная единица применяется ко всем полям, кроме времени.

Пользовательские единицы измерения

Раскрывающийся список Unit также позволяет задать пользовательские единицы измерения, пользовательские префиксы или суффиксы, а также форматы даты и времени.

Чтобы задать пользовательскую единицу измерения, введите нужную единицу и выберите её в раскрывающемся списке. Она будет указана последней. Например, если ввести единицу с названием «Hearts», в раскрывающемся списке появится пункт Custom unit: Hearts.

Пользовательскую единицу измерения можно дополнительно определить с помощью специального синтаксиса. Например, чтобы задать пользовательскую денежную единицу с названием «Gems», введите currency:Gems в поле. В раскрывающемся списке появится пункт Custom unit: currency:Gems:

Пользовательская денежная единица измерения Gems в раскрывающемся списке Unit

В следующей таблице перечислены варианты специального синтаксиса для пользовательских единиц измерения:

Пользовательская единица Описание
suffix:<suffix> Пользовательская единица измерения, которая должна идти после значения.
prefix:<prefix> Пользовательская единица измерения, которая должна идти перед значением.
time:<format> Пользовательский тип формата даты и времени, например time:YYYY-MM-DD. О синтаксисе и параметрах формата см. в разделе formats.
si:<base scale><unit characters> Пользовательские единицы СИ, например si: mF. Можно указать как единицу измерения, так и масштаб исходных данных. Например, если исходные данные представлены в милливеличинах, добавьте к единице измерения приставку СИ m.
count:<unit> Пользовательская единица измерения количества.
currency:<unit> Пользовательская денежная единица измерения.
currency:financial:<unit> Денежная единица измерения в полном формате без сокращений. Отображает полные числовые значения вместо сокращений масштаба (K — тысяча, M — миллион, B — миллиард, T — триллион). Например, currency:financial:$ отображает 500,555 вместо $501K. Добавьте :suffix, чтобы разместить символ после числа: currency:financial:€:suffix отображает 500,555€.

Вы также можете вставить в раскрывающийся список Unit нативный эмодзи и выбрать его в качестве пользовательской единицы измерения:

Эмодзи «большой палец вверх» в качестве пользовательской единицы измерения

Визуализация временного ряда с пользовательскими единицами измерения в виде эмодзи «большой палец вверх»

Единицы формата времени

Все единицы формата Date & time в Grafana (например, Datetime ISO или Datetime US) ожидают входные значения в миллисекундах с начала эпохи Unix (1 января 1970 года). Если ваша база данных предоставляет метки времени в секундах, они будут неверно интерпретированы как даты, очень близкие к 1 января 1970 года.

Чтобы отобразить метки времени в секундах с начала эпохи, умножьте значения меток времени на 1000 с помощью трансформации, выполнив следующие шаги:

  1. В редакторе панели щёлкните вкладку Transformations.
  2. Щёлкните Add transformation.
  3. Выберите трансформацию Add field from calculation.
  4. Задайте следующие параметры:
    • Mode — Binary operation
    • Operation
      • Выберите поле с меткой времени
      • Выберите звёздочку (*) для операции умножения
      • Введите 1000 в поле Field or Number
    • Включите переключатель Replace all fields, если хотите увидеть вычисленное поле.

Управление масштабированием единиц измерения

По умолчанию Grafana автоматически масштабирует единицу измерения в зависимости от величины значения. Например, если у вас есть значения 0,14 кВт и 3000 кВт, Grafana отобразит их как 140 Вт и 3 МВт соответственно. Управлять этим поведением можно с помощью пользовательских единиц измерения, задав префикс, суффикс или пользовательскую единицу СИ.

Строковые единицы измерения

Иногда Grafana слишком агрессивно интерпретирует строки и отображает их как числа. Чтобы настроить Grafana на отображение исходного строкового значения, выберите Misc > String в раскрывающемся списке Unit.

Min

Задаёт минимальное значение, используемое в расчётах порогов в процентах. Оставьте это поле пустым, чтобы минимум вычислялся автоматически.

Max

Задаёт максимальное значение, используемое в расчётах порогов в процентах. Оставьте это поле пустым, чтобы максимум вычислялся автоматически.

Field min/max

По умолчанию вычисленные значения Min и Max основываются на минимуме и максимуме всех рядов и полей. Если включить Field min/max, Grafana вычисляет минимум или максимум каждого поля отдельно, исходя из минимального или максимального значения этого поля.

Decimals

Указывает количество десятичных знаков, которые Grafana включает в отображаемое значение. Если оставить это поле пустым, Grafana автоматически усечёт количество десятичных знаков в зависимости от значения. Например, 1.1234 отобразится как 1.12, а 100.456 — как 100.

Чтобы отобразить все десятичные знаки, задайте единицу измерения String.

Display name

Задаёт отображаемый заголовок для всех полей. В заголовке поля можно использовать переменные.

Когда отображается несколько статистик, полей или рядов, это поле управляет заголовком в каждой статистике. Можно использовать выражения вида ${__field.name}, чтобы в заголовке использовалось только имя ряда или имя поля.

В следующей таблице приведены примеры различных имён полей, формируемых с помощью разных выражений. В этом примере есть поле с именем «Temp» и метками {“Loc”=“PBI”, “Sensor”=“3”}:

Синтаксис выражения Пример Отображается как Пояснение
${__field.displayName} Совпадает с синтаксисом Temp {Loc="PBI", Sensor="3"} Отображает имя поля и метки в {}, если они присутствуют. Если в ответе только один ключ метки, то для части с метками Grafana отображает значение метки без обрамляющих фигурных скобок.
${__field.name} Совпадает с синтаксисом Temp Отображает имя поля (без меток).
${__field.labels} Совпадает с синтаксисом Loc="PBI", Sensor="3" Отображает метки без имени.
${__field.labels.X} ${__field.labels.Loc} PBI Отображает значение указанного ключа метки.
${__field.labels.__values} Совпадает с синтаксисом PBI, 3 Отображает значения меток, разделённые запятой (без ключей меток).

Если после отрисовки выражения для конкретного поля значение оказывается пустой строкой, применяется способ отображения по умолчанию.

Color scheme

Параметры Color scheme позволяют задать один или несколько цветов для всей визуализации.

Параметры цвета и их влияние на визуализацию зависят от того, с какой визуализацией вы работаете; у некоторых визуализаций есть собственные параметры цвета.

Выберите одну из следующих схем:

Схема цвета Описание
Single color Задаёт один цвет.
Shades of a color Grafana выбирает оттенки одного цвета.
From thresholds (by value) Цвет берётся из соответствующего порога. Для некоторых визуализаций также нужно выбрать, задаётся ли цвет значением Last, Min или Max поля или ряда.
Classic palette Grafana автоматически назначает цвет каждому полю или ряду в зависимости от его порядка. Если порядок поля в запросе меняется, меняется и цвет. Полезно для графиков, круговых диаграмм и других визуализаций категориальных данных.
Classic palette (by series name) Grafana автоматически назначает цвета на основе имени ряда. Полезно, когда имена визуализируемых рядов могут меняться в зависимости от доступных данных.
Multiple continuous colors (by value) Grafana автоматически назначает цвета на основе доли значения относительно минимума и максимума поля или ряда. Для некоторых визуализаций также нужно выбрать, задаётся ли цвет значением Last, Min или Max поля или ряда. Выбор из: Green-Yellow-Red, Red-Yellow-Green, Blue-Yellow-Red, Yellow-Red, Blue-Purple и Yellow-Blue.
Single continuous color (by value) Grafana автоматически назначает оттенки одного цвета на основе доли значения относительно минимума и максимума поля или ряда. Для некоторых визуализаций также нужно выбрать, задаётся ли цвет значением Last, Min или Max поля или ряда. Выбор из: Blues, Reds, Greens и Purples.

Также можно открыть выбор цвета из легенды, щёлкнув значок цвета ряда в легенде. Такой способ задания цвета автоматически создаёт правило переопределения, которое задаёт определённый цвет для конкретного ряда.

No value

Укажите, что должна отображать Grafana, если значение поля пустое или равно null. Значение по умолчанию — дефис (-).