用途:kibana-connectors 用于在 Kibana 中创建、更新、查询和删除连接器,把 Elastic 告警规则的动作路由到第三方系统。连接器按 Kibana Space 管理,可在该空间内所有规则间共享。
主要能力:支持 LLM 提供商、事件管理(PagerDuty、Opsgenie、ServiceNow、Jira 等)、终端安全、消息(Slack、Teams、Email)、日志与可观测性、通用 Webhook、Index、Cases 等类别。连接器可作为告警通知之外的集成层,用于 ITSM 工单、值班升级、案例管理、审计日志与 AI 工作流。
使用方式:REST API 基础路径为 <kibana_url>/api/actions,非默认空间使用 /s/<space_id>/api/actions。创建连接器使用 POST /api/actions/connector/{id},需提供 name、connector_type_id、config、secrets 字段;查询列表用 GET /api/actions/connectors;测试连通性用 POST /api/actions/connector/{id}/_execute。所有变更请求须带 kbn-xsrf: true 请求头,并使用 API Key 或 Basic 认证。也可用 Terraform 资源 elasticstack_kibana_action_connector 管理,config 与 secrets 需用 jsonencode() 编码。自管理 Kibana 可在 kibana.yml 中通过 xpack.actions.preconfigured 预配置连接器。
限制与注意事项:connector_type_id 创建后不可修改;即使无密钥的 .index、.server-log 也须传 "secrets": {};删除前应检查 referenced_by_count,避免引用它的规则动作静默失败;密钥为只写,导出/导入后需重新提供;预配置连接器不能通过 API 或 UI 修改删除;部分类型需要 Gold、Platinum 或 Enterprise 许可,具体以 GET /api/actions/connector_types 返回的 minimum_license_required 为准。Terraform 中密钥会存入 state,需使用加密远程后端。代理、TLS 等网络设置可通过 xpack.actions.proxyUrl 与 xpack.actions.customHostSettings 配置。