文档 插件 Grafana 的 New Relic 数据源

Grafana 的 New Relic 数据源

New Relic 数据源插件允许您在 Grafana 中查询和可视化 New Relic APM（应用程序性能监控）和 Insights。

要求

此插件具有以下要求

• 一个 New Relic 帐户
• 以下帐户类型之一
  • 适用于拥有 Grafana Cloud 免费版、高级版或试用版帐户或 已激活的 Grafana Enterprise 许可证 的用户。

已知限制

• 目前不支持即席过滤器。
• 不支持包含多个 FACET 字段的 NRQL 查询。

安装 New Relic 数据源插件

要安装数据源，请参阅 安装。

从 New Relic 获取 API 密钥和帐户 ID

您需要您的个人 API 密钥/用户 API 密钥，请参阅 New Relic API 密钥。您还需要您的 New Relic 帐户 ID，请参阅 帐户 ID。

在 Grafana 中配置数据源

添加数据源，方法是填写以下字段

使用配置来配置数据源

数据源可以使用 Grafana 的配置系统进行配置。您可以阅读有关其工作原理以及可以为数据源设置的所有设置的更多信息，请参阅 配置 Grafana。

以下是以配置此数据源为例的示例

yaml 复制

apiVersion: 1
datasources:
  - name: New Relic
    type: grafana-newrelic-datasource
    jsonData:
      region: EU
    secureJsonData:
      accountId: 1111111
      personalApiKey: Personal API Key

查询数据源

服务可以是 指标、数据资源管理器、NRQL 编辑器、日志 或 跟踪。要了解有关 NRQL 编辑器/Insights 的更多信息，请参阅 Insights。

指标

如果您在这些下拉框中找不到选项，您仍然可以通过选择 创建： (您的文本) 来选择该选项。

应用程序/指标选择器旁边有一个小搜索图标。当您有大量应用程序或指标时，可以使用它们来搜索这些指标。搜索图标将随时显示相关的 1000 个结果。如果您有超过 1000 个应用程序/指标，可以使用名称过滤器过滤结果。注意：搜索区分大小写。

数据资源管理器

数据资源管理器允许您查询 New Relic Insights 数据，而无需编写原始 NRQL。

切换到 **数据资源管理器** 模式后，查询编辑器将预先配置为具有默认查询。您可以通过自定义以下字段来创建自己的数据资源管理器查询

您可以在“预览”部分预览基于您的选项的 NRQL 查询。如果您想进一步自定义查询，可以通过单击 **切换到 NRQL 编辑器** 切换到原始 NRQL 编辑器。

有关 NRQL 语法的更多信息，请参阅 New Relic 文档 页面。

NRQL 编辑器 (Insights)

有关 New Relic 查询语言简介，请参阅 NRQL 简介。

开始键入后将显示代码完成。要选择完成选项，请使用箭头键突出显示所需的选项，然后按 Tab 键进行选择。

编辑器支持以下宏。

示例

sql 复制

SELECT average(value) FROM $event_template_variable $__timeFilter TIMESERIES

请确保在您的 NRQL 查询中包含 $__timeFilter 宏。否则，您的结果将不会与 Grafana 仪表盘的时间范围同步。

合成查询

可以使用 NRQL 编辑器/Insights 从 SyntheticCheck 和 SyntheticRequest 表中查询 New Relic Synthetics 数据。

例如，以下查询返回按响应状态的请求总数。

sql 复制

SELECT count(*) FROM SyntheticRequest FACET responseStatus $__timeFilter

以下查询返回所有监控器的成功率。

sql 复制

SELECT (
    filter(count(*),WHERE result = 'SUCCESS')
    / filter(count(*), WHERE result IN ('SUCCESS','FAILED'))
    * 100
) as 'Success Rate' FROM SyntheticCheck
FACET monitorName $__timeFilter TIMESERIES

有关合成监控查询的更多详细信息，请参阅 合成监控报告的事件

日志

插件的日志服务允许您查询和查看存储在 New Relic Log 表中的日志。插件使用 NerdGraph NRQL 查询执行搜索。插件使用 SELECT * FROM Log WHERE <xxxx> SINCE <xxxxx> UNTIL <xxxxx> ORDER BY <xxxxx> LIMIT MAX 查询执行日志搜索并将结果以 Grafana 日志格式呈现。日志将根据仪表盘时间范围自动过滤。您可以选择配置以下字段来筛选数据

日志搜索查询将返回最多 2000 条记录（NRQL API 限制）。但是，探索中的日志量面板可以提示您在整个时间范围内是否存在更多日志，然后您可以将探索的时间范围缩小到特定时间段。

如果日志行找到诸如 traceId/traceid/trace.id 之类的字段，日志面板将提供指向相应跟踪视图的链接。

跟踪

插件的跟踪服务允许您查询和查看存储在 New Relic 中的跟踪。这可以通过单独搜索跟踪或通过列表进行。

您可以在 New Relic 文档网站 上找到有关 New Relic 跟踪 API 的更多信息。

模板和变量

要添加新的 New Relic 查询变量，请参阅 添加查询变量。使用您的 New Relic 数据源作为以下可用查询的数据源。

New Relic 查询可以返回相对端点（不包括文件扩展名）。有关更多信息，请参阅 New Relic REST API

创建变量后，您可以使用变量语法在 New Relic 查询中使用它。有关更多信息，请参阅 变量语法。有关变量的更多信息，请参阅 模板和变量。

导入 New Relic 的仪表盘

按照这些 说明 导入仪表盘。

导入的仪表盘可以在“配置”>“数据源”>“选择您的 New Relic 数据源”>“选择“仪表盘”选项卡中找到，以查看可用的预制仪表盘。

充分利用插件

• 添加 注释。
• 配置和使用 模板和变量。
• 添加 转换。
• 设置警报；请参阅 警报概述。