Salesforce 和 Cortex 集成

输入和输出集成概述

Salesforce Telegraf 插件收集有关 Salesforce 组织中 API 使用情况和限制的关键指标，从而能够有效地监控和管理 API 消耗。

此插件使 Telegraf 能够使用 Prometheus 远程写入协议将指标发送到 Cortex，从而可以无缝地摄取到 Cortex 的可扩展、多租户时间序列存储中。

集成详细信息

Salesforce

Salesforce 插件允许用户收集有关 API 使用限制以及其 Salesforce 组织内剩余使用量的指标。 通过利用 Salesforce 的 REST API，特别是 limits 端点，此插件提供了关于 API 使用量已消耗多少以及还剩多少的关键见解。 这对于依赖 Salesforce 进行运营的组织尤为重要，因为超出 API 限制可能会中断服务并阻碍业务流程。 该插件将数据处理为结构化格式，其中包含各种 API 操作的最大值和剩余值，使团队可以更轻松地监控其使用情况并进行相应的计划。 提供的配置允许用户自定义其凭据、环境类型（沙盒或生产）和 API 版本，从而确保不同部署场景中的灵活性。

Cortex

借助 Telegraf 的 HTTP 输出插件和 prometheusremotewrite 数据格式，您可以将指标直接发送到 Cortex，这是一个水平可扩展的 Prometheus 长期存储后端。 Cortex 支持多租户，并使用 Prometheus protobuf 格式接受远程写入请求。 通过使用 Telegraf 作为收集代理，并使用 Remote Write 作为传输机制，组织可以将可观测性扩展到 Prometheus 本身不支持的来源（例如 Windows 主机、支持 SNMP 的设备或自定义应用程序指标），同时利用 Cortex 的高可用性和长期保留能力。

配置

Salesforce

[[inputs.salesforce]]
  ## specify your credentials
  ##
  username = "your_username"
  password = "your_password"
  ##
  ## (optional) security token
  # security_token = "your_security_token"
  ##
  ## (optional) environment type (sandbox or production)
  ## default is: production
  ##
  # environment = "production"
  ##
  ## (optional) API version (default: "39.0")
  ##
  # version = "39.0"

Cortex

[[outputs.http]]
  ## Cortex Remote Write endpoint
  url = "http://cortex.example.com/api/v1/push"

  ## Use POST to send data
  method = "POST"

  ## Send metrics using Prometheus remote write format
  data_format = "prometheusremotewrite"

  ## Optional HTTP headers for authentication
  # [outputs.http.headers]
  #   X-Scope-OrgID = "your-tenant-id"
  #   Authorization = "Bearer YOUR_API_TOKEN"

  ## Optional TLS configuration
  # tls_ca = "/path/to/ca.pem"
  # tls_cert = "/path/to/cert.pem"
  # tls_key = "/path/to/key.pem"
  # insecure_skip_verify = false

  ## Request timeout
  timeout = "10s"

输入和输出集成示例

Salesforce

1. 监控 API 限制使用情况以进行扩展决策：使用 Salesforce 插件跟踪一段时间内的 API 限制使用情况，并就何时扩展 Salesforce 资源做出明智的决策。 通过可视化 API 消耗模式，组织可以预测峰值使用时间，从而使其能够主动调整其基础设施或根据需要请求更高的限制。 这种优化可以提高性能，并减少关键业务运营期间的停机时间。

2. API 限制超出自动警报系统：将此插件与通知系统集成，以便在 API 使用量接近临界限制时向团队发出警报。 此设置不仅确保主动通知团队以防止中断，而且还有助于维护运营连续性和客户满意度。 警报可以配置为触发自动脚本，以调整负载或相应地通知利益相关者。

3. 多个 Salesforces 的比较分析：利用 Salesforce 输入插件收集来自不同部门或业务部门的多个 Salesforce 实例的指标。 通过集中这些数据，组织可以执行比较分析，以识别可能比其他部门更频繁地超出其 API 限制的部门。 这有助于进行有针对性的讨论和策略，以平衡整个组织的 API 使用情况，从而提高资源分配和效率。

Cortex

1. 统一的多租户监控：使用 Telegraf 从不同的团队或环境收集指标，并将它们推送到带有单独 X-Scope-OrgID 标头的 Cortex。 这实现了每个租户的隔离数据摄取和查询，非常适合托管服务和平台团队。

2. 将 Prometheus 覆盖范围扩展到边缘设备：在边缘或物联网设备上部署 Telegraf 以收集系统指标，并将它们发送到集中的 Cortex 集群。 这种方法确保即使对于没有本地 Prometheus 抓取器的环境，也能实现一致的可观测性。

3. 具有联合租户的全球服务可观测性：通过配置 Telegraf 代理将数据推送到区域 Cortex 集群（每个集群都标记有租户标识符）来聚合来自全球基础设施的指标。 Cortex 处理跨区域的重复数据删除和集中访问。

4. 自定义应用程序遥测管道：通过 Telegraf 的 exec 或 http 输入插件收集特定于应用程序的遥测数据，并将其转发到 Cortex。 这使 DevOps 团队能够以可扩展、查询高效的格式监控特定于应用程序的 KPI，同时保持按租户或服务逻辑分组的指标。

反馈

感谢您成为我们社区的一份子！ 如果您有任何一般性反馈或在这些页面上发现任何错误，我们欢迎并鼓励您提出意见。 请在 InfluxDB 社区 Slack 中提交您的反馈。