1# hilog 2 3 4HiLog日志系统，提供给系统框架、服务、以及应用，用于打印日志，记录用户操作、系统运行状态等。开发者可以通过hilog命令行查询相关日志信息。 5 6 7## 前置条件 8 9- 根据hdc命令行工具指导，完成[环境准备](hdc.md#环境准备)。 10 11- 正常连接设备。 12 13 14## 命令行说明 15 16hilog命令行使用方式： 17 18| 短选项 | 长选项 | 参数 | 说明 | 19| -------- | -------- | -------- | -------- | 20| -h | --help | | 帮助命令。 | 21| 缺省 | 缺省 | | 阻塞读日志，不退出。 | 22| -x | --exit | | 非阻塞读日志，读完退出。 | 23| -g | | | 查询buffer的大小，配合-t指定某一类型使用，默认app和core。 | 24| -G | --buffer-size | <size> | 设置指定<type>日志类型缓冲区的大小，配合-t指定某一类型使用，默认app和core， 可使用B/K/M/G为单位。 | 25| -r | | | 清除buffer日志，配合-t指定某一类型使用，默认app和core。 | 26| -p | --privacy | <on/off> | 支持系统调试时日志隐私开关控制。 | 27| | | on | 打开隐私开关，显示<private>。 | 28| | | off | 关闭隐私开关，显示明文。 | 29| -k | | <on/off> | Kernel日志读取开关控制。 | 30| | | on | 打开读取kernel日志。 | 31| | | off | 关闭读取kernel日志。 | 32| -s | --statistics | | 查询统计信息，需配合-t或-D使用。 | 33| -S | | | 清除统计信息，需配合-t或-D使用。 | 34| -Q | | <control-type> | 流控缺省配额开关控制。 | 35| | | pidon | 进程流控开关打开。 | 36| | | pidoff | 进程流控开关关闭。 | 37| | | domainon | domain流控开关打开。 | 38| | | domainoff | domain流控开关关闭。 | 39| -L | --level | <level> | 指定级别的日志，示例：-L D/I/W/E/F。 | 40| -t | --type | <type> | 指定类型的日志，示例：-t app core init。 | 41| -D | --domain | <domain> | 指定domain。 | 42| -T | --Tag | <tag> | 指定tag。 | 43| -a | --head | <n> | 只显示前<n>行日志。 | 44| -z | --tail | <n> | 只显示后<n>行日志。 | 45| -P | --pid | <pid> | 标识不同的pid。 | 46| -e | --regex | <expr> | 只打印日志消息与<expr>匹配的行，其中<expr>是一个正则表达式。 | 47| -f | --filename | <filename> | 设置落盘的文件名。 | 48| -l | --length | <length> | 设置落盘的文件大小，需要大于等于64K。 | 49| -n | --number | <number> | 设置落盘文件的个数。 | 50| -j | --jobid | <jobid> | 设置落盘任务的ID。 | 51| -w | --write | <control> | 落盘任务控制。 | 52| | | query | 落盘任务查询。 | 53| | | start | 落盘任务开始，命令行参数为文件名、单文件大小、落盘算法、rotate文件数目。 | 54| | | stop | 落盘任务停止。 | 55| -m | --stream | <algorithm> | 落盘方式控制。 | 56| | | none | 无压缩方式落盘。 | 57| | | zlib | zlib压缩算法落盘，落盘文件为.gz。 | 58| | | zstd | zstd压缩算法落盘，落盘文件为.zst。 | 59| -v | --format | <format> | | 60| | | time | 显示本地时间。 | 61| | | color | 显示不同级别显示不同颜色，参数缺省级别颜色模式处理（按黑白方式）。 | 62| | | epoch | 显示相对1970时间。 | 63| | | monotonic | 显示相对启动时间。 | 64| | | usec | 显示微秒精度时间。 | 65| | | nsec | 显示纳秒精度时间。 | 66| | | year | 显示将年份添加到显示的时间。 | 67| | | zone | 显示将本地时区添加到显示的时间。 | 68| -b | --baselevel | <loglevel> | 设置可打印日志的最低等级：D(DEBUG)/I(INFO)/W(WARN)/E(ERROR)/F(FATAL)。 | 69 70 71### 查询相关命令 72 73| 短选项 | 长选项 | 说明 | 74| -------- | -------- | -------- | 75| -h | --help | 打印hilog的命令帮助信息。 | 76 77 78### 时间相关命令 79 80| 短选项 | 长选项 | 参数 | 说明 | 81| -------- | -------- | -------- | -------- | 82| -v | --format | <format> | 时间显示格式。 | 83 84**参数：** 85 86| 参数名 | 说明 | 87| -------- | -------- | 88| time | 显示本地时间。 | 89| color | 显示不同级别显示不同颜色，参数缺省级别颜色模式处理（按黑白方式）。 | 90| epoch | 显示相对1970时间。 | 91| monotonic | 显示相对启动时间。 | 92| usec | 显示微秒精度时间。 | 93| nsec | 显示纳秒精度时间。 | 94| year | 显示将年份添加到显示的时间。 | 95| zone | 显示将本地时区添加到显示的时间。 |