当前位置: 首页 > 科技观察

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

时间:2023-03-13 14:48:55 科技观察

Relay的配置记录在文件.relay/config.yml中。要更改此位置,请将--config选项传递给任何Relay命令:./relayrun--config/path/to/folder所有配置键都是snake_case。Relay的Relay一般设置记录如下::String,default:managed,可能的值:managed,static,proxy,andcapture控制Relay如何捕获事件的项目配置。有关这些模式的详细说明,请参阅中继模式。relay.upstream:字符串,默认值:https://sentry.io上游中继或哨兵实例的完全限定URL。中继不检查环路。不要将此选项设置为会导致事件循环返回此处的端点。relay.hostString,默认值:Docker中的0.0.0.0,否则127.0.0.1elay应该绑定到主机(网络接口)。示例:0.0.0.0relay.port:Integer,默认:3000为未加密的RelayHTTP服务器绑定的端口。示例:3000relay.tls_port:Integer,optional是绑定到加密RelayHTTPS服务器的可选端口。示例:3001这是对port选项的补充:如果在tls_port上设置了HTTPS服务器,那么port上的HTTP服务器仍然存在。relay.tls_identity_path:字符串,可选HTTPS服务器身份的文件系统路径(DER编码的PKCS12)。相对路径在当前工作目录中计算。例如:relay_dev.pfxrelay.tls_identity_password:字符串,optionalrelay.tls_identity_path中PKCS12存档的密码。HTTP这些设置控制与网络相关的配置。http.timeout:整数,默认值:5上游请求的超时时间(以秒为单位)。此超时涵盖从发送请求到接收响应标头的时间。此超时既不包括连接过程和握手,也不包括读取响应文本。:http.connection_timeout:Integer,default:3与上游建立连接的超时时间(以秒为单位)。这包括SSL握手。当上游支持连接保持活动时,中继重用连接。连接最多保持75秒,不活动状态保持15秒。http.max_retry_interval:整数,默认值:60失败请求重试之间的最大间隔(以秒为单位)。http.host_header:String,default:null自定义HTTPHostheader发送上游。缓存(caching)这些设置可以微调项目状态的缓存。cache.project_expiry:整数,默认:项目配置的300(5分钟)缓存超时(以秒为单位)。如果您使用“simpleproxymode”并且您的项目配置存储在本地文件中并不重要。cache.project_grace_period:Integer,default:0(seconds)获取新状态时缓存过期后继续使用此项目配置的秒数。这是在cache.project_expiry和cache.miss_expiry之上添加的。cache.relay_expiry:Integer,default:3600(1hour)下游中继信息(公钥)的缓存超时时间(秒)。这仅在您计划将更多中继连接到此中继时才有意义。cache.envelope_expiry:整数,默认值:600(10分钟)在网络问题或积压的情况下,中继将在其缓存中缓冲传入有效负载的最长时间。这适用于发送到中继的所有类型的数据,包括事件、附件和会话。另见cache.envelope_buffer_size。cache.miss_expiry:整数,默认值:60(1分钟)不存在的条目的缓存超时。cache.batch_interval:整数,默认值:60(1分钟)不存在条目的缓存超时。cache.batch_size:Integer,default:500一次从sentry获取的项目配置的最大个数。cache.file_interval:Integer,default:10(10seconds)监控本地缓存覆盖文件的时间间隔(以秒为单位)。cache.envelope_buffer_size:整数,默认值:1000在出现网络问题或积压时要缓冲的传入有效负载的最大数量。这适用于发送到中继的所有类型的数据,包括事件、附件和会话。另见cache.envelope_expiry。cache.eviction_interval:整数,默认值:60(秒)从内存中逐出陈旧项目配置的时间间隔。SizeLimits(大小限制)这些设置控制与HTTP相关的限制。所有值都是整数或人类可读的数字字符串和人类可读的单位,例如:500B1kB(1,000字节)1KB或1KiB(1,024字节)1MB(1,000,000字节)1MiB(1,048,576字节)limits.max_concurrent_requests:Integer,default:100上行最大并发连接数。如果上游支持,中继支持连接保活。limits.max_concurrent_queries:整数,默认值:5在Relay开始缓冲请求之前,可以从Relayupstream同时发送的最大查询数。查询是对信息向上游提出的所有请求,并明确排除事件提交。查询的并发数也受max_concurrent_requests限制。limits.max_event_size:字符串,默认值:1MiB事件的最大有效负载大小。limits.max_attachment_size:字符串,默认值:50MiB每个附件的最大大小。limits.max_attachments_size:String,default:50MiB请求中所有附件的信封(envelope)或最大组合大小。limits.max_envelope_size:字符串,默认值:50MiB整个信封的最大有效负载大小。个人限制仍然适用。limits.max_session_count:整数,默认值:100每个信封的最大会话项目数。limits.max_api_payload_size:String,default:20MiB一般API请求的最大payload大小。limits.max_api_file_upload_size:字符串,默认值:40MiB文件上传和块的最大有效负载大小。limits.max_api_chunk_upload_size:字符串,默认值:100MiB块的最大有效负载大小。limits.max_thread_count:整数,默认值:numberofcpus为每个CPU和WebWorker生成的最大线程数。生成的线程总数大约为2*limits.max_thread_count+N,其中N是一组固定的管理线程。limits.query_timeout:整数,默认值:30(秒)允许查询重试的最大秒数。个别请求的超时时间更短。limits.max_connection_rate:Integer,default:256一次可以创建的Relay最大连接数。limits.max_pending_connections:整数,默认值:2048到中继的最大挂起连接数。这对应于POSIX中listen(2)的backlog参数。limits.max_connections:整数:默认值:25_000中继打开的最大传入连接数。limits.shutdown_timeout:Integer,default:L10(seconds)收到关机信号后等待挂起事件的最大秒数。日志记录(logging)logging.level:String,默认:inforelay的日志级别。以下之一:offererrorwarninfodebugtrace在调试和跟踪级别,Relay会发出极其冗长的消息,这会对应用程序性能产生严重影响。logging.log_failed_pa??yloads:布尔值,默认值:false将失败事件的完整事件有效负载记录到日志流中。logging.format:String,default:auto控制日志格式。以下之一:auto:自动检测(非常适合TTY,其他已简化)pretty:具有颜色的人类可读格式simplified:简化的人类可读日志输出json:JSON记录,适用于日志记录软件logging.enable_backtraces:boolean,默认:true如果启用,将所有内部错误的痕迹写回日志流,并将它们包含在哨兵错误中。StatsDMetrics(统计指标)metrics.statsdString,如果optional设置为host/portstring,指标会上报给这个StatsD实例。metrics.prefix:String,default:sentry.relay应该添加到所有指标的前缀中。metrics.default_tags:Mapofstringstostrings,default:empty应附加到所有传出StatsD指标的一组默认标签。metrics.hostname_tag:字符串,可选如果设置,添加一个具有给定名称的标签并将其设置为运行中继的机器的主机名。此配置对于区分多个继电器很有用。metrics.buffering:boolean,default:true是否在发送到StatsDserver之前缓冲发出的指标。这通常会提高性能,但需要注意的是,在低流量条件下,指标可能需要额外几秒钟才能传播。metrics.sample_rate:Float,default1.0所有发出指标的全局采样率。应介于0.0和1.0之间。如果超出该范围,该值将被归一化(负值将变为0.0,大于1.0的正值将变为1.0)。例如,值为0.3表示仅发送30%的已发出指标。请注意,实施的抽样方法不知道指标类型,例如当采样率小于1.0时,计数器值不会重新缩放。:InternalErrorReporting为中继中发生的错误配置错误报告。默认情况下禁用。sentry.enabled:boolean,default:false是否向单独的DSN报告内部错误。false表示不会发送内部错误,但仍会记录下来。sentry.dsn:字符串,可选向其报告内部中继故障的SentryDSN。我们建议将此设置为不会向自身发送中继错误的值。理想情况下,此值应将错误直接发送到Sentry,而不是另一个中继。