For the complete documentation index, see llms.txt. This page is also available as Markdown.

日志

LoongCollector 由 C++ 主进程与 Go 扩展插件等组成,运行日志分为 C++ 主进程日志(spdlog,配置为 apsara_log_conf.json)与 插件 / Go 侧日志(seelog,配置为 plugin_logger.xml)。

路径约定:下文 {conf} 表示配置根目录(为 $LOONGCOLLECTOR_ROOT/conf),{log} 表示日志根目录(标准安装布局为 $LOONGCOLLECTOR_ROOT/log)。完整目录树见 目录结构说明。 开启 logtail_mode 时,部分路径与日志名前缀会回退为历史 iLogtail 布局(如配置目录即为进程工作目录、主日志可能为 ilogtail.LOG、Logger 前缀为 /apsara/sls/ilogtail),下面默认按 非 logtail_mode 的 LoongCollector 布局描述。


主进程日志(C++ / spdlog)

说明

配置文件

{conf}/apsara_log_conf.json

启动诊断

在加载 apsara_log_conf.json 之前,会向 {log}/logger_initialization.log 写入初始化信息。

主日志文件

{log}/loongcollector.LOG

Logger 名前缀

/apsara/loongcollector

根 Logger

/,默认用作兜底 Logger。

级别(写入 JSON 配置及环境变量映射):TRACEDEBUGINFOWARNINGERRORFATAL

环境变量 LOGTAIL_LOG_LEVEL:若值为上述之一,成功解析后对 主采集 Logger 覆盖 JSON 中的级别。

默认行为:若 apsara_log_conf.json 缺失或解析失败,会生成 spdlog 默认配置并尽量写回该文件:/ 使用 WARNING/apsara/loongcollector 使用 INFO,共用 AsyncFileSink,落盘路径为 {log}/loongcollector.LOG

参考配置结构(以落盘为准):

{
	"Loggers": {
		"/": {
			"AsyncFileSink": "WARNING"
		},
		"/apsara/loongcollector": {
			"AsyncFileSink": "INFO"
		}
	},
	"Sinks": {
		"AsyncFileSink": {
			"Type": "AsyncFile",
			"MaxLogFileNum": 10,
			"MaxLogFileSize": 20000000,
			"MaxDaysFromModify": 300,
			"LogFilePath": "/opt/loongcollector/log/loongcollector.LOG",
			"Compress": "Gzip"
		}
	}
}

插件日志(Go / seelog)

说明

配置文件

{conf}/plugin_logger.xml

默认日志文件

{log}/go_plugin.LOG

若 XML 不存在

会按模板 自动生成 plugin_logger.xml

级别:seelog 使用小写等级名(如 tracedebuginfowarnerrorcritical)。默认生产选项为异步 Logger + info 级别。

环境变量 LOGTAIL_LOG_LEVEL:在加载 XML 后,会把配置中的 minlevel="..." 替换为该环境变量的值(小写),用于临时调试;需为 seelog 可识别的等级字符串。

参考配置

更多与插件开发相关的 Logger 用法见 打印日志(其中命令行与文件若仍出现 ilogtail 字样的占位,指历史路径表述,实际文件以本文与部署目录为准)。

Last updated