AppDynamics 数据源插件
AppDynamics 数据源插件允许您在 Grafana 中查询和可视化 AppDynamics 指标和分析。
需求
此插件有以下需求
- 一个AppDynamics账户,其中包含可以生成API密钥的用户。
- 以下账户类型之一
- 适用于拥有Grafana Cloud免费、高级或试用账户,或者已激活Grafana企业许可证的用户。
已知限制
- 指标路径名称不能包含您选择的分隔符。有关更多信息,请参阅查询指标数据源。
安装插件
导航到AppDynamics插件主页。
从左侧菜单中,点击安装插件按钮。
- 如果您看不到安装插件按钮,请确保您已登录到具有有效企业插件订阅的Grafana.com账户。
显示安装选项卡。
满足兼容性要求
对于此插件,没有兼容性要求。
从AppDynamics获取凭据
您可以使用带有用户名和密码的基本认证或使用API令牌进行身份验证。
验证插件是否已安装
- 在Grafana Enterprise中,从左侧菜单导航到配置 > 数据源。
- 从右上角点击添加数据源按钮。
- 在搜索框中搜索
AppDynamics
,并将鼠标悬停在AppDynamics搜索结果上。 - 点击AppDynamics的选择按钮。
- 如果您可以点击选择按钮,则表示已安装。
- 如果按钮不存在或已禁用,则插件未安装。检查您的Grafana Enterprise许可证是否有效,并重新安装插件。如果仍然需要帮助,请联系Grafana Labs。
配置AppDynamics指标数据源
您可以在AppDynamics中为数据源创建角色和用户,或者使用API客户端设置身份验证。
在AppDynamics中为数据源创建角色和用户
数据源需要访问账户、应用程序、数据库和分析的view
权限。
如果您不想使用现有用户,请创建一个用户
- 导航到AppDynamics管理设置。
- 从角色选项卡中选择+按钮以创建新角色,例如
grafana_readonly
。将显示创建角色部分。 - 从账户选项卡中添加权限
查看业务流程
。 - 从应用程序选项卡中,勾选查看框以允许Grafana查看应用程序数据。
- 从数据库选项卡中,勾选
查看
框以允许Grafana查看数据库数据。 - 从分析选项卡中,勾选可查看所有应用程序的数据框以允许Grafana查看应用程序分析数据。
- 从管理页面的用户选项卡中创建新用户,例如
grafana
。将新用户(或用户所属的组)分配给您刚刚创建的角色(例如grafana_readonly
)。
使用API客户端设置身份验证
- 作为具有管理员权限的用户,请在
https://company.saas.appdynamics.com/controller
登录 AppDynamics 控制器 UI,其中company
是您公司的名称。 - 点击齿轮图标并选择 管理。
- 点击 API 客户端 选项卡。
- 通过点击 创建 按钮创建一个新的 API 客户端。
- 为 API 客户端添加名称和描述,然后生成客户端密钥。
- 将 创建 AppDynamics 数据源的角色和用户 步骤中创建的角色添加到新的 API 客户端。
- 将 客户端名称 字段中的值用于数据源配置中的 客户端名称。
- 将您的公司/域名用于 客户端域 中的值。例如,参考点
1
:客户端域 的值将是company
。 - 将步骤
4
中生成的密钥作为 客户端密钥 输入。
配置 Metrics 数据源
通过填写以下字段 添加数据源
基本字段
字段 | 描述 |
---|---|
名称 | 为这个特定的 AppDynamics 数据源指定一个名称。 |
URL | AppDynamics 主机位置,例如 https://moria.saas.appdynamics.com 。 |
访问 | 访问模式控制对数据源的请求如何处理。如果没有其他说明,应首选服务器模式。 |
Metrics 认证字段
字段 | 描述 |
---|---|
基本认证 | 输入 AppDynamics 用户名和密码。 |
TLS 客户端认证 | 用于使用传输层安全性进行认证的内置选项。 |
跳过 TLS 验证 | 启用以跳过 TLS 验证。 |
带有凭证 | 启用以在跨站请求中发送凭证,如 cookie 或认证头。 |
带有 CA 证书 | 启用以验证自签名的 TLS 证书。 |
转发 OAuth 身份 | 转发在 Grafana 中签入的 oauth 用户的身份,对于同时使用 Grafana 和数据源的相同 oauth 提供商的情况。 |
客户端名称 | 使用API客户端设置身份验证. |
客户端域 | 使用API客户端设置身份验证. |
客户端密钥 | 使用API客户端设置身份验证. |
自定义 HTTP 标头数据源由 Grafana 内部配置管理,可以配置以向所有发送到该数据源的请求添加 HTTP 标头。头名称在 jsonData
字段中配置,而头值应在 secureJsonData 中配置。
Analytics 认证字段
与控制器中显示的大多数 AppDynamics REST API 不同,您可以通过指向 AppDynamics 平台中的事件服务实例来访问 Analytics Events API。由于这种划分,Analytics 的认证与 Metrics 独立。
AppDynamics Analytics
字段 | 描述 |
---|---|
Analytics API URL | Analytics 事件服务数据存储 的 SaaS 或 On-premises 终端。 |
Analytics API 密钥 | 使用所需的 Analytics 权限 通过 使用 API 密钥设置认证。 |
全局账户名称 | 如 控制器 UI 许可证页面 所示的全局账户名称。 |
使用配置文件配置数据源
可以使用 Grafana 的配置系统使用配置文件配置数据源。您可以在 配置文件文档页面 上了解更多信息。
以下是使用基本认证为此数据源提供的示例。
apiVersion: 1
datasources:
- name: AppDynamics
type: dlopes7-appdynamics-datasource
basicAuth: true
basicAuthUser: Auth Username
url: https://abcdef12345.saas.appdynamics.com
secureJsonData:
basicAuthPassword: Auth Password
以下是用API密钥提供指标和分析的示例。
注意:如果您已配置了指标API密钥和基本认证,则将使用API密钥。
apiVersion: 1
datasources:
- name: AppDynamics
type: dlopes7-appdynamics-datasource
jsonData:
analyticsURL: https://analytics.api.appdynamics.com
globalAccountName: customer1_abcdef-123456-78910
secureJsonData:
apiKey: Metrics Api Key
analyticsAPIKey: Analytics API Key
查询指标数据源
在查询类型下拉菜单中,点击指标。查询编辑器允许您查询AppDynamics应用程序指标。
字段 | 描述 |
---|---|
应用程序 | AppDynamics应用程序名称 |
指标 | |
图例 | 从完整路径 、段 或自定义 中选择详细信息这里 |
单个数据点(汇总) | 要获取最新行,设置为true 。 |
分隔符 | 选择用于影响指标路径分词的分隔符。 |
指标图例键
图例键的默认值可能相当长,但此格式可以自定义。
如果查询为单统计或无法看到图例键的其他面板,请点击“显示元数据”选项以查看查询的图例键(也称为别名)。
图例下拉菜单有多个选项:完整路径、段和自定义
完整路径:图例键是完整的指标路径。例如:
总体应用程序性能|平均响应时间(毫秒)
。段:图例键由从指标路径中选择的段组成,段索引从1开始。例如,具有指标路径
错误|mywebsite|错误|每分钟错误数
并指定2, 4
作为段返回mywebsite|每分钟错误数
。自定义:通过组合文本和以下别名模式来创建自定义图例,以便能够混合指标元数据
{{app}}
返回应用程序名称。{{n}}
返回指标路径的第n个段。
例如,指标路径
总体应用程序性能|平均响应时间(毫秒)
和自定义图例{{app}} MetricPart2: {{2}}
返回App: myApp MetricPart2: 平均响应时间(毫秒)
。
查询分析数据源
在查询类型列表中,点击分析。查询编辑器允许您使用ADQL查询AppDynamics分析。
在您输入ADQL查询时,查询编辑器将提供字段、表和模板变量的建议。
分析查询示例
SELECT distinct (transactionName), count(*) FROM transactions WHERE transactionName IN (${transactionName:doublequote})
模板和变量
要添加新的AppDynamics查询变量,请参阅添加查询变量。使用以下可用查询的AppDynamics数据源作为数据源
查询 | 描述 |
---|---|
应用程序 | 所有应用程序 |
AppName.Tiers | 应用程序名的所有层 |
AppName.TierName.BusinessTransactions | 特定层的所有业务交易 |
AppName.TierName.Nodes | 特定层的所有节点 |
AppName.Path.<Any Metric Path> | 可以指定任何指标路径 |
SELECT column from table | 分析ADQL查询 |
创建变量后,您可以通过使用变量语法在AppDynamics查询中使用它。有关变量的更多信息,请参阅模板和变量。
注意:在度量查询中不支持多值变量。如果在度量路径中找到多值变量,则将用
*
替换。
导入AppDynamics仪表板
按照这些说明导入仪表板。导入的仪表板可以在“配置”>“数据源”>选择您的AppDynamics数据源>选择“仪表板”选项卡中找到可用的预制仪表板。