16.1 Alarm Reports

Alarm Reports facilitates alarm/fault management. It displays the number and priority (high/medium/low) of events, traps, and errors to have occurred. The reports can pertain to a specific element or to an entire view.

SNM allows you to view a summary of alarm reports for all elements within a given view. Event, trap, and error reports can be summarized in Figure 16-2.

Figure 16-2

The Alarm Reports Summary window is updated every 30 seconds. You might find it useful to leave the window pinned up while the Console is running. The Alarms Reports Summary displays reports only for the current view. If there are no reports pertaining to the current view, the Alarms Reports Summary window is blank. Upon switching to another view, the Alarms Reports Summary window is updated with the switched-to view's alarm reports summary, if such reports exist.

---

Note - If both the Console Alarm Report Summary window and a device specific Alarm Summary window are being displayed simultaneously and reports continue to arrive for the device, the number of reports received totals for the two windows will differ until the Console Alarm Reports Summary window is next updated (every 30 seconds.)

---

The Alarm Reports Summary window has three buttons at the bottom, described in the following sections.

16.1.1 Alarm Reports

Allows you to view a device-specific alarm report for a device selected in the Alarm Reports Summary window's scrolling list.

A device-specific Alarm Reports window allows you to:

• Sort alarm reports
• Filter reports
• Find reports associated with a specific agent
• Save reports to a file (which can be viewed using the Results Browser)
• Print reports

These functions are available through the View, Save, and Print buttons at the bottom of the Alarm Reports window.

Sort Reports In a device-specific Alarm Reports window, press MENU on View >> Sort By. You receive the following menu:

Figure 16-3

These choices are mutually exclusive. Release MENU over the sorting method you want. Your selection takes effect immediately.

The sorting choices are explained as follows:

Time Stamp The default choice. Reports are sorted in chronological order with the most recent being last on the list.

Priority Event reports are sorted according to priority--high, medium, or low--with high priority reports listed first on the list. This option makes most sense if you are filtering out trap and error reports. If you are not filtering out reports and specify sorting by priority, event reports come first, followed by error reports, then trap reports.

Type

Reports are sorted by type, in the order: event, error, trap. Note that alarm reports that are received after you specify sorting by type are appended to the appropriate list of reports, depending on the new reports' type.

---

Note - When sorting alarm reports, only the reports currently displayed in the Alarm Reports window will be sorted. All new reports received during the sorting operation are appended to the end of the sorted list.

---

Filter Reports Press MENU in the View button. Release MENU over Filter to receive the following window:

Figure 16-4

Your selections in the Filter window determine which types of reports are displayed in the device-specific Alarm Reports window. The default is that all alarm reports are displayed. Note that priority choices apply only to Event Reports. If you click on Apply, your choices take effect immediately. Click on Reset to restore the choices to the way they were when you brought up the Filter window.

---

