Show TOC

Procedure documentationActivating and Configuring the Activity Data Collector Locate this document in the navigation structure

Procedure

Activate and configure the activity data collector by modifying properties of the DataCollectionHook portal service, and then restarting the service.

The activity data collector writes each record to the main file, as specified by the Main File Format property, and additional files as specified by the Additional FileFormats property.

  1. Navigate to   System Administration   System Configuration   Service Configuration  .

  2. In the Portal Catalog, navigate to the portal service at   Applications   com.sap.portal.activitydatacollector   Services   DataCollectionHook  .

  3. Right-click DataCollectionHook, and select Configure.

  4. Set the following properties:

    Property

    Description

    Activate Data Collector

    Turns on the data collector and starts creating data files.

    Valid values are true (activated) and false (not activated). The default is false.

    Additional File Formats

    The formats for additional data files.

    Place each file format inside braces, without a separator, as follows:

    {<format1>} {<format2>). . .

    The file name of each additional file is in the format:

    add_<seq>_<base name>_<nodeID>_<timestamp>

    where:

    • seq is a sequence number.

    • base name is defined by the Base File Name property.

    • nodeID is the ID of the server node in the cluster.

    • timestamp is the time the file was created.

    For more information on specifying the file format, seeFile Formats.

    Base File Name

    The base string from which to build each data file name, as described in the Main File Format and Additional File Formats properties.

    Directory Name

    The directory in which the data file is written, either:

    • Relative to the <System ID><Instance ID>/j2ee/cluster/server0 directory

    • An absolute path on the server, starting with <Drive>:\

    File Encoding

    The file encoding of the data files.

    The default is UTF-8.

    Hour in the day to close all files

    The hour in the day to close all open files and start writing to a new file, in GMT.

    It may take up to two hours from the specified hour for the file to close.

    0 = midnight, 23 is 11 p.m.

    Main File Format

    The format for the main file.

    The file name of the main file is in the format:

    _<base name>_<nodeID><timestamp>

    where:

    • base name is defined by the Base File Name property.

    • nodeID is the ID of the server node in the cluster.

    • timestamp is the time the file was created.

    For more information on specifying the file format, seeFile Formats

    Max Buffer Size

    The amount of data to store in memory before writing the data to a file, in kilobytes.

    Note Note

    The value for this property can significantly affect performance, and it is best to experiment to find the best value.

    Generally, a high number reduces the number of calls to the database, improving performance, but also requires more data to be written for each call, which hurts performance.

    The default values are designed to work well with the default service configuration, including the default file formats.

    End of the note.

    Max File Size

    The maximum file size, in kilobytes, for the main file before closing all data files and starting to write to new files.

    Files may be closed before reaching this limit, as all files are closed at the hour specified in the Hour in the day to close all files property.