Dynatrace Grafana数据源

Dynatrace数据源插件允许您查询和可视化在Grafana Dynatrace指标。

需求

这个插件有以下要求:

Dynatrace账户
以下账户类型之一:
- Grafana云:专业客户,先进的客户,与企业或专业试验用户启用插件插件
- Grafana企业:客户提供的激活许可证和一个用户与Grafana服务器或组织管理权限
企业启用插件插件

已知的限制

模板变量不能同时选中;只支持单一的选择。
只有v2度量api支持。

插件安装Dynatrace数据源

安装的数据源,请参考安装。

从Dynatrace得到一个API键

建立一个API令牌,请参考Dynatrace API——令牌和身份验证。

设置metrics.read和entities.readAPI的权限令牌。

在Grafana配置数据源

添加一个数据源通过填写以下字段:

的名字: 这个名字你想应用到Dynatrace数据源。
Dynatrace API类型: Dynatrace的类型实例连接。有三个选项:

SaaS
集群管理
原始URL

环境标识: 在SaaS的例子yfc55578.live.dynatrace.com,您的环境IDyfc55578。成功的例子yd8888.managed-sprint.dynalabs.io / e / abc99984 - 3 - af2 - 55 - tt - 72 kl - 0672983 - gc45,您的环境IDabc99984 - 3 - af2 - 55 - tt - 72 kl - 0672983 - gc45,你的域yd8888.managed-sprint.dynalabs.io

原始URL: 您的自定义的URL dynatrace实例。如。https://yfc55578.live.dynatrace.com。原始URL允许输入一个URL dynatrace实例以外的瀑布SaaS或集群管理。

Dynatrace API令牌: 一个API生成令牌metrics.read和entities.read权限。指得到一个API密匙和应用Dynatrace的关键。
跳过TLS验证: 可选启用这个选项如果你需要跳过TLS验证。默认值:假
与CA证书: 可选所需验证签名TLS能够默认值:false。如果启用,您还需要提供相应的证书的CA证书

配置数据源的配置

可以使用配置文件配置数据源Grafana准备系统。阅读更多关于配置是如何工作的,包括所有的设置,可以设置数据源,请参考供应Grafana。

apiVersion: 1数据源:名称:Dynatrace类型:grafana-dynatrace-datasource访问:代理可编辑:真正启用:真正的jsonData: apiType: saas environmentId:环境Id secureJsonData: apiToken: API令牌-名称:Dynatrace管理类型:grafana-dynatrace-datasource访问:代理可编辑:真正启用:真正的jsonData: apiType:管理environmentId:环境Id #例子:abc99984 - 3 - af2 - 55 - tt - 72 kl - 0672983 - gc45域:域#例子:yd8888.managed-sprint.dynalabs。io tlsSkipVerify:假tlsAuthWithCACert:真secureJsonData: apiToken: API牌tlsCACert: | - - - - - - - - - - -开始证书11231 + g6DAzj / 1221323123213123231231232 sdsaas = = - - - - - - - - - - -端证书版本:1

查询的数据源

查询编辑器允许您配置4个不同类型的dynatrace查询。

查询

查询类型度规,问题,USQL,日志,审计日志,或直接API访问。

度量查询类型

度规: 选择你想看的指标。再次从Dynatrace得到矩阵列表中,单击刷新按钮。
聚合: 选择您想要使用的聚合为一个特定的指标。单击聚合值改变聚合类型或单击+按钮以添加另一个聚合。
转换: 您可以选择转换在查询编辑器。后来,许多参数输入到所选择的变换。目前,只有支持合并转换。合并转换信息,请参考合并转换。
过滤器: Dynatrace插件每个指标的动态查询合适的过滤器。; 要添加一个过滤器,单击+旁边的象征过滤器标签Dynatrace查询编辑器中,选择你想过滤领域,选择您想使用的操作符,然后选择一个值来过滤。; Dynatrace插件允许您创建滤波器组你可以一起创建复杂的逻辑比较。对于大多数用例,滤波器组不需要。; 当创建过滤器标签,无论一起选中,Dynatrace意志总是使用和。Dynatrace不支持或过滤器与标签。
别名: 有两种不同类型的别名使用Dynatrace插件时你会遇到。第一个是一个静态的别名。这种类型的别名可以在每个查询,您构建和别名的名字开始以小写字母开头。第二个是一个动态的别名根据指标变化,您使用的是在你的查询,和别名的名称以一个大写字母开始。; Dynatrace插件支持几种不同的别名:指标名称,聚合,显示名称,主机,描述。

