1. 树叶云首页
  2. 技术资讯

Sentry 企业级数据安全解决方案 – Relay 配置选项

管理••技术资讯

Relay 的配置记录在文件 .relay/config.yml 中。要更改此位置，请将 –config 选项传递给任何 Relay 命令：

  1. ./relay run --config /path/to/folder 

所有配置 key 都是 snake_case。

Relay

以下记录了 Relay 的常规设置：

  1. : String, default: managed, 可能的值: managed, static, proxy 和 capture 
  2.  
  3. 控制 Relay 如何获取事件的项目配置。有关这些模式的详细说明，请参阅 Relay模式。 

relay.upstream

  1. : String, default: https://sentry.io 上游 Relay 或 Sentry 实例的完全限定 URL。 
  2.  
  3. Relay 不会检查循环。不要将此选项设置为会导致事件循环回到此处的端点。 

relay.host

  1. String, default: Docker 中 0.0.0.0, 否则 127.0.0.1 
  2.  
  3. elay 应该绑定到的主机(网络接口)。示例：0.0.0.0 

relay.port

  1. : Integer, default: 3000 
  2.  
  3. 为未加密的 Relay HTTP server 绑定的端口。示例：3000 

relay.tls_port

  1. : Integer, optional 
  2.  
  3. 为加密 Relay HTTPS server 绑定的可选端口。示例：3001 
  4.  
  5. 这是对 port 选项的补充：如果你在 tls_port 上设置了一个 HTTPS 服务器，那么 port 上的 HTTP server 仍然存在。 

relay.tls_identity_path

  1. : String, optional 
  2.  
  3. 用于 HTTPS server 的身份（DER-encoded PKCS12）的文件系统路径。在当前工作目录中评估相对路径。例如：relay_dev.pfx 

relay.tls_identity_password

  1. : String, optional 
  2.  
  3. relay.tls_identity_path 中 PKCS12 存档的密码。 

HTTP

这些设置控制与网络相关的配置。

http.timeout

  1. : Integer, default: 5 
  2.  
  3. 上游请求的超时时间（以秒为单位）。 
  4.  
  5. 此超时涵盖从发送请求到接收响应头的时间。此超时既不包括连接过程和握手，也不包括读取响应正文。 

:http.connection_timeout

  1. : Integer, default: 3 
  2.  
  3. 与上游建立连接的超时时间（以秒为单位）。 
  4.  
  5. 这包括 SSL 握手。当上游支持连接保持活动时，Relay 重用连接。连接最多保留 75 秒，不活动保留 15 秒。 

http.max_retry_interval

  1. : Integer, default: 60 
  2.  
  3. 失败请求重试之间的最大间隔（秒）。 

http.host_header

  1. : String, default: null 
  2.  
  3. 要发送到上游的自定义 HTTP Host header。 

Caching(缓存)

这些设置可以微调项目状态的缓存。

cache.project_expiry

  1. : Integer, default: 300 (5 minutes) 
  2.  
  3. 项目配置的缓存超时（以秒为单位）。如果您使用 "simple proxy mode"，您的项目配置存储在本地文件中，则无关紧要。 

cache.project_grace_period

  1. : Integer, default: 0 (seconds) 
  2.  
  3. 在获取新状态时缓存到期后继续使用此项目配置的秒数。这是在 cache.project_expiry 和 cache.miss_expiry 之上添加的。 

cache.relay_expiry

  1. : Integer, default: 3600 (1 hour) 
  2.  
  3. 下游 Relay 信息（公钥）的缓存超时（以秒为单位）。这仅在您计划将更多 Relay 连接到此 Relay 时才相关。 

cache.envelope_expiry

  1. : Integer, default: 600 (10 minutes) 
  2.  
  3. 在网络问题或积压的情况下，Relay 在其缓存中缓冲传入有效负载的最长时间。这适用于发送到 Relay 的所有类型的数据，包括事件、附件和会话。 
  4.  
  5. 另见 cache.envelope_buffer_size。 

cache.miss_expiry

  1. : Integer, default: 60 (1 minute) 
  2.  
  3. 不存在的条目的缓存超时。 

cache.batch_interval

  1. : Integer, default: 60 (1 minute) 
  2.  
  3. 不存在的条目的缓存超时。 

cache.batch_size

  1. : Integer, default: 500 
  2.  
  3. 一次从 Sentry 获取的最大项目配置数。 

cache.file_interval

  1. : Integer, default: 10 (10 seconds) 
  2.  
  3. 监视本地缓存覆盖文件的时间间隔(以秒为单位)。 

cache.envelope_buffer_size

  1. : Integer, default: 1000 
  2.  
  3. 在网络问题或积压的情况下缓冲的传入有效负载的最大数量。这适用于发送到 Relay 的所有类型的数据，包括事件、附件和会话。 
  4.  
  5. 另见 cache.envelope_expiry。 

