Working with RealTime Monitoring, Daily Checks, Performance Data and CCMS Alerts

This chapter describes how to work with the Monitoring Results in Avantra.

Working with RealTime Monitoring Results

There are several way to access RealTime Monitoring results using Avantra UI.

Viewing RealTime Monitoring Results

There are several options to access RealTime Monitoring Check Results once your logged into Avantra UI:

You may use the check status icons in the tab menu to toggle the view of each of the check status. For Systems you can additionally toggle the System Type, and you can restrict the list to operational Systems or to Systems having monitoring turned on (or off).

For RealTime Monitoring Checks you can restrict the view to confirmed or unconfirmed Checks as well.

You need the permission View RTM in order to view RealTime Monitoring results.

You can also view RealTime Monitoring Check Results using XanMobile

Confirming RealTime Monitoring Checks

In order to confirm a RealTime Monitoring Check proceed to the Check List page as described in Viewing RealTime Monitoring Results and perform the following steps:

  1. Select one or more entries and push the Confirm button.

  2. Fill in a confirmation message in Message.

  3. If you want this Check to stay confirmed until the next check status change occurs select None for Confirmation Auto Reset. Otherwise select either a Date/Time the Check will be unconfirmed automatically, or a Period after which it will be unconfirmed.

    Please note that the confirmation is cleared in any case if the check status changes.
  4. Push the OK button.

You need the permission Confirm RTM in order to confirm RealTime Monitoring Checks.

You can also confirm or unconfirm Checks using XanMobile

Viewing RealTime Monitoring History

In order to view the history of a particular RealTime Monitoring Check proceed as follows

  1. Proceed to the Check List page as described in Viewing RealTime Monitoring Results. Select an entry from the list and push the Open button.

  2. Switch to the History tab.:

    The most recent record appears on top of the list.

    A new entry is created either when the check status changes or a confirmation/un-confirmation occurs but not when the check message changes only. Consequently the column Result contains the value of the check message at the time the check status has changed. It does not show the most current result.

    Confirmation and un-confirmation events are tracked and kept together with the confirmation message in Confirmed by and Confirmation Message.

You need the Permission View RTM in order to view RealTime Monitoring history.

RealTime Monitoring "Control Center" View

The RealTime Monitoring"Control Center" view comprises a summary of the most important Avantra events.

You can access the "Control Center" via Monitoring  RTM Overview.

This view is literally a pre-defined Dashboard.

You can also access this page directly using URL http[s]://[avantra-server][:port]/xn/dashboard/RTM%20Control%20Center. See the rtmuser property for a configuration option without login.

The "Control Center" view will look like shown below:

ui rtm control center
The top frame of the Control Center view

Contains a list of all current Warning or Critical Check Results.

The lower left frame of the Control Center view

provides an overview of all Systems, Checks, and Business Services per Customer.

The lower right frame of the Control Center view

