tencent cloud

边缘安全加速平台 EO

动态与公告
产品动态
安全公告
产品公告
产品简介
产品概述
产品优势
应用场景
EdgeOne 与 CDN 等产品功能对比
使用限制
购买指南
试用套餐体验权益说明
免费版套餐使用说明
计费概述
计费项目
购买指引
续费指引
欠费与退款说明
套餐选型对比
关于“干净流量”计费说明
DDoS 防护容量说明
快速入门
选择业务场景
快速接入网站安全加速
通过 Pages 快速部署网站
域名服务与源站配置
域名服务
HTTPS 证书
源站配置
站点加速
概述
访问控制
智能加速
缓存配置
文件优化
网络优化
URL 重写
修改头部
修改应答内容
规则引擎
图片与视频处理
单连接下载限速
DDoS 与 Web 防护
概述
DDoS 防护
Web 防护
Bot 管理
API 资产识别(Beta)
边缘函数
概述
快速指引
操作指引
Runtime APIs
示例函数
实践教程
Pages
四层代理
概述
新建四层代理实例
修改四层代理实例配置
停用/删除四层代理实例
批量配置转发规则
获取客户端真实IP
数据分析与日志服务
日志服务
数据分析
告警服务
站点与计费管理
计费管理
站点管理
版本管理
通用策略
通用参考
配置语法
请求与响应行为
国家/地区及对应代码枚举
Terraform
Terraform 简介
安装和配置 Terraform
实践教程
自动预热/清除缓存
防盗刷/盗链实践
HTTPS 相关实践
加速优化
流量调度
数据分析与告警
第三方日志平台集成实践
对象存储类源站(例如:COS)配置实践
跨域响应配置
API 文档
History
Introduction
API Category
Making API Requests
Site APIs
Acceleration Domain Management APIs
Site Acceleration Configuration APIs
Edge Function APIs
Alias Domain APIs
Security Configuration APIs
Layer 4 Application Proxy APIs
Content Management APIs
Data Analysis APIs
Log Service APIs
Billing APIs
Certificate APIs
Origin Protection APIs
Load Balancing APIs
Diagnostic Tool APIs
Custom Response Page APIs
API Security APIs
DNS Record APIs
Content Identifier APIs
Legacy APIs
Ownership APIs
Image and Video Processing APIs
Multi-Channel Security Gateway APIs
Version Management APIs
Data Types
Error Codes
常见问题
产品特性相关问题
DNS 记录相关问题
域名配置相关问题
站点加速相关问题
数据与日志相关问题
安全防护相关问题
源站配置相关问题
排障指南
异常状态码参考
EdgeOne 4XX/5XX 状态码排障指南
520/524状态码排障指南
521/522 状态码排障指南
工具指南
相关协议
Service Level Agreement
源站防护启用特别约定
TEO 政策
隐私协议
数据处理和安全协议
联系我们
词汇表

自定义推送日志字段

PDF
聚焦模式
字号
最后更新时间: 2025-07-28 14:45:51
如果您需要推送 HTTP 请求头、HTTP 响应头、Cookie、HTTP 请求正文中的某些字段值,您可以通过自定义日志字段功能将此类信息精确记录在日志中。

使用限制说明

目前仅实时日志-站点加速日志支持添加自定义字段;
同一个实时日志推送任务中,自定义字段名称不能重复;
最多配置 200 个自定义字段;
字段名称区分大小写,需要与 HTTP 行为中的原始字段名称完全匹配;
字段类型选择请求头、响应头、Cookie 时,字段名称可输入 1-100 个字符,允许的字符开头为字母,中间为字母、数字、-,结尾为字母、数字;
字段类型选择请求正文时,支持通过 Google RE2 正则表达式提取指定内容;
单个请求正文类型字段,正则表达式长度上限为 4KB;
单个请求正文类型字段,提取内容的长度上限为 1000 Bytes,超过此上限的内容将会被截断丢弃;
单个实时日志推送任务最多添加 5 个请求正文类型的自定义字段。

示例一:在日志中记录指定响应头部的值

示例场景

在某些业务场景下,了解响应体的大小对于监控网络流量和优化性能至关重要。为了实现这一目的,可以配置自定义日志字段来记录每个响应的Content-Length头部的值。

操作步骤

1. 登录 边缘安全加速平台 EO 控制台,在左侧菜单栏中,进入服务总览,单击网站安全加速内需配置的站点。
2. 在站点详情页面,单击日志服务 > 实时日志。
3. 在实时日志页面,单击新建推送任务。
4. 在选择日志源页面,填写任务名称、选择日志类型、服务区域、需推送日志的域名,单击下一步
5. 在定义推送内容页面,单击添加自定义字段
5.1 选择字段类型为响应头;
5.2 填写字段名称为Content-Length
5.3 单击保存

6. 完成目的地配置后,单击推送

示例二:在日志中记录请求正文中的指定内容

示例场景

假设您需要从 POST 请求中提取请求正文 JSON 对象中的 account 字段,用于分析不同账号用户的访问行为。

操作步骤

1. 登录 边缘安全加速平台 EO 控制台,在左侧菜单栏中,进入服务总览,单击网站安全加速内需配置的站点。
2. 在站点详情页面,单击日志服务 > 实时日志。
3. 在实时日志页面,单击新建推送任务。
4. 在选择日志源页面,填写任务名称、选择日志类型、服务区域、需推送日志的域名,单击下一步
5. 在定义推送内容页面,单击添加自定义字段
5.1 选择字段类型为请求正文。
5.2 填写字段名称为"account": "(.*?)"
5.3 单击保存



6. 完成目的地配置后,单击推送
7. 发送测试请求检查日志记录行为是否符合预期,测试命令如下:
curl -X POST https://www.example.com -H "Content-Type: application/json" -d '{"account": "user123", "password": "pass456"}'
8. 接收到的日志将会增加RequestBodyCustom1字段,示例以键值对形式展示如下。若您在单个实时日志推送任务中添加多个请求正文类型自定义字段,则接收到的日志将会依次增加RequestBodyCustom1RequestBodyCustom2……多个字段。
{"RequestBodyCustom1":"\\"account\\": \\"user123\\""}

参考资料

如您希望了解各种 HTTP 请求头和响应头的释义,以决定是否将它们记录至日志中,请参考 HTTP 标准头部说明

帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