菜单
文档breadcrumb arrow 插件breadcrumb arrow AppDynamics 数据源插件

AppDynamics 数据源插件

AppDynamics 数据源插件允许您在 Grafana 中查询和可视化 AppDynamics 指标和分析。

需求

此插件有以下需求

已知限制

  • 指标路径名称不能包含您选择的分隔符。有关更多信息,请参阅查询指标数据源

安装插件

  1. 导航到AppDynamics插件主页

  2. 从左侧菜单中,点击安装插件按钮。

    • 如果您看不到安装插件按钮,请确保您已登录到具有有效企业插件订阅的Grafana.com账户。

    显示安装选项卡。

满足兼容性要求

对于此插件,没有兼容性要求。

从AppDynamics获取凭据

您可以使用带有用户名和密码的基本认证或使用API令牌进行身份验证。

验证插件是否已安装

  1. 在Grafana Enterprise中,从左侧菜单导航到配置 > 数据源
  2. 从右上角点击添加数据源按钮。
  3. 在搜索框中搜索AppDynamics,并将鼠标悬停在AppDynamics搜索结果上。
  4. 点击AppDynamics的选择按钮。
    • 如果您可以点击选择按钮,则表示已安装。
    • 如果按钮不存在或已禁用,则插件未安装。检查您的Grafana Enterprise许可证是否有效,并重新安装插件。如果仍然需要帮助,请联系Grafana Labs

配置AppDynamics指标数据源

您可以在AppDynamics中为数据源创建角色和用户,或者使用API客户端设置身份验证

在AppDynamics中为数据源创建角色和用户

数据源需要访问账户应用程序数据库分析view权限。

如果您不想使用现有用户,请创建一个用户

  1. 导航到AppDynamics管理设置。
  2. 角色选项卡中选择+按钮以创建新角色,例如grafana_readonly。将显示创建角色部分。
  3. 账户选项卡中添加权限查看业务流程
  4. 应用程序选项卡中,勾选查看框以允许Grafana查看应用程序数据。
  5. 数据库选项卡中,勾选查看框以允许Grafana查看数据库数据。
  6. 分析选项卡中,勾选可查看所有应用程序的数据框以允许Grafana查看应用程序分析数据。
  7. 从管理页面的用户选项卡中创建新用户,例如grafana。将新用户(或用户所属的组)分配给您刚刚创建的角色(例如grafana_readonly)。

使用API客户端设置身份验证

  1. 作为具有管理员权限的用户,请在 https://company.saas.appdynamics.com/controller 登录 AppDynamics 控制器 UI,其中 company 是您公司的名称。
  2. 点击齿轮图标并选择 管理
  3. 点击 API 客户端 选项卡。
  4. 通过点击 创建 按钮创建一个新的 API 客户端。
  5. 为 API 客户端添加名称和描述,然后生成客户端密钥。
  6. 创建 AppDynamics 数据源的角色和用户 步骤中创建的角色添加到新的 API 客户端。
  7. 客户端名称 字段中的值用于数据源配置中的 客户端名称
  8. 将您的公司/域名用于 客户端域 中的值。例如,参考点 1客户端域 的值将是 company
  9. 将步骤 4 中生成的密钥作为 客户端密钥 输入。

配置 Metrics 数据源

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

基本字段

字段描述
名称为这个特定的 AppDynamics 数据源指定一个名称。
URLAppDynamics 主机位置,例如 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 URLAnalytics 事件服务数据存储 的 SaaS 或 On-premises 终端。
Analytics API 密钥使用所需的 Analytics 权限 通过 使用 API 密钥设置认证
全局账户名称控制器 UI 许可证页面 所示的全局账户名称。

使用配置文件配置数据源

可以使用 Grafana 的配置系统使用配置文件配置数据源。您可以在 配置文件文档页面 上了解更多信息。

以下是使用基本认证为此数据源提供的示例。

yaml
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密钥。

yaml
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查询时,查询编辑器将提供字段、表和模板变量的建议。

分析查询示例

sql
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数据源>选择“仪表板”选项卡中找到可用的预制仪表板。

了解更多信息