Trace Options

The routing system can optionally log information about errors and events.

Logging is configured for each protocol or globally.

Logging is not generally enabled during normal operations, because it can decrease performance.

Log messages are saved in the /var/log/routed.log.* files.

For detailed example instructions, see these procedures:

Configuring Trace Options in Gaia Portal

  1. From the left navigation tree, click Advanced Routing > Routing Options.

  2. Click the Configuration tab.

  3. In the Trace Options section, configure:

    • Maximum Trace File Size - Enter a value between 1 to 2047 MB (the default is 1 MB).

      Note - When the active file reaches this size, GaiaClosed Check Point security operating system that combines the strengths of both SecurePlatform and IPSO operating systems. rotates it - renames the active file to /var/log/routed.log.<N> and creates a new active file. The cycle repeats until the total number of these log files reaches the configured number.

    • Number of Trace Files - Enter a number between 1 to 4294967295 (the default is 10). The is the total number of the log files /var/log/routed.log.* to keep. When the total number of these log files reaches the configured number, Gaia deletes the oldest file.

    • Filter Visible Tables Below - Select which trace tables to show below. By default, Gaia PortalClosed Web interface for the Check Point Gaia operating system. shows all available tables (Show All).

    • For each applicable set of trace options:

      1. In the applicable trace table, select the applicable options.

        To select multiple options, press and hold down the Shift key while you click the options.

      2. Above the trace table, click Add.

        The trace table shows Enabled for the selected options.

      Important:

      • In the trace table Global, you can enable the tracing of a specific routing option for all protocols. For example, enable the tracing of Cluster option.

      • In the trace table Global, you can enable the tracing of all routing options for all protocols. Select the option All.

  4. In the Routing Options section (at the top), click Apply.

  1. From the left navigation tree, click Advanced Routing > Routing Options.

  2. In the top right corner, click the Monitoring tab.

  3. In the Trace File field, select the /var/log/routed.log file.

  4. In the Number of lines field, enter the applicable number of lines to show.

    Range: 5-100

    Default: 40

  5. Click Get Tail.

Configuring Trace Options in Gaia Clish

  1. Configure the size (in Megabytes) of the active log file:

    set tracefile size {<1-2047> | default}

  2. Configure the maximal number of log files to keep:

    set tracefile maxnum {<1-4294967295> | default}

  3. Configure the applicable trace options:

    set trace

          bfd <Trace Option> {off | on}

          bgp <Trace Option> {off | on}

          bootp <Trace Option> {off | on}

          cluster <Trace Option> {off | on}

          dhcp6relay <Trace Option> {off | on}

          global <Trace Option> {off | on}

          icmp <Trace Option> {off | on}

          igmp <Trace Option> {off | on}

          ip-reachability-detection <Trace Option> {off | on}

          iphelper <Trace Option> {off | on}

          ipsec-routing <Trace Option> {off | on}

          kernel <Trace Option> {off | on}

          mfc <Trace Option> {off | on}

          ospf <Trace Option> {off | on}

          ospf3 <Trace Option> {off | on}

          pbr <Trace Option> {off | on}

          pim <Trace Option> {off | on}

          rip <Trace Option> {off | on}

          ripng <Trace Option> {off | on}

          router-discovery <Trace Option> {off | on}

          router-discovery6 <Trace Option> {off | on}

          static-route <Trace Option> {off | on}

          vrrp <Trace Option> {off | on}

          vrrp6 <Trace Option> {off | on}

    Note - To configure several trace options in the specified category, you must run the command once for every trace option in the specified category.

    For example:

    set trace ospf hello on

    set trace ospf lsa on

  4. Save the configuration:

    save config

Parameter

Description

size {<1-2047> | default}

Configures the size (in Megabytes) of the /var/log/routed.log log file.

When the active file reaches this size, Gaia rotates it - renames the active file to /var/log/routed.log.<N> and creates a new active file.

Default: 1 MB

maxnum {<1-4294967295> | default}

Configures the total number of the log files /var/log/routed.log.* to keep.

When the total number of these log files reaches the configured number, Gaia deletes the oldest file.

Default: 10

<Trace Option> {off | on}

