Визуализация карты choropleth

Визуализация карты choropleth

Руководство

Когда использовать

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

Взаимодействие с графиком

Взаимодействие с выделением

• Наведите курсор, чтобы отобразить всплывающую подсказку с подробностями.
• Выберите, чтобы закрепить отображаемую всплывающую подсказку открытой; затем вы можете навести курсор на всплывающую подсказку, чтобы отобразить меню опций, специфичных для выделения.
• Доступные опции меню зависят от ваших данных и выбранной визуализации.
  • Подменю поля предлагает опции, специфичные для поля, такие как:
    • Копировать значение — копирует значение поля.
    • Объяснить значение — использует ИИ для объяснения поля.
  • Добавить команду в запрос — раздел команд, специфичных для поля, которые вы можете автоматически добавить в свой запрос.
  • До трёх рекомендуемых приложений может быть указано на поле.

Заголовок

Используйте поле заголовка в верхней части панели параметров (изначально Плитка без названия или Раздел без названия), чтобы добавить заголовок к вашей плитке дашборда или разделу блокнота.

• Вы можете использовать эмодзи, такие как 😃 и 🌍 и ❤️.
• Вы можете использовать переменные.

Пример:

1. Определите переменные с именами Status и Emoji на вашем дашборде.
2. Установите заголовок в Current $Emoji status is $Status.
3. Установите Status в Good.
4. Установите Emoji в 🌍.

Заголовок будет отображаться как Current 🌍 status is Good.

Визуализация

Если вы не уверены, что выбрали правильную визуализацию, используйте селектор визуализации, чтобы попробовать разные визуализации.

Вид

Масштаб по умолчанию

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

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

Сопоставление данных

Раздел Сопоставление данных показывает, как столбец вашего результата сопоставляется с визуализацией.

Разверните для общих правил по настройкам сопоставления данных

Разверните раздел Сопоставление данных настроек визуализации, чтобы увидеть, как данные в вашем результате сопоставляются с визуализацией, и настроить эти параметры при необходимости.

Обязательные поля помечены звёздочкой (*).

Типы данных отображаются рядом с именами полей в раскрывающихся списках и сопоставленных полях.

Единицы измерения отображаются, когда назначена только одна.

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

Автоматическое применение настроек сопоставления данных по умолчанию:

Версия Ключ-АСТРОМ 1.319+

• Уже существующие плитки и разделы считаются определёнными пользователем. Их конфигурации сопоставления данных не обновляются автоматически.
• Вновь созданные плитки и разделы применяют настройку сопоставления данных по умолчанию. Если вы не измените эти настройки вручную, они могут измениться, если новое выполнение плитки/раздела изменит результаты и появятся отсутствующие поля или новые поля, которые лучше подходят для сопоставления данных.

Настройки сопоставления данных, специфичные для визуализации

• Код страны/субъекта: выберите строковое поле из списка.
  • Используйте коды ISO 3166 для стран и субъектов стран.
  • Подробности о кодах стран см. в разделе ISO 3166-1 alpha-2.
  • Подробности о кодах субъектов стран см. в разделе ISO 3166-2.
• Значение цвета: выберите строковое или числовое поле из списка.

Цвет

Цвета регионов

Выберите, как окрашивать регионы:

• Цветовая палитра: отображает все области в оттенке цвета из выбранной цветовой палитры. Оттенок, используемый для каждой области, соответствует значению Значения цвета по отношению к другим областям.
  • Пример
    • Если значения Значения цвета, возвращённые вашим запросом, находятся в диапазоне от 0 до 100:
      • Область со значением, близким к 0, имеет оттенок цвета ближе к правому концу палитры.
      • Область со значением, близким к 100, имеет оттенок цвета ближе к левому концу палитры.
• Одноцветный: отображает все области одним и тем же цветом. Выберите цвет из списка или введите шестнадцатеричный код цвета.
• Пользовательский: отображает каждую область в пользовательском цвете, определённом вами.
  • Для каждого пользовательского цвета, который вы хотите добавить:
    • Выберите Цвет.
    • Введите значение, оператор и цвет для использования для этого значения и оператора.
  • Пример
    • Предположим, вы хотите раскрасить карту по трём уровням Значения цвета:
      • Зелёный, если Значение цвета меньше 4000.
      • Жёлтый, если Значение цвета достигает или превышает порог 4000.
      • Красный, если Значение цвета достигает или превышает порог 5000.
    • Чтобы настроить это:
      • Выберите Цвет и добавьте строку пользовательского цвета со значением 0, оператором ≥ и желаемым оттенком зелёного. Если Значение цвета равно 0 или выше, область будет зелёной.
      • Выберите Цвет и добавьте строку пользовательского цвета со значением 4000, оператором ≥ и желаемым оттенком жёлтого. Если Значение цвета равно 4000 или выше, область будет жёлтой.
      • Выберите Цвет и добавьте строку пользовательского цвета со значением 5000, оператором ≥ и желаемым оттенком красного. Если Значение цвета равно 5000 или выше, область будет красной.

