Sentry 開(kāi)發(fā)者貢獻(xiàn)指南 - SDK 開(kāi)發(fā)(數(shù)據(jù)處理)
敏感數(shù)據(jù)
在較舊的 SDK 中,您有時(shí)可能會(huì)看到復(fù)雜的構(gòu)造以允許用戶(hù)剝離敏感數(shù)據(jù)。較新的 SDK 不再具有此功能,因?yàn)榫S護(hù)每個(gè) SDK 太難了。相反,只剩下兩個(gè)簡(jiǎn)單的配置選項(xiàng):
- send-default-pii 默認(rèn)是禁用的,這意味著默認(rèn)情況下不發(fā)送自然敏感的數(shù)據(jù)。這意味著,例如:
- https://docs.sentry.io/error-reporting/configuration/#send-default-pii
- 將 HTTP 請(qǐng)求附加到事件時(shí),"raw(原始)" 主體(無(wú)法解析為 JSON 或 formdata 的主體)將被刪除,并且已知的敏感 header(例如 Authorization 或 Cookies)也將被刪除。
- 用戶(hù)特定信息(例如,根據(jù)所使用的 Web 框架的當(dāng)前用戶(hù) ID)根本不會(huì)發(fā)送。
- 請(qǐng)注意,如果用戶(hù)在 scope 內(nèi)明確設(shè)置請(qǐng)求,則不會(huì)從該請(qǐng)求中刪除任何內(nèi)容。上述規(guī)則僅適用于 SDK 附帶的集成。
- before-send 可用于注冊(cè)具有自定義邏輯的回調(diào)以刪除敏感數(shù)據(jù)。
- https://docs.sentry.io/error-reporting/configuration/#before-send
可變大小
事件負(fù)載中允許用戶(hù)指定值或動(dòng)態(tài)值的字段大小受到限制。這適用于大多數(shù)元數(shù)據(jù)字段,例如堆棧跟蹤中的變量,以及上下文(context)、標(biāo)簽(tag)和額外數(shù)據(jù)(extra):
- 值的映射(例如 HTTP data、extra data 等)限制為 50 個(gè) item 對(duì)。
- Event ID 限制為 36 個(gè)字符,并且必須是有效的 UUID。
- Tag key 限制為 32 個(gè)字符。
- Tag 值限制為 200 個(gè)字符。
- Culprits 限制為 200 個(gè)字符。
- Context 對(duì)象限制為 8kB。
- 單個(gè) extra data 項(xiàng)限制為 16kB。總 extra data 限制為 256kb。
- Message 限制為 8192 個(gè)字符。
- HTTP data(body)限制為 8kB。在將 HTTP data 附加到事件之前,始終對(duì)其進(jìn)行修剪。
- 堆棧跟蹤限制為 50 幀。如果發(fā)送更多,數(shù)據(jù)將從堆棧的中間刪除。
此外,大小限制適用于所有存儲(chǔ)請(qǐng)求,包括請(qǐng)求(request)、事件負(fù)載(event payload)和附件(attachment)的總大小。Sentry 拒絕所有超過(guò)這些限制的請(qǐng)求。請(qǐng)參閱以下資源以了解確切的大小限制:
- 信封(Envelope)端點(diǎn)大小限制
- https://develop.sentry.dev/sdk/envelopes/#size-limits
- 存儲(chǔ)(Store)端點(diǎn)大小限制
- https://develop.sentry.dev/sdk/store/#size-limits
更多
Sentry 開(kāi)發(fā)者貢獻(xiàn)指南 - SDK 開(kāi)發(fā)(性能監(jiān)控:Sentry SDK API 演進(jìn))