Salt 向け Junos Syslog エンジン

Junos syslogエンジンを使用するには、エンジンが実行されているサーバーにpyparsingおよびtwisted Pythonモジュールをインストールする必要があります。このドキュメントでは、Junos syslog エンジンが Salt マスターで実行されていることを前提としています。前提条件をインストールし、Junos Syslog エンジンを有効にする方法の詳細については、Junos OS 用 Salt クイック スタート ガイドの Junos Syslog エンジンの設定を参照してください。

Junos Syslogエンジンを使用するには、Junos OSを実行しているデバイスで、Salt Masterの指定されたポートにsyslogメッセージを送信するように設定する必要があります。すべてのイベントを送信するようにデバイスを設定することも、特定のファシリティまたはメッセージの重大度レベルに対応するイベントのみを送信するようにデバイスを設定することもできます。

すべてのイベントを送信するには、すべてのファシリティとすべてのメッセージの重大度レベルを示すように any any を構成します。

たとえば、重大度レベルが info 以上のセキュリティ イベントのみを送信するには、 security info を構成します。

システム ロギング機能とメッセージ重大度レベルの詳細については、「 システム ロギング機能とメッセージ重大度レベル」を参照してください。

Junos syslogエンジンを有効にするには、Salt マスター 構成ファイルで engines キーでエンジンを設定し、Junos OSを実行しているデバイスで構成したものと同じポートを指定する必要があります。

設定を適用するには、Salt マスターを再起動する必要があります。再起動すると、Junos syslog エンジン プロセスが自動的に開始されます。次に、Junos syslogエンジンは、指定されたポートでJunos OS syslogメッセージをリッスンし、イベント情報を抽出して、SaltイベントバスにSalt形式で公開します。特定のイベントが発生したときに自動的にアクションを実行するリアクタを作成および設定するには、 Junos OS イベント用の Salt リアクタの設定を参照してください。

Salt イベントバスにパブリッシュされるイベントには、イベントタグとデータの 2 つのコンポーネントがあります。Junos OSイベントは、以下のデフォルトイベントタグ(またはイベントトピック)構文を使用します。

Junos OSイベントのイベントタグは常に jnpr/syslog で始まる必要がありますが、エンジン設定で topic パラメータを定義し、含めるフィールドを指定することで、残りのフィールドをカスタマイズできます。例えば、以下の設定では、デバイスの IP アドレス、メッセージを生成したプロセス、イベントを含むイベントタグが生成されます。

この構文を設定すると、完了したコミット操作イベントのタグは次のようになります。

イベントタグのフィールドには、 jnpr/syslog/の後に以下のフィールドを任意に組み合わせて含めることができます。

• daemon

• event

• hostip

• hostname

• message

• pid

• priority

• raw (the raw event data forwarded from the device)

• severity

• timestamp

Junos Syslog エンジンを有効にする方法の説明に従って、Junos OS を実行しているデバイスが Junos Syslog エンジンに送信する Syslog イベントを設定できます。デフォルトでは、Junos syslogエンジンは、Saltイベントバスで受信したすべてのイベントのイベントデータを公開します。また、エンジン設定で daemon パラメーターを設定することで、特定のプロセスのみにサブスクライブするように Junos syslog エンジンをカスタマイズすることもできます。このパラメーターを設定すると、Junos syslogエンジンは、Salt イベントバス上のこれらのプロセスに関連するイベントのみを公開します。

次のSaltエンジン設定は、管理プロセス(mgd)およびルーティングプロトコルプロセス(rpd)からのイベントにJunos syslogエンジンをサブスクライブします。

salt-masterプロセスを再起動して設定を適用すると、Junos syslogエンジンは、これら2つのプロセスからのイベントのみをSaltイベントバスに公開します。

Salt ランナーは、ミニオンではなく Salt マスターでモジュールを実行します。ランナーは salt-run コマンドを使用して実行します。Salt マスターイベントバスのイベントをリアルタイムで表示するには、次のコマンドを実行して、ターミナルにイベントを表示します。

イベントをすばやくトリガーする場合は、次の例に示すようにミニオンに ping を実行します。

対応するイベント バス出力には、Salt ジョブとミニオンの応答が表示されます。

Junos Syslog エンジンの設定をテストするには、Junos OS を実行しているデバイスで 操作を実行します。デバイスは、その操作のファシリティと重大度レベルのメッセージをJunos syslogエンジンに送信するように設定されている必要があります。さらに、エンジンは、そのプロセス(またはすべてのプロセス(デフォルト))からのメッセージにサブスクライブする必要があります。この操作を実行すると、Junos syslogエンジンがイベントをSaltイベントバスに公開します。