Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Junos 记录器实用程序

总结 使用 Junos 记录器实用程序可记录自定义系统日志消息或生成事件通知,以在测试环境中验证事件策略。

Junos 软件包含一个记录器实用程序,使您能够:

  • 在系统日志文件中记录自定义消息

  • 模拟 Junos 事件通知

Junos 记录器概述

Junos 记录器是一个 shell 实用程序,可用于将自定义消息记录到系统日志文件中并人工生成事件通知。即使触发事件难以重现,也可以使用记录器成功测试事件策略和事件脚本。

您可以在 Junos 设备上配置事件策略,以执行特定操作来响应一个事件或一系列事件。在将事件策略部署到生产环境中之前,请务必对其进行测试,以确保策略按预期触发并执行正确的操作。在某些情况下,很难模拟生成触发事件策略所需事件的环境。在这些情况下,您可以使用 Junos 记录器实用程序生成事件通知以触发策略。

注意:

Junos 事件记录器是不受支持的 shell 实用程序,不应在生产环境中的设备上使用。但是,该实用程序非常适合在开发和验证事件策略和事件脚本的实验室环境中使用。

记录器实用程序还允许您在不触发事件通知的情况下在系统日志中记录消息。因此,除了在正常设备操作期间自动记录的消息和事件之外,您还可以记录有关系统的补充信息。

使用记录器实用程序生成事件通知或记录自定义日志消息时,设备将使用基本操作系统实用程序 logger 的修改版本。修改后的实用程序接受一组专为与 Junos 软件配合使用而设计的专用选项。

Junos 记录器语法(生成事件)

语法 (Junos OS)

语法(Junos OS 演化版)

描述

生成事件通知并将事件记录在系统日志中,前提是设备配置为以指定优先级记录事件。

选项

表 1 概述了 Junos 事件记录器实用程序的必需参数和可选参数。

表 1:记录器选项(生成事件)
选项 说明 示例

-a attribute=value

(可选)与事件关联的属性。属性名称必须小写。要指定多个属性,请包括 -a 每个属性的选项。

有关与特定 Junos 事件关联的属性的详细信息,请在 系统日志资源管理器 工具中查看事件的详细信息。

-a username=admin
-a command=commit

-d process

(可选)要用作事件的源进程的 Junos 进程(守护程序)。

如果未指定进程,Junos OS 将用于 logger 进程,Junos OS 演化版将用于 EVENTD_LOGGER 进程。

-d mgd

-e EVENT_ID

要为其生成事件通知的事件。事件标识符必须大写。

-e UI_COMMIT

-l logical-system-name

(可选)在日志文件中为指定的逻辑系统生成并记录事件通知。

-l ls-router1

-p priority

(可选)以给定优先级记录事件,以数字方式指定或作为系统日志 facility.severity 对指定。

默认优先级为 user.notice

-p external.notice

message

(可选)要在系统日志中记录的消息字符串。引号不是必需的,但为清楚起见,建议使用引号。

“这是手动生成的测试事件。”

Junos 记录器语法(记录消息)

语法 (Junos OS)

语法(Junos OS 演化版)

描述

系统日志中的日志条目(前提是设备配置为记录具有指定优先级的消息)。

注意:

在运行 Junos OS 演化版的设备上,您还可以使用系统 shell 中的 Linux 记录器 实用程序在系统日志中记录消息。

选项

使用 Junos 记录器实用程序在系统日志中记录自定义消息时,设备将调用 logger 底层基本操作系统的实用程序。Junos 设备仅支持一部分 logger 选项。 表 2 概述了支持的选项。

表2:记录器选项(记录消息)
选项           说明

(-4 | -6)

(可选)在 Junos OS 上,仅使用 IPv4 或 IPv6 地址。

-A

(可选)在 Junos OS 上,尝试将消息发送到所有地址。

-f file

(可选)将指定文件的内容复制到系统日志文件中。

-h host

(可选)在 Junos OS 上,将消息发送到指定的远程主机,而不是在本地记录。

-i

(可选)用每行记录记录器进程的进程 ID。

-p priority

(可选)生成具有给定优先级的事件,以数字方式指定或作为系统日志 facility.severity 对指定。

默认优先级为 user.notice

-s

(可选)除了系统日志文件之外,还将消息记录到标准错误。

-t tag

(可选)使用指定的标记而不是默认标记(即当前用户名)记录条目。

message

(可选)要在系统日志中记录的消息字符串。引号不是必需的,但为清楚起见,建议使用引号。

使用 Junos 记录器生成事件

Junos 事件记录器是一个 shell 实用程序。要使用实用程序,必须先启动系统 shell。

要生成事件通知并将其记录在系统日志文件中,请执行以下操作:

  1. 启动系统外壳。

    shell 提示符因操作系统以及用户是否为 root 用户而异。例如:

    • 在 Junos OS 中:

    • 在 Junos OS 演化版中:

  2. 通过调用 Junos 记录器实用程序并以大写形式指定事件 ID 以及任何其他可选参数来生成事件。

    例如,以下命令模拟UI_COMMIT事件。该事件由 mgd 进程生成,具有事件优先级 external.notice

    • 在 Junos OS 中:

    • 在 Junos OS 演化版中:

事件通知将发送到 eventd 进程。设备还会在系统日志文件中记录事件信息和指定消息,前提是您已将设备配置为记录给定设施和严重性级别的消息。

可以使用 Junos 事件记录器实用程序生成一个或多个事件通知,以便在给定实验室环境中难以重现事件时触发和测试事件策略。在前面的示例中,设备将执行在 UI_COMMIT 事件上触发的任何策略。

使用 Junos 记录器记录消息

Junos 记录器是一个 shell 实用程序。要使用实用程序,必须先启动系统 shell。

要在系统日志文件中记录信息,请执行以下操作:

  1. 启动系统外壳。

    shell 提示符因操作系统以及用户是否为 root 用户而异。例如:

    • 在 Junos OS 中:

    • 在 Junos OS 演化版中:

  2. 通过调用 Junos 记录器实用程序并指定要记录的信息以及任何可选参数,将消息记录到系统日志中。

    例如,以下命令记录给定的消息字符串 CUSTOM_LOG ,其标记和优先级 external.notice为 。

    • 在 Junos OS 中:

    • 在 Junos OS 演化版中:

在此示例中,消息字符串将带有 CUSTOM_LOG 标记记录在系统日志中,前提是您已将设备配置为记录给定设施和严重性级别的消息。