NVIDIA UFM-SDN Appliance Command Reference Guide v4.12.1
NVIDIA Docs Hub  NVIDIA UFM-SDN Appliance Command Reference Guide v4.12.1  UFM Logs
NVIDIA UFM-SDN Appliance Command Reference Guide v4.12.1

On This Page

UFM Logs

ufm logging files delete oldest

ufm logging files delete oldest {console | event | opensm | sharp | ufm | ufmhealth} [<number>]

Deletes log files.

Syntax Description

console

Delete the oldest console log files

event

Delete the oldest event log files

opensm

Delete the oldest OpenSM log files

sharp

Delete the oldest NVIDIA® Scalable Hierarchical Aggregation and Reduction Protocol (SHARP)™ log files

ufm

Delete the oldest UFM log files

ufmhealth

Delete the oldest UFM health log files

number

Specifies the number of log files to delete

Default

If no number is specified, the command deletes the oldest log file only

Configuration Mode

config

History

4.6.0

Example
Copy
Copied!
            

            
ufmapl [mgmt-sa] (config) # ufm logging files delete console 3

Related Commands

show ufm logging

Notes

ufm logging files rotation criteria

ufm logging files rotation criteria {frequency daily | size <size-in-megabytes>}

Sets how the system decides when to rotate UFM log files.

Syntax Description

frequency daily

Rotates log files once per day at midnight

size

Rotates log files when they pass a size threshold

Default

100 MB

Configuration Mode

config

History

4.6.0

Example
Copy
Copied!
            

            
ufmapl [mgmt-sa] (config) # ufm logging files rotation criteria size 100

Related Commands

show ufm logging

Notes

ufm logging files rotation max-num

ufm logging files rotation max-num <number>

Specifies the maximum number of old log files to maintain.

Syntax Description

number

Range: 1-999999

Default

10

Configuration Mode

config

History

4.6.0

Example
Copy
Copied!
            

            
ufmapl [mgmt-sa] (config) # ufm logging files rotation criteria size 13

Related Commands

show ufm logging

Notes

ufm logging level

ufm logging level <log-level>

Sets the severity level of certain log messages.

Syntax Description

log-level

  • CRITICAL – critical conditions

  • DEBUG – debug-level messages

  • ERROR – error conditions

  • INFO – informational messages

  • WARNING – warning conditions

Default

WARNING

Configuration Mode

config

History

1.6

Example
Copy
Copied!
            

            
ufmapl [mgmt-sa] (config) # ufm logging level WARNING

Related Commands

Notes

ufm logging syslog

ufm logging syslog <host:port>
no ufm logging syslog

Sends UFM logs to a remote syslog server.
The no form of the command sends UFM logs to the local syslog server.

Syntax Description

port

Remote syslog hostname and port

Default

N/A

Configuration Mode

config

History

1.6

Example
Copy
Copied!
            

            
ufmapl [mgmt-sa] (config) # ufm logging syslog 172.30.36.120:514
This change will take effect after UFM restart.

Related Commands

Notes

This change takes effect after UFM restart.

ufm logging syslog level

ufm logging syslog level <log-level>

Sets the severity level of certain log messages.

Syntax Description

log-level

  • CRITICAL – critical conditions

  • DEBUG – debug-level messages

  • ERROR – error conditions

  • INFO – informational messages

  • WARNING – warning conditions

Default

WARNING

Configuration Mode

config

History

1.6

Example
Copy
Copied!
            

            
ufmapl [mgmt-sa] (config) # ufm logging syslog level WARNING
This change will take effect after UFM restart.

Related Commands

Notes

This change takes effect after UFM restart.

ufm logging syslog enable

ufm logging syslog enable
no ufm logging syslog enable

Enable sending UFM logs to syslog.
The no form of the command disables sending UFM logs to syslog.

Syntax Description

N/A

Default

Disabled

Configuration Mode

config

History

1.6

Example
Copy
Copied!
            

            
ufmapl [mgmt-sa] (config) # ufm logging syslog enable
This change will take effect after UFM restart.

Related Commands

Notes

This change takes effect after UFM restart.

ufm logging syslog ufm-events enable

ufm logging syslog ufm-events enable
no ufm logging syslog ufm-events enable

Send UFM event log messages to a syslog server.
The no form disables the ability to log UFM event messages to syslog locally and remotely.

Syntax Description

N/A

Default

N/A

Configuration Mode

config

History

1.6

Example
Copy
Copied!
            

            
ufmapl [mgmt-sa] (config) # ufm logging syslog ufm-events enable
This change will take effect after UFM restart.

Related Commands

Notes

This change takes effect after UFM restart.

show ufm console log

show ufm console log [matching <regex> | not matching <regex>]

Displays current console event log file in a scrollable pager.

Syntax Description

