注:IRIS有,Cache无。
启用结构化日志记录
^LOGDMN
例程允许管理结构化日志记录;还有一个基于类的 API
,将在下一节中介绍。
要使用 ^LOGDMN
启用结构化日志记录:
- 打开终端并输入以下命令:
set $namespace="%sys"
do ^LOGDMN
这将启动一个带有以下提示的例程:
代码语言:javascript复制1) Enable logging
2) Disable logging
3) Display configuration
4) Edit configuration
5) Set default configuration
6) Display logging status
7) Start logging
8) Stop logging
9) Restart logging
LOGDMN option?
- 按
4
以便可以指定配置详细信息。然后,该例程会提示输入以下项目:
a. 最低日志级别,以下之一:
-
-2
— 详细的调试消息(例如十六进制转储)。 -
-1
— 不太详细的调试消息。 -
0
— 信息性消息,包括所有审计事件。 -
1
(默认值)— 警告,表示可能需要注意但未中断操作的问题。 -
2
— 严重错误,表明问题已中断操作。 -
3
— 致命错误,表示问题导致系统无法运行。
b. 管道命令,它指定系统将结构化日志发送到哪里。输入以下形式的响应:
代码语言:javascript复制irislogd -f c:/myfilename.log
但将 c:/myfilename.log
替换为目标日志文件的完全限定路径名。在此命令中,irislogd 是 可执行文件的名称,它将接收日志数据并将其写入指定文件(通过 -f 选项)。
对于管道命令,最简单的选择是使用此处提到的可执行文件 (irislogd.exe
),但可以替换为不同的目标。
c. 发送到管道的数据格式。指定 NVP
(默认)或 JSON
。选项 NVP
发送由名称-值对组成的数据,以空格分隔。选项 JSON
在 JSON
输出中发送数据。
d. 对管道命令的连续调用之间的间隔(以秒为单位)。默认值为 10
秒。
当例程再次显示主提示时(LOGDMN
选项?),按 1
启用日志记录。
按 7
开始记录。
用于结构化日志记录的基于类的 API
要管理结构化日志记录,可以使用 %SYS
命名空间中的 SYS.LogDmn
类,而不是使用 ^LOGDMN
例程。
irislogd 的其他选项
Argument | Purpose |
---|---|
-d | 发出诊断和错误消息 |
-e | errfilename 将错误和诊断消息写入给定文件。 |
-f | logfilename 将日志消息写入给定文件。 |
-h | hostname 在结构化日志文件中包含给定的主机名。 |
-i | irisinstance 在结构化日志文件中包含给定的实例名称。 |
-s | 将日志消息写入 Unix® syslog 工具(仅限 Unix®) |
此外,可以将输出写入标准输出。要在 Unix
上执行,请同时省略 -f
和 -s
参数。要在 Windows
上执行此操作,请省略 -s
参数。