[toc]

第十章 设置结构化日志记录（二）

注：IRIS有，Cache无。

启用结构化日志记录

^LOGDMN 例程允许管理结构化日志记录；还有一个基于类的 API，将在下一节中介绍。

要使用 ^LOGDMN 启用结构化日志记录：

1. 打开终端并输入以下命令：

set $namespace="%sys"
do ^LOGDMN

这将启动一个带有以下提示的例程：

 
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?

2. 按 4 以便可以指定配置详细信息。然后，该例程会提示输入以下项目：

a. 最低日志级别，以下之一：

• -2 — 详细的调试消息（例如十六进制转储）。
• -1 — 不太详细的调试消息。
• 0 — 信息性消息，包括所有审计事件。
• 1（默认值）— 警告，表示可能需要注意但未中断操作的问题。
• 2 — 严重错误，表明问题已中断操作。
• 3 — 致命错误，表示问题导致系统无法运行。

b. 管道命令，它指定系统将结构化日志发送到哪里。输入以下形式的响应：

irislogd -f c:/myfilename.log

但将 c:/myfilename.log 替换为目标日志文件的完全限定路径名。在此命令中，irislogd 是 可执行文件的名称，它将接收日志数据并将其写入指定文件（通过 -f 选项）。

对于管道命令，最简单的选择是使用此处提到的可执行文件 (irislogd.exe)，但可以替换为不同的目标。

c. 发送到管道的数据格式。指定 NVP（默认）或 JSON。选项 NVP 发送由名称-值对组成的数据，以空格分隔。选项 JSON 在 JSON 输出中发送数据。

d. 对管道命令的连续调用之间的间隔（以秒为单位）。默认值为 10 秒。

当例程再次显示主提示时（LOGDMN 选项？），按 1 启用日志记录。

按 7 开始记录。

image.png image.png image.png image.png

用于结构化日志记录的基于类的 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 参数。