cache.eviction_interval

  1. : Integer, default: 60 (seconds) 
  2.  
  3. 从内存中驱逐过时的项目配置的时间间隔。 

Size Limits(大小限制)

这些设置控制与 HTTP 相关的限制。所有值要么是整数，要么是人类可读的数字字符串和人类可读的单位，例如：

  • 500B
  • 1kB (1,000 bytes)
  • 1KB or 1KiB (1,024 bytes)
  • 1MB (1,000,000 bytes)
  • 1MiB (1,048,576 bytes)

limits.max_concurrent_requests

  1. : Integer, default: 100 
  2.  
  3. 上游的最大并发连接数。如果上游支持，Relay 支持连接保活(keepalive)。 

limits.max_concurrent_queries

  1. : Integer, default: 5 
  2.  
  3. 在 Relay 开始缓冲请求之前，可以同时从 Relay upstream 发送的最大查询数。查询是为了获取信息而向上游发出的所有请求，并明确地排除事件提交。 
  4.  
  5. 查询的并发性还受到 max_concurrent_requests 的限制。 

limits.max_event_size

  1. : String, default: 1MiB 
  2.  
  3. 事件的最大负载大小。 

limits.max_attachment_size

  1. : String, default: 50MiB 
  2.  
  3. 每个附件的最大大小。 

limits.max_attachments_size

  1. : String, default: 50MiB 
  2.  
  3. 信封(envelope)或请求中所有附件的最大组合大小。 

limits.max_envelope_size

  1. : String, default: 50MiB 
  2.  
  3. 整个信封的最大有效负载大小。个人限制仍然适用。 

limits.max_session_count

  1. : Integer, default: 100 
  2.  
  3. 每个信封的最大会话项目数。 

limits.max_api_payload_size

  1. : String, default: 20MiB 
  2.  
  3. 一般 API 请求的最大负载大小。 

limits.max_api_file_upload_size

  1. : String, default: 40MiB 
  2.  
  3. 文件上传和块(chunks)的最大有效负载大小。 

limits.max_api_chunk_upload_size

  1. : String, default: 100MiB 
  2.  
  3. 块的最大有效负载大小。 

limits.max_thread_count

  1. : Integer, default: number of cpus 
  2.  
  3. 为每个 CPU 和 Web Worker 生成的最大线程数。 
  4.  
  5. 产生的线程总数大致为 2 * limits.max_thread_count + N，其中 N 是一组固定的管理线程。 

limits.query_timeout

  1. : Integer, default: 30 (seconds) 
  2.  
  3. 允许查询重试的最大秒数。单个请求的超时时间较短。 

limits.max_connection_rate

  1. : Integer, default: 256 
  2.  
  3. 一次可以创建的与 Relay 的最大连接数。 

limits.max_pending_connections

  1. : Integer, default: 2048 
  2.  
  3. 最大挂起连接到 Relay 的数量。这对应于 POSIX 中 listen(2) 的 backlog 参数。 

limits.max_connections

  1. : Integer: default: 25_000 
  2.  
  3. Relay 打开的最大传入连接数。 

limits.shutdown_timeout

  1. : Integer, default:L 10 (seconds) 
  2.  
  3. 接收到关闭信号后等待挂起事件的最大秒数。 

Logging(日志记录)

logging.level

  1. : String, default: info 
  2.  
  3. relay 的日志级别。以下之一： 
  4.  
  5. off 
  6. error 
  7. warn 
  8. info 
  9. debug 
  10. trace 
  11. 在 debug 和 trace 级别，Relay 会发出极其冗长的消息，这可能会对应用程序性能产生严重影响。 

logging.log_failed_payloads

  1. : boolean, default: false 
  2.  
  3. 将失败事件的完整事件负载记录到日志流中。 

logging.format

  1. : String, default: auto 
  2.  
  3. 控制日志格式。以下之一： 
  4.  
  5. auto: 自动检测(非常适合 TTY，其他则简化) 
  6.  
  7. pretty: 带有颜色的人类可读格式 
  8.  
  9. simplified: 简化的人类可读日志输出 
  10.  
  11. json: JSON 记录，适用于日志软件 

logging.enable_backtraces

  1. : boolean, default: true 
  2.  
  3. 如果启用，将所有内部错误的跟踪写回日志流并将它们包含在 Sentry 错误中。 

StatsD Metrics(统计指标)

metrics.statsd

  1. String, optional 
  2.  
  3. 果设置为 host/port 字符串，则指标将报告给此 StatsD 实例。 

metrics.prefix

  1. : String, default: sentry.relay 
  2.  
  3. 应添加到所有指标的前缀。 

metrics.default_tags

  1. : Map of strings to strings, default: empty 
  2.  
  3. 一组应附加到所有传出 StatsD 指标的默认标签。 

