菜单
文档breadcrumb arrow Grafana 文档breadcrumb arrow 设置breadcrumb arrow 配置 Grafanabreadcrumb arrow 配置自定义品牌
Enterprise

配置自定义品牌

自定义品牌使您能够用您的企业品牌和徽标替换 Grafana Labs 的品牌和徽标。

注意

在 Grafana Enterprise 和 Grafana Cloud 中可用。对于 Cloud Advanced 和 Enterprise 客户，请将自定义元素和徽标提供给我们的支持团队。我们将协助您托管图像并更新您的自定义品牌设置。

此功能不适用于 Grafana Free 和 Pro 版本。有关不同计划功能可用性的更多信息，请参阅我们的功能比较页面

grafana.ini 文件包含 Grafana Enterprise 的自定义品牌配置。与所有配置选项一样，您可以使用环境变量来设置自定义品牌。

通过自定义品牌，您可以修改以下元素

  • 应用程序标题
  • 登录背景
  • 登录徽标
  • 侧边菜单顶部徽标
  • 页脚和帮助菜单链接
  • Fav icon（浏览器标签页中显示）
  • 登录标题（如果设置了登录徽标，则不会显示）
  • 登录副标题（如果设置了登录徽标，则不会显示）
  • 登录框背景
  • 加载徽标

您需要单独托管自定义品牌功能使用的徽标和其他图像。请确保 Grafana 可以访问存储这些资源的 URL。

Grafana Enterprise 的配置文件包含以下选项。有关配置 Grafana 的更多信息，请参阅配置 Grafana。

ini 
# 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 =

您可以选择添加自定义链接来替换默认页脚链接（文档、支持、社区）。下面是替换默认页脚和帮助链接为自定义链接的示例。

ini 
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

以下示例展示了如何使用环境变量而不是 custom.ini 或 grafana.ini 文件来配置自定义品牌。

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 版本
  • 带有构建号的 Grafana 版本

如果您指定 footer_links 或 GF_WHITE_LABELING_FOOTER_LINKS，则所有其他默认链接将从页脚中移除，仅包含您指定的链接。

共享仪表盘的自定义品牌

除了下面描述的自定义设置，您还可以自定义共享仪表盘的页脚。要自定义共享仪表盘的页脚，请在 grafana.ini 文件中添加以下部分。

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，则所有其他值将被忽略，因为页脚将不会显示。