日志集中管理 V 1.0
当前版本仅支持DZZ V2.3.8及以上版本使用，如需在低版本的DZZ中使用，请尝试到更新日志下载以往的版本。
返回
DzzOffice 日志集中管理插件 (CustomLog)
简介
日志集中管理插件可以将 DzzOffice 系统日志转发到外部系统，便于集中管理和分析。
功能特性
JSON文件日志：将日志以 JSON 格式写入 data/log/json/ 目录，便于日志采集工具（Filebeat、Fluentd 等）处理
远程日志服务器：将日志实时发送到远程日志收集服务器（ELK、Graylog、自建服务等）
灵活的认证方式：支持 Header、POST Body、GET Params 三种认证方式
多种 HTTP Method：支持 GET、POST、PUT、PATCH
安装方法
将 customlog 文件夹放置到 DzzOffice 的 dzz/ 目录下
在应用市场右下角选择 "导入"
选择 dzz_app_customlog.xml 文件
点击 "提交" 完成安装
配置说明
JSON文件日志
日志路径：data/log/json/（固定）
日志格式：每行一条 JSON 记录
文件命名：YYYY-MM-DD.log（按天分割）
远程日志服务器
| 配置项 | 说明 |
|---|---|
| 服务器地址 | 日志接收服务器的完整 URL |
| HTTP Method | GET / POST / PUT / PATCH |
| 超时时间 | 请求超时时间（秒），建议 1-5 秒 |
| 认证方式 | Header / POST Body / GET Params |
| 认证字段名 | 如 Authorization、X-API-Key、token |
| 认证字段值 | 认证密钥或 Token |
日志数据格式
{
"timestamp": 1703577600,
"datetime": "2025-12-26 12:00:00",
"type": "loginlog",
"content": "用户登录成功",
"user_id": 1,
"username": "admin",
"ip": "192.168.1.100",
"url": "/login?quot;,
"user_agent": "Mozilla/5.0 ...",
"referer": ""
}
与系统日志的关系
本插件不会影响系统自带的日志功能：
系统日志开关：在 系统日志 应用中控制
本插件开关：在 日志集中管理 应用中控制
两者独立运行，可同时启用或分别启用
常见集成场景
ELK Stack
启用 JSON 文件日志
使用 Filebeat 采集 data/log/json/*.log
发送到 Elasticsearch
自建日志服务
启用远程日志服务器
配置服务器地址和认证信息
在服务端接收 JSON 格式的日志数据
普通应用（dzz）
customlog
实用工具
7.0 +
-
该应用于 2025-12-27 14:55 上线，并发布了 V 1.0 版本。