Innerhalb
Nach weiteren Dokumenten suchen
Support-Ressourcen
| Dieses Buch im PDF-Format herunterladen
Requesting Data
4
- This chapter discusses the following topics:
-
- Making a one-time request for data
- Requesting periodic data
- Copying requests
- Viewing incoming data
- Analyzing stored data
- Modifying the display of a graph
- Printing a graph
- You can request that an agent return values for some or all attributes in a single agent group. Your request can either be for a single, quick snapshot of all the values in the agent group, or it can be a request for periodic reporting of one or more attribute values. For the latter type of requests, you can specify report characteristics such as:
-
- Number of reports from the agent
- Interval between reports
- Whether the reports should be stored in a file
- Whether the attribute values reported should be displayed graphically
- This chapter describes how to request data reports from agents and how to view or analyze the returned data.
4.1 Making a One-Time Request for Data
- A Quick Dump retrieves all the values in an attribute group for a target system. You can initiate a Quick Dump request in one of two ways.
4.1.1 Quick Dump using the Console Requests Menu
-
-
Click SELECT over the glyph that represents the target element.
-
Press MENU on the Requests button in the SNM Console.
-
Release MENU over Quick Dump to receive a Request Builder window such as the one shown in Figure 4-1.

Figure 4-1
-
-
In the Request Builder window, click SELECT on the Agent Schema, then on the Group you want for that schema. Click SELECT on Apply to send the request. You receive a Quick Dump Report window, as shown in Figure 4-3.
4.1.2 Quick Dump Through the Glyph Menu
-
-
Press MENU over the glyph that represents the target element.
-
Press MENU over Quick Dump and drag to the right over the desired agent name and attribute group name as shown in Figure 4-2.

Figure 4-2
- Releasing MENU on the attribute group name starts the Quick Dump request. You receive a Quick Dump Report window, as shown in Figure 4-3.

Figure 4-3
4.1.3 Useful Notes About the Quick Dump Window
- Starting with version 2.3, a popup window is displayed and filled with information as it is gathered from the appropriate managed devices.
- Table attributes are displayed in tabular form when possible and the Quick Dump window is automatically stretched if necessary.
- Data returned in the Quick Dump window is not stored and is not displayed in the Data Reports window.
- Starting with the current product, the pop-up window appears as soon as the quick dump request is submitted. Results of the request display when they are returned from the agent. If an error occurs, the message "cannot start request <request name> displays in the pop-up window. The text of the error can be displayed through the View >> Error Reports window.
4.1.3.1 Quick Dump Information from Set Tool
- The Get operation of the Set Tool returns the same information for SNMP devices as the Quick Dump. The Set Tool is described in "Part 2: Reference."
4.2 Making a Request for Periodic Data
- A data request causes an agent to automatically report the values of specified attributes for a target system at specified intervals. You can compose your own request, targeting a specific machine for a specific set of information. More conveniently, you can use one of the predefined requests. These requests save you the trouble of composing requests for individual machines.
4.3 Prioritizing Requests
- Starting with the current version of SunNet Manager, you can prioritize data requests by specifying:
-
- Start time
- Start date
- Stop time
- Stop date
- This is useful, for example, if you want a request to begin when no one will be available to initiate it, or when network traffic is at a minimum. The default is to start immediately and run indefinitely. If you enter a Stop time, it takes precedence over any count value that has been specified. A count value of 0 means "run indefinitely." If a count value is reached before Stop time, the request would stop. To initiate the prioritizing process:
-
-
Define your request in the Request Builder window, then click SELECT on Apply. You receive the screen shown in Figure 4-4.

Figure 4-4
-
-
Follow the prompts on the Request Builder Menu to specify start and stop for date and time.
4.3.1 Sending a Data Request Through the Console Requests Menu
-
-
Move the mouse pointer over the glyph that represents the target element, and click SELECT.
-
Press MENU on the Requests button, and release MENU over Send Request.
You will receive the window in Figure 4-5. The Request Action field is automatically set to Send Request.

Figure 4-5
-
-
Click SELECT on the Request Type you want to send (Data, in this example).
-
Press MENU on the Request Name abbreviated menu button. You receive the menu shown in Figure 4-6.

