Shoulder-Logging 日志

应用日志

打印在 ${logging.file.path}/${shoulder.application.name} 目录中

LoggerName 打印建议文件名

LoggerName	打印建议	文件名
`APP_DEFAULT`	APP启动/重启等时逻辑，默认包路径日志打在这里	default.log
`APP_WARN`	APP启动/重启等运维时逻辑	warn.log
`APP_ERROR`	所有需要关注的 error 日志都在这里出现	error.log
`APP_BIZ`	业务逻辑处理过程	biz.log
`APP_ROUTER`	业务路由，新老链路/逻辑切流日志：决策因子、规则、切流结果	router.log
`APP_INTEGRATION`	调用其他应用 / 服务的入参、出参、错误码等详细信息	integration.log
`APP_INTEGRATION_DIGEST`	调用其他应用 / 服务的接口、方法、成功、耗时等关键信息	integration-digest.log
`APP_SERVICE`	对外暴露接口/服务的日志详情，入参、出参等	service.log
`APP_SERVICE_DIGEST`	对外暴露接口/服务的接口、方法、成功、耗时等关键信息	service-digest.log
`APP_SERVICE_WARN`	对外暴露接口/服务的接口执行出现预期内异常记录（参数校验失败等）	service-warn.log
`APP_SERVICE_ERROR`	对外暴露接口/服务的接口执行失败记录	service-error.log
`APP_DAL`	数据访问层-详细日志	dal.log
`APP_DAL_DIGEST`	数据访问层-摘要日志	dal-digest.log
`APP_CAL`	数据访问层-缓存日志	cal.log
`APP_CAL_DIGEST`	数据访问层-缓存-摘要日志	cal-digest.log
`APP_DAEMON`	定时任务触发记录	daemon.log
`APP_MSG_CONSUMER`	消费消息记录，如消息内容，消息来源等	msg-consumer.log
`APP_MSG_PRODUCER`	发布消息记录，如消息内容等	msg-producer.log
`APP_NOTIFY`	向其他系统发送通知，如外部	notify.log
`APP_CONFIG`	收到配置变更，读取到配置中心的配置内容	config.log
`APP_CODE_MAPPING`	错误码映射记录，如调用 x 应用返回 errorCode_123，对于本服务接口应该返回 errorCode_567 时记录	code-mapping.log

APP_DEFAULT

APP启动/重启等时逻辑，默认包路径日志打在这里

default.log

APP_WARN

APP启动/重启等运维时逻辑

warn.log

APP_ERROR

所有需要关注的 error 日志都在这里出现

error.log

APP_BIZ

业务逻辑处理过程

biz.log

APP_ROUTER

业务路由，新老链路/逻辑切流日志：决策因子、规则、切流结果

router.log

APP_INTEGRATION

调用其他应用 / 服务的入参、出参、错误码等详细信息

integration.log

APP_INTEGRATION_DIGEST

调用其他应用 / 服务的接口、方法、成功、耗时等关键信息

integration-digest.log

APP_SERVICE

对外暴露接口/服务的日志详情，入参、出参等

service.log

APP_SERVICE_DIGEST

对外暴露接口/服务的接口、方法、成功、耗时等关键信息

service-digest.log

APP_SERVICE_WARN

对外暴露接口/服务的接口执行出现预期内异常记录（参数校验失败等）

service-warn.log

APP_SERVICE_ERROR

对外暴露接口/服务的接口执行失败记录

service-error.log

APP_DAL

数据访问层-详细日志

dal.log

APP_DAL_DIGEST

数据访问层-摘要日志

dal-digest.log

APP_CAL

数据访问层-缓存日志

cal.log

APP_CAL_DIGEST

数据访问层-缓存-摘要日志

cal-digest.log

APP_DAEMON

定时任务触发记录

daemon.log

APP_MSG_CONSUMER

消费消息记录，如消息内容，消息来源等

msg-consumer.log

APP_MSG_PRODUCER

发布消息记录，如消息内容等

msg-producer.log

APP_NOTIFY

向其他系统发送通知，如外部

notify.log

APP_CONFIG

收到配置变更，读取到配置中心的配置内容

config.log

APP_CODE_MAPPING

