Viewing logs for debugs enabled using distributed logger utility

The following example shows the configuration steps to generate and view debug logs using distributed logger utility.
  1. Enable debugging for a module registered with distributed logger.
    device# dlogger module sec_macsec sub-module cli sev all
    device# dlogger module sec_macsec sub-module keygen sev all
    device# dlogger module sec_macsec sub-module mka sev all   
    device# dlogger module sec_macsec sub-module tx sev all 
    device# dlogger module sec_macsec sub-module rx sev all
    device# dlogger module sec_macsec sub-module pdu sev all
    device# dlogger module sec_macsec sub-module stacking sev all
    device# dlogger module sec_macsec sub-module platform sev all
    
    The logs will be generated and maintained in the Log Manager.
  2. Find the mapping of distributed logger modules to Log Manager modules and sub-modules.
    device# show dlogger module filter lm-map
    Total Module 40
    Logger Module to Log Manger Mapping:
    ---------------------------------------------------------
     Idx Logger-M             LogMgr-M             LogMgr-Sub-M
    ---------------------------------------------------------
       2 l3interface          fi_debug             debug_logs
       4 l3mcast              fi_debug             debug_logs
       6 bfd                  fi_debug             debug_logs
       8 arp                  fi_debug             debug_logs
      11 nexthop-mgr          fi_debug             debug_logs
      13 mcrep-sc             fi_debug             debug_logs
      16 ipv4-unicast         fi_debug             debug_logs
      17 ipv6-unicast         fi_debug             debug_logs
      18 openflow             fi_debug             debug_logs
      19 urpf                 fi_debug             debug_logs
      21 ip-nexthop           fi_debug             debug_logs
      22 keychain             fi_debug             debug_logs
      23 remote-ping          fi_debug             debug_logs
      24 remote-traceroute    fi_debug             debug_logs
      25 igmp-snoop           fi_debug             debug_logs
      26 mld-snoop            fi_debug             debug_logs
      27 mcrep-lc             fi_debug             debug_logs
      28 sec_acl              security             security_sub
      29 sec_acl_acct         fi_debug             debug_logs
      30 sec_macsec           security             macsec
      31 sec_dhcpsnoop        security             security_sub
      32 sec_dhcp6snoop       fi_debug             debug_logs
      33 sec_ndi              fi_debug             debug_logs
      34 sec_raguard          fi_debug             debug_logs
      35 sec_brl              fi_debug             debug_logs
      36 sec_pbrl             fi_debug             debug_logs
      37 sec_aclinfra         fi_debug             debug_logs
      38 webauth              security             webauth
      39 flexauth             security             flexauth
    You must use the exact Log manager module names and Log manager sub-module names that correspond to the distributed logger module as listed in the show dlogger module filter lm-map command output for all Log Manager operations.

    In this example for “sec_macsec” distributed logger module, the corresponding Log manager module and sub-module names are “security” and “macsec” respectively.

  3. Fetch (create a local copy) the required logs from local and remote units.
    device# logmgr fetch security macsec all all
  4. View debug logs from the log manager.
    device# show logging debug security macsec all all
    May 29 19:36:50:904422:err:security:macsec:3:34132105102080: cli:[LOGON][CONFIG] - Key is not configured
    May 29 19:36:50:902259:err:security:macsec:3:34132105102080: stacking:[Master][Port-Cfg] Port 2/2/4, Enable 0
    May 29 19:36:50:901984:err:security:macsec:3:34132105102080: stacking:[Master][Port-Indication][Req] Port 2/2/4
    May 29 19:36:50:901807:err:security:macsec:3:34132105102080: Suppressed 1 times: stacking:[Master][Port-Cfg] Port 2/2/4, Enable 1
    May 29 19:36:50:901254:err:security:macsec:3:34132105102080: stacking:[Master][Port-Cfg] Port 2/2/4, Enable 1
    May 29 19:36:50:004782:err:security:macsec:3:33449205302016: stacking:[Master][Port-Cfg] Port 2/2/4, Enable 0
    May 29 19:36:41:906799:err:security:macsec:3:27324581937920: cli:[LOGON][CONFIG] - Key is not configured
    May 29 19:36:41:905105:err:security:macsec:3:27324581937920: stacking:[Master][Port-Cfg] Port 2/2/4, Enable 0
    May 29 19:36:41:904694:err:security:macsec:3:27324581937920: stacking:[Master][Port-Indication][Req] Port 2/2/4
    May 29 19:36:41:904658:err:security:macsec:3:27324581937920: Suppressed 1 times: stacking:[Master][Port-Cfg] Port 2/2/4, Enable 1
    May 29 19:36:41:903809:err:security:macsec:3:27324581937920: stacking:[Master][Port-Cfg] Port 2/2/4, Enable 1
    May 28 09:27:02:228373:err:security:macsec:3:34114925232896: cli:[LOGON][CONFIG] - Key is not configured
    May 28 09:27:02:226751:err:security:macsec:3:34114925232896: stacking:[Master][Port-Cfg] Port 2/2/4, Enable 0
    May 28 09:27:02:226484:err:security:macsec:3:34114925232896: stacking:[Master][Port-Indication][Req] Port 2/2/4
    May 28 09:27:02:226445:err:security:macsec:3:34114925232896: Suppressed 1 times: stacking:[Master][Port-Cfg] Port 2/2/4, Enable 1
    May 28 09:27:02:225577:err:security:macsec:3:34114925232896: stacking:[Master][Port-Cfg] Port 2/2/4, Enable 1
    May 28 09:27:01:328816:err:security:macsec:3:33436320400128: stacking:[Master][Port-Cfg] Port 2/2/4, Enable 0
    May 28 09:26:53:204026:err:security:macsec:3:27328876905216: cli:[LOGON][CONFIG] - Key is not configured
    May 28 09:26:53:195392:err:security:macsec:3:27328876905216: stacking:[Master][Port-Cfg] Port 2/2/4, Enable 0
    May 28 09:26:53:194386:err:security:macsec:3:27328876905216: stacking:[Master][Port-Indication][Req] Port 2/2/4
    May 28 09:26:53:194264:err:security:macsec:3:27328876905216: Suppressed 1 times: stacking:[Master][Port-Cfg] Port 2/2/4, Enable 1
    May 28 09:26:53:191865:err:security:macsec:3:27328876905216: stacking:[Master][Port-Cfg] Port 2/2/4, Enable 1
  5. Optionally, view real-time updates to the specified logs on local units.
    device# logmgr monitor security:macsec:all
    ==> /logmgr/logs//security/macsec_high_tmp.log <==
    May 29 19:36:41:904658:err:security:macsec:3:27324581937920: Suppressed 1 times: stacking:[Master][Port-Cfg] Port 2/2/4, Enable 1
    May 29 19:36:41:904694:err:security:macsec:3:27324581937920: stacking:[Master][Port-Indication][Req] Port 2/2/4
    May 29 19:36:41:905105:err:security:macsec:3:27324581937920: stacking:[Master][Port-Cfg] Port 2/2/4, Enable 0
    May 29 19:36:41:906799:err:security:macsec:3:27324581937920: cli:[LOGON][CONFIG] - Key is not configured
    May 29 19:36:50:004782:err:security:macsec:3:33449205302016: stacking:[Master][Port-Cfg] Port 2/2/4, Enable 0
    May 29 19:36:50:901254:err:security:macsec:3:34132105102080: stacking:[Master][Port-Cfg] Port 2/2/4, Enable 1
    May 29 19:36:50:901807:err:security:macsec:3:34132105102080: Suppressed 1 times: stacking:[Master][Port-Cfg] Port 2/2/4, Enable 1
    May 29 19:36:50:901984:err:security:macsec:3:34132105102080: stacking:[Master][Port-Indication][Req] Port 2/2/4
    May 29 19:36:50:902259:err:security:macsec:3:34132105102080: stacking:[Master][Port-Cfg] Port 2/2/4, Enable 0
    May 29 19:36:50:904422:err:security:macsec:3:34132105102080: cli:[LOGON][CONFIG] - Key is not configured
    This command enables the monitoring mode and simultaneously blocks the CLI. Press Ctrl+C to cancel the monitoring mode.
  6. (Optional) View the filter configuration of distributed logger modules and sub-modules.
    device# show dlogger module filter config-fltr
  7. (Optional) View the logged messages from circular buffer maintained by the distributed logger module.
    device# show dlogger logs module sec_macsec
  8. Optionally, upload the fetched logs to an external server.
    device# logmgr upload tftp 10.198.137.97 GZ.tar