Skip to content
CA Application Performance Management - 10.5
Documentation powered by DocOps

The APM Status Console

Last update January 10, 2018

The following sections explain details about the APM Status console interface. For more information about how to use the APM Status console to monitor Enterprise Manager health, see Monitor performance with the APM Status console.

The APM Status console allows you to view important status and events for a standalone or clustered Enterprise Manager. Its purpose is to allow administrators to monitor and address issues in the health of the Enterprise Managers they administer.

This functionality provides out-of-the-box monitoring capabilities that would otherwise require the administrator to configure alerts on Enterprise Manager supportability metrics.

Note: Only users with apm_status_console_control permission can see the APM Status alert icon and use the APM Status Console. For more information, see APM Security.

APM Status Console Interface

This section explains the APM Status console interface. To see how to use the tool to actively monitor the health of your Enterprise Manager, see Monitor Performance with the APM Status console.

The APM Status alert icon

If you have enabled the APM Status console, an icon appears in the Workstation Investigator.

To enable the APM Status console:

  • See the topic on configuring APM Status console clamps and Important Events under Configure the System.
  • See the topic on using server.xml to configure Enterprise Manager server permissions in the APM Security section.

This icon has two states, as shown in this illustration.

The illustration shows the unalerted (blue) and alerted (red) states of the APM Status Icon.

On the left is the icon in normal state. On the right is the icon in alerted state.

When the icon appears in the alerted state, one or more of these events has happened on one or more of the nodes in the Enterprise Manager map:

  • A clamp has been activated.
  • An important Enterprise Manager event has occurred.
  • An agent has been denied access to the Collector.

Open the APM Status Console

When the APM Status icon appears in the alerted state, you open the APM Status Console to investigate the cause of the alert.

To open the APM Status Console:

  • Click the APM Status icon.
    Note: You can also open the APM Status Console by selecting Workstation > New APM Status Console. 

Overview of the APM Status Console interface

The APM Status Console consists of four panes, marked on the illustration below. Each pane is described in more detail after the list of panes.

The APM Status Console consists of four panes.

1: Enterprise Manager Map

The Enterprise Manager Map displays one of three views, depending on what computer the Workstation is connected to.

  • If the Workstation is connected to a standalone (non-clustered) Enterprise Manager, that computer alone is displayed.
  • If the Workstation is connected to an Enterprise Manager MOM, the map shows a diagram of the MOM and its collector Enterprise Managers.
  • If the Workstation is connected to a Cross-Cluster Data Viewer (CDV) Enterprise Manager, the map shows a diagram of the CDV and its connected Collectors. The Collectors can be located in different clusters.

2: Important Events table

See "Use the Important Events table" below for more information.

3: Information table

The Information table is labeled depending on node you have selected in the map. For example, "APM System Information" or "Collector Information." The pane consists of one tab:

  • Active Clamps

See Use the List of Active Clamps.

4: Denied Agents list

See The Denied Agents List.

Use the Enterprise Manager Map

The illustration shows the Enterprise Manager map displaying a MOM and two collectors.

The Enterprise Manager Map displays a standalone Enterprise Manager, a MOM cluster, or a CDV cluster. In any of these views, when an Enterprise Manager experiences problems, the map displays the corresponding Enterprise Manager icon in an alerted state.

In the illustration, you can see the following:

  • A MOM Enterprise Manager kath@3001 is shown in alerted state.
  • The MOM Enterprise Manager connects to two Collector Enterprise Managers.

To get more information about an alerting Enterprise Manager:

  • Select the Enterprise Manager.
    If an active clamp is causing the alert, the Active Clamps tab lists clamp information for the selected Enterprise Manager.
  • Review the Important Events table and Denied Agents list.
    • If an important event or denied agent is causing the alert, the notification is added to the appropriate pane. Both the Important Events table and Denied Agents list display cluster level information.

Use the Important Events Table

The Important Events table lists the following events when they pass the thresholds listed here:

  • Slow Collector response -- The connection is still live; but the Enterprise Manager is not responding because it is busy.
  • High CPU consumption -- CPU use is over 60 percent
  • Long SmartStor duration -- Time it takes SmartStor to write data is over 3.5 seconds.
  • Long harvest duration -- Time to harvest data is over 3.5 seconds.
  • Database connectivity -- The connection between the Enterprise Manager and the APM database has been lost.
  • apm-events-thresholds-config.xml configuration error -- The file contains one or more syntax errors.

These thresholds are set in <EM_Home>/config/apm-events-thresholds-config.xml.

Note: The threshold values in apm-events-thresholds-config.xml reflect CA Technologies recommended settings, and changing them is not recommended. For more information, see Administrating.

Things to notice:

  • Events are listed with the most recent at the top.
  • Events are listed only while they are active. When the metric that caused the event goes below the threshold, the event disappears from the table.
  • The events listed in the Important Events table are not logged or saved in history.
  • The following actions are not supported:
    • Users cannot change the list of events that appear in the Important Events table.
    • Users cannot change the thresholds for these events in the APM Status console.

Use the List of Active Clamps

The Information pane contains the Active Clamps tab. When a user selects Enterprise Manager or CDV in the Enterprise Manager Map, the Active Clamps tab lists clamp information. This information displays about any clamps that are active on the selected computer:

  • Clamp name
  • Component -- Name and port of the Enterprise Manager where the clamp is located
  • Clamp threshold value
  • Current value of the data controlled by the clamp
  • Time clamp was activated

Things to notice:

  • In the case where multiple per-agent clamps have exceeded threshold values, the label Multiple appears instead of a value. Clicking the row opens a table with clamp details.
  • Scope drop-down list -- use this list to switch the contents of the Active Clamps tab to reflect the active clamps on another Enterprise Manager.

To see more information about the clamp:

  • Double-click a row in the table.
    An Investigator window opens to the metric browser tree, expanded to show the metric graph for the clamp. This graph allows you to see the metric trend over time.
    Note: You must have SuperDomain permission to see metric information for the clamp in the metric browser tree. 

Clamp Details table

If the clamp the user selects is active on more than one component, the word "Multiple" appears. Click on Multiple to open the Clamp Details table, which displays the following information.

  • Affected Component
    Name of the agent or other component controlled by the clamp.
  • Threshold
    Threshold value for this clamp.
  • Current
    Current value of the metric or other component being clamped.
  • Clamped Time
    Time the clamp was activated.

The Denied Agents List

The Denied Agents list displays agents that have been denied connection or disallowed sending data to these Enterprise Managers:

  • A standalone Enterprise Manager
  • All Enterprise Managers in a cluster.

Agents are denied connection under these conditions:

  • Pre-9.1 agents that are disallowed based on loadbalancing.xml configuration.

    Note: Pre-9.1 agents that are denied have (denied) appended to the agent name in the Denied Agents list.

  • The clamps limiting the number of agent connections are put into effect.
  • The clamps limiting the number of disallowed agents are put into effect.

Note: Use of this list is documented in full in Administrating.

Was this helpful?

Please log in to post comments.