kibana-dashboards
Навык kibana-dashboards от Elastic предназначен для декларативного создания и управления Kibana dashboards и визуализациями. Его основной акцент — определения, которые удобно хранить в Git: payload остаётся минимальным, diff показывает существенные изменения, а повторяемый формат подходит для GitOps-процессов и генерации с помощью AI-агента. В метаданных SKILL.md указаны автор Elastic и версия 0.1.2. Источник отдельно предупреждает, что требование к платформе — Kibana 9.4+ (SNAPSHOT), поэтому эту карточку нельзя трактовать как обещание совместимости со всеми версиями Kibana. Работа начинается с проверки соединения командой node scripts/kibana-dashboards.js test. Если проверка неуспешна, исходный навык предписывает остановиться и сначала настроить подключение. Поддержаны несколько вариантов окружения: Elastic Cloud через KIBANA_CLOUD_ID и KIBANA_API_KEY, прямой URL через KIBANA_URL и API key, Basic Authentication с KIBANA_USERNAME и KIBANA_PASSWORD, а также локальная установка через start-local. Для разработки допускается KIBANA_INSECURE=true, но это явно обозначено как режим для development. Таким образом, навык сначала проверяет доступность API, а уже потом предлагает операции dashboard get/create/update/delete/upsert и операции со standalone visualization. Формат dashboard использует корневые title и panels; дополнительно могут задаваться time_range. Панель описывается type, необязательным уникальным id, обязательным grid и конфигурацией. Рекомендуемый способ встраивания визуализаций — inline-определения внутри config: они самодостаточны и не зависят от ref_id. Сетка имеет 48 колонок и неограниченное число строк. В исходных правилах отдельно требуется рассчитывать нижнюю границу каждой панели y + h, не оставлять вертикальные зазоры и выравнивать высоту соседних панелей, когда они образуют общий ряд. Это полезно для плотных дашбордов, где ключевые показатели и тренды должны оставаться видимыми без случайного пустого пространства. Для визуализаций описаны metric, xy, gauge, heatmap, tag_cloud, data_table, region_map и ряд partition-графиков, включая pie, treemap, mosaic и waffle. Источником данных может быть data view reference, ES|QL или index-паттерн. У ES|QL запрос сам формирует агрегированные колонки, а конфигурация визуализации ссылается на их имена. Существенное ограничение: ES|QL-визуализацию нельзя создавать через /api/visualizations; для неё нужно использовать inline-панель в Dashboard API. Для панелей также рекомендуется inline вместо ref_id, поскольку такой вариант надёжнее и переносимее. Навык помогает описать и развернуть проверяемую структуру, но не заменяет проверку прав доступа, наличие индексов и data views, тестирование запросов, оценку полезности метрик или эксплуатационный мониторинг Kibana.
Для чего подходит
- Проектирование Kibana dashboards
- Версионирование визуализаций в Git
- Автоматизация развёртывания через API
Установка
Сначала прочитайте SKILL.md и scripts в исходном репозитории. Затем выполните команду в каталоге проекта:
npx skills add https://github.com/elastic/agent-skills/tree/main/plugins/kibana/skills/kibana-dashboards