Skip to content

访问日志组件

异步保存访问日志

URL: https://demo.youshengyun.com/server-log/services/rest/v1/accessLog/asyncSaveLog

Type: POST

Author: mengjuhua

Content-Type: application/json

Description: 异步保存访问日志

Body-parameters:

ParameterTypeRequiredDescriptionSinceExample
idstringfalse唯一标识-
logTimestringfalse日志记录时间-" 2025-12-09 10:09:47"
systemNamestringfalse系统名称-
modularNamestringfalse模块名称,比如:公文就转-发文-授权管理-
methodNamestringfalse方法类和名称-
logLevelstringfalse日志级别: 普通日志、管理日志、错误日志、警告日志、信息日志、调试日志、跟踪日志-
operateTypestringfalse操作类别: 查看,增加,修改,删除,发送,活动,登录,退出,检查-
operateNamestringfalse操作名称-
elapsedTimeint64false用时-0
serverIpstringfalse服务器ip-
successstringfalse是否成功-
requestUrlstringfalse访问路径-
errorMessagestringfalse错误信息-
logMessagestringfalse日志信息-
throwablestringfalse异常信息-
userHostIpstringfalse用户ip-
userAgentstringfalse浏览器信息-
macAddressstringfalsemac地址-
tenantIdstringfalse租户id-
tenantNamestringfalse租户名称-
userIdstringfalse用户id-
userNamestringfalse用户名称-
loginNamestringfalse登录名称-
dnstringfalse用户的承继关系-
guidPathstringfalse用户的由ID组成的父子关系列表,之间用逗号分隔-
managerLevelint32false三员级别:0:一般用户,1:系统管理员,2:安全保密员,3:安全审计员,4:云系统管理员,5:云安全保密员,6:云安全审计员-0

Request-example:

bash
curl -X POST -k -H "Content-Type: application/json" -i 'https://demo.youshengyun.com/server-log/services/rest/v1/accessLog/asyncSaveLog' --data '{
  "id": "",
  "logTime": "     2025-12-09 10:09:47",
  "systemName": "",
  "modularName": "",
  "methodName": "",
  "logLevel": "",
  "operateType": "",
  "operateName": "",
  "elapsedTime": 0,
  "serverIp": "",
  "success": "",
  "requestUrl": "",
  "errorMessage": "",
  "logMessage": "",
  "throwable": "",
  "userHostIp": "",
  "userAgent": "",
  "macAddress": "",
  "tenantId": "",
  "tenantName": "",
  "userId": "",
  "userName": "",
  "loginName": "",
  "dn": "",
  "guidPath": "",
  "managerLevel": 0
}'

Response-fields:

FieldTypeDescriptionSinceExample
successboolean操作是否成功-true
codeint32错误代码-0
msgstring操作描述-
dataobject操作成功返回的数据-
└─any objectobjectany object.-

Response-example:

json
{
  "success": true,
  "code": 0,
  "msg": "",
  "data": {}
}

保存日志 保存访问日志

URL: https://demo.youshengyun.com/server-log/services/rest/v1/accessLog/saveLog

Type: POST

Author: mengjuhua

Content-Type: application/json

Description: 保存日志 保存访问日志

Body-parameters:

ParameterTypeRequiredDescriptionSinceExample
idstringfalse唯一标识-
logTimestringfalse日志记录时间-" 2025-12-09 10:09:47"
systemNamestringfalse系统名称-
modularNamestringfalse模块名称,比如:公文就转-发文-授权管理-
methodNamestringfalse方法类和名称-
logLevelstringfalse日志级别: 普通日志、管理日志、错误日志、警告日志、信息日志、调试日志、跟踪日志-
operateTypestringfalse操作类别: 查看,增加,修改,删除,发送,活动,登录,退出,检查-
operateNamestringfalse操作名称-
elapsedTimeint64false用时-0
serverIpstringfalse服务器ip-
successstringfalse是否成功-
requestUrlstringfalse访问路径-
errorMessagestringfalse错误信息-
logMessagestringfalse日志信息-
throwablestringfalse异常信息-
userHostIpstringfalse用户ip-
userAgentstringfalse浏览器信息-
macAddressstringfalsemac地址-
tenantIdstringfalse租户id-
tenantNamestringfalse租户名称-
userIdstringfalse用户id-
userNamestringfalse用户名称-
loginNamestringfalse登录名称-
dnstringfalse用户的承继关系-
guidPathstringfalse用户的由ID组成的父子关系列表,之间用逗号分隔-
managerLevelint32false三员级别:0:一般用户,1:系统管理员,2:安全保密员,3:安全审计员,4:云系统管理员,5:云安全保密员,6:云安全审计员-0

Request-example:

