菜单
文档breadcrumb arrow 插件breadcrumb arrow Salesforce 数据源breadcrumb arrow 配置 Salesforce 数据源

配置 Salesforce 数据源

Grafana 为 Salesforce 提供了许多配置选项。请注意，只有具有 Administrator 角色的用户才能将数据源添加到 Grafana。

在安装和配置 Salesforce 数据源之前，您必须拥有一个 Salesforce Connected App。

Connected App 设置

Grafana 支持 Salesforce 数据源的两种身份验证方法：凭据或 JWT。

在配置 Salesforce 数据源之前，以下设置必须在 Connected App 中设置。

注意

Salesforce 插件目前使用 OAuth 2.0 用户名-密码流程。Connected App 中所需的回调 URL 未被使用，因此您可以将其设置为任何有效的 URL。

基于凭据的 Connected App 设置

如果您使用基于凭据的身份验证方法，必须设置以下内容

  • 启用 OAuth 设置 - 点击启用 OAuth。
  • 回调 URL - 在 Salesforce 中是必需的，但 Grafana Salesforce 插件不使用。您可以使用任何有效的 URL。
  • 选定的 OAuth 作用域（最低要求） - 选择以下作用域
    • 访问和管理您的数据 (api)
  • 刷新令牌流程需要 Secret - 可以启用或禁用。

基于 JWT 的 Connected App 设置

如果您使用 JWT 身份验证，必须设置以下内容

  • 启用 OAuth 设置 - 点击启用 OAuth。
  • 回调 URL - 输入 sfdc://oauth/jwt/success
  • 选择 启用使用数字签名 并上传数字证书。
  • 选定的 OAuth 作用域（最低要求） - 选择以下作用域
    • 访问和管理您的数据 (api)
    • 随时代表您执行请求
  • 刷新令牌流程需要 Secret - 可以启用或禁用。

添加 Salesforce 数据源

有关在 Grafana 中安装和管理插件及数据源的通用信息，请参阅以下文档

要安装 Salesforce 数据源插件，请参阅 Grafana 的Salesforce 安装页面。

注意

在添加和配置 Salesforce 数据源之前，您必须安装 Salesforce 数据源插件。该插件将您连接到数据源。

安装 Salesforce 插件后，完成以下步骤添加 Salesforce 数据源

  1. 点击左侧菜单中的连接。
  2. 在搜索栏中输入 Salesforce。
  3. 选择 Salesforce 数据源图块。
  4. 点击右上角的添加新数据源。
  5. 您将被带到设置选项卡，在那里您可以设置您的 Salesforce 配置。

Salesforce 配置选项

以下是 Salesforce 的配置选项列表。

第一个选项是为连接命名

  • 名称 - 您的数据源名称。这是您在查询和面板中引用数据源的方式。示例：Salesforce_Sales_Prod1, SF-Prod-East1。
  • 默认 - 切换此选项可在仪表盘面板中选择默认名称。这将使其在您访问仪表盘面板时成为默认数据源。

连接设置

Grafana 支持 Salesforce 数据源的两种身份验证方法：凭据或 JWT。

基于凭据的身份验证

以下是基于凭据的身份验证的配置选项

  • 用户名 - 用于连接 Salesforce 的 Salesforce 账户用户名。示例：salesforce_admin@abccompany.com。
  • 密码 - 用于连接 Salesforce 的密码。
  • 安全令牌 - 添加安全令牌。
  • 消费者密钥 - 用于连接 Salesforce 的消费者密钥。您可以从您的 Connected App 中获取此密钥。
  • 消费者密匙 - 用于连接 Salesforce 的消费者密匙。您可以从您的 Connected App 中获取此密匙。

基于 JWT 的身份验证

请参阅 Salesforce 文档配置 Connected App 以颁发基于 JWT 的访问令牌，了解如何使用基于 JWT 的访问令牌对您的 Salesforce Connected App 进行身份验证。

在Connected App 数字签名下添加以下内容

在Connected App 凭据下添加以下内容

  • 用户名 - 用于连接 Salesforce 的 Salesforce 账户用户名。示例：salesforce_admin@abccompany.com。
  • 消费者密钥 - 用于连接 Salesforce 的消费者密钥。

可选设置

  • 环境 - 点击下拉菜单选择您的环境。

  • 私有数据源连接 - 仅适用于 Grafana Cloud 用户。私有数据源连接 (PDC) 允许您在 Grafana Cloud 实例或堆栈与私有网络内安全的数据源之间建立私有、安全的连接。点击下拉菜单找到 PDC 的 URL。有关 Grafana PDC 的更多信息，请参阅私有数据源连接 (PDC)。

添加连接设置后，点击测试以测试数据源连接。

使用 Provisioning 配置数据源

使用 Grafana 的 Provisioning 系统通过在 YAML 文件中定义设置来配置 Salesforce 数据源。有关 Provisioning 系统和配置选项的详细信息，请参阅Provisioning Grafana。

以下是 Provisioning Salesforce 数据源的示例

yaml 
apiVersion: 1
datasources:
  - name: Salesforce - user password authentication
    type: grafana-salesforce-datasource
    jsonData:
      authType: user
      user: user name
    secureJsonData:
      password: password
      securityToken: securityToken
      clientID: consumer key
      clientSecret: consumer secret
  - name: Salesforce - jwt authentication
    type: grafana-salesforce-datasource
    jsonData:
      authType: jwt
      user: user name
    secureJsonData:
      clientID: consumer key
      cert: |
        -----BEGIN CERTIFICATE-----
        xxxxxxxxxxxxxxxxxxxxxxxxxxx
        -----END CERTIFICATE-----
      privateKey: |
        -----BEGIN PRIVATE KEY-----
        xxxxxxxxxxxxxxxxxxxxxxxxxxx
        -----END PRIVATE KEY-----

要 Provisioning 沙盒环境，请使用 sandbox 属性更新 jsonData 设置

yaml 
jsonData:
  sandbox: true