Configuring the ITDA monitor type

Java Home Path

Location of the Java Runtime Environment (JRE) used by PATROL Agent.

If you installed the JRE in a new location, other than the following PATROL default locations, then you need to specify this value.

• Windows: %JAVA_HOME%
• UNIX: $JAVA_HOME/..

For information about the JRE versions supported, see System-requirements.

The value of this field is the absolute path to the JRE.

Example: C:\Program Files (x86)\JAVA\jre64

Agent Name

Name of the Collection Agent that you want to configure

Station Configuration Protocol

Select HTTP or HTTPS depending on whether you want to use secure connection between PATROL for IT Data Analytics and the Collection Station component in IT Data Analytics.

Before you select HTTPS, ensure that you have performed the steps described in Enabling-security-for-the-Collection-Station in the IT Data Analytics online documentation portal.

JVM Options

(Optional) Specify the JRE options for which you want to change values.

You might want to change these values to perform advanced functions such as changing the heap size. For example, if you find the Java Heap OutOfMemory error in the collection.log file located at %PATROL_HOME%\bww\udc\logs, then you need to increase the default value for the Java heap size used for the Collection Agent.

For more information about specifying the JRE options, see the following link:

You can specify multiple JRE options by specifying a space-separated list.

Example: -XX:MaxHeapFreeRatio=70 -XX:MaxPermSize=64m

Station Configuration Host

Host name of the server where the Collection Station is installed.

Station Configuration Port

Port number of the server where the Collection Station is installed.

The Collection Station default port is set to 8080. This value must be same as that which you provide at the time of installing the TrueSight IT Data Analytics product.

Collection Profile

(Optional) Specifies the name of the collection profile that you want to associate with the Collection Agent for creating data collectors on TrueSight IT Data Analytics.

Note that if you want to associate a collection profile that is imported via a content pack, then you need to specify the name in the format, "<collectionProfileName> [<contentPackName>]." For example, to associate a collection profile "OracleCP" imported via the content pack "Database Pack", you need to specify, OracleCP [Database Pack].

Macro Name

(Optional) Name of the macro associated with the collection profile for which you want to override values.

You need to ensure that you specify a corresponding value in the Macro Value field.

Macro Value

(Optional) New value for the macro specified in the Macro Name field.

Collection Agent Property Name

(Optional) Specify the property name in the agent.properties file located at %PATROL_HOME%\bww\udc\conf\agent.properties for which you want to modify the value.

You can modify the value for any of the following properties:

• collection.thread.pool.size
  Indicates the total number of reader threads used for collecting data.
• collection.reader.batch.size
  Indicates the number of records that the Collection Agent reads at one time and forwards the results to the Collection Station.
• collection.reader.throttle.bytes.threshold
  Indicates the maximum number of bytes read (per reader thread) before triggering a delay
• collection.reader.throttle.delay
  Indicates the delay in milliseconds per reader thread. This property is used with the collection.reader.throttle.bytes.threshold property.

You can change the default value of the property by specifying its name and specifying a corresponding value in the Collection Agent Property Value field. This feature provides a means to change the properties in the agent.properties file. These changes might be required for making advanced configurations to improve the performance of the Collection Agent.

Note: The property values specified on the user interface take precedence over the values available in the agent.properties file.

Collection Agent Property Value

(Optional) Specify the corresponding value for the property name specified in the Collection Agent Property Name field.

Example:

If you want to change the collection thread pool size from 2 to 3, then you need to specify the following inputs:

Specify 3 in this field and ensure that you have specified collection.thread.pool.size in the Collection Agent Property Name field.

Add to List

Click this option for confirming the configuration information that you provided such that you finally you can see the Agent name added to the list of configured objects.

Modify Selection

Select one of the items that you added to the list in the preceding step, and click this option to modify details.

Remove from List

Select the items added earlier and click this option to delete that item from the list of configured objects and the clear the details provided in the earlier fields.

Add

Click this option to add this monitoring configuration. This information is displayed on the Monitor Configuration page.

After you click this option, you can continue to add more objects for monitoring.

Reset

Click this option to clear off your configuration details and revert to default settings.

Close

Click this option to exit without saving any changes.