85.3 Generating Reports

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

85.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. In the Monitor Agent 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.

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

85.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. Ensure that all domains in your GroupWise system are open.

    You cannot obtain an accurate link map of your GroupWise system if any domains are closed.

  2. In the Monitor Agent 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.

    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.

85.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.

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 subfolder of the monwork folder.

    The default location of the monwork folder varies by platform.

    Linux:

    /tmp/gwmon/monwork/maps

    Windows:

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

    NOTE:On some versions of Windows Server, the ProgramData folder is not visible by default. To display it in File Explorer, click View, then select Hidden items.

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

  3. Continue with Setting Up Maps.

Setting Up Maps

  1. In the Monitor Agent console, click Map.

    Initially, no maps are available in Monitor.

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

    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 folder 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.

    For instructions, see Making Maps Available in Monitor.

  2. In the Monitor Agent 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. In the Monitor Agent 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.

    Ensure that 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. In the Monitor Agent 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.

85.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.

In the Monitor Agent console:

  1. Click Reports > Environment.

85.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 22.1.4, Enabling MTA Message Logging.

In the Monitor Agent 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 name 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. Click Run.

85.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 22.1.4, Enabling MTA Message Logging.

In the Monitor Agent console:

  1. Click Reports > Link Traffic.

  2. Select the source domain of the link, then click Next.

    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 GWIA.

  4. Click Run.

85.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 22.1.4, 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.

In the Monitor Agent console:

  1. Click Reports > Message Tracking.

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

  3. 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.

  4. Click Track.

85.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 85.4, Measuring Agent Performance.

85.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.

In the Monitor Agent console:

  1. Click Reports > Connected Users.

85.3.10 Gateway Accounting Report

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

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

85.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 console:

  1. Click Reports > Down Time.