旧版 URL 别名编辑

本页介绍旧版 URL 别名:它们是什么,它们从哪里来,以及如何禁用它们。

概述编辑

许多保存对象类型在 Kibana 8.0 中进行了转换,因此它们最终可以在 空间 之间共享。在 8.0 之前,您可以在两个不同的空间中拥有两个具有相同类型和相同 ID 的对象。此转换的一部分是确保给定类型的所有对象 ID 在 所有空间中全局唯一

Kibana 为每个需要新 ID 的保存对象创建一个名为 旧版 URL 别名 的特殊实体。此旧版 URL 别名允许 Kibana 保留这些对象的任何深层链接 URL。

示例编辑

考虑以下场景

您有 Kibana 7.16,并且您创建了一个新的仪表板。此仪表板的 ID 为“123”。您创建一个名为“Bill 的空间”的新空间,并将您的仪表板 复制 到另一个空间。现在您有两个不同的仪表板,可以通过以下 URL 访问:

  • 默认空间: https://127.0.0.1:5601/app/dashboards#/view/123
  • Bill 的空间: https://127.0.0.1:5601/s/bills-space/app/dashboards#/view/123

您经常使用这两个仪表板,因此您在 Web 浏览器中将其添加为书签。一段时间后,您决定升级到 Kibana 8.0。当这两个仪表板经过转换过程时,“Bill 的空间”中的仪表板的 ID 将更改为“456”。访问该仪表板的 URL 不同——不用担心,该仪表板有一个旧版 URL 别名。

如果您使用书签通过旧 URL 访问该仪表板,Kibana 会检测到您正在使用旧版 URL,并找到新的对象 ID。如果您导航到 https://127.0.0.1:5601/s/bills-space/app/dashboards#/view/123,您将看到一条消息,表明该仪表板有一个新的 URL,并且您将自动重定向到 https://127.0.0.1:5601/s/bills-space/app/dashboards#/view/456

处理错误编辑

旧版 URL 别名旨在完全透明,但在某些情况下,这可能会导致错误。例如,您可能有一个仪表板,其中一个可视化效果无法加载,导致您被重定向到此页面。如果您在此情况下遇到错误,您可能希望完全禁用旧版 URL 别名。这会保留保存的对象,并且您不会丢失任何数据——您只是无法使用旧 URL 访问该保存的对象。

要禁用旧版 URL 别名,您需要三个信息:targetSpacetargetTypesourceId。然后使用 _disable_legacy_url_aliases API 禁用有问题的旧版 URL 别名。