Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?


Understanding Troubleshooting Resources

This topic describes some of the troubleshooting resources available for the QFX Series or OCX Series. These resources include tools such as the Junos OS CLI, Junos Space applications, and the Advanced Insight Scripts (AI-Scripts).

Table 1 provides a list of some of the troubleshooting resources.

Table 1: Troubleshooting Resources on the QFX and OCX Series

Troubleshooting Resource



Chassis alarms

Chassis alarms indicate a failure on the switch or one of its components. A chassis alarm count is displayed on the LCD panel on the front of the switch.

Chassis Alarm Messages on a QFX3500 Device

Chassis Status LEDs and Fan Tray LEDs

A blinking amber Power, Fan, or Fan Tray LED indicates a hardware component error. A blinking amber Status LED indicates a software error.

Chassis Status LEDs on a QFX3500 Device

Interface alarms

A predefined alarm (red or yellow) for an interface type is triggered when an interface of that type goes down.

Interface Alarm Messages

System alarms

A predefined alarm is triggered by a missing rescue configuration or problem with the software license.

Understand Alarms

System log messages

The system log includes details of system and user events, including errors. Specify the severity and type of system log messages you wish to view or save, and configure the output to be sent to local or remote hosts.

Junos OS operational mode commands

Operational mode commands can be used to monitor switch performance and current activity on the network. For example, use the traceroute monitor command to locate points of failure in a network.

Junos OS automation scripts (event scripts)

Event scripts can be used to automate network troubleshooting and management tasks.

Automation Scripting User Guide

Junos OS XML operational tags

XML operational tags are equivalent in function to operational mode commands in the CLI, which you can use to retrieve status information for a device.

Junos XML API Operational Developer Reference

NETCONF XML management protocol

The NETCONF XML management protocol defines basic operations that are equivalent to Junos OS CLI configuration mode commands. Client applications use the protocol operations to display, edit, and commit configuration statements (among other operations), just as administrators use CLI configuration mode commands such as show, set, and commit to perform those operations.

NETCONF XML Management Protocol Developer Guide

SNMP MIBs and traps

MIBs enable the monitoring of network devices from a central location. For example, use the Traceroute MIB to monitor devices remotely.

AI-Scripts and Advanced Insight Manager (AIM)

AI-Scripts installed on the switch can automatically detect and monitor faults on the switch, and depending on the configuration on the AIM application, send notifications of potential problems and submit problem reports to Juniper Support Systems.

Advanced Insight Scripts (AI-Scripts) Release Notes

Junos Space Service Now

This application enables you to display and manage information about problem events. When problems are detected on the switch by Advanced Insight Scripts (AI-Scripts) that are installed on the switch, the data is collected and sent to Service Now for your review and action.

Service Automation

Junos Space Service Insight

This application helps in accelerating operational analysis and managing the exposure to known issues. You can identify devices that are nearing their End Of Life (EOL) and also discover and prevent issues that could occur in your network. The functionality of Service Insight is dependent on the information sent from Service Now.

Service Automation

Juniper Networks Knowledge Base

You can search in this database for Juniper Networks product information, including alerts and troubleshooting tips.