这是文档下一个版本的Grafana。最新的稳定版本,去最新版本。
Grafana CLI
Grafana CLI是一个小的可执行文件,与Grafana绑定服务器。它可以在同一台机器上执行Grafana服务器上运行。Grafana CLI已经插件
和管理
命令,以及全球的选择。
列出所有命令和选项:
grafana cli - h
调用Grafana CLI
调用Grafana CLI,添加Grafana二进制文件在你的路径路径
环境变量。此外,如果您的当前目录本
目录,使用/ grafana cli。
。否则,您可以指定完整路径CLI。例如,在Linux上/usr/share/grafana/bin/grafana
和窗户C:\Program Files\ GrafanaLabs \ grafana \ bin \ grafana.exe
和调用它grafana cli
。
注意:一些命令,如安装或删除插件,需要sudo
在Linux上。如果你在Windows上,运行Windows PowerShell作为管理员。
Grafana CLI命令语法
一般在Grafana CLI命令的语法是:
grafana cli(全球选项)命令[命令选项][论点……]
全局选项
Grafana CLI允许你暂时覆盖某些Grafana默认设置。除了——帮助
和——版本
,全球多数选项仅仅是由开发人员使用。
每个全局选项仅适用于使用的命令。例如,——pluginsDir价值
不永久地改变Grafana哪里保存插件。它只改变命令的应用选项。
显示Grafana CLI帮助
——帮助
或- h
显示的帮助,包括默认的路径和码头工人配置信息。
例子:
grafana cli - h
显示Grafana CLI版本
——版本
或- v
打印的版本Grafana CLI当前正在运行。
例子:
grafana cli - v
覆盖缺省插件目录
——pluginsDir价值
覆盖的道路在你当地Grafana实例存储插件。使用这个选项,如果你想安装、更新或删除插件在其他地方,而不是默认的目录(/ var / lib / grafana /插件”)[GF_PLUGIN_DIR美元]。
例子:
grafana cli——pluginsDir " / var / lib / grafana / devplugins”插件安装< plugin-id >
覆盖缺省插件回购URL
——回购价值
允许你从一个存储库下载并安装或更新插件默认Grafana回购。
例子:
grafana cli——回购“https://example.com/plugins”插件安装< plugin-id >
覆盖缺省插件zip URL
——pluginUrl价值
允许你下载一个. zip文件,其中包含从本地URL而不是下载一个插件从默认Grafana来源。
例子:
grafana cli——pluginUrl https://company.com/grafana/plugins/ < plugin-id > <插件版本> . zip插件安装< plugin-id >
覆盖传输层安全
警告:关掉TLS是一个重大的安全风险。我们不建议使用这个选项。
——不安全
允许你关掉传输层安全性(Transport Layer Security, TLS)验证(不安全)。你可能想要这么做,如果你从一个非默认来源下载一个插件。
例子:
grafana cli——安全——pluginUrl https://company.com/grafana/plugins/ < plugin-id > - <插件版本> . zip插件安装< plugin-id >
启用调试日志记录
——调试
或- d
使调试日志记录。调试输出返回和显示终端。
例子:
grafana cli——调试插件安装< plugin-id >
覆盖一个配置设置
——configOverrides
是一个命令行参数,就像一个环境变量覆盖。
例如,您可以使用它来将日志重定向到另一个文件(可能日志插件安装在Grafana云)或者当重置管理员密码,你有一些重要的非默认值配置值(如数据库所在)。
例子:
grafana cli——configOverrides cfg: default.paths。日志= / dev / null插件安装< plugin-id >
覆盖homepath值
设置的路径Grafana安装/ home路径,默认的工作目录。您不需要使用这个如果你在使用CLI时Grafana安装目录。
例子:
grafana cli——homepath“/ usr / share / grafana”管理reset-admin-password <新密码>
覆盖配置文件
——配置值
覆盖默认位置Grafana预计配置文件。指配置关于配置的更多信息Grafana和默认的配置文件的位置。
例子:
grafana cli,配置“/ etc /配置/管理reset-admin-password mynewpassword
插件命令
Grafana CLI允许您安装、升级和管理你的Grafana插件。关于安装插件的更多信息,请参考插件页面。
所有列出的命令适用于Grafana默认存储库和目录。您可以覆盖默认值全局选项。
可用插件列表
grafana cli插件list-remote
安装一个插件的最新版本
grafana cli插件安装< plugin-id >
安装一个特定版本的插件
grafana cli插件安装< plugin-id > <版本>
安装插件列表
grafana cli插件ls
更新所有已安装的插件
grafana cli插件更新所有
更新一个插件
grafana cli插件更新< plugin-id >
移除一个插件
grafana cli插件删除< plugin-id >
管理命令
管理命令只在Grafana 4.1和以后。
显示所有管理命令
grafana cli管理
重置管理员密码
grafana cli admin reset-admin-password <新密码>
重置的密码admin用户使用CLI。你可能需要这样做如果你失去了管理密码。
如果有两个国旗被用来设置homepath和配置文件路径,然后运行命令返回这个错误:
找不到配置默认值,确保homepath命令行参数设置或工作目录是homepath
要修正这个问题,使用——homepath
全局选项指定Grafana默认homepath这个命令:
grafana cli——homepath“/ usr / share / grafana”管理reset-admin-password <新密码>
如果你没有失去管理密码,我们建议您更改用户密码的用户首选项或在服务器管理>用户选项卡中。
如果你需要在脚本中设置密码,那么你可以使用Grafana用户API。
数据迁移和加密的密码
数据迁移
运行一个脚本,该脚本迁移或清理您的数据库中的数据。
encrypt-datasource-passwords
迁移密码从无担保领域secure_json_data字段。返回好吧
除非有一个错误。安全执行多次。
例子:
grafana cli管理数据迁移encrypt-datasource-passwords