By default contains so called unassigned{Changes} generated by System Change Auto Detection. They stay _unassigned until a User processes them (see Systems having monitoring turned off, and a — optional — list of all unassigned Tickets.

You cannot customize this view. But you can make a copy of the corresponding Dashboard, modify it according to your needs, and save it as a Favorite, or make it accessible by a direct URL. See also System Dashboards.

You can even instruct the UI to use the copied Dashboard as a replacement for the original "Control Center", i.e. to make it accessible through Monitoring  RTM Control Center. See RTMControlCenterDashboard.

Using the Business Service Overview

The Business Service Overview provides a detailed view on Business Services.

There is a rotating view of each active Business Service that displays not only the overall Business Service check status, but also the check status of the inbound Checks several levels deep, as well as the inbound Systems (if any).

  1. Select Monitoring  Business Service Overview from the top-level menu. A new browser window opens.

  2. Choose Pause or Continue to pause or continue rotation through the defined Business Services.

  3. You can choose Levels and Systems/Checks in order to reduce the amount of information displayed on the page.

You need the Permission View Composite Checks and Business Services in order to use the Business Service Overview.

Working with Daily Checks

Selecting Daily Checks

Select Monitoring  Daily Checks from the top-level menu:

ui first daily check overview

By default all Daily Checks of the current day are displayed. You can choose different time periods from the drop-down list. Or you can restrict the search to confirmed or unconfirmed Daily Checks only.

There is also an option to restrict the list of displayed Systems by defining an ad-hoc Selectors or by choosing a pre-defined Selectors. Use the drop-down list next to the icon.

Of course you can use the usual filter options to further narrow your search, and you can use the status icons to filter based on the check status.

If you expand an entry, you will see the Daily Check details corresponding to the selected status icons.

Select one of the items in the list and push the Open button to show all Daily Check details.

If you click on you have the option to restrict the whole view to certain Daily Check Details.

You need the Permission View Daily Checks in order to view Daily Checks, and the Permission Edit Daily Checks in order to modify them.

Daily Check Overview

There is also the option to get an overview of the Daily Checks over a period of time:

ui daily checks overview

Select Monitoring  Daily Checks from the top-level menu: Select one or more Daily Checks from the list and push the Daily Check Overview. You can choose different time periods from the drop-down list.

You need the Permission View Daily Checks in order to view Daily Check Overview.

Confirming a Daily Check

In order to confirm a Daily Check perform the following steps:

  1. Select Monitoring  Daily Checks from the top-level menu.

  2. Select one or more items from the list and push the Confirm button. See Daily Check details.

  3. Fill in a confirmation message and push OK.

You need the Permission Edit Daily Checks in order to confirm Daily Checks.

Adding manual Daily Check Details

You can define Daily Check details to be performed manually by an administrator. Manual Daily Check Types are created with check status Unknown. The check status must be changed by the administrator performing the check before the whole Daily Check record can be confirmed.

If you specify a Database type, the Check will only be created in Daily Checks of SAP Systems running on top of the corresponding Database, or of Daily Checks running on the corresponding Database.

Please perform the following steps:

  1. Select Administration  Settings from the top-level menu and switch to the Customizing tab.

  2. Select Edit  Manual Daily Check Types from the page menu.

  3. Fill in a Name and select the DBMS Type.

  4. Push the Update Manual Daily Check Type button.

Defining relevant Daily Check Details

By default the overall check status of a Daily Check is the worst check status of all its Daily Check details.

Working with Performance Data

Configuring Performance Data Collection

Most of the configuration options have already been described at Performance Data Collection, but we summarize them here and describe some more options:

Displaying Performance Data

You can display performance data for every system in Avantra. Choose Systems  Servers, Systems  SAP Instances, Systems  SAP Systems, or Systems  Databases and proceed to the Performance tab.

There is a list or even a tree of charts on the left hand side. You can double-click an item to add a chart to the page, and click on the X button to remove it.

You may select the time range of the data globally for all charts displayed. There are pre-defined ranges (Last 24 Hours, Last Week, Last Month, Last Year), or you fill in arbitrary values for Since and Until.

In addition you have the option to drill into every single chart by dragging a rectangle around the desired region of the chart with your mouse. Click on the icon to restore the original size.

The overall size of the charts may be changed with the + and - buttons

For every chart there is an option to display raw data in a table, and to export it in a CSV file (using the icon). Once you have arranged all charts on the page you may export them into a PDF file.

Charts are scaled automatically based on the maximum and minimum values of the data. This may be misleading especially when it comes to percentage values. There may be situations where the chart draws awfully high (visual) maximum values while the y-Axis in fact shows a range between e.g. 0.3% and 0.6%. In this case it may be more reasonable to adjust the range of the y-Axis to the values between 0 and 100%. You can accomplish this using the icon.

As mentioned earlier, there may be a tree of charts on the left hand side. For e.g. SAP System you can display all the SAP System-related Performance data, but you can also include the ones of the Database instance, other SAP Instances, or even the ones of the Servers comprising the SAP System. This allows to correlate e.g. Transaction Response times with CPU values or Database locks.

You need the View Systems Permission in order to view Performance data.

Configuring Custom Performance Data Resource Types

Custom performance data collection can be done via the RUN_PROG Custom Check, or the JavaScript based Custom Check API of the Custom Checks SQL_QUERY and RUN_JS. But before you need to define you own custom performance resource types. To do this, please follow the the steps below.

  1. Configuration  Performance Data

  2. Click on New to create a new Performance resource type. A name for the new Performance resource type is required and it has to be defined for which System Type its relevant. If the System Type is either SAP Instance or SAP System additionally the Instance Type can be selected. The checkbox Create default chart definition is checked by default. It means along with a new Performance resource type a chart definition will be created.

  3. After pressing Finish the new Performance resource type is ready and can be used to collect custom performance data. See RUN_PROG custom check: Collect Performance Values on how to do this.

Displaying Custom Performance Data

To display the custom performance data it is necessary to create a custom chart definition. When the performance resource type is created there is the option to to create the chart definition as well. But the chart definition can be created afterwards or a second chart definition can be created.

  1. Configuration  Performance Data. Switch to the Charts

  2. Open a chart definition or create a new one to modify colors, axis labels etc.

Working with Availability Data

Viewing Availability Data

You can display availability data data for every system in Avantra. Choose Systems  Servers, Systems  SAP Instances, Systems  SAP Systems, or Systems  Databases and proceed to the Availability tab.

You may select the time range of the data displayed. There are pre-defined ranges (Last 24 Hours, Last Week, Last Month, Last Year), or you fill in arbitrary values for Since and Until.

Then you have to choose the Service. By default SYSTEM is used to show the availability data of the System. There may be other Services depending on your Custom Check or Composite Check definition. Also, for SAP Systems there is a DATABASE service showing the availability data of the Database instance.

You can also choose the Timezone used for the display of time stamps.

Avantra UI automatically computes the Planned and Unplanned Downtime as well as the Uptime and Achieved Uptime for the time range selected. There is also a list of availability Records shown the way they are stored internally.

An availability record consists of the following fields:

  • Status: This is what availability is all about: Status shows if the System or Service has been Up or Down during the time period given by Start and Duration. Additionally status may have the value Unknown. See also Table: Availability Records and Service Levels.

  • Moni. Switch: The monitoring switch indicates if monitoring was turned on or off during the time period. If monitoring was turned off the availability record is reported as Planned Downtime instead of Unplanned Downtime in the Service Level Report. If monitoring was turned off due to a Maintenance Window a tool symbol is additionally displayed.

  • Status Information: Displays the reason for the status, e.g. why an SAP Instance was Down, or if a server Up record was computed from the Physical Server's uptime.

    Status information values are:

    • BLOCKED: Indicates that an SAP Instance could not be logged into, e.g. because all dialog work processes are used

    • DB_RECONNECT_STATE: Indicates that an SAP Instance could not be logged into and is in Database reconnect state, so the database is either down (e.g. because of an offline backup) or has a problem.

    • DISPATCHER_EMERGENCY_SHUTDOWN: Indicates that the dispatcher has performed an emergency shutdown. This can happen in case of a serious error.

    • SHUTDOWN: Indicates that an SAP Instance has been properly shut down.

    • Status information for SAP Instances with Oracle Database backed up with BRBACKUP:

      • [SHUTDOWN|DB_RECONNECT_STATE]-OFFLINE_BACKUP_IN_PROGRESS: Indicates that the SAP Instance has either been properly shut down or is in Database reconnect state and an offline backup was processing.

      • [SHUTDOWN|DB_RECONNECT_STATE]-ERROR_CHECK_FOR_BACKUP: Indicates that the SAP Instance has been properly shut down but it was not possible to check for a running backup. This may happen if a system has never been backed and no backup run information can be read.

    • Generated due to system uptime: A Physical Server is considered available due to its system uptime although the Avantra Agent was not running at this time.

You need the View Availabilities Permission in order to view availabilities

If there is no availability data for a particular Managed Object, there will be no such section in the Service Level Report.

Changing Availability Data

You can edit the Mon. Switch, Status, or Status Info on the Availabilities tab for each System. Or you can use the cross-System and cross-Customer view under Reporting  Availability Records from the top-level menu.

Changing the Status Info might be useful e.g. to provide an explanation for a Downtime.

All changes you make manually can be restored to their original values.

In order to modify availability data for a single System perform the following steps:

  1. Open the Availabilities tab as described in Viewing Availability Data.

  2. Select one or more items from the list and push the Edit button.

  3. Make your changes in the Status, Moni. Switch, and/or Status Information field.

  4. Push the OK button to save your settings.

In order to modify availability data for multiple Systems perform the following steps:

  1. Open Reporting  Availability Records.

  2. You may use Status Filter and Monitoring Switch Filter to narrow your search.

  3. Select the desired Systems from the list and push the Edit button.

  4. A dialog warns you attempt to edit multiple values. Push Yes.

  5. Correct the desired values and push Apply.

All records modified manually will be flagged with a red exclamation mark. If you need to restore the original values, select the desired entry and push the Restore button or the icon.

You need the Edit Availabilities Permission in order to modify availability data.

Availabilities Overview

The Availability Overview displays a snapshot of the currently achieved availability rates over all Systems' Uptimes and Downtimes, and whether or not the assigned Service Level Agreement is met (if any). You can access it using Reporting  Availability Overview from the top-level menu.

An advanced feature is the forecast of the availability rates. Once you choose an Until date in the future, the column Best Case Uptime shows the extrapolated availability rate, assuming 100% Up for the remaining period. The Remaining Legal Downtime shows the maximum downtime you can afford without breaking the Service Level Agreement.

Comparing SAP and Database Profiles and Components

Within each Daily Check the Avantra Agent sends all SAP Instance and Database profiles and component information to the Avantra server.

"Compare Profiles" and "Compare Components" are very powerful tools to find configuration differences in case of trouble. The feature can as well be used to improve the overall configuration consistency of your SAP Systems and Databases.

Perform the following steps to compare profiles:

  1. Choose Systems  SAP Systems or Systems  Databases from the top-level menu.

    Use the filter options to have the two or more Systems you want to compare on the same page. If that is not possible, choose two arbitrarily. You still have the choice to adapt your selection in the next step.

  2. Select More  Compare Profiles or More  Compare Components (for SAP Systems) or push the Compare Profiles button (for stand-alone Databases).

  3. Choose one of the options:

    For Profiles

    Choose the Type and select two or more Profiles from the list using the and icons.

    For Components

    Choose the Type and select two or more SAP Systems from the list using the and icons.

  4. Push the Compare button.

  5. Set the All Parameters flag if you want to see all parameters in the result list (instead of only the ones that differ).

  6. For Profiles you also have the option to Export the data.

You need the View Systems Permission in order to compare profiles and components.

Communicating with the Avantra Agent

There is usually no need to communicate directly with the Avantra Agents. Avantra UI uses an internal command scheduler and a communication queue.

However, you can issue commands to this queue directly, and in rare cases it might be necessary to verify the command queue.

You can trigger certain actions on the Avantra Agent or send a configuration update.

  1. Select Systems  Servers, Systems  SAP Systems, or Systems  Databases from the top-level menu.

  2. Select one or more items from the list and push the Send to Agent button.

  3. Choose the appropriate option and push the Send Commands button:

    Set the Send Configuration flag in order to update the Avantra Agent'`s local configuration (if you'`re in a hurry and don'`t want to wait the couple of seconds until this is done automatically).

    Set the Initialize Agent flag to clear the Avantra Agent'`s local cache and force a resend of data.

    Select the Check Cycle to have the corresponding Checks executed immediately.

Another option is to trigger the immediate execution of Checks. In a Checks tab (of a System or in one of the RealTime Monitoring views you can select one or more entries and hit Execute Now. Push the Send Command button on the pop-up.

You need the Send to Agent Permission in order to communicate with the Avantra Agent.

Displaying and Deleting Imported CCMS Alerts

Avantra works perfectly well without SAP CCMS. But of course you can activate the integration if you desire.

CCMS Alerts are available if you have configured a CCMS Custom Check or a CCMS_MONSET Custom Check with the Report CCMS alerts of this MTE to Avantra option selected.

In order to display imported CCMS Alerts perform the following steps:

  1. Select Monitoring  More  CCMS Alerts from the top-level menu.

  2. Select one or more items from the list and push the Delete button in order to delete CCMS Alerts.

    [NOTE]: Deleting CCMS Alerts is the Avantra way of acknowledging.

You need the Permission Delete CCMS Alerts in order to view and delete CCMS Alerts.