Легенда и всплывающая подсказка

• Показывать пользовательские поля: чтобы отобразить пользовательские поля (имя и значение) при наведении курсора на область карты, включите Показывать пользовательские поля и выберите каждое пользовательское поле, которое хотите отобразить.
• Показывать легенду: чтобы отобразить легенду карты, включите Показывать легенду и выберите Позицию легенды:
  • Авто: выбирает подходящее место в зависимости от размера карты и доступного места.
  • Снизу: отображает легенду под картой.
  • Справа: отображает легенду справа от карты.
• Усечение текста: определяет, как усекать текст, когда полный текст не может быть отображён.
  • A…: усечение с правого конца текста (когда правый конец менее важен).
  • A…B: усечение с середины текста (когда середина менее важна).
  • …B: усечение с левого конца текста (когда левый конец менее важен).
• Минимальное значение: устанавливает минимальное значение в данных.
  • Авто: автоматически выбирает подходящее минимальное значение на основе данных (0 или минимальное значение).
  • Пользовательский: позволяет установить ручное минимальное значение.
• Максимальное значение: устанавливает максимальное значение в данных.
  • Авто: автоматически выбирает подходящее максимальное значение на основе данных (0 или максимальное значение).
  • Пользовательский: позволяет установить ручное максимальное значение.

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

Чтобы переопределить единицы измерения и форматы по умолчанию в визуализации дашборда или блокнота

1. Выберите соответствующий значок, чтобы отредактировать плитку визуализации.
2. Выберите вкладку Визуализация.
3. Разверните Единицы и форматы.

Раздел Единицы и форматы перечисляет все доступные настройки единиц измерения для документа (дашборда или блокнота). Некоторые единицы измерения могут быть уже добавлены автоматически при запросе метрик из их метаданных.

Каждая строка имеет два меню:

• Левое меню отображает настройки единиц измерения.
• Правое меню отображает поле, сопоставленное с этой единицей измерения.

Чтобы отредактировать настройки единиц измерения, откройте левое меню и просмотрите/установите следующие параметры:

• Единица измерения: базовая единица, в которой были записаны значения. Она Нет, если не была включена в результат DQL, или автоматически определена единицей, переданной из результата DQL. Это поле не приводит к какому-либо преобразованию, но изменяет суффикс, чтобы соответствовать единице измерения.
• Конвертировать: вы можете включить Конвертировать для преобразования. Например, если результат DQL определил ваше числовое значение в результате как Байты, Конвертировать теперь предлагает подходящий список преобразований байтов, таких как Килобайт и Мегабайт.
  • Поддерживаются только линейные и статические преобразования. Например, вы не можете преобразовать градусы Цельсия (°C) в градусы Фаренгейта (°F) или преобразовать доллары США (US$) в евро (€).
• Раздел Формат определяет, как отображается единица измерения:
  • Десятичные знаки: отображает количество десятичных знаков по умолчанию (степень точности) для отображения. Чтобы увидеть это в действии, измените выбор Десятичных знаков и наблюдайте изменение в визуализации.
  • Пользовательский суффикс: отображает суффикс для отображения после единицы измерения. Чтобы увидеть это в действии, включите Пользовательский суффикс, введите строку и наблюдайте изменение в визуализации. Когда вы не находите нужную единицу измерения, вы можете использовать Пользовательский суффикс, чтобы отобразить желаемую единицу измерения.
  • Сокращать большие числа: отображает большие числа в сокращённой форме. Например, 1053 становится 1.1K.
  • Несколько единиц измерения: отображает более одной единицы измерения. Включите это и выберите количество единиц измерения для отображения. Например, 90 секунд становится 1m 30s, если включено несколько единиц измерения и выбрано 2 единицы.
• Чтобы выбрать другое поле для строки, откройте правое меню в этой строке и выберите поле из доступных полей.

Единицы измерения и форматы: дополнительные действия

• Чтобы добавить строку, выберите Добавить и настройте её, как описано выше.
• Действия открывает меню дополнительных опций:
  • Дублировать создаёт копию выбранной строки.
  • Удалить удаляет строку.
  • Сбросить сбрасывает настройки в выбранной строке к значениям по умолчанию/метаданным.

Единицы измерения и форматы: примеры

