+++
title = "Рекомендации по созданию информационных панелей"
description = "Рекомендации по созданию информационных панелей в Harvest"
weight = 100
+++

# Лучшие практики создания информационных панелей

На этой странице описаны некоторые рекомендации, которым следует следовать при создании информационных панелей Harvest.

## Прежде чем вы начнете

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

### Панель инструментов должна рассказывать историю или отвечать на вопрос

Какую историю вы пытаетесь рассказать с помощью своей приборной панели? Попробуйте создать логическую последовательность данных, например, от больших к маленьким или от общего к частному. Какова цель этой приборной панели? (Подсказка: если у информационной панели нет цели, спросите себя, действительно ли она вам нужна.)

Держите свои графики простыми и сосредоточенными на ответе на вопрос, который вы задаете. Например, если ваш вопрос «какие серверы в беде?», возможно, вам не нужно показывать все данные сервера. Просто покажите данные тем, у кого проблемы.

### Информационные панели должны снижать когнитивную нагрузку, а не увеличивать ее

Когнитивная нагрузка — это, по сути, то, насколько усердно вам нужно думать о чем-то, чтобы понять это. Сделайте панель управления удобной для понимания. Другие пользователи и вы в будущем (когда будете пытаться выяснить, что сломалось в 2 часа ночи) оценят это.

Спроси себя:
- Могу ли я сказать, что именно представляет каждый график? Это очевидно, или мне нужно подумать об этом?
- Если я покажу это кому-то другому, сколько времени им потребуется, чтобы понять это? Они потеряются?

### Иметь стратегию мониторинга

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

См. [Общие стратегии наблюдаемости]({{< relref "common-observability-strategies.md" >}}) и [Уровни зрелости управления информационной панелью]({{< relref "dashboard-management-maturity-levels.md" >} }) Чтобы получить больше информации.

### Запиши это

Когда у вас есть стратегия или рекомендации по дизайну, запишите их, чтобы поддерживать согласованность с течением времени. Ознакомьтесь с этим [примером Runbook Wikimedia] (https://wikitech.wikimedia.org/wiki/Performance/Runbook/Harvest_best_practices).
## Рекомендации к следованию

- При создании новой панели мониторинга убедитесь, что она имеет осмысленное имя.
  - Если вы создаете дашборд для игры или эксперимента, то поставьте в названии слово `ТЕСТ` или `ТМП`.
  - Рассмотрите возможность включения вашего имени или инициалов в название информационной панели или в качестве тега, чтобы люди знали, кому принадлежит эта информационная панель.
  - Удалите временные панели экспериментов, когда вы закончите с ними.
- Если вы создаете много связанных информационных панелей, подумайте, как сделать на них перекрестные ссылки для облегчения навигации. Дополнительные сведения см. в [Рекомендации по управлению информационными панелями]({{< relref "best-practices-for-managing-dashboards.md" >}}).
- Harvest извлекает данные из источника данных. Базовое понимание [источников данных]({{< relref "../datasources/_index.md" >}}) в целом и вашей специфики важно.
- Избегайте ненужного обновления панели управления, чтобы снизить нагрузку на сеть или серверную часть. Например, если ваши данные меняются каждый час, вам не нужно устанавливать частоту обновления панели мониторинга на 30 секунд.
- Используйте левую и правую оси Y при отображении временных рядов с разными единицами измерения или диапазонами.
- Добавление документации на информационные панели и панели.
   - Чтобы добавить документацию на панель инструментов, добавьте на панель [Визуализация панели текста]({{< relref "../panels/visualizations/text-panel.md" >}}). Запишите такие сведения, как назначение панели мониторинга, полезные ссылки на ресурсы и любые инструкции, которые могут потребоваться пользователям для взаимодействия с панелью мониторинга. Посмотрите этот [пример из Викимедиа](https://harvest.wikimedia.org/d/000000066/resourceloader?orgId=1).
   - Чтобы добавить документацию к панели, [измените настройки панели]({{< relref "../panels/add-a-panel.md#edit-panel-settings" >}}) и добавьте описание. Любой добавленный вами текст появится, если вы наведете курсор на маленькую букву «i» в верхнем левом углу панели.
- Повторно используйте свои информационные панели и обеспечьте согласованность с помощью [шаблонов и переменных]({{< relref "../variables/_index.md" >}}).
- Будьте осторожны с данными графа стека. Визуализации могут вводить в заблуждение и скрывать важные данные. Мы рекомендуем отключать его в большинстве случаев.