Adding an adapter for BMC TM ART

Use the following procedure to add an adapter for BMC TM ART.

Before you begin

• Ensure that BMC TM ART environment satisfies the requirements listed in Prerequisites of adapter for BMC TM ART. 
• Ensure that you have BMC TM ART Central user credentials. The data that you collect depends on the following user roles: 
  • A SuperUser collects data for all projects 
  • Any other user collects data for all projects in all groups of which the user is a member

For information about implementing BMC TM ART user roles, refer to BMC Transaction Management Application Response Time Central Installation and Setup Guide and User Guide.

To add an adapter to collect the agent values for the BMC TM ART

1. In the Administration Console, right-click the Adapters folder, and select Add Adapter > BMC TM ART.

2. In the Add BMC TM ART dialog box, on the Configuration tab, complete the required information, as detailed in the following table:
   
   Configuration tab for BMC TM ART adapter

   Input Fields	Description or action
   Instance Name	Type a unique instance name for the BMC TM ART adapter. Note that it is recommended to specify the Fully Qualified Domain Name as the device name instead of the IP address or the partial DNS name. This avoids the creation of a duplicate device. You can also select and item from the Insert Macro list to more easily identify the adapter instance. For example, enter the instance name and select BMC TM ARTCentral Server IP/Host Name to add the $(DNSIP) macro. The macro retrieves the value from the selected field and displays the value during run time.
   Source Agent	Select the name or IP address of the local agent on which the monitor is to be deployed.
   BMC TM ART Central Server IP/Host Name	Type or select the name or IP address of the computer where the BMC TM ART Central server is running.
   Port	Type the BMC TM ART Central web server port, typically 19120 for an HTTP connection, or 8443 for an HTTPS connection. The default port number is 19120. Note: For HTTPS ports, select Use HTTPS.
   User Name and Password	Type the user name and password necessary to log on to the BMC TM ART Central server.
   Use HTTPS	Select this option to use an HTTPS connection when querying data through a secure BMC TM ART Central server. Note: For HTTPS connections, enter an appropriate server port in the Port box.
   Collect Synthetic Transactions	Select this option to collect synthetic transaction data. This option is selected, by default. If neither synthetic nor real collection options are selected, synthetic transactions are collected, nonetheless.
   Collect Real Transactions	Select this option to collect real transaction data. Real transaction data is supported with BMC TM ART version 3.7 or later.

3. Select the Control tab and view or modify the statistics polling options, as detailed in the following table. After you have completed viewing or modifying, click Next.
   
   Control tab for BMC TM ART adapter

   Input Fields	Description
   Statistics Poll Interval	Select the time interval between successive statistical data polls. The default is 15 minutes.
   Statistics Poll Timeout	Select the timeout period for each statistical data poll. The default is 1 minute.

4. (Optional) On the Include Filters and Exclude Filters tabs, select the Instance check box to define filters for instances to include in, or exclude from, discovery.

   
   For information about how to define filters, see Filtering devices and instances.

   Note

   BMC TM ART supports instance-level filtering for transaction monitors only. Project and location monitor hierarchies are always displayed in the Infrastructure Management Operation Console. If project or location monitors are selected for filtering, only their associated transactions are affected.

   
   Click Next.

5. On the Schedule Auto-sync Polls screen, configure the time interval in which Infrastructure Management runs an automatic synchronization poll (that is, a discovery of BMC TM ART project structures).Then click Next.Select Periodic (default), Daily, or Weekly to schedule auto-sync poll periods:

   • Select Periodic to schedule an auto-sync poll at a specific time interval. For example, if you select the poll period as 24 hours, then auto-sync occurs after every 24 hours. Periodic is the default setting.

     Input Field	Description
     Auto-sync Poll Interval	Specify the time interval between two consecutive auto-sync polls. Default is 24 hours.
     Auto-sync Poll Timeout	Specify the timeout period for each auto-sync poll. Default is 15 minutes.

   • Select Daily to schedule an auto-sync poll at a specific time of a day. For example, you can schedule a daily auto-sync at 5.00 A.M.

     Input Field	Description
     Auto-sync Poll Interval	Specify the time of day to run the auto-sync poll.
     Time Zone	Specify the target time zone. By default, the BMC TrueSight Infrastructure Management Server time zone is selected.
     Auto-sync Poll Timeout	Specify the timeout period for each auto-sync poll. Default is 15 minutes.

   • Select Weekly to schedule an auto-sync poll on a specific day or specific days of the week. For example, you can schedule polls at 5:00 A.M. on Sundays and Thursdays.

     Input Field	Description
     Auto-sync Poll Interval	Specify the time of day to run the auto-sync poll.
     Time Zone	Specify the target time zone. By default, the BMC TrueSight Infrastructure Management Server time zone is selected.
     Days of the Week	Select the day or days to run the auto sync poll. Select all the days to trigger the auto sync poll every day.
     Auto-sync Poll Timeout	Specify the timeout period for each auto-sync poll. Default is 15 minutes.

6. On the Summary Details for Adapter screen, review the details. The total number of monitor types for BMC TM ART is always three: project monitors, location monitors, and transaction monitors. Perform one of the following actions:

   • If required, click Back to change the adapter details.
   • Click Finish to trigger an auto-sync poll. 

   
   Although the total number of monitors for BMC TM ART is three, four monitor types are loaded. A Target Availability monitor is automatically added for each BMC TM ART adapter instance. Target Availability is a TMART Server type monitor that provides a built-in statistical attribute which reflects the status of the BMC TM ART Central target. Target Availability is 100% if BMC TM ART Central is available; otherwise, the value is 0%. For more information about the Target Availability monitor, see Target Availability monitor type.