内置数据过滤器
编辑内置数据过滤器编辑
内置数据过滤器允许您过滤或关闭以下类型数据的摄取
数据类型 | 常见敏感数据 |
---|---|
密码、信用卡号、授权等。 |
|
密码、信用卡号等。 |
|
客户端 IP 地址和用户代理。 |
|
访问的 URL、点击事件、用户浏览器错误、使用的资源等。 |
|
敏感的用户或商业信息 |
HTTP 标头编辑
默认情况下,APM 代理会捕获 HTTP 请求和响应标头(包括 Cookie)。大多数 Elastic APM 代理都提供清理 HTTP 标头字段的功能,包括 Cookie 和 application/x-www-form-urlencoded
数据(POST 表单字段)。查询字符串和捕获的请求正文(如 application/json
数据)不会被清理。
默认的清理字段列表试图针对与密码、信用卡号、授权等相关数据的常见字段名称,但可以根据您的数据进行自定义。这些敏感数据永远不会离开受监控的服务。
此设置支持集中配置,这意味着可以更新清理字段列表,而无需重新部署您的服务
- Go:
ELASTIC_APM_SANITIZE_FIELD_NAMES
- Java:
sanitize_field_names
- .NET:
sanitizeFieldNames
- Node.js:
sanitizeFieldNames
- Python:
sanitize_field_names
- Ruby:
sanitize_field_names
或者,您可以完全禁用 HTTP 标头的捕获。此设置也支持集中配置
- Go:
ELASTIC_APM_CAPTURE_HEADERS
- Java:
capture_headers
- .NET:
CaptureHeaders
- Node.js:
captureHeaders
- Python:
capture_headers
- Ruby:
capture_headers
HTTP 正文编辑
默认情况下,不会记录 HTTP 请求的正文。请求正文通常包含密码或信用卡号等敏感数据,因此启用此功能时请务必小心。
此设置支持集中配置,这意味着可以更新清理字段列表,而无需重新部署您的服务
- Go:
ELASTIC_APM_CAPTURE_BODY
- Java:
capture_body
- .NET:
CaptureBody
- Node.js:
captureBody
- Python:
capture_body
- Ruby:
capture_body
个人数据编辑
默认情况下,APM 服务器会捕获一些与跟踪事件相关的个人数据
-
client.ip
:客户端的 IP 地址。通常从传入请求的 HTTP 标头中获取。client.ip
还与geoip
处理器结合使用,为跟踪事件分配地理信息。要详细了解如何获取client.ip
,请参阅获取传入请求的client.ip
地址。 -
user_agent
:用户代理数据,包括客户端操作系统、设备名称、供应商和版本。
可以通过将捕获个人数据设置为 false
来关闭此数据的捕获。
真实用户监控数据编辑
保护用户数据非常重要。因此,可以使用disableInstrumentations
配置变量在 RUM 代理中禁用单个 RUM 检测。禁用的检测不会生成任何跨度或事务。
禁用 | 配置值 |
---|---|
HTTP 请求 |
|
页面加载指标,包括静态资源 |
|
浏览器上的 JavaScript 错误 |
|
用户点击事件,包括访问的 URL、鼠标点击和导航事件 |
|
单页应用程序路由更改 |
|
数据库语句编辑
对于 SQL 数据库,APM 代理不会捕获预处理语句的参数。请注意,Elastic APM 目前不会尝试去除常规语句的参数。不使用预处理语句会使您的代码容易受到 SQL 注入攻击,因此请务必使用预处理语句。
对于非 SQL 数据存储(如 Elasticsearch 或 MongoDB),Elastic APM 会捕获查询的完整语句。对于插入或更新操作,不会存储完整的文档。要过滤或混淆非 SQL 数据库语句中的数据,或者完全删除语句,您可以设置摄取节点管道。
特定于代理的选项编辑
某些代理提供额外的过滤和混淆选项
代理配置选项
- (Node.js)删除服务器端进程引发的错误:使用captureExceptions禁用。
- (Java)从事务中删除进程参数:默认情况下使用
include_process_args
禁用。