Salesforce Grafana数据源

Salesforce数据源插件允许您可视化数据在Grafana Salesforce。

需求

Salesforce数据来源有以下要求:

有效的许可证Grafana企业;指激活一个企业许可证。
Grafana用户与服务器或组织管理作用;指权限。
一个Salesforce帐户。
一个Salesforce连接应用程序。

已知的限制

不支持特殊过滤器。
只有SOQL查询,通过SOQL目前支持的数据。SOSL和SAQL查询格式还不支持。

安装插件

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

先决条件(Salesforce连接应用程序)

一个Salesforce连接应用程序。注意:目前使用的插件OAuth 2.0 Username-Password流。所需的连接应用程序不使用回调URL。因此,您可以将它设置为任何有效的URL。

需要设置Grafana插件

凭证为基础

支持OAuth设置: 验证这个到支持Oauth。
回调URL: 这是需要在Salesforce但不使用的插件。您可以使用任何有效的URL。
选择OAuth范围(最低要求): 访问和管理你的数据(api)
需要秘密刷新令牌流: 这可以启用或禁用

JWT基础

支持OAuth设置: 验证这个到支持Oauth。
回调URL: sfdc: / / oauth / jwt /成功

可以使用数字签名和上传数字证书

选择OAuth范围(最低要求): 访问和管理你的数据(api); 在任何时间执行请求代表你
需要秘密刷新令牌流: 这可以启用或禁用

在Grafana配置数据源

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

身份验证——JWT

证书: 的公共证书作为连接应用程序的数字签名。签名。点击“生成”创建自签署证书或使用你自己的。
私钥: 证书的私钥。
用户名: Salesforce帐户的用户名您想要使用的连接和查询Salesforce。
消费者的关键: 一个消费者连接到Salesforce的关键。你可以获得这个从你连接应用程序

身份验证——凭证

用户名: Salesforce帐户的用户名您想要使用的连接和查询Salesforce。
密码: 上述用户的密码。
安全令牌: 的安全令牌上述用户。
消费者的关键: 一个消费者连接到Salesforce的关键。你可以获得这个从你连接应用程序
消费者的秘密: 一个消费者连接到Salesforce的秘密。你可以获得这个从你连接应用程序
使用沙盒: 选择这个如果你想使用Salesforce沙箱。

配置数据源的配置

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

apiVersion: 1数据源:名称:Salesforce类型:grafana-salesforce-datasource编辑:真正启用:真正的jsonData:用户:用户名secureJsonData:密码:密码securityToken: securityToken clientID:消费者关键clientSecret:消费者的秘密

查询的数据源

查询编辑器支持模式查询构建器和SOQL编辑器。SOQL代表Salesforce对象查询语言。

查询构建器也被称为SOQL建设者

查询构建器构建SOQL查询是一个用户友好的界面。如果您不熟悉写SOQL查询,您可以使用此模式构建SOQL查询Salesforce对象。的从字段查询构建器是指实体或实体在Salesforce。你需要选择从在查询构建器之前任何其他操作。你选择后从行业,你需要选择建造者模式。SOQL Builder目前支持以下模式。

模式	描述
列表	列出项目从选定的表字段/ salesforce。使用这种模式得到的结果,比如“给我机会列表中创建这个财季连同他们的名字,价值,和舞台。”
总	总一个实体的物品。使用这种模式得到的结果,比如“上月数中创建的机会。”或“的总价值是多少分组的机会他们的艺名吗?”
趋势	随着时间的推移显示聚合结果。使用这种模式得到的结果,比如“数一数CreatedDate的机会。”或“的总额是多少`价值`分组的机会关闭日期。”

你选择后实体/表(从)和模式在查询编辑器中,使用以下选项构建您的查询。

字段	适用于	描述
字段(`选择`)	所有	选择你想看的字段列表。也总或趋势的观点,选择你想怎么聚合值。
过滤器(`在哪里`)	所有	(可选)指定过滤条件。结果是根据您选择的条件过滤。
Order By (`命令`)	列表,总	(可选)选择字段名和您想要的排序结果。
限制(`限制`)	列表,总	(可选)限制返回结果的数量。默认值是`One hundred.`。
集团(`集团`)	总	(可选)选择字段如果需要将聚合值的任何特定的字段。
时间字段	趋势	指定的日期字段要组织你的结果。结果过滤基于Grafana时间选择器的范围。

正如你之前配置字段在查询编辑器中,您还将看到一个预览生成的SOQL查询以下编辑器。如果你阻止了任何限制在查询生成器,您可以安全地开关SOQL编辑器,你可以自定义生成的SOQL查询。

SOQL编辑器

原始的SOQL编辑器提供了选项通过原始SOQL查询查询Salesforce对象。SOQL编辑器提供了自动完成建议,如可用实体/表和相应的字段。使用Ctrl+空间在选择或每表在哪里查看可用的实体。你可以看到可用的字段,如果你输入一个点后实体名称。

快捷键

新闻Ctrl+空间显示代码完成功能,这将显示可用的上下文选项。

Cmd+年代运行查询。

查询的时间序列

做一个时间序列查询混叠一个日期字段时间和度规场度规度量和日期,然后分组。

下面是一个例子:

选择金额(金额),CloseDate时间,CloseDate类型指标从机会组织类型

宏

过滤通过仪表板时间范围,您可以在您的SOQL查询:使用宏

__timeFrom美元: 将取代当前活动的开始时间选择转换成吗时间数据类型。
__timeTo美元: 将被替换的选择转换为当前活动时间时间数据类型。
__quarterStart美元: 财政季度的开始(来自SalesForce财年设置)
__quarterEnd美元: 财季结束(来自SalesForce财年设置)

选择UserId, LoginTime从LoginHistory LoginTime > __timeFrom美元

模板和变量

添加一个新的Salesforce查询变量,请参考添加一个查询变量。使用Salesforce数据来源作为数据源。您可以使用任何SOQL查询。

如果你想使用名称/值对,例如用户id和用户名,返回2 SOQL查询中的字段。第一个字段将被用作ID。你可能想要这么做,当你想要过滤的关键(ID等)的SOQL查询编辑器。

使用变量SOQL查询使用变量的语法。

关于变量的更多信息,请参考模板和变量。

得到最多的插件

添加注释。
配置和使用模板和变量。
添加转换。
设置报警;指警报概述。