Understanding the Map

InterMapper provides visual cues to help you understand the states of the devices on your map quickly. Here is a summary of the visual indicators available in your map:

  • Color Codes—see the status of a device immediately.
  • Status Badges—reinforce the status information indicated by the color with additional visual cues.
  • Dotted lines (or "moving ants")—show the traffic moving between devices or networks.
  • Boxes and Ovals (or "bubbles")—consistent display of devices and networks.
  • Line Styles—indicate the speed of different connections.
  • An X on a link—shows that an interface is down.

Color Codes


Devices turn different colors depending on the magnitude of the problem detected. Links may be "haloed" with yellow or orange as utilization reaches 50 and 90 percent respectively. These are coupled with status badges, described below.

These are the default color assignments. You can redefine the colors from the Server Settings window.

Status Badges

InterMapper uses status badges as additional visual cues to increase the ease with which you can determine the status of a device among many devices.

Note: You can specify which badges you want appear on devices from the InterMapper User Preferences window.


The Map Legend

The Map legend to the right of the toolbar shows the different states of the map and the number of devices in each state. It also acts as a filter in list view.







Down - No response has been received from the device within the specified timeout period.



Critical - The specified threshold for critical state has been met.



Alarm - The specified threshold for alarm state has been met.



Warning - The specified threshold for warning state has been met.



Up - The device is working below the specified thresholds.



Unknown - The device is not being polled, so its state is unknown.



Acknowledge - Timed or Indefinite - The device's problem has been acknowledged and notifications are being suppressed, either indefinitely, or for a specified period of time. During the designated time period the wrench will be visible whatever the status of the device.



Acknowledge - Basic - The device's problem has been acknowledged, and notifications are being suppressed until the device comes back up, at which time the checkmark is cleared.

List Acknowledged Devices – (Filter button) List all devices that have been acknowledged.

List Un-Acknowledged Devices – (Filter button) List all devices that have not been acknowledged.

  • Filter by status - Click a legend icon to view a list of devices that currently in that state.
  • Remove filter - Click the icon again to go back to the previous view.
  • Multiple filters - Shift-click icons to view devices in more than one state.
    Example: Shift-click the Alarm and Warning icons to see any devices in either of those states.
  • Acknowledged only - Click one of the Acknowledge Filter buttons (to the right of the legend) to list only acknowledged or un-acknowledged devices.
    Note: The filter buttons work with in concert with the legend icons - clicking a Filter button shows only the devices in the selected state that are acknowledged or un-acknowledged. It is possible to click a filter button and see no devices.


Dotted lines (or "moving ants")

InterMapper draws dotted lines ("ants") next to a link to indicate that its current traffic flow is above a user-settable threshold value. Use the Thresholds>Traffic panel of the Map Settings window, available from the Edit menu, to change the settings and to view a legend of the different varieties of ants. You see the ants only in Monitor mode (as opposed to Edit mode.) To toggle between the two modes, click on the padlock icon in the toolbar or press Tab.

InterMapper regularly polls all the visible interfaces for packets, bytes, errors and discards.

Note: InterMapper uses SNMP to query the MIB of SNMP-enabled equipment to compute and display the traffic processed by each interface. Traffic indication appears only for SNMP-enabled devices.

Boxes and ovals (or "bubbles")

The boxes represent the physical equipment of your network. The ovals represent the networks which link the routers together. The numbers in the bubbles are "network identifiers". For IP networks, the number is the network and the subnet portion of the IP addresses of all devices on it. For example, "" is a network where IP addresses are in the range, and the subnet mask has 24 bits (it is a Class C network.) 

For AppleTalk networks, the number is the AppleTalk network number.

Click and hold on a router or network to see a status window with information about that item. (This only works in "browse" mode -- press Tab, or click on the padlock icon in the upper left corner until it is in the locked position).

Line styles

The style of the line corresponds to the type of interface.


As with the networks and devices, you can click and hold a link to see a Status window, containing information about the interface type and traffic statistics.

An X on a link


An X in the middle of a line or link means the link (or interface, or port) is down, as determined by SNMP. A red X signifies that the link's operational status is down. This could mean that it's broken, or simply that nothing is plugged into the interface. A blue X signifies that the link's administrative status is down (e.g., it has been explicitly disabled by an administrator.)  It can also indicate that the red X has been acknowledged.Many times, a switch is in Alarm state (orange) because it has ports that are not in use, and therefore, down. To resolve this, you should uncheck the ports in the Interfaces window. You can also select all DOWN interfaces in the Edit menu and delete them all at the same time.

2. Probe Basics

Our definition of a probe, is a SNMP, TCP or Command Line query. i.e. querying a device for information and receiving and collecting that information. Use the Set Probe command, available from the Monitor menu, the device's context menu, or by clicking Choose... in the Add Device(s) window, to view the Select Probe window. From this window you can choose and configure the probe for the selected devices.

  • The left pane contains a hierarchical list of probes, divided into sections and subsections.
  • The right pane shows the description and configuration options for the selected probe.
    Probes for Various Servers In addition to simply pinging them, InterMapper can monitor dozens of different devices and display their special characteristics. Right/control-click, or Monitor > Set Probe to select the probe for one or multiple selected devices. Things to try:
    • Automatic This probe uses either Pings or SNMP queries to monitor the device. If the device speaks SNMP, InterMapper will use the SNMP MIB-II probe to query the device. If not, InterMapper will ping the device and report if it ever goes down.
    • SNMP MIB-II The SNMP MIB-II probe monitors traffic on routers, switches, etc. It works with nearly all network gear from different vendors.
    • Network Devices There are many probes for monitoring various other equipment, such as Cisco, Apple, APC and other UPS vendors, and other equipment.
    • Servers-Standard Standards-based servers, such as mail, web, LDAP, Radius, DNS, etc.
    • Servers-Proprietary Vendor-specific probes for Apple, Barracuda, Big Brother, FileMaker, Lotus, and many others.
    • Miscellaneous Nagios, legacy probes, etc. along with other bundles of probes for wireless and other gear.
    • WMI These command line probes retrieve information from Windows servers and workstations using Windows management Instrumentation. WMI probes will only be available on a Windows InterMapper installation.

For a comprehensive list of probes with descriptions, see the Probe Reference.

To choose and configure a probe:

  1. Choose a section - In the left pane, click plus (+) to expand the section and subsections to view the probes. Click minus (-) to collapse an expanded section or subsection.
  1. Choose a probe - In the left pane, click a probe within a section or subsection to select it. The description and options for the probe appear in the right pane.
  1. Set the probe's options - In the right pane, enter or select the options you want to use with the selected probe. These options vary, depending on the probe. Click Default to reset the probe's options to the default settings.
  1. Click OK to choose the probe.

Additional actions available from the Set Probe window:


Import a probe - click this button and select from a standard file dialog to import a probe file.