Figure 4-6
-
-
Choose a request from the Request Name menu.
-
After choosing either NEW_REQUEST or a predefined request name from the Request Name menu, click SELECT on the Apply button. You receive a Data Request Properties window as shown in Figure 4-7.
4.3.2 Creating Your Own Request
- There can be times when you want to create your own request. You can accomplish this using the following steps:
-
-
Click SELECT on an agent in the Agent Schema scrolling list.
-
Click SELECT on a group name in the Group scrolling list.
b. Choose NEW_REQUEST from the Request Name pull-down menu.
-
After choosing either NEW_REQUEST or a predefined request name from the Request Name menu, click SELECT on the Apply button. You receive a Data Request Properties window as shown in Figure 4-7.
-
Examine the Request Properties window and make any changes you want.
Many predefined requests will require little or no modification.

Figure 4-7
- The example above shows the predefined data request "Graph Host Performance."
-
-
On the left side of the request window, modify or fill in the report characteristics fields.
- See the Section below on "Scheduling Requests" for more information.
-
-
On the right side of the request window, select (or accept) the attributes on which you want the agent to send data, and how you want to view the data.
-
Press MENU on the Attribute menu button and release MENU over the attribute you want.
-
-
Click SELECT on Apply to add the attribute to your request. For a description of the fields in the Data Request template, refer to "Part 2: Reference."
-
Click SELECT on the Start button to send the data request to the agent.
4.3.3 Sending a Data Request Using the Glyph Menu
-
-
Move the mouse cursor over the glyph and pull down the Glyph menu.
-
In the Glyph menu, release MENU over Send Request. You then receive a Request Builder window, from which you can use a predefined request or create your own request.
4.3.4 Sending a Predefined Data Request Through the Glyph Menu
- SunNet Manager is shipped with a number of predefined data requests. Use these as a convenient way to request routine data reports. To send such a request using the Glyph menu, follow the steps below:
-
-
Move the mouse pointer over the glyph for the element to which you want to send the request.
-
Press MENU at Send Predefined.
-
Move the mouse pointer to the right over Data Request and continue to pull right to obtain the menu of predefined data requests shown in Figure 4-8.

