在运行时设置更新
注意:8.0及以后版本中可用Grafana企业。
通过在运行时更新设置,您可以更新Grafana设置而无需重新启动Grafana服务器。
更新发生在运行时存储在数据库和覆盖设置从其他来源(参数、环境变量设置文件等)。因此,每次删除特定的设置键在运行时,使用的价值,关键是继承了一个来自其他来源的相反的顺序优先级(参数> >环境变量设置文件
)。时没有提供这些选项的值,然后应用程序将使用默认值
目前,它仅支持更新auth.saml
部分。
通过API更新设置
你可以通过更新设置管理API。
当你提交一个设置更新通过API, Grafana验证如果给定设置允许更新和有效。如果它们,那么Grafana设置存储在数据库和重新加载Grafana服务而无需重新启动实例。
的有效载荷把
请求更新设置端点(/ api /管理/设置
)应包含(一个或两个):
- 一个
更新
与一个关键地图,每部分你想要设置的值。 - 一个
删除
每部分你想设置键列表。
例如,如果您提供以下更新
:
{"更新":{“身份验证。saml”:{“启用”:“真正的”,“single_logout”:“false”}}}
它将使SAML和禁用单注销。如果你提供以下删除
:
{"删除":{“身份验证。saml”(“allow_idp_initiated”):}}
将被删除的键/值设置allow_idp_initiated
在auth.saml
。所以,SAML服务将重新加载,价值将继承(设置. ini
命令行参数文件,环境变量,或任何其他接受机制来提供配置)。
因此,完整的HTTP负载会看起来像:
{"更新":{“身份验证。saml”:{“启用”:“真正的”,“single_logout”:“false”}},“删除”:{“身份验证。saml”(“allow_idp_initiated”):}}
如果不能覆盖这些设置有效,它将返回一个错误,这些设置不会被持久化到数据库中。
背景工作(高可用性的设置)
Grafana企业有一个内置的调度后台作业看起来为设置更新到数据库中每一分钟。如果有更新,它重新加载Grafana服务检测到变化的影响。
后台工作同步设置实例之间在一个高度可用的设置。因此,通过HTTP API进行一些修改后,然后其他实例通过数据库和后台同步工作。