kibana-connectors
kibana-connectors — официальный навык Elastic для создания и сопровождения Kibana connectors. Connector хранит параметры подключения к Elastic или внешнему сервису, а alerting rules используют его для доставки actions. Объекты принадлежат Kibana Space: в одном пространстве их можно переиспользовать несколькими правилами, а при работе с непубличным пространством API получает префикс /s/{space_id}. Навык подходит для Slack, PagerDuty, Jira, webhooks, email, ServiceNow, Opsgenie и других интеграций, а также для отдельных LLM-провайдеров и observability-сценариев, если такой connector type доступен в установленной версии Kibana. Перед созданием нужно определить space, имя, connector_type_id, несекретную config и секретную часть secrets. Для управления connectors требуются права на Actions and Connectors в Stack Management; запросы требуют API key или Basic auth. Любой изменяющий REST-запрос должен содержать заголовок kbn-xsrf. Секреты нельзя переносить в описания, логи или публичные конфигурационные примеры: их следует передавать только в ожидаемое поле API и проверять политику хранения выбранного окружения. Исходник описывает полный базовый цикл через REST API: получить список типов, создать connector, прочитать его, обновить, удалить или выполнить connector. Базовый путь — /api/actions; например, создание использует /api/actions/connector/{id}, а запуск — /api/actions/connector/{id}/_execute. В Terraform connector можно поддерживать как код, если выбранный тип и версия provider это позволяют. До записи полезно получить текущий объект и список connector types, чтобы не предполагать идентификатор, конфигурацию или поддержку конкретной интеграции. Практическая настройка зависит от назначения. Slack, email и webhook обычно доставляют уведомления, PagerDuty и Jira передают события в incident workflow, а LLM connectors используются как часть соответствующих возможностей Kibana. Для каждого типа нужно сверить обязательные config и secrets, доступность endpoint и сетевой маршрут из Kibana. После изменения проверяются target space, права вызывающего субъекта, фактический execute и результат alerting rule; HTTP 200 создания сам по себе не доказывает доставку сообщения внешней системе. Ограничения следует учитывать заранее: набор connector types и отдельные функции зависят от версии Elastic, лицензирования и deployment; один connector не становится глобальным автоматически, если он создан в другом Space. Навык не выдаёт реальные API keys, не заменяет документацию конкретного провайдера и не разрешает отправлять тестовые уведомления в чужую production-систему. Без подтверждённых space, credentials, типа интеграции и безопасного test target запись должна быть остановлена до уточнения этих границ.
Для чего подходит
- Настройка интеграций Kibana
- Управление connectors через REST API
- Описание connectors как Terraform-кода
Установка
Сначала прочитайте SKILL.md и scripts в исходном репозитории. Затем выполните команду в каталоге проекта:
npx skills add https://github.com/elastic/agent-skills/tree/main/plugins/kibana/skills/kibana-connectors