ADC

在 NSLOG 服务器上自定义日志记录

通过对 NSLOG 服务器配置文件 (log.conf) 进行其他修改,可以自定义 NSLOG 服务器上的日志记录。使用文本编辑器修改服务器系统上的 log.conf 配置文件。

要自定义日志记录,请使用配置文件定义过滤器和日志属性。

  • 日志过滤器。筛选来自 NetScaler 设备或一组 NetScaler 设备的日志信息。
  • 日志属性。每个过滤器都有一组关联的日志属性。日志属性定义了如何存储过滤后的日志信息。

本文档包括以下详细信息:

创建过滤器

您可以使用配置文件 (audit log.conf) 中的默认筛选器定义,也可以修改筛选器或创建新的筛选器。您可以创建多个日志筛选器。

注意: 对于合并日志记录,如果发生的日志事务没有筛选器定义,则使用默认筛选器(如果已启用)。配置所有 NetScaler 设备的合并日志记录的唯一方法是定义默认筛选器。

创建筛选器

在命令提示符处,在配置文件 (auditlog.conf) 中键入以下命令:

filter <filterName> [IP <ip>] [NETMASK <mask>] ON | OFF]
<!--NeedCopy-->

过滤器名称:指定筛选器的名称(最多 64 个字母数字字符)。

ip:指定 IP 地址。

掩码:指定要在子网上使用的子网掩码。

指定 ON 以启用过滤器以记录事务,或指定 OFF 以禁用筛选器。如果未指定任何参数,则过滤器处于开启状态。

示例

filter F1 IP 192.168.100.151 ON
<!--NeedCopy-->

要将过滤器 F2 应用于 IP 地址 192.250.100.1 到 192.250.100.254,请执行以下操作:

filter F2 IP 192.250.100.0 NETMASK 255.255.255.0 ON
<!--NeedCopy-->

如果您使用其他可选参数(例如 IP 地址或 IP 地址和网络掩码的组合)定义过滤器,则 filterName 是必填参数。

指定日志属性

与筛选器相关的日志属性应用于筛选器中存在的所有日志条目。日志属性定义以关键词 BEGIN 开头,以 END 结尾,如以下示例所示:


BEGIN <filtername>
    logFilenameFormat ...
    logDirectory ...
    logInterval ...
    logFileSizeLimit ....
END
<!--NeedCopy-->

定义中的条目可以包括以下内容:

  • LogFilenameFormat 指定日志文件的文件名格式。文件的名称可以是以下类型:

    • 静态:一个常量字符串,它指定绝对路径和文件名。
    • 动态:包含以下格式说明符的表达式:
      • 日期 (% {格式} t)
      • 使用 NSIP 创建文件名

    示例

     LogFileNameFormat Ex%`{`%m%d%y}t.log
     <!--NeedCopy-->
    

    这将创建第一个文件名为 Exmmddyy.log。新文件名为: exmmddyy.log.0、exmmddyy.log.1 等。在以下示例中,新文件是在文件大小达到 100MB 时创建的。

    示例

     LogInterval size
     LogFileSize 100
     LogFileNameFormat Ex%`{`%m%d%y}t
     <!--NeedCopy-->
    

小心

在 LogFileNameFormat 参数中指定的日期格式 %t 会覆盖该过滤器的日志间隔属性。为防止每天创建新文件,而不是在达到指定的日志文件大小时创建新文件,请勿在 logFileNameFormat 参数中使用 %t。

  • LogDi rectory 指定日志文件的目录名格式。文件名可以是以下任一名称:

    • 静态:是一个常量字符串,用于指定绝对路径和文件名。
    • 动态:是一个包含以下格式说明符的表达式:
      • 日期 (% {格式} t)
      • 使用 NSIP 创建目录

    目录分隔符取决于操作系统。在 Windows 中,使用目录分隔符。

    示例:

     LogDirectory dir1\dir2\dir3
     <!--NeedCopy-->
    

    在其他操作系统(Linux、FreeBSD 等)中,使用目录分隔符。

  • LogInterval 指定创建新日志文件的间隔。使用以下值之一:

    • 每小时:每小时创建一个文件。默认值。
    • 每天:每天午夜都会创建一个文件。
    • 每周:每周日午夜创建一个文件。
    • 每月:文件在当月的第一天午夜创建。
    • 无:审计服务器日志记录启动时,仅创建一次文件。
    • 大小:只有在达到日志文件大小限制时才会创建文件。

    示例

     LogInterval Hourly
     <!--NeedCopy-->
    
    • LogfileSizeLimit 指定了日志文件的最大大小(以 MB 为单位)。达到限制时会创建一个新文件。

    注意

    您可以通过将大小指定为值来覆盖 loginterval 属性。

    默认 LogFileSizeLimit 为 10 MB。

    示例

     LogFileSizeLimit 35
     <!--NeedCopy-->
    
在 NSLOG 服务器上自定义日志记录