Reload probe list - click this button to reload the list of probes found in the InterMapper Settings/Probes folder.

More Probes...

Click this button to launch your browser and view a list of probes contributed by InterMapper users. These probes can be downloaded and imported.

Basic Probes

InterMapper comes with a set of utility probes that serve a great number of uses. These probe types are described below:

  • Automatic Probe - uses SNMP or IP pings as available
  • Map Status Probe - link to another map.
  • Ping/Echo Probe - tests a device using ICMP echo packets.
  • SNMP Traffic Probe - retrieves system and traffic information from a device.


Automatic Probe

InterMapper first tries to use the Simple Network Management Protocol (SNMP) to communicate with the device. If SNMP is enabled and a SNMP response is received, the probe type automatically changes to "SNMP Traffic" and InterMapper continues to poll the device using SNMP.

If InterMapper is unable to elicit a SNMP response after a number of attempts, the probe type automatically changes to "Ping/Echo" and InterMapper continues to test for basic connectivity.

Map Status Probe

Use the Map Status probe to place an icon in a map which represents the status of another map. Use the Map Status probe to place an item on your map which represents another map. You can use this probe to hide map detail by creating "sub-maps".

The device shows the current state of the most serious condition on the sub-map.

Ping/Echo Probe

For IP devices, this probe sends an ICMP Echo Request to the device's address.

The data area in an Echo packet is 20 bytes long and contains the version of InterMapper that sent the request. The data area is configurable in the probe.

SNMP Traffic Probe

This probe retrieves system and traffic information from a device. The information comes from the system and interfaces groups of SNMP MIB-II.

To view traffic (bytes/second, packets/second, errors/minute) for any interface, right-click a link attached to the interface, and choose Status Window.

The device's status window shows sysLocation, sysContact, and sysUptime from the system group.

Note: The SNMP Traffic probe was formerly known as SNMP MIB-II in earlier versions. It was renamed to reflect its purpose more accurately.


3. Status Windows and Strip Charts

Viewing Status Windows

InterMapper shows detailed status about any item on a map (a device, a network, or a link) in a Status window, as shown in the Device Status window below.

To view device, network, or link status:

  1. Make sure your map is in Monitor mode (click the pencil at the upper left of map window until there is a slash through it, or press the Tab key.)
  2. Click and hold a device, network, or link on the map, or right-click the device, network, or link, then choose Status Window. The Status window for the selected device appears.
  3. Release the mouse button to hide the Status window.

To keep a Status window open:

  1. Make sure your map is in Monitor mode.
  2. Click and hold the device, network, or link on the map.
  3. Drag to a new location. As you drag, the cursor (Windows) or a transparent window appears.
  4. Release the mouse. You have "torn" the window off; it remains open, located where you released the mouse.

Customizing a Status Window

If you are using a custom TCP or SNMP probe, you can override the default contents of a Status window. For more information, see Custom Probes and Customizing Status Windows in the Developer Guide.

Device Status Window

  • Click and hold the mouse on a device to open its device status window, or right-click the device and choose Status Window.
  • Click and drag to tear the window off and leave it open.
  • Click the underlined Reset link to set Packet Loss to zero. This also resets the device's availability measurement.
    Note: The map must be in Edit mode to reset the Packet Loss value.

The window shows the device name, network address, device status, the probe used to poll it, up-time (i.e., SNMP sysUptime, if available), availability (the percentage of the time the device was available based on the number of packets lost while testing), round-trip time (in msec), and spanning tree status (if available), and probe-specific information.

When the device reports a problem, the reason for the most important error is shown in red at the bottom of the Status window.

Network Status Window

  • Click and hold the mouse on a network oval to open its network status window, or right-click the network and choose Status Window..
  • Click and drag to tear the window off and leave it open.

The network status window shows the network's IP address and subnet mask, (if available) and information about the amount of traffic flowing on that network segment. This data comes from all the SNMP devices attached to that network

  • Top Tx - tells which device is transmitting the most data
  • Top Rx - tells which device is receiving the most data
  • Top Err - tells which device is reporting the highest error rate for the link
  • Sum In/Sum Out - the sum of all the transmitters and receivers connected to that network.

Note: The traffic statistic shown are only for devices connected to this network that speak SNMP: Ping/Echo, or TCP-based devices (such as HTTP, FTP, etc. probes) do not have this information and are ignored when computing the sums and maximums displayed in the Status Window.

Link Status Window


  • Click and hold the mouse on a link, or right click the link and choose Status Window. to open its link status window.
  • Click and drag to tear the window off and leave it open.

The link status window shows the link's interface name and description, its type (10 or 100 Mbps, 1.5 Mbps T-1, etc.), its status and up-time, its IP, AppleTalk, and MAC addresses (when available), traffic statistics (transmitted from and received by the interface), and the time since the last poll.

Tip: Certain devices do not report their link speed accurately in their SNMP responses. This causes InterMapper to report a value which is not actually correct. To work around this, switch the map to Edit mode, then right-click the link and choose Set Link Speed... The Set Link Speed window appears, allowing you to set Transmit and Receive speeds.

Strip Charts

InterMapper strip charts display the history of one or more variables. This information can also be saved to a log file for further analysis.

To create a strip chart:

  1. Open one of the status windows as described above.
  2. Tear the status window off to create a new window.
  3. Click on any of the underlined values. If the underlined value appears any existing strip charts, a list of charts appears, along with a Create Chart option.
  4. Click Create Chart. A new strip chart appears.
  5. To add variables to the strip chart, drag their underlined values to the chart. The example below shows a typical strip chart.

A strip chart showing two traces.

Using Strip Charts

InterMapper displays historical information in a strip chart. Strip charts can hold an unlimited number of data sets for an unlimited time period. These data can also be written to a tab-delimited text file.

A strip chart is a persistent window that belongs to a particular map. All the data that is displayed in a chart must come from devices or links of that map.

A strip chart showing two data sets.

  • Labels, axes, time intervals, other options - The figure above shows a strip chart with two variables. You can control its labels, axes, options, and time intervals, as described in the pages of this section.
  • View and hide charts - You use the options available from the Charts Menu to view and hide strip charts.
  • Chart Options menu - You use the options available from the Chart Options menu to view and edit the parameters which control content and appearance of each strip chart.
  • Logging Chart Data - You can also specify the file that logs the chart's data, and control options for creating new chart log files. For more information, see Chart Log Files.

Viewing and Hiding Strip Charts

You view and hide strip charts using the Charts command in the View menu or by selecting options from the Charts menu at the bottom left of the chart's window..

To show an existing strip chart:

  • From the Windows menu, choose the chart you want to view by selecting it from the Charts submenu.
  • Click the  button in the tool bar to view a list of charts associated with the map. Double-click a chart to view it.
  • Right/Ctrl-click the button in the tool bar to view a dropdown menu of charts associated with the map without changing to the Chart List view. Choose a list from the dropdown menu.
  • Right/Ctrl-click a chart in Chart List view and choose Show Chart.