Figure 4-8
-
-
Release MENU over the predefined request you want.
You receive no Properties window for the request; the request is sent immediately following your menu selection.
- To view the properties associated with a predefined request:
-
-
Click SELECT on the glyph to which you are sending a request.
-
Invoke Requests
>>
Send Request.
-
In the Request Builder window, choose the name of the predefined request you want from the Request Name menu.
-
-
Click SELECT on Apply. You receive the Properties window for that predefined request.
- Alternative ways to view the properties of a request:
-
- Double-click on the glyph for the target of your request.
- Click SELECT on the glyph for the request.
- Click SELECT on the Props button in the Console's control area.
- Invoke Requests >> Requests Summary.
- Find and click SELECT on your request.
- Click SELECT on the Props button in the Requests Summary window.
- Use the Select and Sort menus to find your request.
- See "Viewing and Modifying Properties of a Request" on page 4-35 for more information.
- For further background on predefined requests, see "Part 2: Reference."
4.3.5 Predefined Requests Depend on Agents Present
- Predefined requests (and the agents listed in the Agent Schema list in a Request Builder window) for a given machine depend on the agents that have been checked off as present in the properties window for that machine.
- A machine the Discover tool adds to your database which does not have SunNet Manager agents on it, has the hostperf and ping agents checked off. Information is available from a machine without agents through the proxy feature, just as if the hostperf and ping agents were on that machine. A machine with agents installed that the Discover tool adds to your database, has the agents checked off that are actually present.
4.3.6 Notes About Console Window Features
- Messages indicating that the request has been started are displayed in the lower left footer of the Console window.
- The default value of the Restart field in the Request Properties window is specified in the Requests category of the Console's Properties window. You access the Console's Properties window by clicking SELECT in the Props button in the Console's control area. For more information, see "Part 2: Reference."
4.4 Copying Requests
- Copying requests allows you to quickly start the same Data Request for multiple elements. Each request is represented by a glyph that appears in the subview of an element. Because requests are represented by glyphs, copying requests is similar to copying elements.
-
-
Move the mouse pointer over the source element. Double-click SELECT to display the subview of the element.
-
Move the mouse pointer over the request glyph you want to copy, and click SELECT.
-
Press MENU over the Edit button to open the Edit menu.
-
Drag the mouse pointer down to the Copy option and release.
-
Move the mouse pointer over the target element (in either the same view or a different view). Double-click SELECT to display the subview of the element.
-
In the element's subview, press MENU to open the Edit menu. Drag the mouse pointer down to the Paste option and release.
4.4.1 Using Function Keys for Copy and Paste
- You can use the keyboard function keys that correspond to Copy and Paste instead of the Console Edit menu.
- The Copy function copies the request into the clipboard. Once a request has been copied into the clipboard, it can be pasted into as many views as needed. In the Console window, invoke View >> Clipboard to view the contents of the clipboard.
- Pasting a request into the view of an element launches the request for that element. If you specified a name for the original request, the same name is used for the copied request. If you did not specify a name for the original request, the request name assigned to the copied request is incremented by 1. For example, if the original request uses the name hostperf.data.0, then a copied request becomes hostperf.data.1.
- As an alternative to copying a request, you can use the predefined request feature, described in this chapter under "Sending a Predefined Data Request through the Glyph Menu."
4.5 Viewing Incoming Data
- You can view Data Request results as they are received by the Console in one of the following ways:
-
Data Reports The Data Reports option of the View menu displays data reports in a simple text format. The values of attributes specified in a single Data Request are displayed.
-
Results Grapher The Results Grapher displays the values of a specified attribute on a graph. The Grapher is intended to aid in the visual analysis of collected attribute information. You can modify the display of graphs, including specifying graph colors and two-dimensional or three-dimensional displays. Graphs can be merged for comparison of data.
-
Strip Chart A Strip Chart can also display the values of a specified attribute in a simple graph. A Strip Chart is a simple graph of a single attribute for a single system. Although Strip Charts can be copied and pasted into different views, you cannot merge multiple Strip Charts. Because each Strip Chart is automatically scaled, it is not very practical to try to compare data among multiple Strip Charts.
- An Indicator displays the last reported value of an attribute for a particular request. If many different Data Requests are active, an Indicator can be a convenient way of seeing the latest reported value of an attribute.
4.5.1 Viewing Incoming Data for All Systems: Data Reports Window
- To see attribute values sent by the agent in response to a Data Request, follow the steps below:
-
-
In the Console window, press MENU in the View menu and release MENU over Data Reports as shown in Figure 4-9. (Or, click SELECT over the target glyph, and invoke View and Data Reports.)

Figure 4-9
- You receive the window shown in Figure 4-10.
-
-
To examine data reports for a particular system, type in the device name after the Device prompt and press Return.
-
To see entries for all elements again, press Ctrl-U to clear the Device line and press Return.

Figure 4-10
-
-
To save the data reports to a file, click SELECT on the Save button.
A pop-up Save window appears, where you can enter the path and file name where the data reports are to be stored.
-
To browse through entries in the window:
-
- Press SELECT on the slider and drag the slider to the left or right.
- Click SELECT to the left or right of the slider.
- Click SELECT on either end of the slider bar.
- Enter the number of a report on the Report line and press Return.
- The Data Reports window contains the most recently received data reports for all systems. The currently displayed entry and the total number of entries are identified in the slider bar. When Device is set for a particular element, the slider bar reflects the current and total number of entries for the element.
- By default, the maximum number of data reports displayed in the Data Reports window is 1000. When the maximum limit is exceeded, the oldest data report is deleted.
4.5.2 Viewing Incoming Data: Grapher
- The Graph tool (also known as the Grapher) displays reported attribute values in a graph that you can modify.
-
-
Open the Data Request Properties window for the target element by either defining a new Data Request or modifying an existing request.
The Data Request Properties window as shown in Figure 4-7 on page 4-10 will be displayed.
-
Move the mouse pointer over the Graph Tool abbreviated menu button and press MENU. Drag and release on either Absolute Values or Delta Values.

Figure 4-11
- Choose Absolute Values to graph the values as they are reported. In graphs that use absolute values, the graphs use actual numbers, such as packet counts or collisions.
- Choose Delta Values to graph the delta (or difference) between a previously reported value and the current reported value. In graphs that use delta values, the graph starts at zero or an arbitrary number and increments by however much it needs to accommodate changes.
-
Note - The predefined requests shipped with SunNet Manager have Absolute Values selected in the Graph Tool field.
4.5.3 Viewing Incoming Data: Strip Charts and Indicators
- You can choose the Strip Chart or Indicator options in the Data Request Properties window. These options allow you to monitor the value of a single attribute from the Console view. An Indicator shows the last reported value of an attribute. A Strip Chart is an auto-scaled chart of reported values for a single attribute. See Figure 4-12.

