Salesforce 和 Loki 集成

输入和输出集成概述

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

Loki 插件允许用户将日志发送到 Loki 进行聚合和查询，从而利用 Loki 高效的存储功能。

集成详情

Salesforce

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

Loki

此 Loki 插件与 Grafana Loki 集成，Grafana Loki 是一个强大的日志聚合系统。通过以与 Loki 兼容的格式发送日志，此插件可以高效地存储和查询日志。每个日志条目都以键值格式结构化，其中键表示字段名称，值表示相应的日志信息。日志按时间戳排序，确保通过 Loki 查询时日志流保持时间顺序。此插件对密钥的支持使安全管理身份验证参数变得更容易，而 HTTP 标头、gzip 编码和 TLS 配置的选项增强了日志传输的适应性和安全性，满足各种部署需求。

配置

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"

Loki

[[outputs.loki]]
  ## The domain of Loki
  domain = "https://loki.domain.tld"

  ## Endpoint to write api
  # endpoint = "/loki/api/v1/push"

  ## Connection timeout, defaults to "5s" if not set.
  # timeout = "5s"

  ## Basic auth credential
  # username = "loki"
  # password = "pass"

  ## Additional HTTP headers
  # http_headers = {"X-Scope-OrgID" = "1"}

  ## If the request must be gzip encoded
  # gzip_request = false

  ## Optional TLS Config
  # tls_ca = "/etc/telegraf/ca.pem"
  # tls_cert = "/etc/telegraf/cert.pem"
  # tls_key = "/etc/telegraf/key.pem"

  ## Sanitize Tag Names
  ## If true, all tag names will have invalid characters replaced with
  ## underscores that do not match the regex: ^[a-zA-Z_:][a-zA-Z0-9_:]*.
  # sanitize_label_names = false

  ## Metric Name Label
  ## Label to use for the metric name to when sending metrics. If set to an
  ## empty string, this will not add the label. This is NOT suggested as there
  ## is no way to differentiate between multiple metrics.
  # metric_name_label = "__name"

输入和输出集成示例

Salesforce

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

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

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

Loki

1. 微服务的集中日志记录：利用 Loki 插件从 Kubernetes 集群中运行的多个微服务收集日志。通过将日志定向到集中的 Loki 实例，开发人员可以在一个位置监控、搜索和分析来自所有服务的日志，从而更轻松地进行故障排除和性能监控。此设置简化了操作，并支持对分布式应用程序中的问题做出快速响应。

2. 实时日志异常检测：将 Loki 与监控工具结合使用，以实时分析日志输出中可能表明系统错误或安全威胁的异常模式。在日志流上实施异常检测使团队能够主动识别和响应事件，从而提高系统可靠性并增强安全态势。

3. 通过 Gzip 压缩增强日志处理：配置 Loki 插件以使用 gzip 压缩进行日志传输。这种方法可以减少带宽使用并提高传输速度，这在网络带宽可能受到限制的环境中尤其有利。它对于高容量日志记录应用程序尤其有用，在这些应用程序中，每个字节都很重要，性能至关重要。

4. 通过自定义标头支持多租户：利用添加自定义 HTTP 标头的功能来隔离多租户应用程序环境中的不同租户的日志。通过使用 Loki 插件为每个租户发送不同的标头，运营商可以确保正确的日志管理并遵守数据隔离要求，使其成为 SaaS 应用程序的通用解决方案。

反馈

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