Junos ロガー ユーティリティ
概要 Junos ロガー ユーティリティを使用して、カスタム システム ログ メッセージを記録したり、テスト環境でイベント ポリシーを検証するためのイベント通知を生成したりできます。
Junos ソフトウェアにはロガー ユーティリティが含まれており、以下を可能にします。
-
カスタム メッセージをシステム ログ ファイルに記録する
-
Junos イベント通知のシミュレート
Junos ロガーの概要
Junos ロガーは、カスタム メッセージをシステム ログ ファイルにログに記録し、人為的にイベント通知を生成するために使用できるシェル ユーティリティです。ロガーはトリガー イベントが再現が困難な場合でもイベント ポリシーおよびイベント スクリプトを正常にテストすることを可能にします。
Junos デバイスでイベント ポリシーを設定し、イベントまたは一連のイベントに応じて特定のアクションを実行できます。イベント ポリシーを実稼働環境に展開する前にテストし、ポリシーが想定通りにトリガーされ、正しいアクションを実行することを確認することが重要です。イベント ポリシーのトリガーに必要なイベントを生成する環境をシミュレートすることが困難な場合があります。このような場合は、Junos ロガー ユーティリティを使用してイベント通知を生成し、ポリシーをトリガーできます。
Junos イベント ロガーは、実稼働環境のデバイスでは使用できませんが、サポートされていないシェル ユーティリティです。ただし、このユーティリティは、イベント ポリシーやイベント スクリプトを開発および検証するラボ環境での使用に適しています。
また、ロガー ユーティリティを使用すると、イベント通知をトリガーせずに、システム ログにメッセージを記録できます。したがって、通常のデバイス操作時に自動的に記録されるメッセージやイベントに加えて、システムに関する付加情報をログに記録することができます。
ロガー ユーティリティを使用してイベント通知を生成したり、カスタム ログ メッセージを記録したりすると、デバイスはベース OS logger
のユーティリティの変更バージョンを使用します。この変更されたユーティリティは、Junos ソフトウェアで使用できるように設計された特別なオプション セットを受け入れます。
Junos ロガー構文(イベントの生成)
構文(Junos OS)
logger -e EVENT_ID -a attribute=value -d process -l logical-system-name -p priority "message"
構文(Junos OS Evolved)
eventd_logger -e EVENT_ID -a attribute=value -d process -l logical-system-name -p priority "message"
説明
デバイスが指定された優先度でイベントをログに記録するように設定されている場合、イベント通知を生成し、イベントをシステム ログに記録します。
オプション
表 1 は、Junos イベント ロガー ユーティリティに必要な引数とオプションの引数の概要を示しています。
オプション | の説明 | の例 |
---|---|---|
|
(オプション)イベントに関連付けられた属性。属性名は小文字にする必要があります。複数の属性を指定するには、各属性に オプションを 特定の Junos イベントに関連付けられた属性の詳細については、 システム ログ エクスプローラー ツールでイベントの詳細を参照してください。 |
|
|
(オプション)イベントのソースプロセスとして使用するJunosプロセス(デーモン)。 プロセスを指定しない場合、Junos OSはプロセスに使用 |
|
|
イベント通知を生成するイベント。イベント識別子は大文字にする必要があります。 |
|
|
(オプション)指定された論理システムのログ ファイルにイベント通知を生成して記録します。 |
|
|
(オプション)指定された優先度(数値または syslog ペア)でイベントをログに記録します facility.severity 。 デフォルトの優先度は. |
|
message | (オプション)システム ログに記録するメッセージ文字列。引用符は必要ありませんが、明確にするためにお勧めします。 |
「これは手動で生成されたテストイベントです。」 |
Junos ロガー構文(メッセージのログ記録)
構文(Junos OS)
logger -46Ais -f file -h host -p priority -t tag "message"
構文(Junos OS Evolved)
eventd_logger -is -f file -p priority -t tag "message"
説明
デバイスが指定された優先度でメッセージをログするように設定されている場合、システム ログにエントリを記録します。
Junos OS Evolvedを実行しているデバイスでは、システム シェルで Linux ロガー ユーティリティを使用して、システム ログにメッセージを記録することもできます。
オプション
Junos ロガー ユーティリティを使用してシステム ログにカスタム メッセージを記録すると、デバイスは基盤となるベース OS のユーティリティを呼び出します logger
。Junos デバイスでは、一部の logger
オプションのみがサポートされます。 表 2 は、サポートされているオプションの概要を示しています。
オプションの | 説明 |
---|---|
|
(オプション)Junos OSでは、IPv4またはIPv6アドレスのみを使用します。 |
|
(オプション)Junos OS で、すべてのアドレスにメッセージを送信しようとします。 |
|
(オプション)指定されたファイルの内容をシステム ログ ファイルにコピーします。 |
|
(オプション)Junos OSでは、ローカルにロギングするのではなく、指定されたリモートホストにメッセージを送信します。 |
|
(オプション)ロガー プロセスのプロセス ID を行ごとにログに記録します。 |
|
(オプション)指定された優先度(数値または syslog のペア)でイベントを生成します facility.severity 。 デフォルトの優先度は. |
|
(オプション)システム ログ ファイルに加えて、メッセージを標準エラーに記録します。 |
|
(オプション)現在のユーザー名であるデフォルトタグではなく、指定されたタグを使用してエントリをログに記録します。 |
message | (オプション)システム ログに記録するメッセージ文字列。引用符は必要ありませんが、明確にするためにお勧めします。 |
Junos ロガーを使用してイベントを生成する
Junos イベント ロガーは、シェル ユーティリティです。ユーティリティを使用するには、まずシステム シェルを起動する必要があります。
イベント通知を生成し、システム ログ ファイルに記録するには、以下の手順にしたがっています。
イベント通知がプロセスに eventd
送信されます。また、指定されたファシリティおよび重大度レベルのメッセージを記録するようにデバイスが設定されている場合、デバイスはイベント情報と指定されたメッセージをシステム ログ ファイルに記録します。
user@host> show log messages | match UI_COMMIT Nov 4 16:26:41 host mgd: UI_COMMIT: This is a test event.
Junos イベント ロガー ユーティリティを使用して 1 つ以上のイベント通知を生成し、特定のラボ環境でイベントを再現することが困難な場合にイベント ポリシーをトリガーおよびテストできます。前の例では、デバイスはUI_COMMITイベントでトリガーするすべてのポリシーを実行します。
Junos ロガーを使用してメッセージをログに記録する
Junos ロガーはシェル ユーティリティです。ユーティリティを使用するには、まずシステム シェルを起動する必要があります。
システム ログ ファイルに情報を記録するには、次の手順にしたがっています。
この例では、指定されたファシリティと重大度レベルのメッセージをログに記録するようにデバイスを設定している場合、メッセージ文字列がCUSTOM_LOGタグとともにシステムログに記録されます。
user@host> show log messages | match CUSTOM_LOG Nov 16 14:38:31 host CUSTOM_LOG[21905]: The server is up.