To hide a chart:

  • Click the chart's close box. The chart is hidden, but the chart's data is preserved, and continues to be collected.

To scroll the strip chart:

  • Drag the chart's background to scroll the chart right or left.

Creating and Adding Data Sets to Strip Charts

To create a strip chart:

  1. Open and tear off a status window by clicking and holding on a device, link or network, or Right/Ctrl-click the item and choose Open Status Window.
  2. Click on any underlined value. A new chart is created, and the data immediately appears in that chart. 

    Note: You do not need to make the map editable to create a strip chart.

To add a dataset to an existing strip chart:

  1. Open a Status window.
  2. Drag an underlined value (blue or grey) from a status window into the strip chart. The variable is added to the strip chart.

*The same dataset may appear in more than one chart but it will only be saved to disc once.

Editing Strip Charts

You edit the parameters that control a strip chart's content and appearance from the Chart Options window, available from the Strip Chart menu.

Deleting Strip Charts

You delete strip charts using the Strip Chart menu.


InterMapper provides three menus you can use to view and edit strip charts.

The Charts Menu


Use the Charts menu to view and hide strip charts.

To show all charts:

  • From the Charts submenu of the Windows menu, choose Show Charts. All defined charts for the current map appear.

To hide all charts:

  • From the Charts submenu of the Windows menu, choose Hide Charts. All defined charts for the current map disappear.

To view an individual chart:

  • From the Charts submenu of the Windows menu, choose the chart you want to show. When the chart is visible, a checkmark appears in the submenu next to the chart name, as shown at the right.

    Note: From the Charts list window, select one or more charts, then right/Ctrl-click a selected chart line and choose Show Chart.

The Strip Chart Menu

To view the Strip Chart menu:

  • Click the icon in the lower left to access the Strip Chart dropdown menu.


The Strip Chart dropdown menu.

  • Right/Ctrl-click in the strip chart's data area.

The Strip Chart dropdown menu appears.

  • Chart Options - Choose this option to view and edit parameters for the current chart. For more information, see Chart Options.
  • Delete Chart - Choose this option to delete the current chart and its data.
  • Log File - Choose this option to create a log file to receive the data for the current chart.
  • Show Legend - Choose an option from the Show Legend submenu to place the chart's legend at the top, bottom, or to hide the legend completely.
  • Edit Chart - If the map is not in edit mode, this is the only option available. Choose this option to edit the chart and view the Strip Chart dropdown menu.

The Time Interval Menu

Use the Time Interval dropdown menu, located next to the Strip Chart dropdown menu icon at the lower left corner of the Chart window to set the time between the tick marks on the strip chart's horizontal axis.


Chart Options

Use the Chart Options window to view and edit the parameters that define a strip chart's appearance and content.

The Chart Options window is available from the Strip Chart menu. or by right-clicking within the strip chart window.

Applying Changes In the Chart Options Window

Use the Apply button to apply changes to a chart. Here are some things you should know about using the Apply button:

  • Click Apply to apply changes you have made on any of the tabs, without closing the Chart Options window.
  • Click Cancel to undo any changes you've made and applied.
  • Click OK to apply any changes and close the window.
  • Close the window to save any changes you've already applied.

Setting the Chart Title

The chart's title appears in the Charts menu and in the chart's title bar. Enter a title in the Title box.

Vertical Axis Tab


