71.3 Generating Reports

You can generate reports on demand at the Monitor Agent consoles to help you manage message flow throughout your GroupWise system.

71.3.1 Link Trace Report

A link trace report enables you to follow the path a message would take between two GroupWise domains. A link trace report includes a list of all the domains through which a message would need to pass, along with their current status, link type, address, and number of messages currently queued in each domain. If any domain along the link path is closed, an error message is displayed.

If a message fails to arrive at its destination, this report can help you pinpoint its current location, so you can resolve the problem and get messages flowing smoothly again.

  1. On Windows, at the Monitor Agent server console, click Reports > Link Trace.

    or

    On Linux, at the Monitor Agent Web console, click Link Trace.

  2. Select a starting domain and a target domain.

  3. If you want to trace the path back, which is the route status messages will take, select Trace Return Path.

  4. Click Trace.

    Link Trace dialog box

    If any domain in the path is closed, an error message displays so you know where the problem is occurring.

  5. When you are finished tracing links, click Close.

71.3.2 Link Configuration Report

A link configuration report enables you to list the links from one or more GroupWise domains to all other domains in your GroupWise system. This helps you identify inefficient link paths, loops, and unreachable domains. All domains must be open to obtain an accurate link map of your GroupWise system.

  1. Make sure all domains in your GroupWise system are open.

    You cannot obtain an accurate link map of your GroupWise system if any domains are closed. For assistance with closed domains, see Message Transfer Agent Problems in GroupWise 2012 Troubleshooting 2: Solutions to Common Problems.

  2. On Windows, at the Monitor Agent server console, click Reports > Link Configuration.

    or

    On Linux, at the Monitor Agent Web console, click Link Configuration.

  3. Select All Agents

    or

    Select Selected Agent and select a specific agent from the drop-down list.

  4. Click Run.

    Link Configuration dialog box

    The list shows what domains a message would pass through to travel from the domain in the Source column to the domain in the Destination column. If a domain displays as closed, it means that the Monitor Agent could not contact the MTA for the domain or that a loop was detected in the link configuration.

  5. When you are finished checking links, click Close.

71.3.3 Image Map Report

An image map enables you to create a visual picture of your GroupWise system, whether it resides in a single office building or spans the globe. You provide the maps; Monitor provides the up-to-the-minute status information at a glance.

NOTE:The image map report cannot be generated at the Windows Monitor Agent server console. You must use the Monitor Agent Web console.

Making Maps Available in Monitor

  1. Obtain useful maps from the Internet or another location.

    You can use maps that vary in detail. For example, you could have one map the focuses on a particular corporate office building, another that shows offices throughout your country, and another that shows offices throughout the world. You can select from images in PNG and JPG format.

  2. Copy the maps you want to use into the maps subdirectory of the monwork directory.

    The default location of the monwork directory varies by platform.

    Linux:

    /tmp/gwmon/monwork/maps

    Windows:

    c:\ProgramData\Novell\GroupWise Server\Monitor\monwork\maps

    You can change the location using the ‑‑monwork startup switch. For more information, see Section 73.0, Using Monitor Agent Startup Switches

  3. Continue with Setting Up Maps.

Setting Up Maps

  1. At the Monitor Agent Web console, click Map.

    Image Map Selection menu

    Initially, no maps are available in Monitor.

  2. Click New to display all the maps that are available in the maps directory.

    Available image maps

    The file name of each map is displayed below it.

  3. Click the map that you want to set up, specify a custom name for the map, then click Create.

    Map graphic to create an image map from

    This makes the map available for use in Monitor.

  4. To set up additional maps for use in Monitor, click Done to return to the Image Map Selection menu, then repeat Step 2 and Step 3 for each map that is available in the maps directory to make it available in Monitor.

  5. If you want to make one or more smaller-scale maps available from a large-scale map, continue with Setting Up Regions.

    or

    If your maps are all independent from each other, skip to Adding Agents to a Map.

Setting Up Regions

