10.1 Understanding AppManager Reporting

AppManager reports include data in tabular and graphical format from a QDB. Examples of the types of AppManager reports include:

  • Performance-related reports to help you understand the performance of your applications and systems.

  • Trend analysis reports to help you plan for system or application upgrades.

  • Service level agreement reports to quantify the availability of services and service response time.

  • Event summary reports to provide an overview of the events being created by AppManager so that you can develop a plan of action.

  • Configuration reports, to provide an overview of the system details being monitored and configuration details, such as event threshold settings.

AppManager reports use the same Knowledge Script-based mechanism that you use to run monitoring jobs that collect data and raise events.

An AppManager report queries data from a single QDB. At this time you cannot report on data from more than one QDB in the same report. To report on AppManager data from more than one QDB in the same report, use AppManager Analysis Center. For more information, see the Analysis Center product documentation.

AppManager reports include application-specific reports and generic reports. For more information, see the following sections.

10.1.1 About Application-specific Reports

AppManager reports are included with some Knowledge Script categories to provide application-specific reporting. Application-specific reports are included with the corresponding application Knowledge Scripts and are prefixed by Report_. For example, in the Knowledge Scripts view of the Control Center console, the Report_CPULoad report appears in the NT Knowledge Script category.

Application-specific reports only use data collected by a particular Knowledge Script. To extend the previous example, the Report_CPULoad Report Script only reports on data collected by the NT_CPULoaded Knowledge Script.

To determine the data source for a report, double-click the Report Script you want and in the Values tab of the Properties window, click Help to display the Help.

Application-specific reports only include data from standard out-of-the-box Knowledge Scripts and do not include data from copies of Knowledge Scripts. For information about reporting on data collected by a copy of an AppManager Knowledge Script, see Section 10.4.3, Reporting on Data Collected by a Copy of a Knowledge Script.

10.1.2 About Generic Reports

Generic reports are located in the ReportAM category of the Knowledge Scripts view.

Generic reports enable you report on a variety of areas, including:

  • Performance information Includes reports on average hourly and daily values, most recent values, or values by computer or data stream.

  • Job and event information Includes reports that list events by computer, monitored application, Knowledge Script, and event status and severity.

  • Application information Includes reports on your AppManager installation and discovered applications on your managed computers.

  • Hardware information Includes reports on some of the hardware components on your computers, provides an overview of network interfaces (including the manufacturer, IP address, and subnet mask), logical and physical disks (including used and free space), and printers (including port and driver information).

    AppManager Control Center also includes best practice reports. These reports are recommended for all customers and are located in the StartPoint category. For complete information about the StartPoint and ReportAM AppManager reports, including information about the data source for a report, see the Help.

10.1.3 Understanding How AppManager Reports Work

An AppManager report consists of a Report Script that runs on the AppManager report agent. The report agent is an extension of the AppManager agent and is responsible for:

  • Querying a QDB.

  • Generating the HTML-based report.

To run a report, the AppManager report agent must be:

  • Installed and discovered. Note that the report agent is not automatically discovered during installation. Use the Discovery_ReportAgent Knowledge Script to discover the report agent.

  • Configured to have a QDB as a data source. By default, the AppManager report agent installation process configures a single QDB as the data source for the report agent. After installation, you can configure the report agent to report on data in additional QDBs, however, this is not recommended.

NetIQ Corporation recommends that you use a separate report agent for each QDB data source, and install each report agent on a dedicated server. For more information, see the Installation Guide for AppManager, available on the AppManager Documentation page. Here are some considerations:

  • Although you can configure a report agent to have more than one data source, at this time, an AppManager report can only include data from a particular QDB. An AppManager report cannot include data from more than one QDB.

  • Depending on the amount of information in each report and the number and frequency of reports you run, the report agent can consume significant system resources.

10.1.4 Discovering the Appmanager Report Agent

When installing the AppManager Windows agent, the AppManager setup program includes an option to install the report agent. The AppManager setup program does not automatically install the report agent.

After you install the report agent, discover it by running the Discovery_ReportAgent Knowledge Script. If you have not discovered a report agent, the Knowledge Scripts view of the Control Center console does not display the ReportAM category or application-specific Report Scripts.

For information about installing and discovering the AppManager report agent, see the Installation Guide for AppManager, available on the AppManager Documentation page.

Rediscover the report agent to:

  • Update the list of Knowledge Script categories upon which you want to report. For example, if you discover the report agent and then discover a new Knowledge Script category, such as IIS, rediscover the report agent to run IIS reports. For more information, see Section 10.1.3, Understanding How AppManager Reports Work.

  • Update the QDB data source for a report agent. At this time, it is not recommended that a report agent be configured with more than QDB data source.

To view the details for an AppManager report agent:

  1. In the Control Center console, expand the Enterprise Layout view of the Navigation pane to select a management group that contains the report agent computer.

  2. In a Servers view, click the report agent computer.

  3. In the Details tab, expand the list of details to view report agent information.

    In particular, the details include the QDB with which the report agent communicates. If you are not sure which report agent you need, use the details to find the correct report agent.

  4. Under Report Agent > AM Repositories, the QDB data source is displayed with a list of available Knowledge Script categories on which you can report.