SuperAPI AI 工具集

kibana-streams

数据与分析

查看项目

更新于 10-15 21:37

技能介绍

用途:通过 Kibana Streams REST API 查看和管理数据流(Streams)。Streams 是 Kibana 中管理数据的实验性方式,API 与行为可能变化。该技能覆盖读取操作与生命周期操作;创建、更新、删除、fork 及其他变更操作可能在未来版本加入。

主要能力: 读取:列出全部流(GET /api/streams)、获取单个流(GET /api/streams/{name})、读取摄取设置(GET /api/streams/{name}/_ingest)、查询设置(GET /api/streams/{name}/_query)、流的查询(GET /api/streams/{name}/queries)、重要事件(GET /api/streams/{name}/significant_events)、附件(GET /api/streams/{streamName}/attachments,如仪表板、规则、SLO)。 生命周期:禁用(POST /api/streams/_disable)、启用(POST /api/streams/_enable)、重新同步(POST /api/streams/_resync)。

使用方式:向 <kibana_url>/api/streams 发起 GET 或 POST;非默认空间使用 /s/{space_id}/api/streams。读取操作通常无需额外请求头;生命周期操作属变更类,需按 Kibana 版本要求发送 kbn-xsrf: true。认证使用 API key 或基本认证。读取需 read_stream 权限,生命周期 API 需 manage_stream 权限。示例: curl -X GET "${KIBANA_URL}/api/streams" -H "Authorization: ApiKey <base64-api-key>"

摄取设置含两个生命周期区域:流生命周期(ingest.lifecycle),用 lifecycle.dsl.data_retention(如 "30d")控制数据保留,或 lifecycle.inherit 供子流继承,用户说“设置保留”通常指此项;失败存储生命周期(ingest.failure_store.lifecycle)仅控制处理失败文档的保留,除非用户明确提及失败存储或失败文档,否则不应只改此项。

限制:禁用流可能导致 wired 流数据丢失(禁用 API 会删除 wired 流数据,classic 流数据保留),调用前应警告用户并确认已备份或不再需要数据。仅需检查流状态时优先使用读取操作。创建、更新、删除、fork、批量查询管理、附件管理等变更操作本技能不支持。详细端点和参数见 references/streams-api-reference.md。