Vertical Axis Tab parameters

  • Label - Enter a label for the vertical axis of the chart.
  • Prefix - Select a prefix for the data displayed in the chart. InterMapper automatically scales the values to match this prefix, and inserts the prefix into the vertical axis label. (example: "volts" would become "µ-volts".
  • Upper Bounds, Lower Bounds - Enter values to control the vertical scale of the chart. The range of values depends on the variable being monitored.
  • Auto-adjust - Select or clear the Auto-adjust check box to choose whether to allow InterMapper to adjust the scale of the chart automatically. If the Auto-adjust check box is checked, the upper and/or lower bounds are adjusted automatically so that data points are always displayed, no matter how much they increase or decrease.
  • Dividers, Sub-Dividers - Click the up- and down-arrows or enter a number of dividing lines to set the number of horizontal dividers and to set the number of sub-dividers you want to appear between the dividers. 

    Example: To divide a chart into 10 parts, you'll need eleven dividers. You can do either of the following:
    - Set the number of dividers to 11, with no sub-dividers.
    - Set the number of dividers to 3, and the sub-dividers between each divider to 4.
  • Scale - Click to choose Linear or Logarithmic. scaling of the displayed values. When you choose Logarithmic scaling, you can set the Y-axis labels to powers of 10 by setting the desired upper bound and lower bounds, then adjusting the number of dividers to match. A lower bound of zero is converted to 1.

    Example: To create a log scale with labels of 3000, 300, 30, and 3:
    - Set the upper bound to 3000
    - Set the lower bound to 3
    - Set the number of dividers to 4

Time Axis Tab


Time Axis Tab parameters

  • Show Date, Show Day of Week, Show Time, 24 Hour Time - Check or clear these boxes to specify which labels appear on a strip chart's horizontal axis by default.
  • Sub-Dividers - Click the up- and down-arrows to specify the number of unlabeled vertical sub-dividers to draw between data points.

Data Tab

The Data tab shows a lists of data sets used in the current chart. Use the Data tab of the Chart Options window to export a data set, to remove it from the chart, or to edit the appearance of a data set's legend.

The Data tab of the Chart Options window

To remove a data set from the chart:

  1. In the list of data sets, click the data set you want to remove from the chart.
  2. Click Remove. The data set disappears from the list.

To export a data set:

  1. In the list of data sets, click the data set you want to export.
  2. Click Export. A standard file dialog appears.
  3. Enter a filename, choose a location, and click Save. A tab-delimited text file is created, with one data value per line. 

Exporting a dataset may take some time and will interrupt polling for large datasets.

To edit the appearance of the legend for a data set:

In the list of data sets, double-click the data for the set whose legend you want to edit. The edit window for the data set's legend appears:

  1. Click the Color rectangle and choose a color for the data set.
  2. Choose a line style for the data set from the Style drop-down menu.
  3. Choose a highlight icon for the data set from the Highlight drop-down menu.
  4. Edit the chart's title in the Title text box.
  5. Click OK to save your changes.

To delete a range of data from a data set:

  1. In the list of data sets, click to select the data set containing the data you want to delete.
  2. Click Delete. The Delete Data window for the data set appears.

  3. Set the date and time. Data before this date and time are deleted from the data set.
  4. Click OK. The specified data is deleted from the data set.

Colors Tab

Use the Colors tab of the Chart Options window to define the colors for various parts of the chart.

  • Exterior - Click to set the color of the chart's background, outside the data area. Click the check box to use the color.
  • Interior - Click to set the background color for the data area of the chart.
  • Frame - Click to set the line color for the frame of the data area.
  • Text - Click to set the color for the chart's text.
  • Horizontal Dividers - Click to set the line color for the chart's horizontal dividers. Click the check box to use the color.
  • Vertical Dividers - Click to set the line color for the chart's vertical dividers. Click the check box to use the color.

To change a color:

  • Click a color box in the window above to set the color. Use the system color picker to select a new color.

4. Alerts and Notifiers

InterMapper can send many different kinds of notifications to alert the network manager of problems in the network. An entire map can be configured to use a default notifier (or set of notifiers), and then individual devices can have customized notifiers.

What is a Notifier?

Think of a notifier as a little "robot" that watches the state of one or more devices, and performs a specified action when the device changes to a certain state. The action is called a notification.

You can attach notifiers to a device, and then specify which states (down, up, warning, alarm, critical) should trigger the notifier. When a device changes to that state, the notifier triggers, and InterMapper sends the notification.

For example, you can create a notifier that sends an e-mail message. You then attach that notifier to a device. You might also specify that it should be triggered when the device goes down or comes back up. When the device goes into either of those states, the e-mail would be sent.

Notifier Types

There are several types of notifiers; each uses a different method to send a notification:

  • E-mail - sends an e-mail
  • Alphanumeric Pager - sends a page through a dial-up modem using the TAP protocol.
  • Network Paging - sends a page across the Internet using the Simple Network Paging Protocol (SNPP).
  • SMS Alert - sends a text message to a cell phone via SMS.
  • Sound - plays a sound associated with the state of the device.
  • SNMP Trap - sends an SNMP trap to the specified trap receiver
  • Syslog - sends a message to a syslog server
  • WinPopup (Windows only) - sends a message to the specified user. The message appears in a separate window.
  • Command Line - executes a command on the InterMapper host machine.
  • Group - sends notifications to a group of existing notifiers.

What You Can Do With Notifiers

  • The Notifier List (Available from the Server Configuration section of the Server Settings window) is a library of notifiers you have created.
  • You create a notifier from the Notifier List (Server Settings panel), the Default Notifiers dialog (Map Settings window), or the Notifiers window.
  • You configure the notifier, then test it to make sure it's working properly.
  • You attach a notifier to a device using the Attach Notifier dialog.
  • You remove a notifier using the Notifier List.
  • You define a set of default notifiers using the Default Notifiers dialog. When you add a new device to a map, the default notifier set is attached to the new device automatically. (You can also create and attach notifiers to individual items.)
  • You attach notifiers only to devices, not to networks.

Parts of a Notifier


Notifier Name

This is a human-readable description of the notifier. It's useful to include the type and recipient in the name, e.g., "Network Techs via email" or "Syslog to Main Logger"


Notifier Type

There are many notifier types - e-mail, sounds, traps, etc. - as listed above. Each notifier you create will cause some kind of notification or alert, depending on its parameters.


Notifier Parameters

The parameters of a notifier indicate the recipient or the action to be performed. Parameters can specify an e-mail address, a sound file to play, the address of a syslog or trap server, a pager account, or a script or program to run. Each notifier type determines its parameters.


Notifier Schedule

Each notifier has a schedule associated with it. The schedule specifies the days of the week, and the hours of each day during which a notifier should send notifications. If the event happens outside the schedule, no notification will be sent.

About the Notifier List

The Notifier list is a library of notifiers that you can attach to different devices on your map. It is available from the Server Settings window. You create, configure, edit, remove, and disable notifiers from the Notifier list. Once you have created and configured the notifiers you want to use, you can attach them to devices.

Occasionally, you may be about to attach a Notifier, and discover that you need to create a new one before you can attach it. You can quickly open the Notifier list from the Notifiers window, and create a new notifier.

How Notifications Get Sent

When an event occurs, for example, when a device changes to a new state (Up to Down, Warning to Alarm, Alarm to OK) InterMapper triggers the attached notifiers that apply to that new state. The notifier then sends a notification, as defined in its parameters, to the specified target users as defined by the notifier schedule.

Working With Notifiers

You create and configure notifiers in the Notifier list. You attach notifiers to devices in the Notifiers window.

Using the Notifier List

Notifier List window. The Default Sounds are built-in.

Use the Notifier List to view a list of all notifiers defined for all open maps. You can also use the Notifier List window to:

  • Add new notifiers
  • Edit existing notifiers
  • Copy existing notifiers
  • Remove a notifier
  • Activate or deactivate a notifier

To view the Notifier List:

  • From the Server Settings window's Server Configuration section, choose Notifier List. The Notifier List appears.

To add a notifier:

  1. Click Add... The Configure Notifier window appears.
  2. Configure the notifier and click OK.

To edit an existing notifier:

  1. Click to select the notifier you want to edit.
  2. Click Edit... The Configure Notifier window appears, showing the current configuration of the selected notifier.
  3. Edit the notifier's configuration, and click OK.

To make a copy of an existing notifier:

  1. Click to select the notifier you want to copy.
  2. Click Duplicate. The Configure Notifier window appears, showing the current configuration of the selected notifier.
  3. Edit the notifier's configuration, and click OK.

To remove a notifier:

  1. Click to select the notifier you want to remove. 
  2. Click Remove... A confirmation dialog appears.Click Remove. The selected notifier disappears from the Notifier List.

To activate or deactivate a notifier:

  • Select or clear the check box to the left of the notifier's name in the notifier list. When deactivated, the notifier never triggers. This is useful for vacation periods or other times when you don't want the notifier to be used.

Defining Default Notifiers

You can create one or more notifiers that, by default, are attached to every new device you create. When the status of the device changes to a specified state, the notifier sends a notification automatically.

InterMapper ships with one default notifier, called "Default Sounds." It plays a default sound when a device goes down, and another sound when the device comes back up.

To create a set of default notifiers:

  1. From the Edit menu, choose Map Settings... The Map Settings window appears.
  2. Click Edit Default Notifiers...The Default Notifiers window appears, showing a list of defined notifiers, with a column containing a check box for each possible device state.
  3. For each notifier you want to attach to all new devices, select the check box for each state you want to trigger that notifier.
  4. When finished, close the Default Notifiers window. The specified notifiers are automatically attached to each new device added to your map.

Note: Changing default notifiers does not change existing notifiers attached to existing devices; it applies only to newly added devices.

To change all notifiers on a map:

  • Select all items on the map, then open the Notifiers window from the Monitor menu. Any changes you make apply to all selected map items.  

Attaching a Notifier to a Device

You can attach one or more notifiers to any device. For each notifier, you can choose which states trigger a notification to be sent. For example, a particular device might have a notifier send an e-mail when a device goes down, but can have a second notifier that plays sounds when the same device goes down, comes up, or enters an alarm state. You might also send an e-mail to an on-site system administrator during the day, and to a different administrator outside business hours.

To attach a notifier to an item:

  1. Select one or more devices.
  2. From the Monitor menu, choose Notifiers Window. The Notifier Settings window appears, containing the notifiers currently attached to the selected item as shown below.
  3. Select or clear the check boxes for the device states you want to trigger the notifier. A notification is sent when the device's state changes to any of the selected states. 

Notifier Settings window

Note: You can create a new notifier from the Notifier Settings window. The "Edit Notifiers..." button is a shortcut to the Notifier List in the Server Settings page.

Using the Delay, Repeat, and Count parameters

For each notifier, you can specify DelayRepeat, and Count parameters. These parameters can be used to control how quickly and how frequently notifications are sent. For example, to avoid unnecessary pages you might configure a notifier to wait until a device has been down for two minutes before sending the first page. You might also choose to re-send a notifier every 10 minutes forever. Notifications are sent until the count is reached, or the device has been acknowledged.

How Delayed Notifiers work

InterMapper maintains a queue of notifications to be sent. When a DOWN, WARN, ALARM or CRITICAL event happens, InterMapper places a notification in the queue, and sets its "time to be sent" according to the delay. (UP, OK and Trap notifications are never delayed.)

When an UP or OK event occurs, InterMapper first searches the notification queue for the corresponding down, warn, or alarm notification. If it's there, InterMapper removes both the DOWN (or Warn or Alarm) notification and UP (OK) event and won't send either one. If not, then InterMapper sends the UP/OK notification straight away.

Notification Escalation

You can use notifiers to implement a problem escalation system by creating two or more notifiers for a device. The first notifier can fire quickly to alert someone immediately. A second notifier can be delayed for a period of time, perhaps 30 minutes or an hour, before notifying a second person. If the problem remains when the second notifier's delay time is reached, the second notification is sent. As soon as a problem is acknowledged, no further notifications are sent, even if the outage lasts a long time.

Configuring A Notifier


Enter a name in the Name box. The name can be any can be any descriptive text string.

Tip: If the notifier is active only at certain times of the day or week, you may want to include a description of the time period as well. For example, you could assign names like "Weekend Pager" and "Second Shift Pager" to notifiers that had those time schedules.

Notifier Type

From the Configure Notifier window's Notifier Type dropdown menu, choose a notifier type. For more information, see Notifier Types at the top of this topic.

Scheduled Hours

Select a range of hours during which this notification should be sent.

To set a range of hours:

  • Click and drag across a range of hours.

To add or remove hours from the schedule:

  • Click an individual cell to make it active or inactive.

To activate or deactivate all hours in the schedule:

  • Double-click the Active Hours legend to activate all hours in the schedule.
  • Double-click the Inactive Hours legend to de-activate all hours in the schedule.

To edit the message sent with the notification:

  • Click Edit Message... The E-mail Notification page shows the editing interface.

Test Notifier

  • In the Configure Notifier window, click Test Notifier. The notification is sent immediately, with the state defined as "Test."

Once you have created notifiers, you may attach them to all devices (the default notifier is used for all new devices) or to one or more devices.


A typical notification schedule. In this example, an e-mail notification is sent to "tommy@company.net", at any time -- 24 hours per day and 7 days per week.

The window above shows the Configure Notifier window.

  • Use the left side of the window to choose the type of notification, and to set the notifier parameters.
  • Use the right side of the window edit the schedule during which the notification can be sent.

When you select the type of notifier from the Notifier Type dropdown menu, the left pane changes to show the parameters required for the selected notifier type.

Removing a Notifier

You can remove a notifier from the Notifier List window.

To remove a notifier:

  1. From the Edit menu, choose Server Settings... The Server Settings window appears, with a list of settings in the left pane.
  2. From the Server Configuration section of the settings list, choose Notifier List. The Notifier List window appears.
  3. Click to select the notifier you want to remove.
  4. Click Remove... A confirmation dialog appears.
  5. Click Yes. The selected notifier disappears from the Notifier List.

Configuring a Sound Notifier

A sound notifier plays a sound whenever a device enters a new state. For each state, you can assign a different sound.
The Configure Notifier window for Sound notifier type. For each device state, you can select a different sound.  

To configure a sound notifier:

  1. Create or edit the notifier you want to configure.
  2. In the Notifier Type dropdown menu, choose Alert by Sound if it is not already chosen. The Sound Notifier configuration panel appears as shown in above.
  3. For each state, use the Sound Name dropdown menu to choose the sound you want to play when the device changes to that state. If you do not want sounds to play for certain states, set those states to None. The states are described below.
  4. If the sound you want to use for a particular state does not appear, click Import Sound... to import a sound file containing the sound you want to use.


  • On Windows machines, the available sounds are located in the InterMapper Settings/Sounds folder.
  • On Mac OS X machines, the available sounds include any system sounds or the sound files in /System/Library/Sounds folder, as well as those in the /InterMapper Settings/Sounds folder.
  • Supported sound file formats: .WAV, .AIF, and .AU.
  • InterMapper RemoteAccess must download each sound file from the InterMapper server, but once it is downloaded it is cached on the remote machine. Bear in mind that large sound files may affect system performance for remote users.
  • Sounds are queued up for playing. One sound does not start until the previously queued sound is completely finished playing. Relatively short sound files are recommended.

Device States

  • Up - Plays a sound when a device responds normally after being down.
  • Down - Plays a sound when a device goes down (fails to respond to InterMapper's queries.)
  • Critical - Plays a sound when a device enters Critical state.
  • Alarm - Plays a sound when a device enters Alarm state.
  • Warning - Plays a sound when a device enters Warning state.
  • OK - Plays a sound when a device is no longer in critical, alarm, or warning state.
  • Trap - Plays a sound when InterMapper receives an SNMP trap from the device.

Default sound notifiers

InterMapper uses these default sound notifiers:

  • Down - plays the Klaxon sound
  • Up - plays the Yahoo sound
  • All other states are set to None.

What you can do with sounds

You can use sounds in many different ways to help give you audible indicators the condition of your network. Here are two possible uses for sound notifiers.

  • Create different sound sets for different times of day, or for different days - create different sound notifiers, each having a different notifier schedule. This can be helpful if you need to, for example, use certain notification sounds during working hours in a busy office, and have louder, more easily distinguishable sounds outside working hours, when you are working away from your computer.
  • Create different sound sets for certain devices - create sound notifiers for certain kinds of devices, and use different sounds. You can tell without looking if, for example, a certain machine or router goes down. It is also useful if you been having trouble with a particular device.

Sound files must be placed in the InterMapper Settings/Sounds folder before they can be made available in the Server Configuration Notifier List panel of the Server Settings window.

These sound file formats are supported:

  • AIF
  • WAV
  • AU


Configuring an E-Mail Notifier

Use an e-mail notifier to send an e-mail message to one or more recipients. The e-mail message can provide detailed information about the device that triggered the notifier. The example below shows the Configure Notifier window for the E-mail notifier type.


Configuring an e-mail notifier.

To configure an e-mail notifier:

  1. In the Configure Notifier window, choose "Electronic mail (SMTP)" from the Notifier Type drop-down menu.
  2. In the Address box, enter the e-mail address you want to receive the notification. You can enter multiple addresses, separated by commas, spaces, tabs, newlines, or carriage returns.

Note: E-mail is sent using an outgoing SMTP mail server. Before InterMapper can send e-mail notifications, you must specify the SMTP host you want to use for sending e-mail notifications. For more information on how to specify your outgoing SMTP mail server (and a backup server) see E-mail Preferences.

Editing the Text of an E-mail Notification Message

Edit E-mail Message window, showing the default e-mail message.

An E-mail notifier sends a text message that describes the failure.

Use the Edit Message window to edit the message sent by the notifier. The example below shows the Edit E-mail Message window containing the default e-mail message. The list at the lower left contains variables you can substitute in the text.

Double-click an item to insert it into the message text. When the notification is sent, the inserted item is replaced with its current value in the message text.

Subject :
<Device Name>
Message from InterMapper <Version>
Event: <Event>
Name: <Device Name>
Document: <Document Name>
Address: <Device Address>
Probe Type: <Probe Type>
Condition: <Device Condition>
Time since last reported down: <Last Down>
Device's up time: <SysUpTime>

Using Group Notifiers

InterMapper can group notifiers together so that a transition to a particular device state sends multiple notifiers, even of different types, for that event.

To create a Group notifier:

  1. Select Group from the Notifier Type dropdown menu. A set of currently-defined notifiers appears, with a check box next to each.
  2. Check the appropriate boxes in the list.

How it works

When the Group notifier is invoked, InterMapper first checks the time schedule. If the time is applicable, InterMapper invokes each of the checked notifiers. They in turn check their schedules, and send the notification if desired.


  • It is normal for a group notifier's schedule to be 24 x 7, so that the underlying notifiers will govern when they are sent.
  • When attaching a group notifier to a device, leave its component notifiers' boxes unchecked. Otherwise, duplicate notifications are sent (once for the group and again for the component).

Configuring a Syslog Notifier

Syslog is a mechanism for recording information about significant events into a log file. It originated on Unix hosts which wrote the information to a local file (the system log file). This was later enhanced to write the data across a network to a server that collects the entries.

InterMapper can send a syslog message as a notification. That is, when an event occurs, InterMapper can write the data to a specified syslog server on the network.


Syslog Notifier Parameters

Send syslog messages to: - the IP address or DNS name of the syslog server that should receive the message

Facility: - The syslog server administrator may specify that messages from a particular source be tagged with a certain facility code. Select the facility requested by your administrator.

Severity: - Syslog messages can be tagged with a severity, so that the syslog files can be scanned for entries with different priority. Select the desired severity from these choices:

  • Emergency
  • Alert
  • Critical
  • Error
  • Warning
  • Notice
  • Informational
  • Debug

Edit message... - You may enter the format of the syslog message. Newline characters will be converted to spaces, so the message will appear as a single line. Syslog messages will contain "InterMapper" as the syslog tag.

Using Notification Dependencies

InterMapper can block or suppress notifications for devices that are "behind" or "shadowed by" another failed device. This helps you avoid receiving dozens (or hundreds) of notifications for devices that don't respond because there is a router or link down between InterMapper and that device.

This feature is called dependencies, because InterMapper can suppress the notifications for other devices that depend on the failed device.

There's no need to set the dependencies manually between devices on a map. Instead, InterMapper follows the links that are already part of the map.

To enable dependencies, you set a Vantage Point. The Vantage Point indicates the position from which InterMapper views the network. You usually set the Vantage Point on the actual device where InterMapper is running. Once you've set the Vantage Point, InterMapper can determine which devices are dependent on which other devices.

Example 1: All devices are up

The example below shows a map with several interconnected routers. The yellow star on the InterMapper icon shows that it is the map's vantage point.


Example 2: One device is down, shows dependent devices

In this example, Router2 has failed. InterMapper will send the normal notifications for Router2, but it will suppress notifications for any of the devices that depend on it. Those dependent devices' icons are dimmed on the map to show they're being shadowed by the failure.


Setting a Vantage Point

A Vantage Point.
Notice the star 
on the item.


To set a map's Vantage Point:

  1. Make the map editable.
  2. Select the device or network you want to use as the Vantage Point.
  3. From the Monitor menu, choose Set Vantage Point .

  • When the map is editable, control-click a device or network, then choose Set Vantage Point from the dropdown menu. A small star appears next to the item, as shown here.

Moving and Removing a Vantage Point

You may remove a Vantage Point or move it to a new item.

To move a Vantage Point to a new item:

  • Set the Vantage Point to the new item as described above.

To remove a Vantage Point:

  1. Select the item to which the Vantage Point is currently assigned.
  2. From the Monitor menu, choose Remove Vantage Point.

  • Control-click the item to which the Vantage Point is currently assigned, then choose Remove Vantage Point from the dropdown menu. A star next to the item disappears, and no Vantage Point is set. Notifications are sent for all map items.

How Dependencies Work

When a device goes down (when no response has been received from it), InterMapper uses the dependencies to determine whether to suppress the notification. Starting at the Vantage Point, InterMapper follows the links toward the device in question.

If the only path to that device passes through a device, link, or interface that's already down, InterMapper knows that the device is shadowed, dims its icon, and suppresses the notifications.

If there is no failure along the path, or if there is no path at all (functional or not) to the device, InterMapper allows the notification to go through.

Even though a device is shadowed (and its notifications are suppressed), InterMapper continually probes the device to show its status.

Acknowledging Device Problems

Use the Acknowledge command, available from the Monitor Menu, to acknowledge failures or problems in the network. When you acknowledge a problem, the InterMapper program does the following:

  • Device turns blue - Changes the device's icon color to blue to show that the problem has been acknowledged.
  • Alerts stop - Stops further notifications of the problem, either for the duration of this outage, or for a specified time period.
  • Logs a comment - Writes any comment you enter into to the Event Log file, along with the name and IP address of the user who acknowledged the problem.
  • Comment in Status Window - Displays the comment in the device's Status Window.

Why are Acknowledgements useful?

Acknowledgments allow the network administrator to see the state of the network, as well as the responses that have been made to the current set of problems.

Acknowledging a problem

To acknowledge a problem with a device:

  1. Click the device(s) you want to acknowledge.
  2. From the Monitor menu, choose Acknowledge... (Cmd-' or Ctrl-'). The Acknowledge window appears.
  3. If you want keep the device in Acknowledgement mode for a specific period of time, or for an indefinite period, choose Indefinite or Timed... in the Ack column.
  4. If you want to suppress notifications for devices that depend on this device, click to select the Block notifications for dependent devices check box.
  5. Enter a comment, then click Acknowledge. The selected device's icon changes to blue, and your comment is written to the Event Log file. Notifications are cancelled for the selected device for the duration of this outage.

Basic, Timed and Indefinite Acknowledgements

InterMapper offers three kinds of acknowledgements:


The device is acknowledged, and notifications are suppressed until it gets better or worse. The icon turns blue to indicate that someone has taken responsibility for it, and that no further notifications will be sent.

As soon as the device's state changes to any other status, its acknowledge status is automatically cleared, and notifications resume. From then on, notifications are sent for any subsequent failures.

Down, with Basic Acknowledgement


The device is acknowledged, and notifications suppressed for the specified period of time. The icon turns blue (if it's not okay), and the wrench badge appears to show that notifications will be blocked for the specified time. In this case, the state of the device is OK.

Up, with Timed Acknowledgement


The device remains acknowledged until the operator unacknowledges it.

As with the Timed acknowledgement, the icon turns blue and the wrench badge appears to remind the operator that notifications are suppressed. In this case, the device is DOWN.


Down, with Indefinite Acknowledgment

Note: With timed and indefinite acknowledge, you can acknowledge a device even when it is up and okay (i.e., green). This is useful if you know that there may be future outages (for example, planned maintenance) with the device, and you want to avoid extraneous notifications. You cannot do this with Basic Acknowledge.

Note: The presence of the wrench badge is a safety measure. When you scan the map visually, the wrench indicates devices whose notifications are currently being blocked.

Acknowledgements and Dependencies

When you acknowledge a device, use the Block notifications for dependent devices check box to specify whether the acknowledged device should be considered in finding dependencies. Checking the box suppresses notifications for any device "on the other side" of the device being acknowledged.

To suppress notifications for all devices that are dependent on the selected device:

  • Check the Block notifications for dependent devices box. Notifications are suppressed for any device that depends on the selected device.

For more information on dependencies and dependent devices, see Using Vantage Points.

Unacknowledging a Device

Use the Unacknowledge command to restore the device to its current notification state.

To remove the acknowledgement for a device:

  1. Click to select the device, or choose multiple devices.
  2. From the Monitor menu, choose Un-Acknowledge. The selected devices are returned to their current notification states, and their notifications are no longer suppressed.

5. Using InterMapper Reports


Use the InterMapper Reports server to create, view, print and save reports that use data collected from InterMapper servers.

InterMapper Reports is a module of InterMapper DataCenter. Use your favorite browser to use InterMapper Reports to create your reports.

Note: Before you can use it, you must start the InterMapper Reports Server. This allows InterMapper to send data to the Reports Server where it is collected in a database.

To start collecting data:

  1. From the Server Settings window, choose Reports Server. The Reports Server pane appears.
  2. From the Reports Server pane, click Start. The Configure button becomes active.

To view the Reports Server interface:

  • From any InterMapper map, right-click a device and choose Reports... A browser page launches and the InterMapper Reports window appears.

Creating A Report

Use the Reports Server web UI to create, save, load, link, or print a report.

You can open the InterMapper Reports window from an InterMapper map.

Opening the Reports Window

To open the InterMapper Reports window:

  1. Select a device in an InterMapper map window.
  2. Right-click the device and choose Reports... The InterMapper Reports window appears in a new browser window as show below.


Two other ways you can also open the Reports window:

  • Use this URL:

        https://[InterMapper Server address]:8182/~imreports/
  • From the Server Settings window, view the Reports Server pane, and click Configure, log in to the InterMapper DataCenter, and click View Reports in the InterMapper Reports box.

Creating the Report

There are several ways to create a report:

  • From the Map Window - open the Reports window after selecting one or more devices or interfaces.
  • From a template - a number of pre-configured templates are available.
  • From scratch - using an empty template. Select your own devices or interfaces, the data you want to show from each, any calculations you want to apply, a report period and interval, and the way in which the data is shown.

To create a new report from a template:

  1. If you haven't stored any reports, you can start with a template.
  2. From the Report window's File menu (shown at right,) choose New. The Templates list appears, as shown below.
  3. Click to choose a template from the left side of the list. A set of parameters for that template appears on the right. You can also click Saved Reports to view a list of reports that have already been saved.
  4. Choose from the template's available parameters.
  5. Click Create Report. The report loads with the selected parameters.


The Templates List

Report types

Report templates fall into two general categories:

Graph - Can be used with datasets that contain only numeric data. Three display options are available in a Graph report:

      Area - a line chart with the area below the line filled.
      Line - a line chart with a dot at each data point.
      Bar - a bar chart.

Table - a tabular report, containing columns and rows.

To create a new report from the Empty Report template:

  1. If you choose the Empty Report template, you can create a report from scratch. You can also recall an existing report to use as a starting point.
  2. Click Edit, located just below the File and Export menus. The Reports window changes to Edit mode. (The Edit button toggles the report in and out of Edit mode.)

Editing a Report

The image below shows the controls you can use to fine-tune your report definition.

Once in Edit mode, you need to answer some or all of these questions (in the areas shown above), depending on your needs:

  • Which devices? Select the devices you are interested in reporting on. You can specify what Server, Map and Device. If there is network interface data for any of the devices selected, you may select it under Interface.
  • Which data? Choose from available Datasets. Details and Event History are standard for all devices, other datasets are based on data available from your device selection.

    Note: Currently, only one dataset can be included in a report.
  • Calculations? If you have selected a Dataset other than Details and Event History, such as Response Time, you can choose from some basic calculation options. Choose MinAvg, or Max to specify how the results are displayed.

       Min shows the only lowest values for the dataset. 
       Avg averages the results (most commonly used). 
       Max shows only the highest values in the dataset. 

    The Group checkbox allows devices in your selection to be grouped as one dataset in the results.
  • Period of time? Choose a start date or date range. (Not active when Detail dataset is selected.) For other datasets, common date selections are available. When specifying a date range, the calendar indicates whether data is available from the selected date range (grayed for no data, black for data)
  • Interval? Specifies data interval, which controls the density of the data over time. 

    Note: Event History and Details datasets do not use Interval.
  • Report Type? Choose how the dataset results are displayed. By default, a Tabular report (list) is shown. When the selected dataset contains numeric values, you can also choose Area, Line or Bar chart. For Event History and Details, only a tabular view is available.

Additional Report-editing Features

Use a number of other controls to customize your report further:

  • Click the title to edit it.
  • For tabular reports, click a column heading to sort by that column; click again to reverse the sort. The sort order is saved with the report.
  • To change the order of tabular report columns, drag a column heading to move the column to the right or left.
  • To save the report, click Save from the Report window's File menu, give the report a name, and click Save Report.

Opening a Saved Report

You can save any number of reports, then open, view or print them at a later time. For more information, see Managing and Printing Your Reports  .

Selecting Source Data

When creating a report, you first need to choose the devices or interfaces for which data is included in the report.

Use the data source selection bar to select the devices or interfaces for your report.

To select data sources:

  • Click anywhere in the source selection bar shown above. A selection tree appears, as shown below.

  • Select or clear the check boxes for the devices or interfaces whose source data you want to include in the report.
  • Select the Show deleted devices & interfaces check box to include devices or interfaces that have been deleted.
  • Click the Select All or Unselect All to select or unselect all devices or interfaces in a column.
  • When finished selecting, click the source selection bar. The selection tree disappears, and the selected data appears.

    Note: If you select a large amount of data over a large time range, it may take a few moments or longer for the data to appear. This depends on a number of variables - the speed of reports server CPU, the amount of data, the time units selected.

Selecting a Dataset

To create graphs, you need to select a dataset that contains numeric values. The datasets available depend on which devices are selected, the probes used to monitor those devices, what datasets are recorded through those probes, and whether those datasets are being exported to the Reports Server database.

A dataset is available when retention policy for the selected device is not set to None and one of the following is true:

  • For devices, response time or short-term packet loss are always stored.
  • For interfaces, incoming or outgoing bytes/second are always stored.
  • If the dataset is specified in the probe to be 'autorecord' .
  • If a chart was created from the dataset by clicking it in the Status window or dragging it from the Status window to an existing chart.

To select a dataset:

  • From the Dataset dropdown menu, near the right of the device selection controls, choose a dataset. Assuming you are still in Table view, a list of values appears.

Selecting Data Grouping

Grouping by time

In most cases, the selected time scale causes each data point to represent a group of raw samples. Use the data grouping buttons to specify how you want the group of samples represented by a graph data point to be displayed.

To select data grouping for each time period:

  • Click Min to display the minimum value from the group of samples during a data point's time period.
  • Click Avg to take the average value from the group of samples during a data point's time period.
  • Click Max to display the maximum value from the group of samples during a data point's time period.

Grouping by device or interface

When multiple devices or interfaces are selected, each device or interface's dataset appears as a line or bar on the graph. The Group check box allows you to group the datasets from multiple devices or interfaces into a single dataset that shows the minimum, average or maximum value for all devices in the group over the selected time period.

To view devices or interfaces as one dataset:

  • Select the Group check box.

Selecting Columns (Table view)

In Table view, regardless of the selected dataset, use the Columns selector to choose the columns to show in the report.

Using the Page Controls

Use the page controls to choose the page of data you want to view.

  • Click the left and right arrow buttons to move to the start or end of the report or to move to the previous or next page.
  • Type in a page number to move to that page.
  • Use the dropdown selector to specify the number of results are shown on a page.

Selecting a Data Range

You can limit the amount of data from the dataset that is displayed in the report. In selecting a data range, you select data over a time range, and control the density of that data over the specified range. You do this using the Show Data From controls at the bottom of the window. Select a range of data by date, and specify the units to use (hours, days, weeks, months, etc.). Learn more about data range selection options in Data Range Options, below.

Data Range Options


Select a data in a range of time previous to today.

...to Date

Select all data from beginning of the most recent day, week, month, or year.

The time units vary with your selection.


Specific date

Select data for a specific date.

All dates before

Select all data before the specified date.

 All dates after

Select all data after the specified date.


Date Range

Select data from the specified range of dates.

Specifying Time Units

In addition to selecting a range of data over time, you can specify the units used to display the data.

Of course, the data units selected affect the time it takes to display the report. (Displaying data every 5 minutes over a year, for example, represents a large amount of data.)

Creating and Using Data Filters

You can limit the amount of data, or select specific subsets within a dataset, using Filters.

To create a filter:

  • Click the Filters button. A new filter control appears.

Filter Options

Filters generally have three parts:

  • Data field - the default value is Any Field.
  • Comparison operator - the default value is Matches.
  • Comparision value - no default value

The available values for comparison operators depend on the type of data field selected.

Data field options

This menu lists all the available fields in the dataset.

Comparison operators

(non-numeric fields)

When comparing values in non-numeric fields, a simple boolean comparison operator is available.

Comparison operators

(numeric fields)

When comparing numeric values, a number of comparison operators are available.

Multi-part Filters

You can create filters with more than one set of filter criteria.

To add a filter to an existing filter set:

  • Click the Plus button.

To remove a filter from an existing filter set:

  • Click the X button.

Choosing a Report Style

Four report styles available:

  • Table - a list-style report with rows and columns.
  • Area - a line chart with the area below the line filled.
  • Line - a line chart.
  • Bar - a standard bar chart.

Note: Area, Line, and Bar styles are available only for datasets with numeric values.

Use the report style tabs in the lower right of the window to choose a report style.

Table Report

Area Report



Line Report

Column Report

Managing and Printing Your Reports

Use the Edit button to switch between Edit and View modes.


Use the File and Export menus to create new reports, to Load, Save, to get a Link URL for distribution or to Export a report to a CSV file.


Switching to Edit Mode

To edit a report, you must be in Edit mode.

To switch to Edit mode:

  • Click the Edit button. The Edit controls appear as shown below. Click again to switch back to View mode.

Reports window in Edit mode

Loading a Saved Report

You can save any number of reports, then open, view or print them at a later time.

To open a saved report:

  1. From the Report window's File menu, choose Open. A list of saved reports appears, as shown below. Each report shows a summary of selected parameters.
  2. Click the report you want to load, then click Load Report. To create a new report instead, click Report Templates to view available templates.

The Saved Reports list

Deleting a Saved Report

You can delete a saved report from the Saved Reports list.

To delete a saved report:

  1. From the Report window's File menu, choose Open. A list of saved reports appears, as shown above.
  2. Click the report you want to delete, then click Delete. A Confirm window appears.
  3. Click OK. The selected report is removed from the list.

Exporting and Linking to a Report

Use the Report window's Export menu to obtain a URL for distribution, or to export the report data in a CSV file.

To get the URL to a report:

  1. After viewing the report, choose Link URL from the Report window's Export menu. The Link URL box appears as shown.

  1. Copy the URL and paste it into an email, document, or other container you want to use to distribute it.
  2. Click Cancel to close the Link URL box.
  3. To protect the URL from being changed, select Lock against changes.

To export a CSV file:

  1. After viewing the report, choose CSV File from the Report window's Export menu. The result depends on your browser, but a file save action is initiated.
  2. Choose a location for the file, and click Save (again, the actual name depends on your browser.) A CSV file is saved to the specified location.

Still have questions? We can help. Submit a case to Technical Support.

Last Modified On: December 20, 2016