Figure 4-12
-
-
Open the Data Request Properties window for the target element by either defining a new Data Request or modifying an existing request. See Figure 4-13.

Figure 4-13
-
-
To specify that the attribute data be displayed in an Indicator, move the mouse pointer over the box next to the Indicator field and click SELECT.
A check mark appears in the box.
-
To specify that the attribute data be displayed in a Strip Chart, move the mouse pointer down over the Strip Chart abbreviated menu button and press MENU. Drag the mouse pointer down to either Absolute Values (chart the received values) or Delta Values (chart the differences between received values).

Figure 4-14
4.5.4 Useful Notes About Indicators and Strip Charts
- Indicators and Strip Charts are automatically positioned in the view from which the request is launched. You can move Indicators or Strip Charts within a view, or cut, paste, or copy them into other views.
- A maximum of 64 Indicators or 128 Strip Charts can be displayed in the view where the associated request is started.
- You can modify certain properties of Strip Charts with their Properties window. For example, you can specify the maximum height and width of a Strip Chart. To modify the properties of a Strip Chart:
-
-
Move the mouse pointer over the Strip Chart you want to modify and press MENU to open its Glyph menu.
-
Drag the mouse pointer down to Properties and release to open the Properties window.
-
Modify the Properties window, as necessary.
Note that the Properties window for Strip Charts is similar to an Element Properties window. The middle portion of the window, for selecting agent schemas, and the bottom portion, for color selection, do not apply to Strip Charts.
-
Click SELECT on the Apply button to modify the Indicator or Strip Chart.
4.6 Analyzing Stored Data
- You can analyze data that has been stored into a disk file by using the following tools:
-
- Results Browser
- Results Grapher
- The following types of data files can be analyzed:
-
- Event/Trap Reports file. Unless a different log directory was specified during installation, this file is located at:
· /var/adm/snm/event.log for Solaris 1.x installations.
· /var/opt/SUNWconn/snm/event.log for Solaris 2.x installations. The log file is defined by the event-log keyword in the /etc/snm.conf file for Solaris 1.x installations and in the /etc/opt/SUNWconn/snm.conf file for Solaris 2.x installations.
- Data report entries that have been saved to a disk file (see the section "Viewing Incoming Data for All Systems: Data Reports Window," in this chapter).
- Data report files specified with the Log to File field in the Data Request window.
- Any other files that use the data format specified by snm.logfile(5).
4.6.1 Analyzing Stored Data: Results Browser
- Use the Results Browser to retrieve and organize stored data.
-
-
Move the mouse pointer over the Tools button on the Console Menu and press MENU to open the Tools menu. Or, invoke the Browser from the command line:
-
-
host% snm_br.
-
-
Drag the mouse pointer down to Browser and release to open the Results Browser. You receive the window in Figure 4-15

Figure 4-15
-
-
In the Results Browser file menu, move the mouse pointer over the File button and press MENU to open the File menu. Drag the mouse pointer down to Load. You receive the window in Figure 4-16.

Figure 4-16
-
-
Enter the directory and file name of the file to be loaded and click SELECT on the Load button. You receive the window shown in Figure 4-17.
Data loaded into the Browser is automatically organized into report streams and grouped by request and type of data. A stream is the set of requests associated with a specific pairing of hostname or IP address and agent name. For example, all of the data reports from the hostmem2 agent for poignant would make up a single stream. The reports from the layers2 agent for the same machine make up a different stream, as do the layers2 reports for a different machine.

