实例运维

更新时间:
复制 MD 格式

Agent 引擎版的日常运维包括实例监控、Collection 权限配置和备份恢复。

集群监控

在控制台实例详情页的左侧导航栏选择监控与日志 > 集群监控,可以查看实例的运行指标。配置告警阈值时,应根据业务 SLO 和压测基线设置,具体指标名称和告警入口以控制台为准。

常用观测项与控制台指标的对应关系如下。

观测目标

控制台指标

维度

写入吞吐

集群写入 QPS

集群级

写入延迟

集群写入的平均耗时

集群级

查询吞吐

集群查询 QPS

集群级

查询延迟

集群搜索的平均耗时

集群级

CPU 使用率

节点 CPU 使用率_ES 业务、节点 CPU 使用率_总

节点级

堆内存使用率

节点堆内存使用率_ES 业务

节点级

拒绝情况

写入线程池拒绝的任务数、查询线程池中被拒绝的请求数

线程池维度

集群监控页面按指标类别分组,不提供索引节点和查询节点的角色分组。需要分别观察两类节点时,请将“资源类型”切换为指定节点,再根据节点名筛选:索引节点名包含 -index-,查询节点名包含 -search-。Agent 引擎版没有 Warm 节点,只需关注索引节点和查询节点。

Collection 权限

操作

所需权限

创建、更新、删除 Collection 或 Slice

Collection 上的索引权限 manage

预创建 Backing

Collection 上的索引权限 manage

调用 POST /{collection}/_warm_slice 预热 Slice

Collection 上的索引权限 manage

启动或取消 Copy Slice

Collection 上的索引权限 manage

创建 Branch Slice(Beta)

Collection 上的索引权限 manage

创建和修改 Collection Alias

Collection 名和 Alias 名上的索引权限 manage

获取 Collection、查询或列出 Slice、使用 CAT、查询 Copy 状态

Collection 上的索引权限 monitor

调用 POST /{collection}/_refresh 显式刷新 Collection

Collection 上的索引权限 maintenance。该权限还包含 flush 和 forcemerge,只授予运维或导入任务账号,不要授予在线应用账号;显式刷新影响整个 Collection 的全部租户,使用条件见 Refresh 与查询可见性。

文档读写和查询

对应的索引权限 read 或 write

使用 GET /_tasks/{taskId} 查询异步预热任务

集群权限 monitor

配置角色时,通常需要同时授予 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 滚动创建。如果备份期间发生了上述变更,应重新制作备份。