If some of your maps are subsets of other maps, you can set up a large-scale map so that it links to one or more smaller-scale maps. For example, a map of the world could have a region for each continent or country, or a map of a city or country could have a region for each office where GroupWise domains or post offices are located.

  1. Set up at least two maps in Monitor, as described in Making Maps Available in Monitor.

  2. At the Monitor Agent Web console, click Map to display the maps that are available in Monitor.

    Maps available in Monitor

    The custom name of each map is displayed below it.

  3. Click Edit, then click a large-scale map.

  4. In the drop-down list, scroll down through the agents, click the smaller-scale map that you want to define as a region, then click on the large-scale map to refresh the view.

  5. Click points on the map to surround the region.

    Image map with region defined

  6. Click Done to define the region.

    With a very wide map, you need to scroll horizontally to display the Done button.

    The region appears labeled on the large-scale map.

    Image map with region labeled

  7. To define more regions on the large-scale map, click Done to return to the available maps, then repeat Step 3 through Step 6 for each region.

    or

    To place agents on a map, continue with Adding Agents to a Map.

Adding Agents to a Map

  1. At the Monitor Agent Web console, click Map to display the maps that are available in Monitor.

    Maps available in Monitor

    The custom name of each map is displayed below it.

  2. Click Edit, then click the map where you want to add agents.

  3. Select an agent in the drop-down list, then click the place on the map where that agent is located.

    The agent name appears in a blue box.

  4. Select additional agents and locations as needed.

    Image map with GroupWise sites labeled

  5. In the Line Color drop-down list, select the color to use to show links between locations.

    Make sure you select a color that shows up well on the particular map. Lines display on the map only when links between locations are down.

  6. Click Done when the map includes all the needed GroupWise agents in their respective locations.

  7. Continue with Using an Image Map to Monitor Agents.

Using an Image Map to Monitor Agents

  1. At the Monitor Agent Web console, click Map > View.

  2. Click a map to view agent status.

    or

    If the map has regions, click a region to display the map that has agent status for that region.

    Image map with problem site identified

    At this point, the Monitor Agent checks the status of each agent on the map. Any agent that is down or that has a status of Major, Critical, or Warning displays in red on the map. Agents with a lower status do not display on the map. If a link between agents is down, a line displays between the agents.

71.3.4 Environment Report

An environment report lists all monitored agents, along with each agent’s location, version, IP address, port number, and operating system information.

At the Windows Monitor Agent server console or the Monitor Agent Web console:

  1. Click Reports > Environment.

    Environment report

  2. Scroll through the displayed information for your own use.

    or

    Click Send, type your email address, type one or more email addresses to send the environment report to, then click Send.

  3. Click OK to close the Environment Report dialog box.

71.3.5 User Traffic Report

A user traffic report enables you to determine how many messages a user has sent outside his or her post office. The user traffic report lists all messages sent by a specified user during a specified date/time range, along with date, time, and size information for each message. You can also generate a user traffic report for all users whose messages pass through a selected domain.

In order for the information to be available to generate a user traffic report, you must configure the MTA to perform message logging. See Section 42.4.2, Enabling MTA Message Logging.

At the Windows Monitor Agent server console or the Monitor Agent Web console:

  1. Click Reports > User Traffic.

  2. Select the user’s domain or the domain you want to generate a user traffic report for.

  3. Type the GroupWise user ID that you want to create a report for.

    or

    Leave the field blank to create a report for all users whose messages pass through the selected domain.

  4. If you want to restrict the report to a particular time interval, specify start and end dates and times.

  5. Click Run.

  6. After the results are displayed, click Save, provide a file name for the report, select the format for the report, then click OK.

    Reports can be saved in comma-separated or tab-separated format to meet the needs of the program you plan to use to display and print the report. For example, you could bring the data into a spreadsheet program. If needed, you can include column headings to create an initial line in the output file that labels the contents of each column.

  7. When you are finished generating user traffic reports, click Close.

71.3.6 Link Traffic Report

A link traffic report enables you to determine how many messages are passing from a selected GroupWise domain across a specified link. The link traffic report lists the total number and total size of all messages passing through the link during each hour or half hour of operation.

In order for the information to be available to generate a link traffic report, you must configure the MTA to perform message logging. See Section 42.4.2, Enabling MTA Message Logging.

