菜单
文档breadcrumb arrow Grafana 文档breadcrumb arrow 管理breadcrumb arrow 插件管理breadcrumb arrow 自定义插件页面的导航位置
Enterprise 开源 Grafana Cloud

自定义应用插件页面的导航位置

默认情况下,Grafana 应用插件及其页面会出现在导航菜单的“更多应用”部分。然而,作为 Grafana 管理员,您可能希望通过将特定页面或整个应用插件重新定位到导航层级中更相关的部分来改善用户体验。本指南将向您展示如何在 Grafana 导航菜单的不同部分自定义应用插件页面的位置。

自定义应用和页面导航位置

您可以通过两种方式更改应用插件页面的位置

  1. 将整个应用插件(及其所有页面)移动到不同的部分
  2. 将应用插件中的特定页面移动到不同的部分

1. 将整个应用插件移动到不同的部分

要将整个应用插件重新定位到不同的导航部分,请在您的 Grafana 配置文件中使用 navigation.app_sections 配置

ini
[navigation.app_sections]
org-example-app = explore 100

此配置

  • 将 ID 为 org-example-app 的应用插件移动到
  • 将其放在 explore 部分
  • 为其分配排序权重 100(确定其在该部分中的位置)

2. 将单个应用页面移动到不同的部分

要将应用插件中的特定页面移动到不同的导航部分,请使用 navigation.app_standalone_pages 配置

ini
[navigation.app_standalone_pages]
/a/org-example-app/dashboard-page = dashboards 200
/a/org-example-app/monitoring-page = alerting 50

此配置

  • 将路径为 /a/org-example-app/dashboard-page 的页面移动到 dashboards 部分,排序权重为 200
  • 将路径为 /a/org-example-app/monitoring-page 的页面移动到 alerting 部分,排序权重为 50

完整示例

这是一个配置应用整体和单个页面位置的完整 Grafana 配置文件示例

ini
# Move the entire app to the Explore section
[navigation.app_sections]
org-example-app = explore 50

# Move specific pages to their own sections
[navigation.app_standalone_pages]
/a/org-example-app/metrics = dashboards 100
/a/org-example-app/logs = alerting 75

理解页面路径

要移动单个页面,您需要知道它们的路径。应用插件中的页面路径遵循以下格式:/a/PLUGIN_ID/PAGE_PATH

您可以通过在浏览器中访问页面并观察地址栏中的 URL 来识别插件页面路径。

故障排除

如果您的导航更改未生效

  1. 验证您的配置语法是否正确
  2. 确保在进行更改后已重启 Grafana
  3. 检查插件 ID 和页面路径是否与您插件中定义的完全一致