Документация является одним из важнейших компонентов программного обеспечения. Большинство программ плохо документированы, хотя выглядят великолепно. Может быть, именно поэтому мы, программисты, должны быть еще и писателями.

В качестве примера я использую Демо-ветряную электростанцию из Demo: AWS IoT Sitewise в Grafana Playground.

По умолчанию это Временной ряд и выглядит так:

Когда мы меняем Тип запроса на Получить интерполированные значения свойств и используем Гистограмму, он меняется на:

По умолчанию отображается не Все значения, а Вычислитьзначение. Вот почему отображается только одна полоса. Это последнее значение, выбранное из списка Расчет. Если мы изменим отображение Все значения, то оно изменится на:

Как видите, он однотонный. Чтобы использовать разные цвета для разных значений свойств, выберите Классическая палитра в Цветовой схеме.

До сих пор все выглядит нормально.

Однако есть некоторые потенциальные проблемы, которые нужно исправить.

Первый — это размер шрифта меток данных над каждой полосой и X-метками. Он контролируется Размером текста: Название относится к меткам X или Y, а Значение — к меткам данных над столбцами. (Почему оно называется «Название»? 😃)

Второй — он может не отображать все значения на диаграмме, поскольку по умолчанию отображается только 25 значений, а фактические значения могут быть больше. Значение по умолчанию 25 контролируется Параметры значения Ограничение. Чтобы проверить, сколько значений на самом деле, мы можем использовать Инспектор запросов. После нажатия Инспектор запросов выберите вкладку Статистика, мы увидимОбщее количество строк. Если мы установим предел параметров значений, равный или превышающий Общее количество строк, то Все значения будут отображаться на диаграмме.

После настройки этих частей диаграмма будет выглядеть так:

Как видите, когда мы отображаем слишком много столбцов, трудно отображать текст в X-Label и метках данных. Поэтому нам приходится приспосабливаться или адаптироваться. Например, попробуйте отобразить полосы в горизонтальной ориентации — установите ее в Шкала/Ориентация/Горизонтальная.

А затем используйте меньший размер шрифта, тогда было бы почти идеально: