Saving Log Files

Log files can be saved to a file in a local or remote location specified by a URL. Use the following EXEC mode command to save log files:

save logs { url } [ active ] ] [ inactive ] [ callid call_id ] [event-verbosity evt_verboseness ] [ facility facility ] [level severity_level ] [ pdu-data pdu_format ] [ pdu-verbosity pdu_verboseness ] [ since from_date_time [ until to_date_time ] ] [ | { grep grep_options | more } ]  

OPTIONS:

  • url: Specifies the location to store the log file(s). url may refer to a local or a remote file and must be entered in the following format.

  • active : Saves data from active logs.

  • inactive : Saves data from inactive logs.

  • callid call_id : Specifies a call ID for which log information is to be saved as a 4-byte hexadecimal number.

  • event-verbosity evt_verboseness : Specifies the level of verboseness to use in the displaying of event data as one of:

    • min : Logs minimal information about the event. Information includes event name, facility, event ID, severity level, date, and time.

    • concise : Logs detailed information about the event, but does not provide the event source within the system.

    • full : Logs detailed information about event, including source information, identifying where within the system the event was generated.

  • facility facility : Specifies the facility to modify the filtering of logged information.

  • level severity_level : Specifies the level of information to be logged in the following list which is ordered from highest to lowest:

    • critical : Logs critical events

    • error : Logs error events and all events with a higher severity level

    • warning : Logs warning events and all events with a higher severity level

    • unusual : Logs unusual events and all events with a higher severity level

    • info : Logs info events and all events with a higher severity level

    • trace : Logs trace events and all events with a higher severity level

    • debug : Logs all events

  • pdu-data pdu_format : Specifies output format for the display of packet data units as one of:

    • none - raw format (unformatted).

    • hex - hexadecimal format.

    • hex-ascii - hexadecimal and ASCII similar to a main-frame dump.

  • pdu-verbosity pdu_verboseness : Specifies the level of verboseness to use in the displaying of packet data units as a value from 1 to 5, where 5 is the most detailed.

  • since from_date_time : Saves only the log information which has been collected more recently than from_date_time

  • until to_date_time : Saves no log information more recent than to_date_time . Defaults to current time when omitted.

  • from_date_time and to_date_time must be formatted as YYYY:MM:DD:HH:mm or YYYY:MM:DD:HH:mm:ss. Where:

    • YYYY = 4-digit year

    • MM = 2-digit month in the range 01 through 12

    • DD = 2-digit day in the range 01 through 31

    • HH = 2-digit hour in the range 00 through 23

    • mm = 2-digit minute in the range 00 through 59

    • ss = 2 digit second in the range 00 through 59

    to_date_time must be a time which is more recent than from_date_time .

    Using the until keyword allows for a time range of log information; using only the since keyword will display all information up to the current time.

  • grep grep_options | more : Pipes (sends) the output of this command to the specified command. You must specify a command to which the output of this command is sent.