Network Management Card and Network Management Card with Environmental Monitoring for the UPSB505 Uninterruptible Power Supply Caterpillar

Use the Event and Data Logs

Event Log

Path: Logs >Events >options

You can view, filter, or delete the event log. By default, the log displays all events recorded during the last two days, in reverse chronological order.

For lists of all configurable events and the events current configuration, select the "Administration" tab, "Notification" on the top menu bar, and by event under "Event Actions" on the left navigation menu.

ReferenceRefer to the "Configuring by Event" section in the, "Administration: Notification" chapter of this manual.

To Display the Event Log (Logs > Events > log)

• By default, view the event log as a page of the "Web interface". The most recent event is recorded on page 1. In the navigation bar below the log:

- Click a page number to open a specific page of the log.

- Click "Previous" or "Next" to view the events recorded immediately before or after the events listed on the open page.

- Click "<<" to return to the first page or click ">>" to view the last page of the log.

• To see the listed events on one page, click "Launch Log in New Window" from the event log page to display a full-screen view of the log.

Note: In your browsers options, JavaScript must be enabled for you to use the "Launch Log in New Window" button.

ReferenceYou can also use FTP or Secure CoPy (SCP) to view the event log. Refer to the "How to use FTP or SCP to retrieve log files " section in this chapter.

To Filter the Log (Logs > Events > log)

Filtering the log by date or time - :To display the entire event log or to change the number of days or weeks for which the log displays the most recent events, select "Last". Select a time range from the drop-down menu, then click "Apply". The filter configuration is saved until the NMC restarts. To display events logged during a specific time range, select "From". Specify the beginning and ending times (using the 24-hour clock format) and dates for which to display events, then click "Apply". The filter configuration is saved until the NMC restarts.

Filtering the log by event - To specify the events that display in the log, click "Filter Log". Unmark the check box of an event category or alarm severity level to remove the event from view. Text at the upper right corner of the event log page indicates that a filter is active. As Administrator, click "Save As Default" to save this filter as the default log view for all users. If you do not click "Save As Default", the filter is active until you clear the event or until the NMC restarts. To remove an active filter, click "Filter Log", then "Clear Filter (Show All)".

Note: Events are processed through the filter using OR logic.

• Events that you do not select from the "Filter By Severity" list never display in the filtered event log, even if the event occurs in a category you selected from the "Filter by Category" list.

• Events that you do not select from the "Filter by Category" list never display in the filtered event log, even if devices in the category enter an alarm state you selected from the "Filter by Severity" list.

To Delete the Log (Logs > Events > log)

To delete all events recorded in the log, click "Clear Log" on the web page that displays the log. Deleted events cannot be retrieved.

ReferenceTo disable the logging of events based on the assigned severity level or the event category, refer to the "Configuring by group" section in the, "Administration : Notification" chapter in this manual.

To Configure Reverse Lookup (Logs > Events > reverse lookup)

Reverse lookup is disabled by default. Enable this feature unless you have no DNS server configured or have poor network performance because of heavy network traffic.

With reverse lookup enabled, when a network-related event occurs, both the IP address and the domain name for the networked device associated with the event are logged in the event log. If no domain name entry exists for the device, only the IP address is logged with the event. Since domain names generally change less frequently than IP addresses, enabling reverse lookup can improve the ability to identify addresses of networked devices that are causing events.

To Resize the Event Log (Logs > Events > size)

By default, the event log stores 400 events. You can change the number of events the log stores. When you resize the event log, all existing log entries are deleted. To avoid losing log data, use FTP or SCP to retrieve the log before you enter a new value in the "Event Log Size" field.

ReferenceRefer to the "How to use FTP or SCP to Retrieve Log Files" section in this chapter.

When the log is full, the older entries are deleted.

Data Log

Path: Logs > Data > options

View a log of measurements about the UPS, the power input to the UPS, and the ambient temperature of the UPS and batteries. Each entry is listed by the date and time the data was recorded.

To Display the Data Log (Logs > Data > log)

• By default, view the data log as a page of the "Web interface". The most recent data item is recorded on page 1. From the navigation menu below the log:

- Click a page number to open a specific page of the log.

- Click "Previous" or "Next" to view the data recorded immediately before or after the data that is listed on the open page.

- Click "<<" to return to the first page of the log, or click ">>" to view the last page of the log.

• To see the listed data on one page, click "Launch Log in New Window" from the data log page to display a full-screen view of the log.

