This section includes the following topics:
The Add-on AppTier extends agent-based data collection to applications currently not supported by Precise products. It is an SDK (Software Development Kit) used by a customer's application development team, a third-party vendor, or other professional services team to create an application Collector for new AppTiers in the Precise environment.
AppTier is the Precise abbreviation for an application tier in a Precise environment. Each AppTier contains the instances of one technology (third-party software tool) for functional and business-related views. Precise agents monitor, process, and communicate performance-related information for that tier. An installed Add-on Collector monitors new App-Tier instances and collects application-specific performance data.
The customer's application development team, third-party vendor, or other professional services team plan and develop how the Add-on AppTier collects the application-specific information.
You must perform the following actions to create an Add-on AppTier:
Two options are available for planning the Add-on AppTier:
To understand the process of introducing a new AppTier to a Precise environment, you should know how components are used to create an Add-on AppTier.
The following are major Add-on AppTier components:
The Add-on AppTier Collector is user-defined to collect application-specific information in XML format files. As an external Collector, the customer's home-grown application development team, third-party vendor, or other professional services team develops the Collector.
The Add-on AppTier Collector is separate from an Insight Collector. Currently, it can be developed in any programming language or script. When the XML file format is used, the Add-on AppTier Collector passes the data to the Precise Listener by writing files to a folder under the Precise installation directory. The Precise Listener also includes a Harvester. The Harvester is responsible for collecting application-specific data files and transferring the performance files from the monitored server to the Precise FocalPoint server.
The Insight SDK Collector collects application specific information using an ARM standard API. The Insight SDK Collector receives ARM API events from the monitored application in order to extract performance information. An SDK software designer needs to develop the ARM call back functions used inside the monitored application.
For more details regarding the ARM standard, refer to: http://www.opengroup.org/management/arm/. When using ARM SDK format, the Insight SDK Collector passes the data to the Precise Listener by writing files to a folder under the Precise installation directory. The Precise Listener also includes a Harvester. The Harvester is responsible for collecting application-specific data files and transferring the performance files from the monitored server to the Precise FocalPoint server.
Insight FocalPoint (usually installed on the Precise FocalPoint server) aggregates all of the performance information that all Insight agents collect. See How the Collectors work for more information.
The Add-on AppTier plug-in installation package includes one or more XML files which contain metadata that describes the new Add-on AppTier to the Precise environment. The software designer defines the Add-on AppTier application entities, counters, and general application-level definitions.
The Add-on AppTier plug-in, a component of the Precise FocalPoint server, reads the plug-in installation package and builds or updates the necessary Precise metadata files. The Add-on AppTier plug-in installation package also invokes the processes needed to implement changes. For example, the installation package invokes the PMDB process to perform schema changes in the database. If needed, consult with the Precise research and development team regarding Add-on AppTier metadata development.
Each performance record, generated by the user-defined Collector, can include the following information:
AdminPoint performs the plug-in installation and defines the instances. After plug-in installation, certain screens display the new Add-on AppTier instance in AdminPoint. Both the Add-on AppTier Collector (external) and Insight SDK Collectors can start providing performance data for monitoring.
When the Add-on AppTier Collector is used, it passes the data as XML formatted files to the Precise Listener by writing files to a folder under the Precise installation directory.
The Insight ARM extension is a dynamic library within the application which implements the ARM API and transfers transaction information to the Insight SDK Collector. The Insight SDK Collector correlates the transactions and creates XML performance files.
The Precise Listener (in the monitored server) includes a Harvester that collects application-specific data files from both the Add-on AppTier Collector (external Collector) and the Insight SDK Collector file directory and transfers the performance files from the monitored server to the Insight FocalPoint. Files are loaded from the monitored (Collector) servers to the Insight FocalPoint.
The Insight FocalPoint aggregates all of the performance information that all Precise Collectors collect and stores the collected information in a centralized location. For received application-specific data files, the Insight FocalPoint runs a pre-load process to read the files and converts the data to Precise standards, such as: common time adjustments and location calculations. The pre-load process creates the PMDB load files for the performance records.
The PMDB, on the Precise FocalPoint server, stores performance records as history received from Insight FocalPoint. The data is correlated along AppTiers (allowing Cross AppTier analysis) in the PMDB. Report Manager retrieves the information from the PMDB and generates reports.
The following items display the performance data:
The Add-on AppTier application data is processed before being harvested by the Precise Listener. The software designer defines the order for processing the application data.
The application data is processed as follows:
The Insight SDK Collector receives information from the Insight ARM extension dynamic library by using a dedicated process for each monitored instance, called psi_sdk_poll. A single process (one per monitored instance) called psi_sdk writes SDK files under the Precise Listener directory.
More information on Precise, its products, technical notes, and so on, can be found in the Release Notes document for this version.