连接到 Salesforce 数据源 - Amazon Managed Grafana
已知限制条件必需的设置添加数据源查询 Salesforce 数据源模板和变量

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

连接到 Salesforce 数据源

注意

此数据源仅适用于 Grafana Enterprise。有关更多信息，请参阅 管理对企业插件的访问权限。

此外，在支持版本 9 或更高版本的工作空间中，此数据源可能需要您安装相应的插件。有关更多信息，请参阅 使用插件扩展您的工作空间。

Salesforce 数据源允许您在亚马逊托管 Grafana 中可视化来自 Salesforce 的数据。

要使用此数据源，您必须拥有 Salesfor ce 账户和 Sal esforce 关联应用程序。

已知限制条件

  • 尚不支持临时过滤器。

  • 目前仅支持 SOQL 查询和可通过 SOQL 访问的数据。尚不支持 SOSL 和 SAQL 查询格式。

必需的设置

需要进行以下设置。

注意

该插件目前使用 OAuth 2.0 用户名密码流程。未使用已连接应用程序中所需的回调 URL。因此，您可以将其设置为任何有效的 URL。

名称 描述
Enable OAuth settings 您必须勾选此项才能启用 OAuth。
Callback URL 此插件中未使用，因此您可以指定任何有效的 URL。
Selected OAuth Scopes (minimum requirements) 访问和管理您的数据 (api)。
Require Secret for Refresh Token Flow 您可以启用或禁用此功能。

添加数据源

  1. 在亚马逊托管 Grafana 工作区中打开 Grafana 控制台，并确保您已登录。

  2. 在 “配置”（齿轮图标）下的侧面菜单中，选择 “数据源”。

  3. 选择添加数据来源。

    注意

    如果您在侧面菜单中看不到数据源链接，则表示您当前的用户没有该Admin角色。

  4. 从数据源列表中选择 Salesforce。

  5. 输入以下信息：

    • 在用户名中，输入要用于连接和查询 Salesforce 的 Salesforce 账户的用户名。

    • 在 “密码” 中，输入该用户的密码。

    • 对于安全令牌，请输入该用户的安全令牌。

    • 在使用者密钥中，输入要连接到 Salesforce 的使用者密钥。你可以从你的 Salesforce 互联应用程序中获得这个。

    • 在 “消费者机密” 中，输入消费者密钥以连接到 Salesforce。你可以从你的 Salesforce 互联应用程序中获得这个。

    • 对于使用沙箱，如果您要使用 Salesforce 沙箱，请选择此选项。

查询 Salesforce 数据源

查询编辑器支持 “查询生成器” 和 “SOQL 编辑器” 模式。SOQL 代表 S alesforce 对象查询语言。

查询生成器（SOQL 生成器）

查询生成器是一个用户友好的界面，用于构建 SOQL 查询。如果您不熟悉编写 SOQL 查询，则可以使用此模式构建 SOQL 来查询 Salesforce 对象。查询生成器中的 FROM 字段指的是 Salesforce 中的一个或多个实体。您需要在查询生成器中进行任何其他操作之前选择 FROM 字段。选择 FRO M 字段后，需要选择生成器模式。SOQL 生成器目前支持以下模式。

  • List— 列出选定表格/salesforce 中的项目及其字段。使用此模式可以获得诸如 “向我显示本财季创造的机会列表及其名称、价值和阶段” 之类的结果。

  • Aggregate— 聚合实体中的项目。使用此模式可以获得诸如 “统计上个月创造的机会” 之类的结果。或 “按艺名分组的机会的总价值是多少？”

  • Trend— 显示一段时间内的汇总结果。使用此模式可以获得诸如 “计算机会数量” 之类的结果 CreatedDate。或 “按机会截止日期分组的总价值是多少”。

在查询编辑器中选择Entity/FROM和模式后，使用以下选项生成查询。

字段 适用于 描述
SELECT ALL 选择要查看的字段列表。对于聚合视图或趋势视图，还要选择要如何聚合这些值。
WHERE ALL （可选）指定筛选条件。结果将根据您选择的条件进行筛选。
ORDER BY 列表，汇总 （可选）为结果选择所需的字段名称和排序顺序。
LIMIT 列表，汇总 （可选）限制返回的结果数。默认值为 100。
GROUP BY AGGREGATE （可选）如果要按任何特定字段拆分聚合值，请选择该字段。
时间字段 趋势 指定要按其对结果进行分组的日期字段。结果是根据 Grafana 的时间选择器范围进行筛选的。

在查询编辑器中配置上述字段时，还将在查询编辑器下方看到生成的 SOQL 的预览。如果您在查询生成器中受到任何限制，则可以安全地切换到 SOQL Editor，您可以在其中自定义生成的 SOQL 查询。

SOQL 编辑器

原始 SOQL 编辑器提供了通过原始 SOQL 查询查询 Salesforce 对象的选项。SOQL 编辑器提供自动完成建议，例如每个表的可用实体和相应的字段。在 SELECT 或 WHERE 之后使用 Ctrl+Space 查看每个表的可用实体。如果在实体名称后输入一个点，则可以看到可用字段。

快捷方式

使用 CTRL + 空格键显示代码完成功能，它会显示可用的上下文选项。

CMD + S 运行查询。

按时间序列查询

通过将日期字段别名为时间，将指标字段别名为指标，然后按指标和日期分组，进行时间序列查询。以下是 示例：

SELECT sum(Amount) amount, CloseDate time, Type metric from Opportunity
group by Type, CloseDate

宏

要按控制面板时间范围进行筛选，可以在 SOQL 查询中使用宏：

  • $__timeFrom— 将替换为转换为time数据类型的当前活动时间选择的开头。

  • $__timeTo— 将替换为当前活动时间选择的结尾转换为time数据类型。

  • $__quarterStart— 会计季度的开始（源自 “ SalesForce 会计年度设置”）。

  • $__quarterEnd— 会计季度结束（源自 “ SalesForce 会计年度设置”）。

SELECT UserId, LoginTime from LoginHistory where LoginTime > $__timeFrom

模板和变量

要添加新的 Salesforce 查询变量，请参阅添加查询变量。使用你的 Salesforce 数据源作为数据源。你可以在这里使用任何 SOQL 查询。

如果要使用名称/值对，例如用户 ID 和用户名，请从 SOQL 查询中返回两个字段。第一个字段将用作 ID。当你想在查询编辑器 SOQL 中按键（ID 等）进行筛选时，请执行此操作。

使用变量语法在 SOQL 查询中使用该变量。有关更多信息，请参阅 变量语法。