Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Logging and Notifications

SUMMARY Read this topic to learn about logging and notification functions in Juniper Cloud-Native Router. We discuss the location of log files, what you can log, and various log levels. You can also learn about the available notifications and how the notifications are implemented in the cloud-native router.

Logging

The Juniper Cloud-Native Router pods and containers use syslog as their logging mechanism. You can determine the location of the log files at the deployment time by retaining or changing the value of the log_path key in the values.yaml file. By default, the location of the log files is /var/log/jcnr. The system stores log files from all the cloud-native router pods and containers in the log_path directory.

In addition, a syslog-ng pod stores event notification data in JSON format on the host server. The syslog-ng pod stores the JSON-formatted notifications in the directory specified by the syslog_notifications key in the values.yaml file. By default, the file location is /var/log/jcnr and the filename is jcnr_notifications.json. You can change the location and filename by changing the value of the syslog_notifications key before the cloud-native router deployment.

When you use the default file locations, the /var/log/jcnr directory displays the following files:

Note: The host server must manage the log rotation for the contrail-vrouter-dpdk.log and the jcnr-cni.log files.

Notifications

The syslog-ng pod continuously monitors the preceding log files for notification events such as interface up, interface down, interface add, and so on. When these events appear in a log file, syslog-ng converts the log events into notification events and stores the events in JSON format within the syslog_notifications file configured in the values.yaml file.

Here is a sample of syslog-ng notifications:

Table 1: Supported Notifications
Notification Source Pod

License Near Expiry​

cRPD

License Expired

cRPD

License Invalid​

cRPD

License OK​

cRPD
License Grace Period cRPD
License Not Present cRPD

JCNR Init Success​

Deployer

JCNR Init Failure​

Deployer
JCNR Graceful Shutdown Request Deployer
JCNR Graceful Shutdown Complete Deployer
JCNR Graceful Shutdown Failure Deployer
JCNR Restart Deployer
JCNR Upgrade Success Deployer
JCNR Upgrade Failure Deployer

Upstream Fabric Bond Member Link Up​

vRouter

Upstream Fabric Bond Member Link Down​

vRouter

Upstream Fabric Bond Link Up​

vRouter

Upstream Fabric Bond Link Down​

vRouter
Upstream Fabric Bond Link Switchover vRouter

Downstream Fabric Link Up​

vRouter

Downstream Fabric Link Down​

vRouter

Appliance Link Up​

vRouter

Appliance Link Down​

vRouter

Any JCNR Application Critical Errors​

vRouter
Any JCNR Application Warnings vRouter
Any JCNR Application Info vRouter
JCNR Rate Limits Reached vRouter

JCNR MAC Table Limit Reached​

vRouter

JCNR CLI Start​

cRPD or vRouter-Agent

JCNR CLI Stop​

cRPD or vRouter-Agent

JCNR Kernel App Interface Up​

vRouter

JCNR Kernel App Interface Down​

vRouter

JCNR Virtio User Interface Up​

vRouter

JCNR Virtio User Interface Down​

vRouter