错误码映射记录，如调用 x 应用返回 errorCode_123，对于本服务接口应该返回 errorCode_567 时记录

code-mapping.log

框架内置日志

打印在 ${logging.file.path}/shoulder 目录中

LoggerName	内容说明	文件名
SHOULDER-OPERATION	操作日志专属Logger	operation.log
SHOULDER-DEFAULT	默认日志输出，记录启动时 + 未分类的日志信息（极少）	default.log
SHOULDER-ERROR	记录错误日志，建议注意定期检查	common-error.log
SHOULDER-THREADS	线程相关日志，记录线程异常与状态信息	threads.log
SHOULDER-CLIENT	客户端调用相关日志	client.log
SHOULDER-CLIENT-ERROR	客户端错误日志，包含所有客户端产生的错误信息	client-error.log
SHOULDER-SERVER	服务端日志，记录服务端相关操作信息	server.log
SHOULDER-SERVER-ERROR	服务端错误日志，关注此日志健康状态非常重要	server.error.log
SHOULDER-SECURITY	安全相关日志，包含安全事件和相关操作	security.log
SHOULDER-SECURITY-ERROR	安全错误日志，记录安全模块错误信息	security.server.error.log
SHOULDER-CONFIG	配置相关日志，记录应用读取关键配置相关信息	config.log
SHOULDER-BATCH	shoulder-batch 处理流程相关日志	batch-default.log
SHOULDER-BATCH-ERROR	shoulder-batch 处理流程-错误日志	batch-error.log
SHOULDER-DB	数据库操作日志，记录数据库操作	db-default.log
SHOULDER-DB-ERROR	数据库错误日志，关注可能的数据访问异常	db-error.log
SHOULDER-SEQUENCE	序列号生成相关日志	sequence-default.log
SHOULDER-SEQUENCE-MONITOR	序列号生成监控日志，分析序列号生成性能和问题	sequence-monitor.log
SHOULDER-CRYPTO	加密解密日志，用于记录加解密操作	crypto-default.log
SHOULDER-CRYPTO-ERROR	加密模块错误日志，记录加解密过程中的错误信息	crypto-error.log

LoggerName

内容说明

文件名

SHOULDER-OPERATION

操作日志专属Logger

operation.log

SHOULDER-DEFAULT

默认日志输出，记录启动时 + 未分类的日志信息（极少）

default.log

SHOULDER-ERROR

记录错误日志，建议注意定期检查

common-error.log

SHOULDER-THREADS

线程相关日志，记录线程异常与状态信息

threads.log

SHOULDER-CLIENT

客户端调用相关日志

client.log

SHOULDER-CLIENT-ERROR

客户端错误日志，包含所有客户端产生的错误信息

client-error.log

SHOULDER-SERVER

服务端日志，记录服务端相关操作信息

server.log

SHOULDER-SERVER-ERROR

服务端错误日志，关注此日志健康状态非常重要

server.error.log

SHOULDER-SECURITY

安全相关日志，包含安全事件和相关操作

security.log

SHOULDER-SECURITY-ERROR

安全错误日志，记录安全模块错误信息

security.server.error.log

SHOULDER-CONFIG

配置相关日志，记录应用读取关键配置相关信息

config.log

SHOULDER-BATCH

shoulder-batch 处理流程相关日志

batch-default.log

SHOULDER-BATCH-ERROR

shoulder-batch 处理流程-错误日志

batch-error.log

SHOULDER-DB

数据库操作日志，记录数据库操作

db-default.log

SHOULDER-DB-ERROR

数据库错误日志，关注可能的数据访问异常

db-error.log

SHOULDER-SEQUENCE

序列号生成相关日志

sequence-default.log

SHOULDER-SEQUENCE-MONITOR

序列号生成监控日志，分析序列号生成性能和问题

sequence-monitor.log

SHOULDER-CRYPTO

加密解密日志，用于记录加解密操作

crypto-default.log

SHOULDER-CRYPTO-ERROR

加密模块错误日志，记录加解密过程中的错误信息

crypto-error.log

不建议主动使用以上 Logger 打印日志，以上 Logger 仅用在框架内部使用，便于日志分类与问题排查。

点击这里去 SpringBoot 官网查看更多日志支持。