Configuring the ITDA monitor type

This topic provides information about configuring the ITDA monitor type by using Central Monitoring Administration. The ITDA monitor type can be used to configure Collection Agents that help you collect data from target hosts and send it to TrueSight IT Data Analytics (IT Data Analytics). 

On the Add Monitor Types dialog, with the Monitoring Profile set to ITDA and the Monitor Type set to ITDA, provide the following details: 

FieldDescription
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

Collection Agent Configuration
Agent NameName 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
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.
Agent Properties
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 SelectionSelect one of the items that you added to the list in the preceding step, and click this option to modify details.
Remove from ListSelect 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.

ResetClick this option to clear off your configuration details and revert to default settings.
CloseClick this option to exit without saving any changes.

Related topics

PATROL Agent configuration variables

Known and corrected issues

Was this page helpful? Yes No Submitting... Thank you

Comments