在Grafana中使用OpenTSDB

Grafana提供了对OpenTSDB的高级支持。本主题解释特定于OpenTSDB数据源的选项、变量、查询和其他选项。指添加数据源获取如何向Grafana添加数据源的说明。只有具有组织管理员角色的用户才能添加数据源。

OpenTSDB设置

要访问OpenTSDB设置，请将鼠标悬停在配置(齿轮)图标，然后点击数据源，然后单击OpenTSDB数据源。

的名字	描述
`的名字`	数据源名称。这就是在面板和查询中引用数据源的方式。
`默认的`	默认数据源意味着将为新面板预先选择它。
`URL`	OpenTSDB服务器的HTTP协议、IP和端口(默认端口通常是4242)
`允许饼干`	列出要转发到数据源的cookie的名称。
`版本`	Version = opentsdb版本，<=2.1或2.2
`决议`	来自opentsdb的度量可能具有秒级或毫秒级分辨率的数据点。
`查询限制`	缺省值为1000。

通过单击标题在编辑模式中打开图形。如果数据源的版本<=2.1或= 2.2，查询编辑器将有所不同。在前一个版本中，只能使用标签查询OpenTSDB。但是在后一个版本中，可以使用过滤器和标记来查询opentsdb。OpenTSDB 2.2中也引入了填充策略。

注意:在使用OpenTSDB 2.2数据源时，请确保使用过滤器或标签，因为它们是互斥的。如果一起使用，可能会产生奇怪的结果。

一旦您开始输入指标名称、标记名称和标记值，您应该会看到针对它们的高亮显示的自动完成建议。只有启用了OpenTSDB建议API，自动补全才有效。

而不是硬编码的东西，如服务器，应用程序和传感器名称在您的指标查询，你可以使用变量在他们的地方。变量显示为仪表板顶部的下拉选择框。这些下拉列表可以很容易地更改仪表板中显示的数据。

请查看模板介绍模板特性和不同类型的模板变量的文档。

Grafana的OpenTSDB数据源支持模板变量查询。这意味着您可以创建从OpenTSDB获取值的模板变量。例如，度量名称、标记名称或标记值。

的模板变量使用OpenTSDB时查询类型，可以使用以下语法进行查找。

如果没有看到模板变量被填充值预览节时，您需要启用tsd.core.meta.enable_realtime_ts在OpenTSDB服务器设置中。此外，要在OpenTSDB中填充现有时间序列数据的元数据，需要运行TSDB uid metasync在OpenTSDB服务器上。

一个模板变量可以用来为另一个模板变量筛选标记值。第一个参数是指标名称，第二个参数是标记键，您需要为其查找标记值，然后是所有其他依赖模板变量。下面提到了一些示例，以使嵌套模板查询成功工作。

查询	描述
`Tag_values (cpu, hostname, env=$env)`	返回cpu度量的标记值，所选的env标记值和标记键主机名
`Tag_values (cpu, hostname, env=$env, region=$region)`	返回cpu度量、选定的env标记值、选定的区域标记值和标记键主机名的标记值

有关OpenTSDB度量查询的详细信息，请参阅官方OpenTSDB文档

现在可以在Grafana的配置系统中使用配置文件配置数据源。您可以阅读更多关于它的工作原理以及可以为数据源设置的所有设置配置文档页面

下面是该数据源的一些配置示例。

apiVersion: 1 datasources:—name: OpenTsdb type: OpenTsdb access: proxy url: http://localhost:4242 jsonData: tsdbResolution: 1 tsdbVersion: 1