Note - If you plan to both sort (described in "Sort Reports" on page 16-4") and filter your device-specific alarm reports, you must sort before filtering. If you want to sort again, after filtering, you must click SELECT on Reset, then Apply, in the Filter window, sort again, then reinvoke Filter.

---

Find Agent-specific Reports SNM allows you to search on an agent name to find instance(s) of event reports originating with that agent. To do this, in the device-specific Alarm Reports window, press MENU on View >> Find and release MENU. In the Agent Name field, enter the agent and group name--not just the agent name. For example, specify hostperf.data, not just hostperf. When you click SELECT on Find, the window displays the contents of the first (oldest) report originating with the agent you specified. If there is no report originating with the agent you specify, you receive the message, "Agent name not found."

Save Device-specific Reports SNM allows you to save device-specific alarm reports to a file. To do this, in the device-specific Alarm Reports window, click SELECT on Save. You receive a window such as the one in Section Figure 16-5, "Save to Logfile Window."

Figure 16-5

If the directory that is first displayed is not the directory you want, change directories by clicking SELECT on folder icons or the .. (level above) symbol. Alternatively, you can enter a path name in the Name field and click SELECT on Save. If the path you enter ends in a valid directory, you are switched to that directory.

When you reach the directory you want, enter the name of the file to which the report will be written.

Print Device-specific Reports SNM allows you to print device-specific alarm reports. Click SELECT on the Print button on the bottom of the device-specific Alarm Reports window, or press MENU on Print >> Report and release MENU. SNM sends the currently displayed alarm report to your default printer.

16.1.2 Show View

After having selected a specific device from the scrolling list, clicking SELECT on the Show View button selects the specified device and brings it into view in the Console window and tells you whether the device resides under one or multiple views. You receive a window such as the one shown in Figure 16-6.

Figure 16-6

If a device resides under multiple views, clicking the Next button allows you to switch to the next view under which this device resides.

If a device resides under multiple views, clicking the Next button allows you to switch to the next view under which this device resides.

If a device is in only one view, the Next button in the window above is grayed-out. If a device is in multiple views, click SELECT on Next to switch from the current view (as displayed in the Console window) to the next view in which the specified device appears. In this context, "next" means the next view on the list of views as displayed by the Console's Goto menu.

16.1.3 Find

Allows you to find an element entry not visible in the Alarm Reports Summary window's scrolling list.

Figure 16-7

To find a device that is not visible in the window's scrolling list, you can scroll through the list or, more conveniently, click SELECT on the Find button at the bottom of the window

If a line for a device is present, that line is displayed and highlighted in the Alarm Reports Summary window's scrolling list. If a line for a device is not present, you receive the message "Device name not found" in the Alarm Reports Summary Find pop-up window.

This section describes several ways of viewing output from data and event requests. Additionally, you can view data reports or event/trap reports with the SunNet Manager Results Browser and Results Grapher. (See Chapter 20, "Browser," and Chapter 21, "Results Grapher," for more information.)

16.2 Data Reports

For data requests, you specify how you want the attribute data displayed (data reports log, Strip Chart, or Indicator) in the Data Request window. You view the Data Reports log through the SNM Console View menu, while Strip Charts and Indicators are displayed in the view from which the data request was launched. The following subsections discuss each of these types of displays.

16.2.1 Data Reports Log

The Data Reports log contains data reports, in ASCII, for all elements managed by the SunNet Manager Console. You display the Data Reports log by selecting the SNM Console View >> Data Reports menu item.

Figure 16-8

Data report entries have the following format:

<timestamp> [ <element_name> ] : <report type>: '<request_name>'

Table attributes are displayed in tabular form when possible. Attributes that are not tables are displayed in the format:

<attribute_name> = <attribute_value>

To view data reports, drag the slider to the right or the left. To look at all data reports for all elements, leave the Device field blank. To examine data reports for a particular element instance, type in the element name after the Device prompt and press Return. If you wish to look at Data Report log entries for all the elements again, press ctrl-u to clear the Device field and press Return.

The Data Reports log contains the most recently-received data reports for all systems. The currently displayed report is indicated on the Report line, while the total number of entries is displayed at the right of the slider. If you specify an element name in the Device field, the number of entries reflects the total number of entries for that element.

Data reports are allocated a maximum number of entries in the Data Reports log. By default, the maximum number of data reports is 1000. When the allocation limit is reached for either data reports, the oldest data report or error message is deleted. You can change the maximum number of entries by modifying the Maximum Data Reports setting in the Console Properties Miscellaneous category.

Save writes the contents of the Data Reports log to disk. Selecting this button displays a pop-up window in which you can specify the file name and path of the disk file. You can use Save after specifying a Device name to save a subset of the Data Reports log to disk.

Use the scroll elevator to scroll through an entry that spans multiple panes of the Data Report window. Any number of Data Report log windows can be displayed simultaneously, allowing you to view the log entries for individual systems side-by-side.

---

Note - The contents of the Data Report log window are subject to configured XView limitations. This may cause data requests for very large tables to not be displayed in the Data Reports log window. If this happens, increase the value of the text.maxDocumentSize parameter in your .Xdefaults file, reload the resource into the X resource manager, and restart the Console.

---

16.2.2 Indicators

An Indicator shows the last reported value for a particular attribute. Indicators are displayed in the format of <label>:<value>, where the <label> consists of the element name, agent name, and attribute. For example: poignant.etherif.ipkts: 6892892

The SunNet Manager Console displays a maximum of 64 indicators in the View where the data request selection process is begun. Indicators are positioned in the View using the same algorithm applied to newly created elements.

Indicators may be edited (cut, copied, or pasted) in the same manner as other elements. For example, you can position an Indicator adjacent to the glyph for the element being monitored.

As with any other element in the SunNet Manager Console, an Indicator has properties that may be modified using the Properties option. The Indicator Properties window is similar to the Properties window for an element. The middle portion of the window for selecting agents does not apply, nor do the color slide bars in the lower portion of the window. The scrollable top portion of the window displays the Name, Label, and Data fields.

If an Indicator is associated with a request that is loaded from an ASCII file and the request's Restart field is set to True, the Indicator is displayed in the view from which the request is launched. This is the case even if you have moved the Indicator into a different view before saving the ASCII file.

16.2.3 Strip Charts

A Strip Chart contains an auto-scaled strip chart of values for a single attribute reported from a particular element.

Figure 16-9

The SunNet Manager Console displays up to 128 Strip Charts in the view where the data request selection process is begun. Strip Charts are positioned in the view using the same positioning algorithm applied to newly created elements.

Strip Charts may be edited (cut, copied, pasted) in the same manner as other elements. For example, all Strip Charts can be collected in a separate view.

If a Strip Chart is associated with a request that is loaded from an ASCII file and the request's Restart field is set to True, the Strip Chart is displayed in the view from which the request is launched. This is the case even if you have moved the Strip Chart into a different view before saving the ASCII file.

As with any other SunNet Manager Console element, the Strip Chart has properties that can be modified. Click MENU on the appropriate strip chart, and click SELECT on the Properties option. The window shown in the following figure will be displayed.

Figure 16-10

Note that the Strip Chart Properties window is similar to the Properties window for an element. However, the middle portion of the window for selecting agents does not apply and the strip chart color cannot be changed. The scrollable top portion of the window displays the following fields:

Name: is an internal element identifier and may not be changed.

Label: sets the label displayed underneath the chart.

Data: is the latest attribute value displayed in the chart and may not be changed.

Width: is the displayed width of the chart in pixels.

Height: is the displayed height of the chart in pixels.

Fixed Range: determines whether the chart is auto-ranging (no check mark in box) or fixed-range (check mark in box).

Max Y Value: is the maximum value to use in a fixed range chart.

Min Y Value: is the minimum value to use in a fixed range chart.

16.2.4 Graph Tool

The Graph Tool, also known as the Results Grapher, is an application that allows the display of real-time data. See Chapter 21, "Results Grapher,"for more information about displaying information with the Grapher.

16.3 Event/Trap Reports

Event/Trap Reports displays event reports as well as trap reports. The information in the reports consists of timestamp, element name, request name, and attribute name/value pairs. The reports can pertain to a specific element or to an entire view.

The Event/Trap Reports log displays reported values for selected attributes, as well as asynchronous (trap) reports. You display the Event/Trap Reports log by selecting the SNM Console View >> Event/Trap Reports menu item.

16.3.1 Event/Trap Reports Log

The Event/Trap Reports log contains event and trap reports, in ASCII, for all elements managed by the SunNet Manager Console. Event/trap reports entries are time-stamped and show attribute values for the entire agent group. The attribute and value that caused the event are flagged with the relational operator and threshold value shown to the right in parentheses. See Figure 16-11.

Figure 16-11

To view event/trap reports, drag the slider to the right or the left. To look at all Event/Trap log entries for all elements, leave the Device field blank. To examine event/trap reports for a particular element instance, type in the

element name after the Device prompt and press Return. If you wish to look at Event/Trap log entries for all the elements again, press ctrl-u to clear the Device field and press Return.

The Event/Trap log contains the most recently received event reports and trap reports for all systems. The currently displayed report is indicated on the Report line, while the total number of entries is displayed at the right of the slider. If you specify an element name in the Device field, the number of entries reflects the total number of entries for that element.

Event reports and trap reports are each allocated a maximum number of entries in the Event/Trap log. By default, the maximum number of reports for either events or traps is 1000. When the allocation limit is reached for either event reports or trap reports, the oldest event report or trap report is deleted. You can change the maximum number of entries by modifying the Maximum Event Reports or Maximum Trap Reports settings in the Console Properties Miscellaneous category.

Save writes the contents of the Event/Trap Reports log to disk. Selecting this button displays a pop-up window in which you can specify the file name and path of the disk file. You can use Save after specifying a Device name to save a subset of the Event/Trap Reports log to disk.

Use the scroll elevator to scroll through the entry that spans multiple panes of the Event/Trap log window. Any number of Event/Trap log windows can be displayed simultaneously, allowing you to view log entries from individual systems side-by-side.

16.4 Error Reports

Error Reports displays messages that are sent when a request is not successfully launched and when other miscellaneous errors occur. The reports can pertain to a specific element or to an entire view.

16.4.1 Errors Log

The Errors log contains a list of machines, in ASCII, that have had at least one error occur on them, for all elements managed by the SunNet Manager Console. You display the Error Reports log by selecting the SNM Console View >> Error Reports menu item. You are then able to use the View >> Event/Trap Reports

menu item to specify a specific device name in the Event/Trap Reports window to see the event(s) that have occurred on the machine(s) of your choice.

16.5 Events Summary

Events Summary displays a list of machines that have had at least one event or trap occur on them. You can use the Event/Trap Reports option to see the event(s) and trap(s) that have occurred for a specific device.

16.5.1 Events Summary Log

The Events Summary log contains a list of machines, in ASCII, that have had at least one event occur on them, for all elements managed by the SunNet Manager Console. You display the Events Summary log by selecting the SNM Console View >> Events Summary menu item. You are then able to use the View >> Event/Trap Reports menu item to specify a specific device name in the Event/Trap Reports window to see the event(s) that have occurred on the machine(s) of your choice. If you press the MENU button over the Events Summary, the Drop All popup menu appears, as shown in Figure 16-12. Selecting Drop All clears all outstanding events.

Figure 16-12

You can select multiple devices and drop all events against them.

16.6 Add Background

Add Background allows you to specify the background image to be used for the current view. The background image is a Raster file.

16.7 Remove Background

Remove Background allows you to remove the background image from the current view.

16.8 Find

Find displays a window which allows you to specify an element to find (see Figure 16-13). It then displays the view containing the glyph for the element specified. The message at the bottom of the Find window tells you the number of views that the particular glyph appears in. If the glyph appears in only one view, the Next button is dimmed. Otherwise, the Console displays the next view in which the glyph appears when Next is selected.

---

Note - Element names are not case-sensitive.

---

Figure 16-13

16.9 Clipboard

Clipboard displays the contents of the clipboard. For example, glyphs for elements and requests edited via a Cut or Copy operation are displayed. See "Edit Button" in the following subsection for a discussion of the Cut and Copy operations.

This section describes several ways of viewing output from data and event requests. Additionally, you can view data reports or event/trap reports with the SunNet Manager Results Browser and Results Grapher. (See Chapter 20, "Browser" and Chapter 21, "Results Grapher," for more information.)