Kibana 连接器用于存储 Elastic 服务与第三方系统的连接信息,告警规则通过连接器在条件满足时发送通知。连接器按 Kibana 空间管理,可在该空间内所有规则间共享。
主要能力:可创建、更新、查询、删除连接器并直接执行测试;覆盖 LLM 提供商、事件管理、端点安全、消息通知、日志观测、Webhook、Cases 等类别。API 基础路径为 <kibana_url>/api/actions,非默认空间为 /s/<space_id>/api/actions。创建连接器需提供 name、connector_type_id、config、secrets 字段,示例:curl -X POST "https://my-kibana:5601/api/actions/connector/my-slack-connector" 并携带 kbn-xsrf: true 与认证头。
使用方式:所有 API 调用需 API key 或 Basic 认证,且每个变更请求必须包含 kbn-xsrf: true,否则返回 400。连接器需具备 Actions and Connectors 相关权限。可用 GET /api/actions/connectors 列出连接器并查看 referenced_by_count,用 GET /api/actions/connector_types 发现可用类型,用 POST /api/actions/connector/{id}/_execute 测试连通性。也可通过 elasticstack 提供者的 elasticstack_kibana_action_connector 资源以 Terraform 管理,config 与 secrets 需用 jsonencode() 编码。
适用场景:ITSM 工单、值班升级、案例管理、消息通知、审计日志、AI 工作流和自定义 Webhook 集成。
限制:connector_type_id 创建后不可修改;删除被规则引用的连接器会导致动作静默失败;secrets 为只写,GET 不返回,导出导入会丢失;预配置连接器不能通过 API 或 UI 修改删除;Terraform 导入不会恢复 secrets;部分连接器类型需要更高许可证。建议先测试再挂载规则,并配置恢复动作与去重键。