metrics.hostname_tag

  1. : String, optional 
  2.  
  3. 如果设置，则添加给定名称的标签并将其设置为运行 Relay 的机器的 hostname。此配置对于区分多个 Relay 很有用。 

metrics.buffering

  1. : boolean, default: true 
  2.  
  3. 在发送到 StatsD server 之前是否会缓冲发出的指标。这通常会提高性能，但需要注意的是，在流量较低的情况下，指标可能需要多几秒钟才能传播。 

metrics.sample_rate

  1. : Float, default 1.0 
  2.  
  3. 所有发出的指标的全局采样率。应该在 0.0 和 1.0 之间。如果超出该范围，该值将被归一化（负值将变为 0.0，大于 1.0 的正值变为 1.0）。例如，0.3 的值意味着只有 30% 的已发出指标将被发送。请注意，实施的采样方法不知道指标类型，例如，当采样率小于 1.0 时，不会重新调整计数器值。 

: Internal Error Reporting(内部错误报告)

为 Relay 中发生的错误配置错误报告。默认禁用。

sentry.enabled

  1. : boolean, default: false 
  2.  
  3. 是否向单独的 DSN 报告内部错误。false 表示不会发送内部错误，但仍会记录。 

sentry.dsn

  1. : String, optional 
  2.  
  3. 向其报告内部 Relay 故障的 Sentry DSN。 
  4.  
  5. 我们建议将其设置为不会向自身发送 Relay 错误的值。理想情况下，这个值应该直接向 Sentry 发送错误，而不是另一个 Relay。 

 

文章来源网络，作者：管理，如若转载，请注明出处：https://shuyeidc.com/wp/150436.html<

赞 (0)
管理的头像管理
00
上一篇2025-03-13 02:07
下一篇 2025-03-13 02:08

相关推荐

  • jsp空间购买和交换数据空间怎么买，有哪些注意事项？技术资讯

    jsp空间购买和交换数据空间怎么买，有哪些注意事项？

    购买JSP空间时，是否考虑过数据交换空间的性能？简米科技（2003年始创，23年行业沉淀）与酷番云（工信部一类增值电信全牌照）这类持牌自营机房的服务商，能确保数据交换的高效稳定，是值得优先选择的合作伙伴，为什么JSP空间需要搭配独立的数据交换空间从JSP应用特性看数据交换需求JSP基于Java技术,常用于企业级……

    管理的头像管理
    2026-08-11
    0
  • 建网站用香港空间效果怎么样，香港空间稳定吗？技术资讯

    建网站用香港空间效果怎么样，香港空间稳定吗？

    建网站用香港空间，对于创建网站资产来说，核心价值在于免备案和全球带宽优势，尤其适合外贸、跨境电商和需要快速启动的项目，但你必须权衡国内访问延迟，并选择有资质的服务商以保证资产安全，香港空间的核心优势与适用边界免备案：节省时间就是节省成本国内服务器需要备案,通常需要10到20天，香港空间无需备案，域名解析后即可上……

    管理的头像管理
    2026-08-11
    0
  • Java连接云数据库的方法是什么，如何操作技术资讯

    Java连接云数据库的方法是什么，如何操作

    Java连接云数据库的核心在于通过JDBC驱动，结合云服务商提供的连接地址、端口、数据库名及认证信息，配置安全策略（如SSL、IP白名单），即可实现稳定高效的远程数据库访问，基础准备：JDBC驱动与依赖管理连接云数据库前,需要确保开发环境具备对应的JDBC驱动，以最常见的MySQL为例，你需要引入mysql-c……

    管理的头像管理
    2026-08-11
    0
  • 建网站公安联网备案必须使用数据码吗，备案流程是什么技术资讯

    建网站公安联网备案必须使用数据码吗，备案流程是什么

    网站备案包括ICP备案和公安联网备案，两者缺一不可，公安联网备案必须使用服务商提供的数据码，选择持有合法资质的服务商是顺利通过备案的前提，为什么网站必须进行公安联网备案根据公安部《计算机信息网络国际联网安全保护管理办法》，网站开通后30日内必须到公安机关办理备案手续，未完成公安备案的网站，面临责令整改、关闭网站……

    管理的头像管理
    2026-08-10
    0
  • 建一个企业网站大概需要多少钱？，怎么收费？技术资讯

    建一个企业网站大概需要多少钱？，怎么收费？

    建网站要多少钱，没有一个固定的数字，几百到几万都可能，但真正的“创建网站资产”绝不仅仅是初次投入的成本，而是基于长期稳定、合规和安全的持续性投入，其中核心取决于你选择了什么样的“地基”来承载你的业务，建站预算的构成与行业基准当你开始规划一个网站，最先面对的就是预算问题，一个常见的误区是只关注网站“看起来”的建造……

    管理的头像管理
    2026-08-10
    0

发表回复

您的邮箱地址不会被公开。必填项已用 * 标注