云日志服务 LTS-云日志服务Java SDK:日志上报方式

时间：2025-03-10 20:03:28

云日志服务 LTS

日志上报方式

支持两种上报方式：标准日志、结构化日志。推荐您使用结构化日志上报，更加灵活可变，性能更好。

标准日志：

批量上报日志，一次可以上报多条日志。
字段"log"表示原始日志，即一条日志是一个字符串。
字段"log_time_ns"表示此条日志上报时间，单位ns纳秒，便于在LTS页面查看日志时按照时间排序。
可以将日志按照不同的labels标签进行分类上报。

上报一批日志结构体如下：

[{
	"contents": [{
		"log": "log content1",
		"log_time_ns": 1737527157333902200
	}, {
		"log": "log content2",
		"log_time_ns": 1737527157333914100
	}],
	"labels": "{\"lts-test-count\":\"2\"}"
}, {
	"contents": [{
		"log": "log content3",
		"log_time_ns": 1737527157333986200
	}, {
		"log": "log content4",
		"log_time_ns": 1737527157333987400
	}],
	"labels": "{\"lts-test-count\":\"2\"}"
}]

结构化日志（推荐使用，但目前该方式仅支持白名单用户使用，如有需要，请提交工单申请开通）：
- 批量上报日志，一次可以上报多条日志。
- 字段"contents"表示某几条日志。单条日志使用K-V结构，即一条日志是一个JSON体。"content" 为LTS保留字段，用来表示原始日志，可以不上报。
- 字段"time"表示某几条日志上报时间，单为ms毫秒，LTS会将这几条日志在ms毫秒的基础上拓展为ns纳秒保存。这样会丧失这几条日志的先后顺序，可能会影响到您在LTS页面查看日志的先后顺序。
- 字段"labels"表示这批日志公共的标签。
- 字段"path"表示这批日志的路径。
- 字段"source"表示这批日志的来源。
上报一批日志结构体如下：
```
{
	"labels": {
		"label": "label"
	},
	"logs": [{
		"contents": [{
			"k1": "v1",
			"k2": "v2",
			"content": "log content1"
		}, {
			"k3": "v3",
			"k4": "v4",
			"content": "log content2"
		}],
		"time": 1721784021037
	}, {
		"contents": [{
			"k5": "v5",
			"k6": "v6",
			"content": "log content3"
		}],
		"time": 1721784021038
	}, ],
	"path": "path",
	"source": "source"
}
```