产品动态
公告
<dependency><groupId>com.tencentcloudapi.cls</groupId><artifactId>tencentcloud-cls-logback-appender</artifactId><version>1.0.8</version></dependency>
<appender name="LoghubAppender" class="com.tencentcloudapi.cls.LoghubAppender"><!--必选项--><endpoint>${region}.cls.tencentcs.com</endpoint><!--请确保密钥关联的账号具有相应的SDK日志上传权限-- 查看权限策略前往https://www.tencentcloud.com/document/product/614/45004#.E4.BD.BF.E7.94.A8-api-.E4.B8.8A.E4.BC.A0.E6.95.B0.E6.8D.AE ><accessKeyId>${SecretID}</accessKeyId><accessKeySecret>${SecretKey}</accessKeySecret><!--日志主题ID--><topicId>${topicId}</topicId><!-- 可选项 详见 '参数说明'--><totalSizeInBytes>104857600</totalSizeInBytes><maxBlockMs>0</maxBlockMs><sendThreadCount>8</sendThreadCount><batchSizeThresholdInBytes>524288</batchSizeThresholdInBytes><batchCountThreshold>4096</batchCountThreshold><lingerMs>2000</lingerMs><retries>10</retries><maxReservedAttempts>11</maxReservedAttempts><baseRetryBackoffMs>100</baseRetryBackoffMs><maxRetryBackoffMs>50000</maxRetryBackoffMs><includeMessage>false</includeMessage><!-- 可选项 设置时间格式 --><timeFormat>yyyy-MM-dd'T'HH:mm:ssZ</timeFormat><timeZone>Asia/Shanghai</timeZone><customFields>{"${自定义key}":"${自定义value}"}</customFields><encoder><pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger - %msg</pattern></encoder><mdcFields>${MDC字段}</mdcFields></appender>
参数 | 描述 | 示例 |
totalSizeInBytes | 单个 producer 实例能缓存的日志大小上限，默认为100MB | totalSizeInBytes=104857600 |
maxBlockMs | 如果 producer 可用空间不足，调用者在 send 方法上的最大阻塞时间，默认为60秒。为了不阻塞打印日志的线程，强烈建议将该值设置成0 | maxBlockMs=0 |
sendThreadCount | 执行日志发送任务的线程池大小，默认为可用处理器个数 | sendThreadCount=8 |
batchSizeThresholdInBytes | 当一个 ProducerBatch 中缓存的日志大小大于等于 batchSizeThresholdInBytes 时，该 batch 将被发送，默认为512 KB，最大可设置成5MB | batchSizeThresholdInBytes=524288 |
batchCountThreshold | 当一个 ProducerBatch 中缓存的日志条数大于等于 batchCountThreshold 时，该 batch 将被发送，默认为4096，最大可设置成40960 | batchCountThreshold=4096 |
lingerMs | 一个 ProducerBatch 从创建到可发送的逗留时间，默认为2秒，最小可设置成100毫秒 | lingerMs=2000 |
retries | 如果某个 ProducerBatch 首次发送失败，能够对其重试的次数，默认为10次 如果 retries 小于等于0，该 ProducerBatch 首次发送失败后将直接进入失败队列 | retries=10 |
maxReservedAttempts | 该参数越大能让您追溯更多的信息，但同时也会消耗更多的内存 | maxReservedAttempts=11 |
baseRetryBackoffMs | 首次重试的退避时间，默认为100毫秒。Producer 采用指数退避算法，第 N 次重试的计划等待时间为 baseRetryBackoffMs * 2^(N-1) | baseRetryBackoffMs=100 |
maxRetryBackoffMs | 重试的最大退避时间，默认为50秒 | maxRetryBackoffMs=50000 |
timeFormat | 设置时间格式 | 精确到秒：yyyy-MM-dd'T'HH:mm:ssZ 精确到毫秒：yyyy-MM-dd'T'HH:mm:ss.SSSZ 注意： 仅 Logback 版本为1.0.4及以上支持毫秒时间。 |
mdcFields | 指定要在 Appender 中包含的 MDC（Mapped Diagnostic Context）字段。这些字段将作为日志的一部分上传至 CLS。 | - |
customFields | 定义自定义字段，这些字段将作为日志的一部分上传至 CLS | {"app":"my_application"} |
includeMessage | 当 encoder 不为空时，是否要包含 message 字段，默认为 true | true |
文档反馈