Kibana 升级后可视化图表无法显示如何迁移保存对象

文章导读
Kibana 升级后可视化图表无法显示,通常是因为保存对象(Saved Objects)与新版本的数据视图(Data Views)或索引模式不兼容。优先使用 Kibana 自带的 Upgrade Assistant 处理,必要时配合 API 导出导入。
📋 目录
  1. 升级前检查清单
  2. 界面迁移步骤
  3. API 迁移实操命令
  4. 验证与日志排查
  5. 常见报错与解决方案
  6. 参考来源
A A

Kibana 升级后可视化图表无法显示,通常是因为保存对象(Saved Objects)与新版本的数据视图(Data Views)或索引模式不兼容。优先使用 Kibana 自带的 Upgrade Assistant 处理,必要时配合 API 导出导入。

先说结论:大部分显示问题源于索引模式变更或对象元数据过期,迁移前务必备份配置与集群数据。

  • 先备份:操作前导出所有保存对象,同时保留 Elasticsearch 集群快照
  • 用助手:优先使用 Upgrade Assistant 自动修复兼容性问题
  • 再验证:迁移后逐个打开仪表盘确认图表渲染正常

升级前检查清单

在执行升级操作前,请确认以下事项以降低迁移风险:

  • 版本兼容性:查阅官方兼容性矩阵,避免跨大版本过大(如直接从 6.x 跳到 8.x),建议按主版本逐级升级。
  • 集群快照:这是配置回滚的重要依据之一,建议同时保留集群快照,防止数据丢失。
  • 插件检查:第三方可视化插件在升级后可能不兼容,需确认插件支持新版本。

界面迁移步骤

第一步:全量备份保存对象

在升级前,进入 Kibana 管理界面,选择 Management > Saved Objects,点击 Export 全部导出。

Kibana 升级后可视化图表无法显示如何迁移保存对象

第二步:使用 Upgrade Assistant

升级完成后,登录 Kibana,进入 Management > Upgrade Assistant。按照指引执行迁移脚本,它会自动修复大部分已知的对象格式问题。若状态显示为 "Ready to upgrade",点击 "Run migrations" 开始处理。

第三步:手动修复引用

如果图表仍不显示,检查对象依赖的 Data View 是否存在。若不存在,需重新创建索引模式并通过 API 更新对象引用或重新创建可视化配置。

Kibana 升级后可视化图表无法显示如何迁移保存对象

API 迁移实操命令

如果不方便使用界面操作,可以通过 Saved Objects API 进行导出导入。以下命令示例基于默认本地环境,请根据实际情况调整 host 和认证信息。

导出保存对象:

curl -X POST "http://localhost:5601/api/saved_objects/_export" \
-H "kbn-xsrf: true" \
-H "Content-Type: application/json" \
-d '{"type":["dashboard","visualization","search"]}' \
`--output` saved_objects.ndjson

导入保存对象:

Kibana 升级后可视化图表无法显示如何迁移保存对象
curl -X POST "http://localhost:5601/api/saved_objects/_import" \
-H "kbn-xsrf: true" \
`--form` file=@saved_objects.ndjson

验证与日志排查

打开迁移后的 Dashboard,观察每个面板是否加载数据。查看浏览器控制台(Console)是否有 API 报错,同时检查 Kibana 日志文件中是否有 saved object migration 相关的警告信息。

日志检查命令:

tail -f /var/log/kibana/kibana.log | grep -i "migration"

常见报错与解决方案

报错信息可能原因解决方案
Index pattern not found索引模式 ID 变更或丢失重新创建 Data View 并更新可视化引用
Mapping conflictElasticsearch 端字段类型改变检查 ES Mapping,必要时重建图表
Plugin not loaded第三方插件不兼容升级插件或暂时禁用该可视化

参考来源

1. Elastic 官方文档 - Upgrading Kibana
URL: https://www.elastic.co/guide/en/kibana/current/upgrading.html

2. Elastic 官方文档 - Saved Objects Management
URL: https://www.elastic.co/guide/en/kibana/current/saved-objects-management.html