matching

Displays new console log messages that match a given regular expression

not matching

Displays new console log messages that do not match a given regular expression

Default

N/A

Configuration Mode

Any configuration mode

History

4.6.0

Example
Copy
Copied!
            

            
ufmapl [ mgmt-sa ] (config) #  show ufm console log
2021-07-20 13:34:49.090 ufm   INIT    Prometheus Client: Request time = 0.005601406097412109, Total Processing time = 0.011138916015625
2021-07-20 13:34:49.092 ufm   INIT    handled device stats. (10) 3887.93 devices/sec. (18) 6998.28 ports/sec, queue: 9
2021-07-20 13:35:19.115 ufm   INIT    Telemetry packet: size:  0.043 MB, transfer rate: 7.684 MB/sec
2021-07-20 13:35:19.120 ufm   INIT    Prometheus Client: Request time = 0.0056459903717041016, Total Processing time = 0.010822296142578125
...

Related Commands

Notes

show ufm console log continuous

show ufm console log continuous [matching <regex> | not matching <regex>]

Displays new event log messages as they arrive.

Syntax Description

matching

Displays new console log messages that match a given regular expression

not matching

Displays new console log messages that do not match a given regular expression

Default

N/A

Configuration Mode

Any configuration mode

History

4.6.0

Example
Copy
Copied!
            

            
ufmapl [ mgmt-sa ] (config) # show ufm console log continuous matching CRITICAL
2021-07-20 09:40:33.825 eventlog CRITICAL 2021-07-20 09:40:33.825 [10] [394] CRITICAL [Module_Status] Switch [default(6) / Switch: switch-system / NA / NA] [dev_id: 0002c903005dd830]: Module PS 2 on switch-system(10.10.10.10) status is fatal
2021-07-20 10:36:23.962 eventlog CRITICAL 2021-07-20 10:36:23.961 [40] [518] CRITICAL [Maintenance] Grid [Grid]: Process periodic_report_runner is down.

Related Commands

show ufm console log

Notes

show ufm console log files

show ufm console log files [<file-number> [matching <regex> | not matching <regex>]]

Lists all archived log files available.

Syntax Description

file-number

Displays the selected archived event log file

matching

Displays entries from the selected log file that match a given regular expression

not matching

Displays entries from the selected log file that do not match a given regular expression

Default

N/A

Configuration Mode

Any configuration mode

History

4.6.0