的名字	价值
美元的名字	内装式:apps.other.keyUserActions.reportedErrorCount.os
美元的聚合	汽车、价值
displayName的美元	报告错误计数(操作系统,通过关键用户操作)(移动、自定义)

问题查询类型

问题查询类型: 选择一个问题查询类型。目前,只有提要支持问题查询类型。对于饲料问题查询的信息类型,参考问题API——获得提要。
状态滤波器: 通过状态过滤结果的问题。
影响过滤: 过滤结果的问题,影响水平。
严重性过滤器: 过滤结果问题的严重程度。
扩大细节: 包括相关事件的响应,如果设置。

USQL查询类型

USQL查询类型: 选择USQL查询类型。这个查询类型使用用户会话API
USQL查询: 工具栏左边的这个区域有3个选项

回复:将恢复您的查询到最新保存的查询
保存:保存当前查询和执行查询(Alt + S / Cmd + S /点击)。向右拨动开关是启用自动保存。在自动模式下,查询将被保存只要你远离导航查询编辑器。(即:点击刷新按钮)
添加Deeplink字段:当玩家将返回deeplinked查询中的字段作为一个额外的数据集。转换数据可以用于进一步的按摩。

日志查询类型

查询: 日志搜索查询。查询必须使用Dynatrace搜索查询语言。示例查询:日志。源= " / var / log / syslog”和(loglevel =“错误”或loglevel =“警告”)
排序: 这定义了如何对结果进行排序。

结果是基于仪表板timerange自动过滤。

引用底层API文档在这里更多细节和局限性。

注意:日志查询类型是测试版。请报告任何异常行为Grafana支持团队。底层Dynatrace API是一个早期版本。API可能会改变的方式与这个插件不兼容。

审计日志查询类型

过滤器: 审计日志过滤器。您可以输入过滤查询中指定DynaTrace API文档。示例查询:eventType(“创造”,“更新”),类别(“配置”)
排序: 这定义了如何对结果进行排序。

结果是基于仪表板timerange自动过滤。

引用底层API文档在这里更多细节和局限性。

直接API访问查询类型

:直接API访问允许查询其他dynatrace API端点,但会要求你使用解析数据JSON路径表达式

API端点

输入部分的api端点从版本。例子:

API文档	API端点
人工合成物	`v2 /合成/位置`
事件	`v2 /事件`

解析使用JSONPath

这是默认的。选中时,与列标题为JSON响应返回路径,使它简单的解析单个字段(如果需要的话)。

场

输入字段的JSON路径在响应中提取

类型

选择数据类型应该提取。如果使用汽车,将自动检测到的类型。对数字的一年内的电流UNIX毫秒时代,将“时间”类型的。注意时间,不能被解析为一个时间将返回的值零。

别名

选择别名。进入时,列标题/名字将反映输入的别名。目前,不支持模板变量。保留为空白则使用默认,JSON路径。

+

最右边的一个字段行条目,点击这个加号将添加一个额外的字段。

模板和变量

添加一个新的Dynatrace查询变量,请参考添加一个查询变量。用你Dynatrace数据源的数据源后可以查询:

查询类型: 选择查询类型。查询类型将一些数据与一些关键或描述符。

查询类型	描述
指标名称	返回所有指标名称的列表
过滤键	返回一个列表的所有可能的维度(比如主机名),可以使用过滤器
过滤值的关键	返回一个列表过滤值的一个关键模板变量名称或关键的名字
问题状态选择	返回一个列表的所有问题的状态
问题影响选项	返回一个列表的所有问题影响的地区
问题严重程度选择	返回一个列表的所有问题严重性类型
查询编辑器	允许您配置一个客户查询使用查询编辑器,您可以使用
	要创建一个自定义模板变量。查询必须返回只有1列。
	当查询返回1列,点击`应用`按钮。