---
title: 日志解析子模块功能说明
description: "提供日志文件解析功能，调用CTF反序列化接口，完成对日志文件的解析输出。"
url: https://www.hikunpeng.com/document/detail/zh/kunpengdevps/development/tracer/KunpengDevKitCli_0117.html
sourcePath: /source/zh/kunpengdevps/development/tracer/KunpengDevKitCli_0117.html
indexId: 9de9c827f69673791080464131d3223073fe1011bde2cb3fcc7f43f6614fb25b69
---
# 日志解析子模块功能说明

#### 命令功能

提供日志文件解析功能，调用CTF反序列化接口，完成对日志文件的解析输出。

使用日志解析子模块功能需要12GB以上的内存空间，请确保服务器内存空间足够。


#### 命令格式

```
./tracelog parser [-h | --help] [-l {0,1,2,3} | --log-level {0,1,2,3}] {-md <METADATA_FILE> | --metadata <METADATA_FILE>} {-tl <TRACELOG_FILE | TRACELOG_DIR> | --tracelog <TRACELOG_FILE | TRACELOG_DIR>} [-mf <MAP_FILE> | --mapfile <MAP_FILE>] [-o <OUTPUT_PATH> | --output <OUTPUT_PATH>]
```


#### 参数说明


**表1 参数说明**

| 参数 | 参数选项 | 参数说明 |
| --- | --- | --- |
| \-h/\-\-help | \- | 可选参数，获取帮助信息。 |
| \-l/\-\-log\-level | 0/1/2/3 | 可选参数，设置日志级别，默认为1。 0：日志级别为DEBUG。 1：日志级别为INFO。 2：日志级别为WARNING。 3：日志级别为ERROR。 |
| \-md/\-\-metadata | \- | 必选参数，指定解析日志的metadata文件。 |
| \-tl/\-\-tracelog | \- | 必选参数，指定解析日志的tracelog文件或存放tracelog文件的文件夹。 |
| \-mf/\-\-mapfile | \- | 可选参数，指定解析日志的ProcMaps文件。 |
| \-o/\-\-output | \- | 可选参数，指定解析后的日志文件输出路径，不指定默认输出到控制台。 |


#### 使用示例

执行以下命令，查看日志解析子模块支持的功能信息：

```
./tracelog parser -h
```

返回信息如下：

```
NAME
    tracelog parser - Run the command to parse and view the files generated by the trace library.
USAGE
    tracelog parser
    [-h | --help]
    [-l {0,1,2,3} | --log-level {0,1,2,3}]
    {-md <METADATA_FILE> | --metadata <METADATA_FILE>}
    {-tl <TRACELOG_FILE | TRACELOG_DIR> | --tracelog <TRACELOG_FILE | TRACELOG_DIR>}
    [-mf <MAP_FILE> | --mapfile <MAP_FILE>]
    [-o <OUTPUT_PATH> | --output <OUTPUT_PATH>]
DESCRIPTION
    By default, the trace library generates log, metadata, and ProcMaps files in the /var/log directory.
    To change the path, specify the new path in the result header file of the generated code.
    For details, see the related document.
OPTIONS
    -h, --help
        Get help information and exit.
    -l {0,1,2,3}, --log-level {0,1,2,3}
        Specifies the print log level, 0(debug) | 1(info) | 2(warning) | 3(error).Default is 1(info).
    -md, --metadata
        Metadata file for parsing logs.
    -tl, --tracelog
        Tracelog file for parsing logs or the folder for storing the tracelog file.
    -mf, --mapfile
        Map file for parsing logs. By default, the map file is not specified.
    -o, --output
        Output path to parsed log files, which defaults to the standard output.
```