Monitoring Ensemble
Monitoring All Namespaces
[Back] [Next]
   
Server:docs1
Instance:LATEST
User:UnknownUser
 
-
Go to:
Search:    

This chapter describes how to monitor productions in all namespaces. It contains the following topics:

General Notes
For background information, see the chapter Concepts.”
For information on starting and stopping productions, see Managing Ensemble.” Note that for a live, live, deployed production, InterSystems recommends that you use the auto-start option, which is described in that book.
If a production is Suspended or Troubled, see Correcting Production Problem States,” in the next chapter.
Viewing Summaries for Active Productions
When you select any option in the Ensemble menu, the right side of the page displays summary information about the productions, as follows:
Using the Ensemble System Monitor
The Ensemble System Monitor page provides a high-level view of the state of your system, across all namespaces. (It displays Ensemble information combined with a subset of the information shown on the [Home] > [System Dashboard] page, which is provided for the users of Caché.)
To access this page in the Management Portal, select Ensemble, Monitor, and System Monitor.
This page displays tables of information, described in the following subsections.
Also see General Notes,” earlier in this chapter.
Ensemble Throughput
This table provides information about the throughput of productions in all namespaces. The table lists the following values:
Ensemble Jobs
This table provides information about the jobs associated with the currently running productions in all namespaces. The table lists the following values:
Also see Diagnosing Problems with Jobs in the next chapter.
System Time
This table provides the same information as in the System Time table of the [Home] > [System Dashboard] page. See Monitoring System Dashboard Indicators in the chapter “Monitoring Caché Using the Management Portal” in the Caché Monitoring Guide.
If you click a row in this table and then click the link at the bottom of the page, Ensemble displays the [Home] > [System Dashboard] page.
System Usage
This table provides a subset of the information in the System Usage table of the [Home] > [System Dashboard] page. See Monitoring System Dashboard Indicators in the chapter “Monitoring Caché Using the Management Portal” in the Caché Monitoring Guide.
If you select a row in this table and then click the link at the bottom of the page, Ensemble displays one of the following pages, as appropriate for the row you selected:
Ensemble Queues
This table provides information about Ensemble queues in all namespaces. The table lists the following values:
Also see Diagnosing Problems with Queues in the next chapter.
Errors and Alerts
This table provides information about errors and alerts. The table lists the following values:
For information on configuring a production to send alerts, see Configuring Alerts in Configuring Ensemble.
Licensing
This table provides the same information that is shown in the Licensing table of the [Home] > [System Dashboard] page. See Monitoring System Dashboard Indicators in the chapter “Monitoring Caché Using the Management Portal” in the Caché Monitoring Guide.
If you select a row in this table and then click the link at the bottom of the page, Ensemble displays the [Home] > [License Usage] > [Summary] page.
Task Manager
This table provides the same information that is shown in the Task Manager table of the [Home] > [System Dashboard] page. See Monitoring System Dashboard Indicators in the chapter “Monitoring Caché Using the Management Portal” in the Caché Monitoring Guide.
If you select a row in this table and then click the link at the bottom of the page, Ensemble displays the [Home] > [Tasks Manager] > [Upcoming Tasks] page.
Monitoring Multiple Productions with the Enterprise Monitor
The Enterprise Monitor displays the overall status of multiple running productions. These productions can be running on different namespaces within the same instance of Ensemble or can be running on multiple instances of Ensemble. You can display the Production Monitor or the Ensemble management portal for any of the productions being monitored. The monitored productions can be running in different namespaces on the same Ensemble instance. running on multiple Ensemble instances on the same system, running on multiple systems, or running on any combination of these.
This section contains the following topics:
Configuring the Enterprise Monitor
The Enterprise Monitor runs in its own namespace with a special production that gets the status of the monitored systems. To configure an Enterprise Monitor, you perform the following steps:
  1. Create a namespace for the Enterprise Monitor or choose to use an existing namespace for it. The following steps are done in this namespace.
  2. Define credentials that provide access to the systems that you will be monitoring.
  3. Configure Enterprise Systems, defining a new connection for each system that you are monitoring. Optionally, specify a queue threshold for each system. For details on configuring Enterprise Systems, see Identifying Enterprise Systems for Viewing and Monitoring in Configuring Ensemble Productions.
  4. Optionally, specify Enterprise Monitor Roles. If the user using the Enterprise Monitor has one of these roles, the user only monitors the configuration items that have one of the specified categories. For details, see Configuring and Using Enterprise Monitor Roles
  5. Create a production for the special Enterprise Monitor service. The class of this production must derive from the Ens.Enterprise.Production class. You can create the production in Studio or create it using the management portal and then edit in Studio as follows
    1. In Studio, open the class that defines the production running in the Enterprise Monitor namespace.
    2. Replace the class Ens.Production with Ens.Enterprise.Production. For example, if the class definition is
      Edit it so that the class extends Ens.Enterprise.Production so that it appears as:
    3. Compile the class.
  6. Add the Ens.Enterprise.MonitorService business service to the production and enable it.
  7. Start the production.
  8. Select Ensemble, Monitor, and Enterprise Monitor to display the Enterprise Monitor. Note that this menu item is only visible if you have configured Enterprise Systems in the current namespace.
Using the Enterprise Monitor
The Enterprise Monitor displays a line for each system being monitored. The following Enterprise Monitor is monitoring four systems:
The Enterprise Monitor displays the following information for each system:
If you click on an item in the Enterprise Monitor that is not a link, the Enterprise Monitor displays the production monitor for that system. For information on the Production Monitor, see Monitoring a Production.
Configuring and Using Enterprise Monitor Roles
Enterprise Monitor Roles allow you to limit the production components that are visible in the Enterprise Monitor based on the roles of the current user and the categories specified in the production configuration for the component. When a user displays the Enterprise Monitor, it checks if the user has any roles specified in the Enterprise Monitor Roles. If none of the roles match, the Enterprise Monitor displays information about all the components in the productions. If one or more of the roles match, the Enterprise Monitor displays information about components that have one of the specified categories.
To add new roles or edit an existing role, select Enterprise Monitor Roles on the Enterprise Monitor. The following illustrates the Enterprise Monitor Roles page:
To add a new role, select New Role. To edit or delete a role, select “edit” or “delete”. When you enter the role and category, the form does not list the existing roles or categories. You must know these and enter them as text. Once you have entered a category, it is available as a checkbox when you add or edit a role.
Troubleshooting the Enterprise Monitor
If the Enterprise Monitor is not working, this troubleshooting list may help you resolve the problem: