커스텀 브랜딩 구성하기

커스텀 브랜딩 구성하기 (Configure custom branding)

커스텀 브랜딩으로 Grafana Labs의 브랜드와 로고를 회사 브랜드와 로고로 바꿀 수 있어요. 로그인 페이지 배경·로고·제목과 앱 타이틀·메뉴 로고·파비콘 등을 grafana.ini의 [white_labeling] 설정이나 환경 변수로 바꿀 수 있어요.

참고: Grafana Enterprise와 Grafana Cloud 유료 계정에서 사용할 수 있습니다. Grafana Cloud Free 플랜은 로그인 제목과 푸터 링크 커스터마이즈만 지원해요. Cloud 사용자는 Cloud Portal에서 Open a Support Ticket을 클릭해 티켓을 만들어 구성해야 합니다.

출처: 문서

본문

grafana.ini 파일에는 Grafana Enterprise 커스텀 브랜딩이 포함되어 있어요. 다른 구성 옵션과 마찬가지로 환경 변수로도 설정할 수 있습니다.

커스텀 브랜딩으로 변경할 수 있는 요소는 다음과 같아요.

  1. Login background (login_background) - 로그인 카드 뒤의 전체 페이지 배경. 유효한 CSS background 값(url() 포함) 허용.
  2. Login box background (login_box_background) - 로그인 폼 카드 배경. 유효한 CSS background 표현식 허용.
  3. Login logo (login_logo) - 로그인 카드 상단 로고. SVG(48x48픽셀 이하) 권장. 설정하면 로그인 제목·부제목이 표시되지 않아요.
  4. Login title (login_title) - 로그인 페이지 메인 제목. 기본 "Welcome to Grafana". 로그인 로고 설정 시 표시 안 됨.
  5. Login subtitle (login_subtitle) - 로그인 제목 아래 보조 텍스트. 기본 비어 있음. 로그인 로고 설정 시 표시 안 됨.
  6. Footer and help menu links (footer_links) - 로그인 페이지 하단 링크. 로그인한 뒤 Help 메뉴에도 동일하게 나타남. 기본: Documentation, Support, Community.

홈 페이지 관련 요소:

  1. Fav icon (fav_icon) - 브라우저 탭의 작은 아이콘. 기본 Grafana sunburst 아이콘.
  2. Application title (app_title) - 브라우저 탭의 모든 페이지 제목에 붙는 텍스트. 기본 "Grafana". 브라우저 탭과 메인 메뉴 헤더 이름을 모두 제어.
  3. Side menu top logo (menu_logo) - 앱 왼쪽 상단 로고(메인 메뉴 헤더에도 표시).
  4. Application title (app_title) - 메인 메뉴 헤더의 앱 이름(사이드 메뉴 로고 옆).

또한 초기 페이지 로딩 스플래시 화면에 나타나는 loading logo (loading_logo)도 커스터마이즈할 수 있어요.

로고·이미지는 별도로 호스팅해야 하며, Grafana가 자산이 저장된 URL에 접근할 수 있게 해야 합니다.

grafana.ini의 [white_labeling] 설정은 다음과 같습니다.

# Enterprise only
[white_labeling]
# Set to your company name to override application title
;app_title =

# Set to main title on the login page (Will not appear if a login logo is set)
;login_title =

# Set to login subtitle (Will not appear if a login logo is set)
;login_subtitle =

# Set to complete URL to override login logo
;login_logo =

# Set to complete CSS background expression to override login background
# example: login_background = url(http://www.bhmpics.com/wallpapers/starfield-1920x1080.jpg)
;login_background =

# Set to complete CSS background expression to override login box background
;login_box_background =

# Set to complete URL to override menu logo
;menu_logo =

# Set to complete URL to override fav icon (icon shown in browser tab)
;fav_icon =

# Set to complete URL to override apple/ios icon
;apple_touch_icon =

# Set to complete URL to override loading logo
;loading_logo =

# Set to `true` to remove the Grafana edition from appearing in the footer
;hide_edition =

login_logo는 48x48픽셀 이하 SVG를 권장합니다. login_logo에는 url() 함수가 필요 없어요. 로컬 Grafana 이미지 디렉터리 /usr/share/grafana/public/img/에 이미지를 복사하고 login_logo = /public/img/<YOUR_LOGO.svg>처럼 설정할 수도 있어요.

기본 푸터 링크(Documentation, Support, Community)를 커스텀 링크로 바꾸는 예시입니다.

footer_links = support guides extracustom
footer_links_support_text = Support
footer_links_support_url = http://your.support.site
footer_links_guides_text = Guides
footer_links_guides_url = http://your.guides.site
footer_links_extracustom_text = Custom text
footer_links_extracustom_url = http://your.custom.site

환경 변수로 구성하는 예시입니다.

GF_WHITE_LABELING_FOOTER_LINKS=support guides extracustom
GF_WHITE_LABELING_FOOTER_LINKS_SUPPORT_TEXT=Support
GF_WHITE_LABELING_FOOTER_LINKS_SUPPORT_URL=http://your.support.site
GF_WHITE_LABELING_FOOTER_LINKS_GUIDES_TEXT=Guides
GF_WHITE_LABELING_FOOTER_LINKS_GUIDES_URL=http://your.guides.site
GF_WHITE_LABELING_FOOTER_LINKS_EXTRACUSTOM_TEXT=Custom Text
GF_WHITE_LABELING_FOOTER_LINKS_EXTRACUSTOM_URL=http://your.custom.site

푸터에는 다음 두 링크가 항상 존재합니다: Grafana edition, Grafana version(빌드 번호 포함). footer_links나 GF_WHITE_LABELING_FOOTER_LINKS를 지정하면 다른 기본 링크는 모두 제거되고 지정한 링크만 포함됩니다.

공유 대시보드의 커스텀 브랜딩

공유 대시보드의 푸터도 커스터마이즈할 수 있어요. grafana.ini에 다음 섹션을 추가하세요.

[white_labeling.public_dashboards]

# Hides the footer for the shared dashboards if set to `true`.
# example: footer_hide = "true"
;footer_hide =

# Set to text shown in the footer
;footer_text =

# Set to complete url to override shared dashboard footer logo. Default is `grafana-logo` and will display the Grafana logo.
# An empty value will hide the footer logo.
;footer_logo =

# Set to link for the footer
;footer_link =

# Set to `true` to hide the Grafana logo next to the title
;header_logo_hide =

footer_hide를 true로 설정하면 푸터가 표시되지 않으므로 다른 모든 값은 무시됩니다.

더 알아보기 (Learn more)