Note: In your browsers options, JavaScript^® must be enabled for you to use the "Launch Log in New Window" button.

ReferenceAlternatively, you can use FTP or SCP to view the data log. Refer to the "How to Use FTP or SCP to Retrieve Log Files" section of this chapter.

To Filter the Log by Date or Time (Logs > Data > log)

To display the entire data log, or to change the number of days or weeks for which the log displays the most recent events, select "Last". Select a time range from the drop-down menu, then click "Apply". The filter configuration is saved until the device restarts.

To display data logged during a specific time range, select "From". Specify the beginning and ending times (using the 24-hour clock format) and dates for which to display data, then click "Apply". The filter configuration is saved until the device restarts.

To Delete the Data Log

To delete all data recorded in the log, click "Clear Data Log" on the web page that displays the log. Deleted data cannot be retrieved.

To Set the Data Collection Interval (Logs > Data > interval)

In the "Log Interval" setting, define how frequently data is sampled and stored in the data log. View the calculation of how many days of data the log can store, based on the interval you selected. When the log is full, the oldest entries are deleted. To avoid automatic deletion of older data, enable and configure data log rotation, described in the next section.

To Configure Data Log Rotation (Logs > Data > rotation)

Set up a password-protected data log repository on a specified FTP server. Enabling rotation causes the contents of the data log to be appended to the file you specify by name and location. Updates to this file occur at the upload interval you specify.

To Resize the Data Log (Logs > Data > size)

By default, the data log stores 400 events. You can change the number of data points the log stores. When you resize the data log, all existing log entries are deleted. To avoid losing log data, use FTP or SCP to retrieve the log before you enter a new value in the "Data Log Size" field.

ReferenceRefer to the "How to Use FTP or SCP to Retrieve Log Files" section of this chapter.

When the log is full, the older entries are deleted.

How to Use FTP or SCP to Retrieve Log Files

An Administrator or Device User can use FTP or SCP to retrieve a tab-delineated event log file (event.csv) or data log file (data.csv) and import the file into a spreadsheet.

• The file reports all events or data recorded since the log was last deleted or (for the data log) truncated because the log reached maximum size.

• The file includes information that the event log or data log does not display.

- The version of the file format (first field)

- The date and time the file was retrieved

- The "Name", "Contact", and "Location" values and IP address of the NMC

- The unique "Event Code" for each recorded event (event.csv file only)

Note: The NMC uses a four-digit year for log entries. You may need to select a four-digit date format in your spreadsheet application to display all four digits.

If you are using the encryption-based security protocols for your system, use SCP to retrieve the log file.

If you are using unencrypted authentication methods for the security of your system, use FTP to retrieve the log file.

ReferenceSee the Security Handbook for information on available protocols and methods for setting up the type of security you need.

To Use SCP to Retrieve the Files

To use SCP to retrieve the event.csv file, use the following command:

"scp username@hostname_or_ip_address:event.csv ./event.csv"

To use SCP to retrieve the data.csv file, use the following command:

"scp username@hostname_or_ip_address:data.csv ./data.csv"

To Use FTP to Retrieve the Files

To use FTP, to retrieve the "event.csv" or "data.csv" file:

1. At a command prompt, type "ftp" and the IP address of the NMC, and press "ENTER".

   If the "Port" setting for the "FTP Server" option (set through the "Network" menu of the "Administration" tab) has been changed from the default (21), use the non-default value in the FTP command. For Windows FTP clients, use the following command, including spaces. (For some FTP clients, you must use a colon instead of a space between the IP address and the port number.)

   "ftp>open ip_address port_number"

   ReferenceTo set a non-default port value to enhance security for the FTP Server, refer to the "FTP Server" section in the, "Administration: Network Features" chapter of this manual. You can specify any port from 5001 to 32768.

2. Use the case-sensitive "User Name" and "Password" for Administrator or Device User to log on. For Administrator, "cat" is the default for "User Name" and "Password". For the Device User, the defaults are "device" for "User Name" and "cat" for "Password".

3. Use the "get" command to transmit the text of a log to your local drive.

   "ftp>get event.csv"

   or

   "ftp>get data.csv"

4. You can use the "del" command to clear the contents of either log.

   "ftp>del event.csv"

   or

   "ftp>del data.csv"

   You will not be asked to confirm the deletion.

   • If you clear the data log, the event log records a deleted-log event.

   • If you clear the event log, a new event.csv file records the event.

5. Type quit at the "ftp>" prompt to exit from FTP.