Disables (off) or enables (on) the specific trace option in the specified category.

To configure all available options in the specified category, enter all.

global <Trace Option> {off | on}

Disables (off) or enables (on) the specific trace option in all categories.

To configure all available options in all categories, enter all.

Description of Trace Options

Trace Option

Description

ack

Trace the Link State acknowledgment packets in this category.

address

Trace the IP address messages in this category.

adv

Trace the allocation of and freeing of policy blocks in this category.

advertise

Trace the "Advertise" messages in this category.

alerts

Trace the alert callback events in this category.

all

Trace all the routing events in this category.

assert

Trace the "Assert" messages in this category.

auth

Trace the authentication messages in this category.

bootstrap

Trace the bootstrap messages in this category.

cache

Trace the cache maintenance log details:

  • addition or deletion of orphan entries (entries with no route to source)

  • addition or deletion of normal entries

  • cache state aging and refresh entries

cluster

Trace the clusterClosed Two or more Security Gateways that work together in a redundant configuration - High Availability, or Load Sharing.-specific events in this category.

crp

Trace the Candidate Rendezvous Point advertisements in this category.

dd

Trace the database description packets in this category.

dr

Trace the designated router packets in this category.

error

Trace the ICMP "Error" packets:

  • time exceeded

  • parameter problem

  • unreachable

  • source quench

general

Trace the events related to "normal" and "route" options in this category.

graft

Trace the "Graft" and "Graft Acknowledgment" packets in this category.

group

Trace the multicast group "Add", "Delete", "Refresh", and "Accelerated Leave" events in this category.

hello

Trace the "Hello" packets in this category.

iflist

Trace the interface list scans in this category.

info

Trace the ICMP "Informational" packets:

  • mask request/response

  • info request/response

  • echo request/response

  • time stamp request/response

interface

Trace the interface-specific messages in this category.

join

Trace the "Join"/"Prune" messages in this category.

keepalive

Trace the BGP keepalive messages to this peer.

These messages are used to verify peer reachability.

leave

Trace the "Leave Group" messages in this category.

lsa

Trace the Link State Advertisement packets in this category.

mcastdist

Trace the multicast distribution, register encapsulation, and decapsulation messages in this category.

mfc

Trace calls to or from the Multicast Forwarding Cache in this category.

mrt

Trace the multicast routing table events in this category.

mtrace

Trace the multicast traceroute events in this category.

normal

Trace all the normal protocol occurrences.

Abnormal protocol occurrences are always traced.

open

Trace the BGP "Open" messages to this peer (used to establish a peer connection).

packets

Trace all packets in this category.

parse

Trace the lexical analyzer and parser events in this category.

policy

Trace the application of protocol-specified and user-specified policy to imported and exported routes.

query

Trace the multicast group membership "Query" packets (both general and group-specific) in this category.

refresh

Trace the PIM state "Refresh" messages.

register

Trace the "Register" and "Register-Stop" packets in this category.

remnants

Trace the kernel routes at the time when the routing daemon starts.

reply

Trace all "Reply" packets in this category.

report

Trace the multicast group membership "Report" packets in this category.

request

Trace all "Request" packets in this category.

resolve

Trace the resolve requests in this category.

response

Trace all "Response" packets in this category.

route

Trace the routing table changes in this category.

router-discovery

Trace the "Router Discovery" packets in this category.

routes

Trace operations on routes - add, delete, change.

rp

Trace Rendezvous Point -specific events, including RP "set-specific" and "bootstrap-specific" events.

rule

Trace the ruleClosed Set of traffic parameters and other conditions in a Rule Base (Security Policy) that cause specified actions to be taken for a communication session. messages in this category.

spf

Trace the shortest-path-first (SPF) calculation events in this category.

state

Trace the state machine transitions in the protocols in this category.

table

Trace the table messages in this category.

task

Trace the system interface and processing events in this category.

timer

Trace the timer usage events in this category.

trap

Trace the trap packets in this category.

update

OSPF - Trace the Link State update packets.

BGP - Trace the "Update" messages to this peer (used to pass network reachability information).

wrongif

Trace the kernel multicast incoming physical interface and register violation notifications in this category.