Juniper Networks, Inc.
1194 North Mathilda Avenue
Sunnyvale, California 94089
USA
408-745-2000
www.juniper.net
Juniper Networks, Junos, Steel-Belted Radius, NetScreen, and ScreenOS are registered trademarks of Juniper Networks, Inc. in the United
States and other countries. The Juniper Networks Logo, the Junos logo, and JunosE are trademarks of Juniper Networks, Inc. All other
trademarks, service marks, registered trademarks, or registered service marks are the property of their respective owners.
Juniper Networks assumes no responsibility for any inaccuracies in this document. Juniper Networks reserves the right to change, modify,
transfer, or otherwise revise this publication without notice.
Products made or sold by Juniper Networks or components thereof might be covered by one or more of the following patents that are
owned by or licensed to Juniper Networks: U.S. Patent Nos. 5,473,599, 5,905,725, 5,909,440, 6,192,051, 6,333,650, 6,359,479, 6,406,312,
6,429,706, 6,459,579, 6,493,347, 6,538,518, 6,538,899, 6,552,918, 6,567,902, 6,578,186, and 6,590,785.
JunosE™ Software for E Series™ Broadband Services Routers System Event Logging Reference Guide
Writing: Krupa Chandrashekar, Subash BabuAsokan, MarkBarnard, DianeFlorio, Bruce Gillham, Sarah Lesway-Ball, BrianWesley Simmons,
Fran Singer
Editing: Benjamin Mann, Alana Calapai
Illustration: Nathaniel Woodward
Cover Design: Edmonds Design
Revision History
October 2010—FRS JunosE 11.3.x
The information in this document is current as of the date listed in the revision history.
YEAR 2000 NOTICE
Juniper Networks hardware and software products are Year 2000 compliant. The Junos OS has no known time-related limitations through
the year 2038. However, the NTP application is known to have some difficulty in the year 2036.
READ THIS END USER LICENSE AGREEMENT (“AGREEMENT”) BEFORE DOWNLOADING, INSTALLING, OR USING THE SOFTWARE.
BY DOWNLOADING, INSTALLING, OR USING THE SOFTWARE OR OTHERWISE EXPRESSING YOUR AGREEMENT TO THE TERMS
CONTAINED HEREIN, YOU (AS CUSTOMER OR IF YOU ARE NOT THE CUSTOMER, AS A REPRESENTATIVE/AGENT AUTHORIZED TO
BIND THE CUSTOMER) CONSENT TO BE BOUND BY THISAGREEMENT. IF YOU DO NOTOR CANNOT AGREE TOTHE TERMS CONTAINED
HEREIN, THEN (A) DO NOT DOWNLOAD, INSTALL, OR USE THE SOFTWARE, AND (B) YOU MAY CONTACT JUNIPER NETWORKS
REGARDING LICENSE TERMS.
1. The Parties. The parties to this Agreement are (i) Juniper Networks, Inc. (if the Customer’s principal office is located in the Americas) or
Juniper Networks(Cayman)Limited(if the Customer ’sprincipal office is locatedoutside the Americas) (such applicable entity beingreferred
to herein as“Juniper”), and (ii)the person ororganizationthat originally purchased from Juniperor anauthorized Juniper reseller theapplicable
license(s) for use of the Software (“Customer”) (collectively, the “Parties”).
2. The Software. In this Agreement, “Software” means the program modules and features of the Juniper or Juniper-supplied software, for
which Customer has paid the applicable license or support fees to Juniper or an authorized Juniper reseller, or which was embedded by
Juniper in equipment which Customer purchased from Juniper or an authorized Juniper reseller. “Software” also includes updates, upgrades
and new releases of such software. “Embedded Software” means Software which Juniper has embedded in or loaded onto the Juniper
equipment and any updates, upgrades, additions or replacements which are subsequently embedded in or loaded onto the equipment.
3. License Grant. Subject to payment of the applicablefees and the limitations and restrictions set forthherein, Junipergrants to Customer
a non-exclusive and non-transferable license, without right to sublicense, to use the Software, in executable form only, subject to the
following use restrictions:
a. Customer shall use Embedded Software solely as embedded in, and for execution on, Juniper equipment originally purchased by
Customer from Juniper or an authorized Juniper reseller.
b. Customer shall use the Software on a single hardware chassis having a single processing unit, or as many chassis or processing units
for which Customer has paid the applicable license fees; provided, however, with respect to the Steel-Belted Radius or Odyssey Access
Client software only, Customer shall use such Software on a single computer containing a single physical random access memory space
and containing any number of processors. Use of the Steel-Belted Radius or IMS AAA software on multiple computers or virtual machines
(e.g., Solaris zones) requires multiple licenses, regardless of whether such computers or virtualizations are physically contained on a single
chassis.
c. Product purchase documents, paper or electronic user documentation, and/or the particular licenses purchased by Customer may
specify limitstoCustomer’suse ofthe Software. Such limitsmayrestrictuse toa maximum numberof seats, registered endpoints, concurrent
users, sessions, calls, connections, subscribers, clusters, nodes, realms, devices, links, ports or transactions, or require the purchase of
separate licenses to use particular features, functionalities, services, applications, operations, or capabilities, or provide throughput,
performance, configuration, bandwidth, interface, processing, temporal, or geographical limits. In addition, such limits may restrict the use
of the Software to managing certain kinds of networks or require the Software to be used only in conjunction with other specific Software.
Customer’s use of the Software shall be subject to all such limitations and purchase of all applicable licenses.
d. For any trial copy of the Software, Customer’s right to use the Software expires 30 days after download, installation or use of the
Software. Customer may operate the Software after the 30-day trial period only if Customer pays for a license to do so. Customer may not
extend or create an additional trial period by re-installing the Software after the 30-day trial period.
e. The Global Enterprise Edition of the Steel-Belted Radius software may be used by Customer only to manage access to Customer’s
enterprise network. Specifically, service provider customers are expressly prohibited from using the Global Enterprise Edition of the
Steel-Belted Radius software to support any commercial network access services.
The foregoing license is not transferable or assignable by Customer. No license is granted herein to any user who did not originally purchase
the applicable license(s) for the Software from Juniper or an authorized Juniper reseller.
4. Use Prohibitions. Notwithstanding the foregoing, the license provided herein does not permit the Customer to, and Customer agrees
not to and shall not: (a) modify, unbundle, reverse engineer, or create derivative works based on the Software; (b) make unauthorized
copies of the Software (except as necessary for backup purposes); (c) rent, sell, transfer, or grant any rights in and to any copy of the
Software,in anyform, to anythird party;(d) remove anyproprietarynotices, labels, or marks onor inany copy ofthe Software orany product
in which the Software is embedded; (e) distribute any copy of the Software to any third party, including as may be embedded in Juniper
equipment sold in thesecondhandmarket;(f) use any‘locked’ or key-restricted feature,function, service, application, operation,or capability
without first purchasing the applicable license(s) and obtaining a valid key from Juniper, even if such feature, function, service, application,
operation, or capability is enabled without a key; (g) distribute any key for the Software provided by Juniper to any third party; (h) use the
Software in any manner that extends or is broader than the uses purchased by Customer from Juniper or an authorized Juniper reseller; (i)
use Embedded Software on non-Juniper equipment; (j) use Embedded Software (or make it available for use) on Juniper equipment that
the Customer did not originally purchase from Juniper or an authorized Juniper reseller; (k) disclose the results of testing or benchmarking
of the Software to any third party without the prior written consent of Juniper; or (l) use the Software in any manner other than as expressly
provided herein.
5. Audit. Customer shall maintain accurate records as necessary to verify compliance with this Agreement. Upon request by Juniper,
Customer shall furnish such records to Juniper and certify its compliance with this Agreement.
6. Confidentiality. The Parties agree that aspects of the Software and associated documentation are the confidential property of Juniper.
As such, Customer shall exerciseall reasonable commercial efforts to maintain the Software and associated documentation in confidence,
which at a minimum includes restricting access to the Software to Customer employees and contractors having a need to use the Software
for Customer’s internal business purposes.
7. Ownership. Juniper and Juniper’s licensors, respectively, retain ownership of all right, title, and interest (including copyright) in and to
the Software, associated documentation, and all copies of the Software. Nothing in this Agreement constitutes a transfer or conveyance
of any right, title, or interest in the Software or associated documentation, or a sale of the Software, associated documentation, or copies
of the Software.
8. Warranty, Limitation of Liability, Disclaimer of Warranty. The warranty applicable to the Software shall be as set forth in the warranty
statementthataccompaniesthe Software(the “Warranty Statement”). Nothing inthis Agreement shall giverise to anyobligation tosupport
the Software. Support services may be purchased separately. Any such support shall be governed by a separate, written support services
agreement. TO THE MAXIMUM EXTENT PERMITTED BY LAW, JUNIPER SHALL NOT BE LIABLE FOR ANY LOST PROFITS, LOSS OF DATA,
OR COSTS ORPROCUREMENT OFSUBSTITUTE GOODSOR SERVICES,OR FORANYSPECIAL,INDIRECT, OR CONSEQUENTIALDAMAGES
ARISING OUTOF THIS AGREEMENT,THE SOFTWARE,OR ANY JUNIPEROR JUNIPER-SUPPLIED SOFTWARE. IN NOEVENT SHALL JUNIPER
BE LIABLE FOR DAMAGES ARISING FROM UNAUTHORIZED OR IMPROPER USE OF ANY JUNIPER OR JUNIPER-SUPPLIED SOFTWARE.
EXCEPT AS EXPRESSLY PROVIDED IN THE WARRANTY STATEMENT TO THE EXTENT PERMITTED BY LAW, JUNIPER DISCLAIMS ANY
AND ALL WARRANTIES IN AND TO THE SOFTWARE (WHETHER EXPRESS, IMPLIED, STATUTORY, OR OTHERWISE), INCLUDING ANY
IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NONINFRINGEMENT. IN NO EVENT DOES
JUNIPER WARRANT THAT THE SOFTWARE, OR ANY EQUIPMENT OR NETWORK RUNNING THE SOFTWARE, WILL OPERATE WITHOUT
ERROR OR INTERRUPTION, OR WILL BE FREE OF VULNERABILITY TO INTRUSION OR ATTACK. In no event shall Juniper’s or its suppliers’
or licensors’ liability to Customer, whether in contract, tort (including negligence), breach of warranty, or otherwise, exceed the price paid
by Customer for the Software that gave rise to the claim, or if the Software is embedded in another Juniper product, the price paid by
Customer for such other product. Customer acknowledges and agrees that Juniper has set its prices and entered into this Agreement in
reliance upon the disclaimers of warranty and the limitations of liability set forth herein, that the same reflect an allocation of risk between
the Parties (including the risk that a contract remedy may fail of its essential purpose and cause consequential loss), and that the same
form an essential basis of the bargain between the Parties.
9. Termination. Any breach of this Agreement or failure by Customer to pay any applicable fees due shall result in automatic termination
of the license granted herein. Upon such termination, Customer shall destroy or return to Juniper all copies of the Software and related
documentation in Customer’s possession or control.
10. Taxes. All license fees payable under this agreement are exclusive of tax. Customer shall be responsible for paying Taxes arising from
the purchase of the license, or importation or use of the Software. If applicable, valid exemption documentation for each taxing jurisdiction
shall be provided to Juniper prior to invoicing, and Customer shall promptly notify Juniper if their exemption is revoked or modified. All
payments made by Customer shall be net of any applicable withholding tax. Customer will provide reasonable assistance to Juniper in
connection with such withholding taxes by promptly: providing Juniper with valid tax receipts and other required documentation showing
Customer’s payment of any withholding taxes; completing appropriate applications that would reduce the amount of withholding tax to
be paid; and notifying and assisting Juniper in any audit or tax proceeding related to transactions hereunder. Customer shall comply with
all applicable tax laws and regulations, and Customer will promptly pay or reimburse Juniper for all costs and damages related to any
liability incurred by Juniper as a result of Customer’s non-compliance or delay with its responsibilities herein. Customer’s obligations under
this Section shall survive termination or expiration of this Agreement.
11. Export. Customer agrees to comply with all applicable export laws and restrictions and regulations of any United States and any
applicable foreign agency or authority, and not to export or re-export the Software or any direct product thereof in violation of any such
restrictions, laws or regulations, or without all necessary approvals. Customer shall be liable for any such violations. The version of the
Software supplied to Customer may contain encryption or other capabilities restricting Customer’s ability to export the Software without
an export license.
12. Commercial Computer Software. The Software is “commercial computer software” and is provided with restricted rights. Use,
duplication, or disclosure by the United States government is subject to restrictions set forth in this Agreement and as provided in DFARS
227.7201 through 227.7202-4, FAR 12.212, FAR 27.405(b)(2), FAR 52.227-19, or FAR 52.227-14(ALT III) as applicable.
13. Interface Information. To the extent required by applicable law, and at Customer's written request, Juniper shall provide Customer
with the interface information needed to achieve interoperability between the Software and another independently created program, on
payment of applicable fee, if any. Customer shall observe strict obligations of confidentiality with respect to such information and shall use
such information in compliance with any applicable terms and conditions upon which Juniper makes such information available.
14. Third Party Software. Any licensor of Juniper whose software is embedded in the Software andany supplier ofJuniper whose products
or technology are embedded in (or services are accessed by) the Software shall be a third party beneficiary with respect to this Agreement,
and such licensor or vendor shall have the right to enforce this Agreement in its own name as if itwere Juniper. In addition, certain third party
software may be provided with the Software and is subject to the accompanying license(s), if any, of its respective owner(s). To the extent
portions of the Software are distributed under and subject to open source licenses obligating Juniper to make the source code for such
portions publicly available (such as the GNU General Public License (“GPL”) or the GNU Library General Public License (“LGPL”)), Juniper
will make such source code portions (including Juniper modifications, as appropriate) available upon request for a period of up to three
years from the date of distribution. Such request can be made in writing to Juniper Networks, Inc., 1194 N. Mathilda Ave., Sunnyvale, CA
94089, ATTN: General Counsel. You may obtain a copy of the GPL at http://www.gnu.org/licenses/gpl.html, and a copy of the LGPL
at http://www.gnu.org/licenses/lgpl.html .
15. Miscellaneous. This Agreement shall be governed by the laws of the State of California without reference to its conflicts of laws
principles. The provisions of the U.N. Convention for the International Sale of Goods shall not apply to this Agreement. For any disputes
arising under this Agreement, the Parties hereby consent to the personal and exclusive jurisdiction of, and venue in, the state and federal
courts within Santa Clara County, California. This Agreement constitutes the entire and sole agreement between Juniper and the Customer
with respect to the Software, and supersedes all prior and contemporaneous agreements relating to the Software, whether oral or written
(including any inconsistent terms contained in a purchase order), except that the terms of a separate written agreement executed by an
authorized Juniper representative and Customer shall govern to the extent such terms are inconsistent or conflict with terms contained
herein. No modification to this Agreement nor any waiver of any rights hereunder shall be effective unless expressly assented to in writing
by the party to be charged. If any portion of this Agreement is held invalid, the Parties agree that such invalidity shall not affect the validity
of the remainder of this Agreement. This Agreement and associated documentation has been written in the English language, and the
Parties agree that the English version will govern. (For Canada: Les parties aux présentés confirment leur volonté que cette convention de
même que tous les documents y compris tout avis qui s'y rattaché, soient redigés en langue anglaise. (Translation: The parties confirm that
this Agreement and all related documentation is and will be in the English language)).
If the information in the latest release notes differs from the information in the
documentation, follow the JunosE Release Notes.
To obtain the most current version of all Juniper Networks®technical documentation,
see the product documentation page on the Juniper Networks website at
http://www.juniper.net/techpubs/.
Audience
This guide is intended for experienced system and network specialists working with
Juniper Networks E SeriesBroadband Services Routers in an Internetaccessenvironment.
E Series and JunosE Text and Syntax Conventions
Table 1 on page xxii defines notice icons used in this documentation.
or variable to the left or to the right of this
symbol. (The keyword or variable can be
either optional or required.)
[ ]* (brackets and asterisk)
that can be entered more than once.
Represent required keywords or variables.{ } (braces)
Obtaining Documentation
To obtain the most current version of all Juniper Networks technical documentation, see
the Technical Documentation page on the Juniper Networks Web site at
http://www.juniper.net/.
To download complete sets of technical documentation to create your own
documentation CD-ROMs or DVD-ROMs, see the Portable Libraries page at
Copies of the Management Information Bases (MIBs) for a particular software release
are available for download in the software image bundle from the Juniper Networks Web
site athttp://www.juniper.net/.
Documentation Feedback
We encourage you to provide feedback, comments, and suggestions so that we can
improve the documentation to better meet your needs. Send your comments to
techpubs-comments@juniper.net, or fill out the documentation feedback form at
https://www.juniper.net/cgi-bin/docbugreport/. If you are using e-mail, be sure to include
the following information with your comments:
•
Document or topic name
•
URL or page number
•
Software release version
Requesting Technical Support
Technical productsupport isavailable through theJuniper NetworksTechnical Assistance
Center (JTAC). If you are a customer with an active J-Care or JNASC support contract,
JTAC hours of operation—The JTAC centers have resources available 24 hours a day,
7 days a week, 365 days a year.
Self-Help Online Tools and Resources
For quick and easy problem resolution, Juniper Networks has designed an online
self-service portal called the Customer Support Center (CSC) that provides you with the
following features:
Find solutions and answer questions using our Knowledge Base: http://kb.juniper.net/
•
Download the latest versions of software and review release notes:
http://www.juniper.net/customers/csc/software/
•
Search technical bulletins for relevant hardware and software notifications:
https://www.juniper.net/alerts/
•
Join and participate in the Juniper Networks Community Forum:
http://www.juniper.net/company/communities/
•
Open a case online in the CSC Case Management tool: http://www.juniper.net/cm/
To verifyservice entitlement by product serial number, use our SerialNumber Entitlement
(SNE) Tool: https://tools.juniper.net/SerialNumberEntitlementSearch/
Opening a Case with JTAC
You can open a case with JTAC on the Web or by telephone.
•
Use the Case Management tool in the CSC at http://www.juniper.net/cm/ .
•
Call 1-888-314-JTAC (1-888-314-5822 toll-free in the USA, Canada, and Mexico).
For international or direct-dial options in countries without toll-free numbers, see
E Series Broadband Services Routers enable you to log system events to discover and
isolate problems with your system. This chapter explains how to use the command-line
interface (CLI) to monitor your system’s log configuration and stay informed about all
system events that you want to track.
This chapter contains the following sections:
•
Overview of System Logging on page 3
•
Logging Platform Considerations on page 4
•
Configuring Event Logging on page 5
•
Configuring Log Severity for Individual and Systemwide Logs on page 10
•
Configuring Log Verbosity for Individual Logs or All Logs on page 14
•
Setting the Timestamp for Log Messages on page 14
•
Configuring Log Filters on page 15
•
Turning Off Log Filters on page 16
•
Monitoring Logging System Events on page 17
Overview of System Logging
System events are classified into event categories. Using the CLI, you can determine
which event categories to log. To fully utilize the logging facility, you need to understand
log severity and log verbosity.
Log Severity
Log severity is a level that is assigned to an event or log message. Log severity levels
apply to event categories, such as bulkStats, bgpRoutes, or atm1483.
The minimum severity of a log message for an individual category is described either by
a severity number in the range 0–7 or a descriptive priority term, such as emergency or
debug. The lower the severity number is, the higher the priority. See Table 3 on page 4.
NOTE: Not every event category supports every severity level. For a list of
event categories and the severity levels that each category supports, see
“Event Categories” on page 21.
The verbosity level determines theamount of information that appears in each message.
You can assign the verbosity level for the log category. Verbosity levels can be any of the
following:
•
Low—Terse
•
Medium—Moderate
•
High—Verbose
NOTE: Many event categories provide only low-verbosity detail regardless
of the verbosity setting.
Log messages can survive a system reboot. After a reboot, the system rebuilds the list
of log messages. However, if the system detects any problems or has gone through a
power cycle, the buffer is reset, and the log messages from the previous session are lost.
Log messages are not synchronized between primary and redundant SRP modules.
During a switchover from a primary to a redundant SRP module, existing log messages
are not transferred to the redundant SRP module.
Logging Platform Considerations
System logs are supported on all E Series routers.
For information about the modules supported on E Series routers:
•
See the ERXModule Guide for modulessupportedon ERX7xxmodels, ERX14xx models,
and the Juniper Networks ERX310 Broadband Services Router.
•
See the E120 and E320 Module Guide for modules supported on the Juniper Networks
E120 and E320 Broadband Services Routers.
Configuring Event Logging
By default, event logging is enabled and has default settings. This section explains how
to change settings to customize event logging to fit your needs.
•
Set a baseline for when the system begins logging messages.
host1#baseline log 11:12:55 April 30 2002
•
Set the log severity.
host1(config)#log severity warning
Chapter 1: System Logging Overview
•
Remove the limit on the number of buffers available for an event category.
host1(config)#log unlimit qos
•
Set the log verbosity.
host1(config)#log verbosity low
•
Log messages to a specified destination.
host1(config)#log destination syslog 10.10.9.5 include ospfGeneral
JunosE 11.3.x System Event Logging Reference Guide
• last-reset—Causes the system to display log messages generated since the last time
the system was reset
• Examples
host1#baseline log 11:12:55 April 30 2002
host1#baseline log last-reset
• There is no no version.
• See baseline log.
log destination• Use to log messages to the specified destination, including system log, console, and
nv-file (nonvolatile storage).
NOTE: You can display traffic logs—such as ipTraffic, icmpTraffic,
tcpTraffic, and udpTraffic—only through the show log data command or
from the SRP module console. You cannot redirect traffic logs elsewhere,
such as to a system log or nonvolatile storage file, or to a Telnet session.
• Use the severity keyword to limit the messages logged based on priority level.
• The following information applies to logging messages to system log servers.
• You can have multiple system log servers, but must configure logging to each one
separately.
• A particular message within a specified event category is logged to a particular
system log server only if the priority of the message is greater than or equal to both
the priority of the event category and the priority of that system log server.
• If you log messages to a system log server, you can also specify:
• facility—Specifies a facility ID on the system log destination host. The range is
0–7, representing the logging facilities local0–local7.
• include—Logs only the listed categories to system log; no other categories are
logged unless specifically included by issuing this command again.
• exclude—Logs all categories to system log except the listed categories; all other
categories are logged unless specifically excluded by issuing this command again.
• Issuing an include command after an exclude command (or vice versa) overrides
the earlier command. Therefore, you cannot enter a command including certain
categories and then follow it with a commandexcludingothers. Similarly,you cannot
enter a command excluding certain categories and then follow it with a command
including others.
• You can issue successive include commands or successive exclude commands; in
this case, the successive commands expand the list of included or excluded
categories.
• Example 1—The first command causes only the osfpGeneral, mplsGeneral, and os
event categoriesto be logged to system log at 10.10.9.5. Thesecond command reverses
this inclusion and restores the logging of all event categories.
host1(config)#log destination syslog 10.10.9.5 include ospfGeneral
mplsGeneral os
host1(config)#no log destination syslog 10.10.9.5
• Example 2—The first command again causes only the osfpGeneral, mplsGeneral, and
os event categories to be logged to system log at 10.10.9.5. The second command
reversesthe inclusion ofospfGeneral and os. The mplsGeneral category isstill included
and is thus the only category logged.
host1(config)#log destination syslog 10.10.9.5 include ospfGeneral mplsGeneral os
host1(config)#no log destination syslog 10.10.9.5 include ospfGeneral os
• Example 3—The first command causes the isisGeneral, ipRoutePolicy, and ipTraffic
event categories to be excluded from logging to system log at 10.1.2.3. The second
command reverses this exclusion and restores the logging of all event categories.
• Example 4—The first command again causes the isisGeneral, ipRoutePolicy, and
ipTraffic event categories to be excluded from logging to system log at 10.1.2.3. The
second command reverses the exclusion of ipRoutePolicyand ipTraffic. The isisGeneral
category is still excluded; all other events are logged.
• Example 6—The first command causes the isisGeneral event category to be excluded
from logging to systemlogat 10.1.2.3; all othereventsare logged. The second command
overrides the first and causes the exclusion of all events except ospfGeneral.
log severity• Use to set the severity level for systemwide logs (that is, when you do not specify an
individual event category) or for a specific event category. For a list of severity values,
see Table 3 on page 4.
NOTE: Assigning a log severity to an individual event category changes its
state to Assigned. You cannot change the severity of that event category
using systemwide level commands until you return the event category to
its default, unassigned state with the no log severity command.
• If you do not specify a category, the severity value changes for all categories except
individual categories for which you previously set a specific severity level. See
“Configuring Log Severity for Individual and Systemwide Logs” on page 10 for details.
• Each event category has itsown defaultseverity value. For most categories,the default
is Error.
• To disable all default level log messages, use the off keyword without specifying an
event category.
• To disable individual level log messages, use the off keyword and specify the event
category that you want to disable.
• Example
host1(config)#log severity warning
• Use the no version toreturn the systemwide (whenassigned) or default severity values
to event categories.
• Use the no version with an* (asterisk) to return all event categories (modified either
systemwide or individually) to their default severity setting. For example:
host1(config)#no log severity *
• See log severity.
log unlimit• Use to remove the limit on the number of outstanding buffers for an event category,
such as when the system is dropping logs of a particular category.
• Example
host1(config)#log unlimit qos
• Use the no version to return to the default value.
• See log unlimit.
log verbosity• Use to set the verbosity level for a selected category or for all categories.
• If you do not specify a category, then the verbosity level is set for all categories.
• The default verbosity setting for all logs is low.
JunosE 11.3.x System Event Logging Reference Guide
• Use the no version to return to the default verbosity (low) for the selected category.
• See log verbosity.
Configuring Log Severity for Individual and Systemwide Logs
You can change the severity setting for individual logs and the systemwide value.
When working with log severities, keep the following in mind:
•
All log event categories have a default. However, the default values can vary for each
category. For example, most event categories havea default severity of Error. However,
some event categories may have a default severity of Notice, Warning, Info, and so on.
•
Log event categories have two states—unassigned (default) and assigned. How a log
event category reacts to the log severity command depends on its current state.
•
You can change log severities for event categoriesata systemwidelevelor anindividual
level. Systemwide changes are those that modify a large number of unassigned event
categories at one time; for example, the command log severity debug off. Individual
changes are those that indicate an explicit event category that you want to change;
for example, the command log severity notice clicommand.
•
Changes to log event categories at an individual level take precedence over those
made at the systemwide level.
•
Changes to log event categories at the systemwide level take precedence over the
default.
•
Assigning a log severity to an individual event category changes its state to Assigned.
This means that you cannot change the severity of that event category using
systemwide level commands until you return the event category to its default,
unassigned state by using the no log severity eventCategory command.
•
To return all logs, systemwide and individual, to their default, unassigned severity level,
use the no log severity * command.
•
To see whether individual or systemwide severity and verbosity settings are in effect,
use the show log configuration command.
ExampleThe following example demonstrates the effects of event category state in regard to
using systemwide commands:
1. In Configuration mode and having made no changes to the severity settings of any
event categories, view the log configuration:
host1(config)#run show log config
log destination console severity WARNING
log destination nv-file severity CRITICAL
log destination syslog 10.10.4.240 facility 7 severity DEBUG
no log engineering
log fields timestamp instance no-calling-task
no log here
Warning: Logging to this terminal is disabled
no log severity
Notice that the atm event category that you individually assigned in Step 3 does not
change.
5. Turn off log notification, systemwide, and view the log configuration:
host1(config)#log severity off
host1(config)#run show log config
log destination console severity WARNING
log destination nv-file severity CRITICAL
log destination syslog 10.10.4.240 facility 7 severity DEBUG
no log engineering
log fields timestamp instance no-calling-task
no log here
Warning: Logging to this terminal is disabled
log severity OFF
category severity verbosity filters notes
-------------------- --------- --------- ------- ----aaaAtm1483Cfg OFF low 1
aaaEngineGeneral OFF low 1
aaaServerGeneral OFF low 1
aaaUserAccess OFF low 1
addressServerGeneral OFF low 1
ar1AaaServerGeneral OFF low 1
atm EMERGENCY low 2
atm1483 OFF low 1
atmAal5 OFF low 1
Notice that the atm event category does not change.
6. Remove the assignedstatus ofthe atmevent category and view the log configuration:
host1(config)#no log severity atm
host1(config)#run show log config
log destination console severity WARNING
log destination nv-file severity CRITICAL
log destination syslog 10.10.4.240 facility 7 severity DEBUG
no log engineering
log fields timestamp instance no-calling-task
no log here
Warning: Logging to this terminal is disabled
log severity OFF
category severity verbosity filters notes
-------------------- -------- --------- ------- ----aaaAtm1483Cfg OFF low 1
aaaEngineGeneral OFF low 1
aaaServerGeneral OFF low 1
aaaUserAccess OFF low 1
addressServerGeneral OFF low 1
ar1AaaServerGeneral OFF low 1
atm OFF low 1
atm1483 OFF low 1
atmAal5 OFF low 1
Notice that the atm event category follows the systemwide severity level of OFF. The
systemwide setting takes precedence over the atm event category default of Error.
7. Change all event categories, systemwide, to their default/unassigned levels, and view
the log configuration:
host1(config)#no log severity *
Please wait....
host1(config)#run show log config
log destination console severity WARNING
log destination nv-file severity CRITICAL
log destination syslog 10.10.4.240 facility 7 severity DEBUG
no log engineering
log fields timestamp instance no-calling-task
no log here
Warning: Logging to this terminal is disabled
no log severity
JunosE 11.3.x System Event Logging Reference Guide
Configuring Log Verbosity for Individual Logs or All Logs
The default verbosity setting for all logs is low. To change the logging verbosity of an
individual log, specify a category when you enter the log verbosity command. To change
the log verbosity of every log, do not specify an event category when you enter the logverbosity command. However, after you enter the log verbosity command without
specifying aparticular event category, all logsare set to thenew verbosity.No log verbosity
overrides are saved.
ExampleThe following example sets all log categories to verbosity medium, and then it sets the
verbosity level for ds3 events to high.
host1(config)#log verbosity medium
host1(config)#log verbosity high ds3
Setting the Timestamp for Log Messages
You can use the service timestamps command to format timestamps for log messages.
By default, log messages display universal coordinated time (UTC) without the time
zone.
The following examples illustrate how you can change the timestamp on log messages.
•
Set the time zone to eastern daylight time (EDT), 5 hours behind UTC, and display the
local time on the log messages.
host1(config)#clock timezone EDT -5
•
Display UTC, but no time zone, on the log messages.
host1#exit
host1#show log data category cliCommand severity info
***********************************************************
NOTICE 134 cliCommand: "configure terminal", console
NOTICE 133 cliCommand: "no service timestamps", console
***********************************************************
service timestamps• Use to format timestamps for log messages.
• For information about setting local times and time zones, see JunosE System Basics
Configuration Guide.
• The show log data command displays the logdata with the current timestampformat.
• The show log data nv-file command displays the log data with the timestamp format
in effect at the time the log record was written.
• Use the no version to remove timestamps from log messages.
• See service timestamps.
Chapter 1: System Logging Overview
Configuring Log Filters
Many event categories contain filters so you can further refine the type of information
that the system logs. For example, when logging BGP connections, you can limit the
information logged to a specific access class, peer, route map, or virtual router.
You define filters when you set the log severity for an event category. The online Help
shows the options you can set for each filter.
NOTE: You can use the packet flow monitoring feature to create user-defined
classification parameters that specify the packet data that is logged. See
Packet Tagging Overview.
The following example createsa filter that logs BGPconnection information at thedebug
severity level on traffic that matches access list ListOne, and is incoming traffic to virtual
router default.
host1(config)# log severity debug bgpevents ?
access-class Select an access list for the filter
in Select import/in direction for the filter
out Select export/out direction for the filter
peer Select a peer IP address for the filter
route-map Select a route map for the filter
router Identify an instance of a virtual router
<cr>
host1(config)# log severity debug bgpevents access-class ?
WORD The access list
host1(config)# log severity debug bgpevents access-class ListOne ?
filtering-router Identify virtual router where access-class/route-map are defined
in Select import/in direction for the filter
out Select export/out direction for the filter
route-map Select a route map for the filter
<cr>
JunosE 11.3.x System Event Logging Reference Guide
host1(config)# log severity debug bgpevents access-class ListOne route-map ?
WORD The route map
host1(config)# log severity debug bgpevents access-class ListOne route-map default ?
filtering-router Identify virtual router where access-class/route-map are defined
in Select import/in direction for the filter
out Select export/out direction for the filter
<cr>
host1(config)# log severity debug bgpevents access-class ListOne route-map default in
The next example limits the logging of PPP debug events to traffic to or from the POS
interface in slot 2/0.
host1(config)#log severity debug ppp ?
atm Specify an ATM PPP interface
fastEthernet Specify a fastEthernet interface
gigabitEthernet Specify a gigabitEthernet interface
mlppp Specify an MLPPP network interface
pos Specify a POS PPP interface
serial Specify a serial PPP interface
<cr>
host1(config)#log severity debug ppp pos 2/0
To obtain a list of the filters available in each event category, see “Event Categories” on
page 21 .
Turning Off Log Filters
You can turn off filters in three ways:
•
•
•
To turn off all filters:
To turn off all filters for anevent category, use the no version ofthe log severity command
along with the category name. For example:
To turn off a specific filter, use the no version of the log severity command that you used
to add the filter. For example:
no log filters• Use to turn off log filters.
• To turn off all filters for an event category, specify the category name.
• To turn off a specific filter, use the no version of the log severity command that you
used to add the filter.
• See no log filters.
Monitoring Logging System Events
Use the show log configuration command to display your log configuration. Use the
show log data command to display system events on your screen.
You can use theoutput filteringfeature of the show command to include or exclude lines
of outputbasedon atextstring you specify. Seeshow Commands in JunosE System BasicsConfiguration Guide for details.
show log configuration• Use to show the logging configuration on your system.
This chapter lists each event category in the system software. To help you determine
the severity level to set when troubleshooting, the log strategy for each event category
is included. The log strategy shows the type of information logged for each severity level.
In addition, this chapter includes the filters available in each event category.
JunosE 11.3.x System Event Logging Reference Guide
DebugNotification from AAA indicating that an ATM 1483subinterface configurationis available;
ATM 1483 processing configuration received from AAA; unable to get ATM 1483
subinterface information; number of ATM 1483 configuration entries is out of range
FilterNone
aaaEngineGeneral
DescriptionAAA engine general
EmergencyNone
AlertNone
CriticalNone
ErrorNone
Warning LogNone
Notice LogControl flow and key events, less verbose than debug
messagefailures;the Framed-IPv6-PrefixRADIUS attribute isused for bothIPv6 Neighbor
Discovery router advertisements and DHCPv6 Prefix Delegation;Notify duplicate event
ignored for profileHandle: profileHandle issu in progress; Notify duplicate event ignored
for profileHandle: profileHandle unable to allocate memory
Notice LogAuthentication failures resulting from memory allocation failures
DebugAuthentication failures resulting from reasons other than memory allocation failures;
FilterNone
aaaUserAccess
DescriptionAAA user access
EmergencyNone
AlertNone
InfoNone
status of authentication; accounting and address assignment requests sent to local
(internal) servers; duplicate accountingmessagefailures;EAP challenge received; memory
allocation failure for tunnel definition table and profile; failed to insert tunnel attribute
and tunnel tag table; container size exceeded: creating new; found unexpected tunnel
table; dsl-forum atrribute type parse error: limited data or overflow; Duplicate prefix
event received for profileHandle: profileHandle
interface; error allocating memory for new interface; error setting system identifier; error
adding or configuring an interface; error getting capabilities of interface; error getting
maximum VPI/VCI for interface; error getting maximum virtual circuit descriptor for
interface;unable to store orallocate memoryfor F4OAM circuit data;unable to configure
F4 OAM circuit for interface
Notice LogInterfacepool expanded by anincremental number of entries; reportretry delay inseconds
when waiting for the underlying physical interface to be created; unable to allocate a
message to sendan interfaceup ordown notification; unable toadd orconfigureinterface
InfoDropping interface up, down, or not present notification due to removal of interface;
discarding F4 OAM circuits when interface does not support F4 OAM
JunosE 11.3.x System Event Logging Reference Guide
AlertNone
CriticalNone
ErrorError applying static map entry for a newly created circuit of an NBMA interface; unable
to configure interfaces on ATM interface; unable to determine interface location for ATM
AAL5 interface;unable to determinemaximum interface configurationcount for interface;
unable to configure interface on ATM interface
error opening a circuit for an NBMA interface; attempting to associate a static map to an
underlying ATM interface that does not exist; error restoring circuits from NVS; error
removing static map entry; NVS entry not found for static map entry; error storing static
map entry in NVS; error expanding interface pool, interface binding pool, or subscriber
pool
Notice LogInterface pool, interface binding pool, or subscriber pool expanded by an incremental
number of entries; unable to allocate a message to send a subinterface up or down
notification
InfoDropping subinterface up or down notification due to removal of subinterface; configure
DebugNone
FilterNone
atm1483VcClass
DescriptionApplication of attributes configured in a virtual circuit (VC) class to PVCs
EmergencyNone
AlertNone
CriticalNone
ErrorIn routers with high availability enabled, failure to mirror the VC modification or failure
Warning LogFailure to find the PVCs associated with this VC class; failure to apply the VC class
interfaces on ATM interface; elapsed time for downloading interfaces; elapsed time for
ATM AAL5 present notification; maximum interface count per call
to associate the VC modification with the standby SRP module
attributes to the appropriate PVCs; the log message displays a brief description of the
failure
Warning LogError getting location of underlying ATM interface; error binding to ATM interface; unable
Notice LogInterfacepool expanded by anincremental number of entries; reportretry delay inseconds
atmVcClass
DescriptionInformation on VC class operational errors
EmergencyNone
to expand interface pool; error creating interface; unable to set administrative status of
interface
when waitingfor the underlyingATM interfaceto be created; unable to allocate a message
to send an interface up or down notification
InfoDropping interface up or down notification due to removal of interface
DebugNone
FilterNone
AlertNone
CriticalNone
ErrorResource failure errors, such as error allocating memory for adding a VC class; internal
software errors; error processing a VC class association; when using SNMP, unable to
set a VC class state from not in service to in service, or vice-versa; unable to find an
accepted, refused, or failed; TCP connection closed by peer
InfoNone
DebugTCP connection is ready to send; data received on TCP connection; notification message
sent; could not send notification message due to flow control—will retry later; error while
sending notification message; keepalive messagesent; could not send keepalive message
due to flow control—will retry later; error while sending keepalive message; message
other than notification or keepalive sent; could not send other message than notification
or keepalive due to flow control—will retry later; error while sending other message than
notification or keepalive
Filter 1access-class—This filter is not currently supported
Filter 2peer—See description of the bgpRoutes peer filter for information about this filter
Filter 3route-map—This filter is not currently supported
Filter 4router—See description of the bgpRoutes router filter for information about this filter
Filter 5in—This filter is not currently supported
Filter 6out—This filter is not currently supported
bgpDampening
DescriptionBGP dampening
EmergencyNone
AlertNone
CriticalNone
ErrorNone
Warning LogNone
Notice LogRoute is suppressedby route-flap dampening; routeis nolonger suppressed by route-flap
Notice LogLog BGP performed or did not perform a graceful restart; router supports or does not
support non-stop forwarding; router is capable of switching gracefully, deferring, or
resuming best path selection decision process; BGP routes allowed or prevented from
being downloaded to line cards; graceful-restart timer expiration; marking or removing
stale routes; waiting to receive end-of-rib marker from peer; received end-of-rib marker
from all peers
InfoNone
DebugStandby SRP will wait for BGP convergence on next restart
Filter 1access-class—This filter is not currently supported
Filter 2peer—This filter is not currently supported
Filter 3route-map—This filter is not currently supported
Filter 4router—See description of the bgpRoutes router filter for information about this filter
Filter 5in—This filter is not currently supported
Filter 6out—This filter is not currently supported
bgpIpv6NextHops
DescriptionBGP indirect next-hops for IPv6 NLRI
EmergencyNone
AlertNone
CriticalNone
ErrorErrors in BGP IPv6 next hop events and state transitions
JunosE 11.3.x System Event Logging Reference Guide
DebugBGP IPv6 indirect next-hop events
Filter 1router—See description of the bgpRoutes router filter for information about this filter
Filter 2remote-ipv6-address—Matches on the IPv6 address of the BGP indirect next-hop
bgpKeepAlives
DescriptionBGP keepalive messages
EmergencyNone
AlertNone
CriticalNone
ErrorNone
Warning LogKeepalive message received with unexpected additional data after header
Notice LogKeepalive message received; keepalive message sent
InfoNone
DebugNone
Filter 1access-class—This filter is not currently supported
Filter 2peer—See description of the bgpRoutes peer filter for information about this filter
Filter 3route-map—This filter is not currently supported
Filter 4router—See description of the bgpRoutes router filter for information about this filter
Filter 5in—Matches on traffic coming into the router
Filter 6out—Matches on traffic going out of the router
NOTE: Send messages are logged to the bgpKeepAlives log when a message
is added to the send queue. A debug message is logged in to the
bgpConnections log when the message is actually passed to TCP.
Warning LogUnknown message type received; invalid field in received message; notification message
Chapter 4: B Commands
AlertNone
ErrorNone
received or sent; invalid capability length in received ORF capability; invalid capability
value in received ORF capability; invalid ORF in received ORF capability; ORF entries
exceeded maximum limit in received prefix list
Notice LogOpen message receivedor sent; update message received or sent;route-refresh message
received or sent; route-refresh-cisco message received or sent; received ORF capability;
received route refresh message with ORF entries
InfoNone
DebugKeepalive message received or sent (Full decode of message logged if verbosity is high)
NOTE: Send messages are logged to the bgpMessages log when a message
is added to the send queue. A debug message is logged to the bgpConnections
log when the message is actually passed to TCP.
Filter 1access-class—This filter is not currently supported
Filter 2peer—See description of the bgpRoutes peer filter for information about this filter
Filter 3route-map—This filter is not currently supported
Filter 4router—See description of the bgpRoutes router filter for information about this filter
Filter 5in—Matches on traffic coming into the router
Filter 6out—Matches on traffic going out of the router
Filter 1access-class—This filter is not currently supported
Filter 2peer—See description of the bgpRoutes peer filter for information about this filter
Filter 3route-map—This filter is not currently supported
Filter 4router—See description of the bgpRoutes router filter for information about this filter
Filter 5in—Matches on traffic coming into the router
Filter 6out—Matches on traffic going out of the router
bgpRoutes
DescriptionBGP routing table updates
EmergencyNone
Warning LogFailure to add, remove, or modify BGP route in IP forwarding table
Notice LogBGP route added to, removed from, or modified in the IP forwarding table; aggregate
AlertNone
CriticalNone
ErrorNone
route added to, removed from, or modified in Loc-RIB; network route added to, removed
from, or modified in Loc-RIB; best route for internal peers for a given prefix became
available; bestroute for internal peersfor a given prefix isno longer available,has changed,
or has become available; best route for external peers for a given prefix is no longer
available, has changed, or has become available; MPLS base tunnel used to reach an
indirect next-hop came upor went down;MPLSstackedtunnel for label came up;indirect
next-hop became reachable or unreachable; direct next-hop for an indirect next-hop
changed; MPLS tunnel for Inter-AS label came up or went down; route added to L2VPN
instance; route deleted from L2VPN instance; route modified for L2VPN instance; -VE
device for multihomed local layer 2 site 1 changed from peer to peer2
InfoAll unsuccessful CLI configuration commands; all nonconfiguration commands
DebugNone
FilterNone
EmergencyNone
AlertNone
CriticalNone
ErrorNone
Warning LogCLI command mode from prior release no longer exists; the overridden privilege level
Notice LogNone
InfoNone
DebugNone
FilterNone
connectionManager
DescriptionLogging various conditions in the component that manages the chassis fabric.
EmergencyNone
AlertNone
Critical10G and 5G SRP modules only—Detection that the FPGAs have not been loaded (results
command will be discarded
in an SRP [and chassis] reset)
Error10G and 5G SRP modules only—That there is not enough bandwidth for a particular
board in the system, that connections could not be added in the fabric due to resource
limitations (such as memory), that a board was just removed and the resource will not
JunosE 11.3.x System Event Logging Reference Guide
•
dvmrpGracefulRestart on page 71
•
dvmrpMcastTable on page 72
•
dvmrpProbeRcv on page 72
•
dvmrpProbeSent on page 73
•
dvmrpRtTable on page 73
dcm
DescriptionDynamic Configuration Manager
EmergencyNone
AlertNone
CriticalNone
ErrorNone
Warning LogNone
Notice LogNone
InfoNone
DebugSchedule engine event; status of dynamic interface creation; receipt of teardown signal
FilterNone
dcmEngineGeneral
DescriptionDCM engine general
EmergencyNone
AlertNone
CriticalNone
for a dynamic interface; no interface adapterto propagate teardown; creation of dynamic
PPP interface failed; creation of dynamic PPPoE interface failed
JunosE 11.3.x System Event Logging Reference Guide
DebugDHCP message received
FilterNone
dhcpIssuLog
DescriptionDHCP ISSU information
EmergencyNone
AlertNone
CriticalNone
ErrorError recreating DHCP ISSU IC shadow and its data structures, followed by an ISSU halt
Warning LogBuffering capacity exceeded between DHCP engine and the driver/ISSU shadow driver
Notice LogNone
InfoNone
DebugNormal operation: packet processing events, creation and deletion of DHCP common
FilterNone
dhcpLocalClients
DescriptionDHCP local server clients
EmergencyNone
AlertNone
CriticalNone
ErrorCannot find the client’s interface; cannot find the client to expire the lease or remove it
objects during ISSU
from the database; trying to expire client’s lease or remove it from database with bad IP
address; requested MAC address does not match the available address; cannot allocate
SDX subscriber information
Warning LogCannot find the DHCP instancefor the client with an expired lease; cannot find theDHCP
instance to release the client IP address; secondary DNSwithout primaryDNS configured,
using DHCP values; secondary NetBIOS Name Server (NBNS) without primary NBNS
configured, using DHCP values
ErrorCannot find interface; remote client bind add failed; client failed to decline IP address;
client failed to decline a null offered IP address; delete remote client entry failed
Warning LogAAA not responding; SDX program not responding; rediscovering with no IP address
allocated; a renewal is received on the line module for an unknown client; secondary
DNS without primary DNS configured, using DHCP values; secondary NetBIOS Name
Server (NBNS) without primary NBNS configured, using DHCP values; duplicate MAC
address detected
Notice LogNone
InfoNone
DebugReceived packet; transmit packet; authentication status; DHCP local server state
dhcpOfferLog
DescriptionDHCP offer selection process log
EmergencyNone
transitions
Filterinterface interfaceType interfaceSpecifier
• interface—Logs events for a specific interface
• interfaceType—Type of interface for which you want to log events
• interfaceSpecifier—Location of interface in the appropriate format
NOTE: For information about interface types and specifiers, see Interface
Types and Specifiers in JunosE Command Reference Guide.