Figure 4-17
-
-
To view individual reports in a report stream, double-click SELECT on the line that represents the stream.
- The Browser runs as a separate process from the Console and remains running when you quit or close the Console.
- The first column in the Browser scrolling list of streams can contain a hostname or an IP address.
4.6.1.1 Printing Browser Reports
- You can invoke the Browser from a command line by entering snm_br. When you invoke the Browser from the command line, you can also specify the path and name of one or more data files to be loaded automatically when the Browser's main window is displayed. You can print Browser report streams to a specified printer. To do so:
-
-
Select the report streams you wish to print.
a. Move the mouse pointer into the top portion of the Browser window where the names of the report streams are displayed. b. Press MENU to open the Streams menu.
c. Drag the mouse pointer down to Select, then continue to drag right to By System, By Agent and Group, or By Report Type. d. Continue to drag right on the appropriate system name, agent group name, or report type.
e. Repeat steps a through d until all desired streams are selected.
-
Move the mouse pointer over the report streams and press MENU to open the Streams menu.
-
Drag the mouse pointer down to Print. (See Figure 4-18.)
The default printer is lp. To change the printer, modify the Browser Properties window as explained in the following summary.

Figure 4-18
- You can modify certain characteristics of the Browser display and the default printer. To do so:
-
-
Move the mouse pointer to the Edit button of the Browser window and press MENU to open the Edit menu.
-
Drag the mouse pointer down to the Tool Properties option and release. (See Figure 4-19.)

Figure 4-19
-
-
Modify Browser display or print options. (See Figure 4-20.)

Figure 4-20
- For a complete description of Results Browser features, see "Part 2: Reference."
4.6.2 Analyzing Stored Data: Results Grapher
- The Results Grapher displays reported attribute values in a graph that can be manipulated.
- You can invoke the Grapher directly, by selecting Tools >> Grapher in the Console window or by invoking snm_gr on a command line.
- However, it is often more useful to invoke the Grapher from the Browser, then, enter the attribute name you want. The procedure for this is specified below.
-
-
Move the mouse pointer over the Tools button and press MENU to open the Tools menu. Drag the mouse pointer down to Browser and release. Or, invoke the Browser from the command line:
-
-
host% snm_br
-
-
Load the file into the Results Browser.
a. Move the mouse pointer over the File button and press MENU to open the File menu. Drag the mouse pointer down to Load. b. Enter the directory and path name of the file to be loaded and click SELECT on the load button.
-
In the Browser window, send the stream(s) that contain the data to be graphed to the Grapher.
a. Select the stream that contains the data to be graphed. b. Move the mouse pointer into the scrolling list in the upper portion of the Browser window and press MENU to open the Streams menu.
c. Drag the mouse pointer down to Graph and drag right over the desired attribute name.
4.6.2.1 Changing a Graph Display
- Follow the steps below to change the display of the graph:
-
-
Move the mouse pointer over the displayed graph.
-
Press MENU and drag the mouse pointer down to Properties and release.
-
-
Modify the Properties window of the graph.
- To change the viewing angle of the graph:
-
-
Move the mouse pointer over the displayed graph.
-
Press MENU and drag the mouse pointer down to Controls and release.
-
In the Rotation Angles window, adjust the elevation and rotation of the graph by dragging the mouse pointer on the slider buttons.
- To zoom into a portion of the graph:
-
-
Move the mouse pointer to a point in the graph along the X-axis and press SELECT.
-
Drag the mouse pointer to another point along the X-axis.
- To merge multiple graphs:
-
-
In the Results Grapher main window, click SELECT on the names of the graphs you want to merge.
-
Click SELECT on the Merge button.

Figure 4-21
4.7 Printing a Graph
- You can print graphs (or strip charts) using the OpenWindows Snapshot utility. Snapshot is available from the Tools menu of the Console.
-
-
Start the Snapshot utility from the Console Tools menu or from the OpenWindows Programs menu.
-
- In the Console, move the mouse pointer to the Tools button and press MENU to open the Tools menu. Drag the mouse pointer down to Snapshot and release.
- In an open area of your workstation display, press MENU to open the Workspace menu. Drag the mouse pointer right on Programs, then drag down to the Snapshot option and release.
- For more information on the Snapshot utility, refer to the SunOS 4.x DeskSet Environment Reference Guide.
-
-
In the Snapshot window, click SELECT on Window in the Snap Type field, then click SELECT on the Snap button. (See Figure 4-22.)

