Skip Navigation
  1. BlackBerry Docs
  2. BlackBerry AtHoc
  3. 7.15
  4. System Administrator Configuration Guide
  5. Manage system settings
  6. Monitor system health
  7. Create a system health monitor

Create a system health monitor

You must be an Enterprise Administrator or System Administrator to create a new system health monitor.
  1. In the navigation bar, click Settings icon.
  2. In the
    System Setup
     section, click
    Global System Health
     or
    System Health
    , depending on which system contains the monitor that you want to edit. The System or Organization Visibility Console screen opens, displaying all of the system monitors in the system.
  3. Click
    Create new monitor
     at the top of the screen.
    You can also click any of the
    Create new monitor
     links within the groups on the System or Organization Visibility Console screen. The difference is that when you click a link within a group, the New Health Monitor screen that opens has the
    Is it associated with other Health Monitors?
     field preset to the name of the group the link appeared within.
  4. On the
    New Health Monitor
     screen, complete the fields in the following sections:
    • Basic details
      1. Enter the name of the monitor, the location where you want it to appear on the Visibility Console screen, and the time and frequency of the monitoring checks.
      2. Designate whether or not the monitor will appear on the Organization Visibility Console and whether errors and warnings about the monitor will appear on the System area on the
        BlackBerry AtHoc
         homepage.
    • How does this Monitor test the system?
      : Select the kind of test the Monitor will run on the system. Note that the type of test cannot be edited after it is saved. The following options are available:
      • Web URL Test
      • Combined Health Monitors
      • BlackBerry AtHoc
         Event Logs
      • Database Procedure
      • UAP Health Test
      After you make a selection, sample configuration XML for that type of test appears below the Test Configuration field. Use that as the basis for the XML code you enter into the Test Configuration field.
    • How is the state of this Health Monitor determined?
      : Designate the way the state of the monitor will be determined by selecting one of the following options:
      • Use the most recent test result
      • Calculate it over multiple test results
        : If you select this option, use the drop-down lists in the section to specify how the calculation should be determined. Optionally, select
        Match the state if
         if you want to also use "X" number of identical test results as a trigger for a state change, where you set the value for X.
    • What happens when this Health Monitor reaches a particular state?
      : For each of the Health Monitor states, specify the following:
      1. The implications of the state:
        • Error
          : The test returned an error condition on the object being tested.
        • Warning
          : The test returned a warning condition on the object being tested.
        • Good
          : The test run returned the expected results.
        • Inoperative
          : The test process failed. This does not reflect the health of the object being tested. This state indicates the operational status of the monitor itself. For example, if in a database query, the database referenced has a typo and the system cannot find the database to query.
      2. Actions to take when the monitor is in the selected state:
        Define the actions that should be taken any time a monitor transitions into each of the states. To make this process faster and less prone to errors, click
        Show a list of possible actions
         for each state and then add either or both of the actions
        Trigger a URL
         or
        Send an Email
         on the pop-up screen for the
        Configure
         field.
  5. Click
    Save
    . The system evaluates the parameters you set. If the parameters are correct, the system creates a new monitor. If the syntax in any of the conditions is incomplete or incorrect, an error message is displayed.