Agent 引擎版的日常运维包括实例监控、Collection 权限配置和备份恢复。
集群监控
在控制台实例详情页的左侧导航栏选择监控与日志 > 集群监控,可以查看实例的运行指标。配置告警阈值时,应根据业务 SLO 和压测基线设置,具体指标名称和告警入口以控制台为准。
常用观测项与控制台指标的对应关系如下。
|
观测目标 |
控制台指标 |
维度 |
|
写入吞吐 |
集群写入 QPS |
集群级 |
|
写入延迟 |
集群写入的平均耗时 |
集群级 |
|
查询吞吐 |
集群查询 QPS |
集群级 |
|
查询延迟 |
集群搜索的平均耗时 |
集群级 |
|
CPU 使用率 |
节点 CPU 使用率_ES 业务、节点 CPU 使用率_总 |
节点级 |
|
堆内存使用率 |
节点堆内存使用率_ES 业务 |
节点级 |
|
拒绝情况 |
写入线程池拒绝的任务数、查询线程池中被拒绝的请求数 |
线程池维度 |
集群监控页面按指标类别分组,不提供索引节点和查询节点的角色分组。需要分别观察两类节点时,请将“资源类型”切换为指定节点,再根据节点名筛选:索引节点名包含 -index-,查询节点名包含 -search-。Agent 引擎版没有 Warm 节点,只需关注索引节点和查询节点。
Collection 权限
|
操作 |
所需权限 |
|
创建、更新、删除 Collection 或 Slice |
Collection 上的索引权限 |
|
预创建 Backing |
Collection 上的索引权限 |
|
调用 |
Collection 上的索引权限 |
|
启动或取消 Copy Slice |
Collection 上的索引权限 |
|
创建 Branch Slice(Beta) |
Collection 上的索引权限 |
|
创建和修改 Collection Alias |
Collection 名和 Alias 名上的索引权限 |
|
获取 Collection、查询或列出 Slice、使用 CAT、查询 Copy 状态 |
Collection 上的索引权限 |
|
调用 |
Collection 上的索引权限 |
|
文档读写和查询 |
对应的索引权限 |
|
使用 |
集群权限 |
配置角色时,通常需要同时授予 Collection 名和底层 Backing 的访问权限:
<collection>
.sc-<collection>-*
例如 Collection 名为 knowledge-chunks 时,可以在角色中配置 knowledge-chunks 和 .sc-knowledge-chunks-*。只配置 Collection 名时,单文档读写、MGet、显式 Refresh、_update_by_query 和 _delete_by_query 可能返回 HTTP 403。具体权限以接口要求为准,在线应用不应直接访问 Backing。
授权前先核对前缀重叠。 .sc-knowledge-chunks-* 也会匹配 knowledge-chunks-private 的 Backing,因此该模式不能单独保证 Collection 间的严格隔离。.sc-* 范围更大,不应作为默认最小授权配置。
-
应用访问原则:应用应始终通过 Collection 名访问数据,不要直接访问或保存 Backing Index 名称。直接访问 Backing 不经过 Collection 的逻辑入口和
_slice范围改写,一次可以读取该 Backing 中全部 Slice 的数据。 -
严格隔离:如果需要在 Collection 之间严格隔离凭据,不能只依靠当前 Backing 名通配符。请通过避免 Collection 名的前缀重叠、平台或应用层的独立隔离来实现,并在权限变更后验证实际可访问的索引范围。
-
租户隔离和凭据:Slice 不是租户权限隔离边界,当前权限模型无法为单个租户签发只能读取其自身 Slice 的 Elasticsearch 账号。租户级鉴权和数据范围限制必须在应用层完成,Elasticsearch 账号凭据不应直接下发给最终用户。
manage 同时覆盖 Collection 管理、预热和删除等操作。在线读写账号通常只授予 read 和 write;预热、预创建 Backing、Copy、Branch 及 Collection/Slice 管理建议由单独的服务账号或运维任务发起,并限制其可访问的 Collection。如果业务必须由在线应用直接预热,需要接受该账号同时具备这些管理能力,并在应用层限制管理接口的调用。
Collection 备份与恢复
Collection 提供完整命名空间的备份恢复方案,即一起备份和恢复实例内的全部 Collection,当前由技术支持通过工单协助执行。暂不支持只恢复其中一个 Collection 或 Slice,也不支持在恢复时重命名 Collection。
恢复前,目标实例中应不存在 Collection,也不能遗留与备份同名的底层索引。请在上线前通过工单提供源实例、恢复目标及备份需求,由技术支持核对版本、存储条件和全局配置影响,并安排备份窗口。
备份期间,已有 Slice 中的普通文档读取、查询、写入、更新和删除可以继续。 从备份开始到完成,需要暂停以下管理操作:
-
创建、更新或删除 Collection;
-
注册或删除 Slice,包括首次写入触发的自动注册;
-
滚动创建或切换 Backing;
-
创建 Branch Slice(Beta)。
请由技术支持协助协调这些操作,包括可能自动触发的 Slice 注册和 Backing 滚动创建。如果备份期间发生了上述变更,应重新制作备份。