Figure 4-22
-
-
Move the mouse pointer to the graph to be printed and click SELECT.
Within a few seconds you should see the message "Snap succeeded" at the bottom of the Snapshot window.
-
-
In the Snapshot window, press MENU on the Print abbreviated menu button.
-
Drag the mouse pointer down to Print Snap to print the snapshot. Drag the mouse pointer down to Options to set up printer options.
4.7.0.1 Useful Notes About Displaying and Printing Graphs
- The Results Browser and Grapher run as separate processes and remain running when you quit or close the Console.
- By default, graphs are displayed on a black background. To display graphs on a white background, invoke the Grapher from the command line with the -b option. You can also modify the Tools menu to add the -b option when invoking the Grapher. See Chapter 10, "Customizing SunNet Manager" for more information.
- Graphs can be printed by using the OpenWindows Snapshot utility. Snapshot is available from the Tools menu of the Console. See "Printing a Graph" later in this Section for more information.
- If the Grapher displays the graphs on a black background, the graphs will print on a black background. To print graphs on a white background, invoke the Grapher with the -b option. You can also modify the Tools menu to add the -b option when invoking the Grapher. See Chapter 10, "Customizing SunNet Manager" for more information.
4.8 Viewing and Managing Requests
- The SunNet Manager Console Requests >> Summary window allows you to view the status of all requests that have been started from the Console session. From the Requests >> Summary window you can stop, kill, or restart multiple requests at a time or modify the properties of a request.
- Each request is associated with a request glyph that resides in the subview of the target element. From the Glyph menu for the request you can modify, stop, or kill the request.
- This section describes how to view, modify, stop, and kill requests from the Requests Summary window and from the Glyph menu for the request.
4.8.1 Viewing the Status of Requests
- The Console Requests >> Summary window allows you to view the status of all active or held Console requests. To receive the Requests >> Summary pop-up window:
-
-
Move the mouse pointer over the Requests button and press MENU to open the Requests menu.
-
Drag the mouse pointer down to Summary and release. See Figure 4-23

Figure 4-23
-
-
To display the requests in a different order:
a. Move the mouse pointer over the Sort button and press MENU to open the Sort menu.
b. Drag the mouse pointer down and release on the desired sort.
4.9 Request States
- Every active or held Console request is shown in one of several states:
-
- Not defined
- Idle
- Retrying Failed Start
- Being Started
- Active
- Retrying Failed Stop
- Stopping
- Scheduled
- When you start a request (you click SELECT on the Start button on the Properties window for the request), the request state is initially awaiting activation. Normally, the request state quickly changes to being activated, followed by active.
- If an agent error occurs while a request is being activated, the request state changes to stopped.
- An active request that is stopped or killed passes through the states awaiting stop, being stopped, and stopped.
- A held request (you click SELECT on the Hold button on the Properties window for the request) is shown in stopped state.
- If you specified Delete Request in the Upon Completion field in the Properties window of a request, the request disappears from the Requests >> Summary window when the request is completed. If you specified Save Request in the Upon Completion field in the Properties window of a request, the state of the request becomes stopped when the request is completed.
- Note that the states awaiting activation, being activated, awaiting stop, and being stopped are normally temporary. If you notice that a request seems to be in one of these states for a long time without changing, you should make sure that the target element is reachable by using the ping agent to do a Quick Dump request.
- A request that is Scheduled for later is sent to the appropriate agent at the scheduled time.
4.10 Viewing and Modifying Properties of a Request
- You can modify a data or event request from the Requests >> Summary window or from the request glyph.
- To view the properties of a request from the Requests >> Summary window:
-
-
Click SELECT on the request whose properties you want to view or modify.
-
Click SELECT on the Props button at the top of the window. See Figure 4-24

Figure 4-24
- To view the properties of a request from the request glyph:
-
-
Move the mouse pointer over the glyph that represents the target element for which you have specified an Event or Data report, and double-click SELECT.
Data requests are represented by a meter glyph, while event requests are represented by an alarm clock glyph. When a request is active, its glyph appears black or solid. When a request is stopped or held, its glyph is dimmed.
-
Move the mouse pointer over the glyph that corresponds to the request and press MENU to open the Glyph menu for that request.
-
Drag the mouse pointer down to Properties and release. See Figure 4-25.