At the Windows Monitor Agent server console or the Monitor Agent Web console:

  1. Click Reports > Link Traffic.

  2. Select the source domain of the link.

    The list includes all domains that the Monitor Agent uses XML to communicate with. If the Monitor Agent must use SNMP to communicate with a domain, that domain is not included in the list.

  3. Select the other end of the link, which could be another domain, a post office, or a gateway.

  4. If you want to restrict the report to a particular time interval, specify start and end dates and times.

  5. Click Run.

  6. After the results are displayed, click Save, provide a file name for the report, select the format for the report, then click OK.

    Reports can be saved in comma-separated or tab-separated format to meet the needs of the program you plan to use to display and print the report. For example, you could bring the data into a spreadsheet program. If needed, you can include column headings to create an initial line in the output file that labels the contents of each column.

  7. When you are finished generating link traffic reports, click Close.

71.3.7 Message Tracking Report

A message tracking report enables you to track an individual message through your GroupWise system. The message tracking report provides information about when a message was sent, what queues the message has passed through, and how long it spent in each message queue. If the message has not been delivered, the message tracking report shows where it is.

In order for the information to be available to generate a message tracking report, you must configure the MTAs in your GroupWise system to perform message logging. See Section 42.4.2, Enabling MTA Message Logging.

In addition, you need to determine the message ID of the message. Have the sender check the Sent Item Advanced Properties of the message in the GroupWise client. The Message Id field displays the message ID of the message; for example, 3AD5EDEB.31D : 3 : 12763.

At the Windows Monitor Agent server console or the Monitor Agent Web console:

  1. Click Reports > Message Tracking.

  2. Type the message ID of the message to track.

    You can obtain the message file ID in the GroupWise client. Open the Sent Items folder, right-click the message, click Properties, then click the Style drop-down list and click Advanced Properties. The Message Id field displays the message file ID; for example, 3A75BAB9.FF1 : 8 : 31642.

  3. Select the domain where you want to start tracking.

  4. Click Track.

  5. When you are finished generating message tracking reports, click Close.

71.3.8 Performance Testing Report

A performance testing report enables you to measure how long it takes messages to travel through your GroupWise system. The performance testing report lists each domain that a performance test message was sent to, when it was sent by the Monitor Agent, and the number of seconds between when it was sent and when the Monitor Agent received a response from the tested agent.

In order run a performance testing report, you must configure the Monitor Agent for performance testing. See Section 71.4, Measuring Agent Performance.

71.3.9 Connected User Report

The Connected Users report lists all users that are currently connected to POAs throughout your GroupWise system. It lists user name; client version, date, and platform; login time; and the IP address of the client user.

At the Monitor Agent Web console:

  1. Click Reports > Connected Users.

    NOTE:The Connected Users report cannot be generated at the Windows Monitor Agent server console or the Monitor Web console.

71.3.10 Gateway Accounting Report

The Gateway Accounting report shows traffic through a gateway. For example, you can use a Gateway Accounting report to track traffic to and from the Internet through a GWIA.

In order to run a Gateway Accounting report, you must configure the Monitor Agent to collect gateway accounting data. See Section 71.5, Collecting Gateway Accounting Data.

71.3.11 Trends Report

The Trends report presents graphs of agent MIB variables as sampled over time. Graphs are generated based on data gathered from Monitor Agent log files. The quality of the graphs depends on the quantity of data that has been gathered when the graph is generated.

In the Monitor Agent Web console:

  1. Click Reports > Trends.

    NOTE:The Trends report cannot be generated at the Windows Monitor Agent server console.

  2. Click the type of agent for which you want to set up a Trend report.

  3. Specify a unique name for the Trend report.

  4. Select the MIB variables that you want to collect values for over time, then click Add Trend.

    The Trend report appears in the Agent Trends list.

  5. Click the Trend report to view the graphs.

71.3.12 Down Time Report

The Down Time report graphically illustrates how much time each GroupWise agent has been down during the day.

In the Monitor Agent Web console:

  1. Click Reports > Down Time.

    NOTE:The Down Time report cannot be generated at the Windows Monitor Agent server console.