Example
Copy
Copied!
            

            
ufmapl [ mgmt-sa ] (config) # show ufm console log files 1 matching INFO
2021-07-20 11:47:43.231 rest_api INFO    user: ufmsystem, url: (http://11.1.1.11:8000/app/events/external_event), method: (POST)
2021-07-20 11:50:43.437 rest_api INFO    user: ufmsystem, url: (http://11.1.1.11:8000/app/events/external_event), method: (POST)
2021-07-20 11:53:43.642 rest_api INFO    user: ufmsystem, url: (http://11.1.1.11:8000/app/events/external_event), method: (POST)
2021-07-20 11:56:43.862 rest_api INFO    user: ufmsystem, url: (http://11.1.1.11:8000/app/events/external_event), method: (POST)

Related Commands

show ufm console log

Notes

show ufm event log

show ufm event log [matching <regex> | not matching <regex>]

Displays current event log file in a scrollable pager.

Syntax Description

matching

Displays new event log messages that match a given regular expression

not matching

Displays new event log messages that do not match a given regular expression

Default

N/A

Configuration Mode

Any configuration mode

History

4.6.0

Example
Copy
Copied!
            

            
ufmapl [ mgmt-sa ] (config) #  show ufm event log matching INFO
2021-07-20 09:35:31.551 [1] [352] INFO [Logical_Model] Grid [Grid]: Network management is added
2021-07-20 09:35:34.454 [3] [604] INFO [Maintenance] Grid [Grid]: Fabric Analysis Report succeeded
2021-07-20 09:40:31.957 [5] [604] INFO [Maintenance] Grid [Grid]: Fabric Analysis Report succeeded
...

Related Commands

Notes

show ufm event log continuous

show ufm event log continuous [matching <regex> | not matching <regex>]

Displays new event log messages as they arrive.

Syntax Description

matching

Displays new event log messages that match a given regular expression

not matching

Displays new event log messages that do not match a given regular expression

Default

N/A

Configuration Mode

Any configuration mode

History

4.6.0

Example
Copy
Copied!
            

            
ufmapl [ mgmt-sa ] (config) # show ufm event log continuous not matching INFO
2021-07-20 09:38:33.192 [4] [406] WARNING [Communication_Error] Grid [Grid]: Failed to get sysinfo for switch 0002c903005dd830
2021-07-20 09:40:33.825 [10] [394] CRITICAL [Module_Status] Switch [default(6) / Switch: switch-system / NA / NA] [dev_id: 0002c903005dd830]: Module PS 2 on switch-system(10.10.10.10) status is fatal
2021-07-20 10:36:23.961 [40] [518] CRITICAL [Maintenance] Grid [Grid]: Process periodic_report_runner is down.

Related Commands

show ufm console event log

Notes

show ufm event log files

show ufm event log files [<file-number> [matching <regex> | not matching <regex>]]

Lists all archived log files available.

Syntax Description

file-number

Displays the selected archived event log file

matching

Displays entries from the selected log file that match a given regular expression

not matching

Displays entries from the selected log file that do not match a given regular expression

Default

N/A

Configuration Mode

Any configuration mode

History

4.6.0

Example
Copy
Copied!
            

            
ufmapl [ mgmt-sa ] (config) # show ufm event log files

Related Commands

show ufm event log

Notes

show ufm logging

show ufm logging

Displays logging configuration.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any configuration mode

History

1.6

4.6.0

Updated command output

Example
Copy
Copied!
            

            
ufmapl [ mgmt-sa ] (config) # show ufm logging 
Number of archived log files to keep: 10
Log rotation size threshold: 100 megabytes
 
Ufm-log level:          WARNING
Syslog:
   Enabled:             No
   Server:              Local
   Level:               WARNING
   Ufm-log enabled:     No
   Ufm-events enabled:  No

Related Commands

Notes

show ufm log

show ufm log [continuous | files | matching | not]

Displays UFM event log.

Syntax Description

continuous

Displays new event log messages as they arrive

files

Displays archived log files

matching

Displays event logs that match a given regular expression

not

Displays event logs that do not meet certain criteria

Default

N/A

Configuration Mode

Any configuration mode

History

1.6

Example
Copy
Copied!
            

            
ufmapl [ mgmt-sa ] (config) # show ufm log
2013-09-03 14:34:00.407 ufm   INIT    Request Polling Delta Fabric
2013-09-03 14:34:30.411 ufm   INIT    Request Polling Delta Fabric
2013-09-03 14:35:00.413 ufm   INIT    Request Polling Delta Fabric
2013-09-03 14:35:30.416 ufm   INIT    Request Polling Delta Fabric
2013-09-03 14:36:00.419 ufm   INIT    Request Polling Delta Fabric
2013-09-03 14:36:06.016 ufm   ACTION  user ufmsystem called triggerExternalEvent with params : <ws.UFM_services_types.ExternalEvent_Holder instance at 0x6ffe440>
2013-09-03 14:36:30.423 ufm   INIT    Request Polling Delta Fabric
2013-09-03 14:37:00.426 ufm   INIT    Request Polling Delta Fabric
2013-09-03 14:37:30.428 ufm   INIT    Request Polling Delta Fabric
2013-09-03 14:38:00.431 ufm   INIT    Request Polling Delta Fabric
2013-09-03 14:38:02.175 ufm   WARNING Failed to parse host response from host 172.30.105.153 message type 10
2013-09-03 14:38:02.193 ufm   WARNING Failed to parse host response from host 172.30.11.161 message type 10
2013-09-03 14:38:02.489 ufm   WARNING Failed to parse host response from host 172.30.112.23 message type 10
2013-09-03 14:38:02.723 ufm   WARNING Failed to parse host response from host 172.30.112.24 message type 10
2013-09-03 14:38:02.768 ufm   WARNING Failed to parse host response from host 172.30.49.89 message type 10
2013-09-03 14:38:30.435 ufm   INIT    Request Polling Delta Fabric

Related Commands

Notes

show ufmhealth log

show ufmhealth log [continuous | files | matching | not]

Displays UFM health event log.

Syntax Description

continuous

Displays new event log messages as they arrive

files

Displays archived log files

matching

Displays event logs that match a given regular expression

not

Displays event logs that do not meet certain criteria

Default

N/A

Configuration Mode

Any configuration mode

History

1.6

Example
Copy
Copied!
            

            
ufmapl [ mgmt-sa ] (config) # show ufmhealth log
2013-09-03 14:36:30.423 ufm   INIT    Request Polling Delta Fabric
2013-09-03 14:37:00.426 ufm   INIT    Request Polling Delta Fabric
2013-09-03 14:37:30.428 ufm   INIT    Request Polling Delta Fabric
2013-09-03 14:38:00.431 ufm   INIT    Request Polling Delta Fabric
2013-09-03 14:38:02.175 ufm   WARNING Failed to parse host response from host 172.30.105.153 message type 10
2013-09-03 14:38:02.193 ufm   WARNING Failed to parse host response from host 172.30.11.161 message type 10

Related Commands

Notes

© Copyright 2023, NVIDIA. Last updated on Sep 6, 2023.