菜单

这是文档下一个版本的Grafana。最新的稳定版本,去最新版本

Grafana文档 Grafana CLI
企业 开源

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