앱 플러그인 페이지의 내비게이션 배치 커스터마이즈

기본적으로 Grafana 앱 플러그인과 그 페이지는 내비게이션 메뉴의 "More apps" 섹션 아래 나타나요. 관리자는 특정 페이지나 플러그인 전체를 더 관련성 높은 내비게이션 섹션으로 옮겨 사용자 경험을 개선할 수 있어요. 이 문서에서 그 방법을 알려드릴게요.

출처: 문서

본문

앱 플러그인 페이지의 위치는 두 가지 방법으로 바꿀 수 있어요.

앱 플러그인 전체(모든 페이지 포함)를 다른 섹션으로 이동
앱 플러그인의 특정 페이지만 다른 섹션으로 이동

1. 앱 플러그인 전체를 다른 섹션으로 이동

구성 파일에서 navigation.app_sections 설정을 사용하세요.

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

이 구성은:

ID가 org-example-app인 앱 플러그인을
explore 섹션에 배치하고
정렬 가중치(sort weight) 100을 부여합니다(해당 섹션 내 위치 결정).

2. 개별 앱 페이지를 다른 섹션으로 이동

navigation.app_standalone_pages 설정을 사용해 앱 플러그인의 특정 페이지를 다른 섹션으로 옮길 수 있어요.

[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으로 이동

완전한 예시

앱 배치와 개별 페이지 배치를 모두 구성하는 예시입니다.

# 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을 확인하면 됩니다.

문제 해결

내비게이션 변경이 반영되지 않으면:

구성 문법이 올바른지 확인하세요.
변경 후 Grafana를 재시작했는지 확인하세요.
플러그인 ID와 페이지 경로가 플러그인에 정의된 것과 정확히 일치하는지 확인하세요.