График среднего CPU across всех хостов

В этом примере используется линейный график, но параметры применяются и к другим визуализациям.

1. В Дашбордах создайте дашборд.
2. Выберите соответствующий значок и в разделе Библиотека меню выберите График среднего CPU across всех хостов.
3. На панели редактирования выберите вкладку Визуализация и выберите Линия.
4. Разверните Единицы и форматы.
   • Одна строка уже определена на основе метаданных из avg(dt.host.cpu.usage).
5. Чтобы переопределить настройки единиц измерения для этого поля, откройте левое меню в этой строке, чтобы отобразить настройки единиц измерения.
6. Определите переопределение для отображаемой метрики. Вы можете наблюдать свои изменения на оси Y графика.
   • Единица измерения отображает Процент, который является единицей измерения по умолчанию для выбранной метрики.
   • Включите Конвертировать, чтобы попробовать настройки преобразования. Например, измените Авто на Один, чтобы отобразить результат как долю от 1.
   • Десятичные знаки отображает количество десятичных знаков по умолчанию (степень точности) для отображения. Например, введите Pct и просмотрите дашборд, чтобы увидеть Pct вместо % после процентного значения.
   • Включите Пользовательский суффикс, чтобы попробовать разные суффиксы для отображения после единицы измерения. Например, измените выбор Десятичных знаков и просмотрите дашборд, чтобы увидеть изменение в количестве десятичных знаков в процентном значении.
7. Чтобы сбросить к значениям по умолчанию (отменить настройки переопределения для выбранной метрики), откройте меню Действия для этой строки и выберите Сбросить.

Ссылки

Используйте раздел Ссылки для управления пользовательскими ссылками из вашего дашборда или блокнота.

Добавление ссылки

Чтобы добавить ссылку

1. Откройте раздел Ссылки на вкладке визуализации вашей выбранной визуализации.
2. Выберите соответствующий значок, чтобы открыть Добавить ссылку.
3. Настройте ссылку:
   • Имя: введите описательное имя, такое как «Перейти к хосту», для отображения в меню.
   • Значок: выберите значок, например «Логи», чтобы представить ссылку в меню.
   • URL: используйте динамические заполнители для вставки полей данных или переменных. Например, выберите Вставить заполнитель и добавьте заполнитель :name к вашему URL, например https://myhost/host=Name.
   • Используйте раздел Предварительный просмотр в нижней части, чтобы увидеть, как заполнители будут заменены фактическими данными, и протестировать вашу ссылку.
4. Выберите Добавить ссылку, чтобы сохранить. Ссылка теперь появится в меню всплывающей подсказки визуализации.

Ссылки: дополнительные действия

• Чтобы добавить строку, выберите соответствующий значок и настройте её, как описано в разделе «Добавить ссылку».
• Чтобы переместить строку вверх или вниз в таблице, выберите и перетащите.
• Соответствующий значок открывает меню дополнительных опций:
  • Редактировать отображает поля ссылки для редактирования, как описано в разделе «Добавить ссылку».
  • Дублировать создаёт копию выбранной строки.
  • Удалить удаляет строку.

Подробности см. в разделе «Ссылка из визуализации через пользовательские ссылки».

Ограничения запроса

Используйте раздел Ограничения запроса, чтобы проверить и настроить ограничения запроса к хранилищу на раздел блокнота или плитку дашборда. Эти настройки определяют максимальные ограничения при извлечении данных. Превышение любого ограничения вызовет предупреждение.

Плитки дашборда и разделы блокнота, созданные в Ключ-АСТРОМ раньше версии 1.296, не затрагиваются. Эти существующие плитки/разделы будут возвращать те же результаты, что и раньше.

• Ограничение чтения данных (ГБ)
  • Ограничение в гигабайтах для объёма данных, который будет просканирован во время чтения.
• Ограничение записей
  • Максимальное количество записей результата, которое вернёт этот запрос. По умолчанию: 1 000 записей. Чтобы увидеть больше записей, вам нужно увеличить значение Ограничения записей.

Если ваш запрос не имеет ограничения, такое как

fetch logs

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

fetch logs
| limit 2000

применяется меньшее из двух значений (либо ограничение в вашем запросе, либо Ограничение записей в веб-интерфейсе).

В приведённом выше примере вы всё равно увидите только 1 000 записей, если не увеличите значение Ограничения записей.

• Ограничение размера результата
  • Максимальное количество байтов результата, которое вернёт этот запрос. Для лучшей производительности с типичными запросами и меньшими документами по умолчанию установлено 1 МБ.
• Выборка (только логи и спаны)
  • Приводит к выбору подмножества записей логов или спанов.