bash
curl -X POST -k -H "Content-Type: application/json" -i 'https://demo.youshengyun.com/server-log/services/rest/v1/accessLog/saveLog' --data '{
  "id": "",
  "logTime": "     2025-12-09 10:09:47",
  "systemName": "",
  "modularName": "",
  "methodName": "",
  "logLevel": "",
  "operateType": "",
  "operateName": "",
  "elapsedTime": 0,
  "serverIp": "",
  "success": "",
  "requestUrl": "",
  "errorMessage": "",
  "logMessage": "",
  "throwable": "",
  "userHostIp": "",
  "userAgent": "",
  "macAddress": "",
  "tenantId": "",
  "tenantName": "",
  "userId": "",
  "userName": "",
  "loginName": "",
  "dn": "",
  "guidPath": "",
  "managerLevel": 0
}'

Response-fields:

FieldTypeDescriptionSinceExample
successboolean操作是否成功-true
codeint32错误代码-0
msgstring操作描述-
dataobject操作成功返回的数据-
└─any objectobjectany object.-

Response-example:

json
{
  "success": true,
  "code": 0,
  "msg": "",
  "data": {}
}

多条件分页查询访问日志

URL: https://demo.youshengyun.com/server-log/services/rest/v1/accessLog/search

Type: GET

Author: mengjuhua

Content-Type: application/x-www-form-urlencoded

Description: 多条件分页查询访问日志

Query-parameters:

ParameterTypeRequiredDescriptionSinceExample
userNamestringfalse用户名称-
userHostIpstringfalse客户端IP-
successstringfalse操作状态-
startTimestringfalse开始时间-
endTimestringfalse结束时间-
modularNamestringfalse模块名称-
operateNamestringfalse操作名称-
operateTypestringfalse操作类型-
logLevelstringfalse日志级别-
pageint32false页数,默认为 1
Validation[Min(value=DEFAULT_PAGE)]
-0
sizeint32false每页的条数,默认为 10
Validation[Min(value=MIN_SIZE); Max(value=MAX_SIZE)]
-0

Request-example:

bash
curl -X GET -k -i 'https://demo.youshengyun.com/server-log/services/rest/v1/accessLog/search?userName=&userHostIp=&success=&startTime=&endTime=&modularName=&operateName=&operateType=&logLevel=&page=0&size=0'

Response-fields:

FieldTypeDescriptionSinceExample
currPageint32当前页-0
totalPagesint32总页数-0
totalint64总条数-0
rowsarray数据项-
└─idstring唯一标识-
└─logTimestring日志记录时间-" 2025-12-09 10:09:47"
└─systemNamestring系统名称-
└─modularNamestring模块名称,比如:公文就转-发文-授权管理-
└─methodNamestring方法类和名称-
└─logLevelstring日志级别: 普通日志、管理日志、错误日志、警告日志、信息日志、调试日志、跟踪日志-
└─operateTypestring操作类别: 查看,增加,修改,删除,发送,活动,登录,退出,检查-
└─operateNamestring操作名称-
└─elapsedTimeint64用时-0
└─serverIpstring服务器ip-
└─successstring是否成功-
└─requestUrlstring访问路径-
└─errorMessagestring错误信息-
└─logMessagestring日志信息-
└─throwablestring异常信息-
└─userHostIpstring用户ip-
└─userAgentstring浏览器信息-
└─macAddressstringmac地址-
└─tenantIdstring租户id-
└─tenantNamestring租户名称-
└─userIdstring用户id-
└─userNamestring用户名称-
└─loginNamestring登录名称-
└─dnstring用户的承继关系-
└─guidPathstring用户的由ID组成的父子关系列表,之间用逗号分隔-
└─managerLevelint32三员级别:0:一般用户,1:系统管理员,2:安全保密员,3:安全审计员,4:云系统管理员,5:云安全保密员,6:云安全审计员-0
codeint64错误代码-0
msgstring调用信息-
successboolean操作是否成功-true

Response-example:

json
{
  "currPage": 0,
  "totalPages": 0,
  "total": 0,
  "rows": [
    {
      "id": "",
      "logTime": "     2025-12-09 10:09:47",
      "systemName": "",
      "modularName": "",
      "methodName": "",
      "logLevel": "",
      "operateType": "",
      "operateName": "",
      "elapsedTime": 0,
      "serverIp": "",
      "success": "",
      "requestUrl": "",
      "errorMessage": "",
      "logMessage": "",
      "throwable": "",
      "userHostIp": "",
      "userAgent": "",
      "macAddress": "",
      "tenantId": "",
      "tenantName": "",
      "userId": "",
      "userName": "",
      "loginName": "",
      "dn": "",
      "guidPath": "",
      "managerLevel": 0
    }
  ],
  "code": 0,
  "msg": "",
  "success": true
}

Released under the GPL-3.0 License.