Figure 4-25
4.10.1 Modifying Report Characteristics or Specifications
- Once the Properties window for the request is displayed, you can modify request reporting characteristics or the attribute or event specifications.
- To change how an attribute is logged or displayed, select the attribute in the Attribute values scrolling list by pointing the mouse at the entry and clicking SELECT. This causes the current values of the event definition to appear in the fields on the right side of the window. If you modify any of these fields, click the Apply button at the bottom of the window. To delete an attribute from a data request, select the attribute from the Attribute values scrolling list and click the Delete button at the bottom of the window.
4.10.2 Using Data Requests to Monitor Performance
- Use data requests to gather comparative data in such areas as network traffic levels or the performance of critical nodes, such as servers and routers. A data request causes an agent to report the values of specified attributes for a target device. You can request a one-time report of current data (a Quick Dump), or reporting of data at periodic intervals. You can see data reports in a real-time graph or log them to a file for later viewing.
- Continual data polling can generate significant additional network traffic. You may prefer to collect data only at periodic intervals, to establish an historical record, to help you gauge trends, and to determine normal levels of activity.
- Define your own data requests using the Data Requests Properties window or, more conveniently, use one of SunNet Manager's predefined data requests. Table 4-1 lists the predefined data requests shipped with the current version of SunNet Manager.
-
Table 4-1
| Request Name | Agent Name | Group Name | Attributes Supported | Function |
| Graph Host Performance | hostperf | data | cpu%
intr
disk
ipkts
opkts | CPU utilization
# of device interrupts
# of disk transfers
# of if input pkts
# of if output pkts |
| Record Disk Space | diskinfo | diskSpace | all | disk space information |
| Record Host Performance | hostperf | data | all | Statistics of Host |
| Show Host Interfaces | hostif | if | all | host interface statistics |
| Show NFS Statistics | rpcnfs | client | all | RPC and NFS statistics |
| Show Path to Host | ippath | path | all | trace IP packet's path between proxy and target system |
| Show Routing Statistics | iproutes | routes | all | Routing statistics |
| Show snmp System Info | snmp | system | all | System information |
| Show snmp-mibII System Info | snmp-mibII | system | all | System information |
| Show sun-snmp System Info | sun-snmp | system | all | System information |
- To view a system's performance in a real-time graph, select the predefined data request "Graph Host Performance." As shown in Figure 4-26, you can launch this data request from the target host's glyph popup menu.
- You can launch this request at each critical node. For each such request, you receive a graph such as the one in Figure 4-27.

Figure 4-26 hostperf

Figure 4-27
- Example:
- You can also use the hostperf agent to log data reports to a file. See Figure 4-28. To build such a request for a target device:
-
-
Select the device.
-
Invoke the Request Builder window through the Console's Requests
>>
Send Request option.
-
Select the Data Request type and the hostperf agent
-
Click on the Apply button to invoke the Data Request Properties sheet.
-
To launch the request, click SELECT on the Start button.
- The subview for each device shows the active requests targeted at that device. To access the subview for a device:
-
-
Double-click SELECT on the glyph for that device.
The active requests for that device are represented by glyphs.

Figure 4-28
4.10.2.1 Copying and Pasting Requests to Track Additional Devices
- After a request is launched for one device, you can copy and paste it from the subview of the initial device to the subview of each additional device you want to track. As shown in Figure 4-29, you can use the Console Edit >> Copy function to copy requests from the subview of one element to the clipboard. You can then paste this request into the subview of each of multiple elements. This launches a clone of the initial data request for each additional device where you paste the request.

Figure 4-29
- To view the data reports from these requests:
-
-
Invoke the Results Browser from the Console Tools menu
-
Load the log file where the data is stored into the Results Browser through the Browser's File
>>
Load option
-
Figure 4-30 shows the Results Browser loaded with the log file specified in the Log to File field of a Data Request Properties Sheet.

Figure 4-30
4.10.3 Example: Assessing Overall Operation of the Network
- To quickly assess individual performance characteristics of each critical node, and determine potential problem areas for overall operation of the network. graph the attributes available from the Streams >> Graph Grapher menu shown in Figure 4-31. Features such as "zooming" and merging help you refine comparisons of the data you have logged. A detailed discussion of Grapher features is presented in the "Grapher" chapter in "Part 2: Reference."
- To compare data from different streams over a particular attribute, such as cpu%, merge the data from the various files into a single graph:
-
- Invoke the Grapher tool from the Browser.
- You receive the window shown inFigure 4-32. The merged graph allows you to quickly compare the CPU utilization of multiple nodes.

Figure 4-31
>>

Figure 4-32
|
|