Knowledge Discovery 25.1
Knowledge Discovery Expert

# Use Statistics to Monitor Your Components

In addition to using HTTP requests to monitor the status of your components, you can submit the `GetStatistics` action to the service port of a Knowledge Discovery component to retrieve internal statistics for the service. The response is in formatted XML, and each statistic is identified by a `class`, `autnid`, and `name`. For example:

    <autn:stat class="Service" autnid="Statistics" name="24HourRequestsPerSecond" metric="3" value="8.5" />

You can also use the `MemoryReport` and `DiskReport` ACI actions to retrieve statistics on the use of system resources.

For more information on these actions, refer to the relevant component reference, for example the Content Component Help.

## ACI Requests

To view statistics for ACI requests, you can either submit a `GetStatistics` action, or you can use the ACI secondary tab on the Statistics tab of the Performance page in the Monitor section of Knowledge Discovery Admin.

Statistics for ACI requests are identified by `class=“Service”` and `autnid =“Statistics`”, and include information on the total number of requests, the average response time, the number of requests per second, and the number of requests generating a warning or an error. You can view statistics for the last 10 seconds, 60 seconds, one hour, or 24 hours.

You can use these statistics to monitor response times, or check if a particular component is receiving an unusually high rate of requests.

The `GetStatistics` response also includes detailed statistics on individual ACI actions (for example, `Query`, `Suggest`, and so on). These are identified by `class=“ACI”` and `autnid =“Action:*”`.

## Index Queue

Statistics for components with an index queue (for example, Content and DIH ) are identified by `class=“Indexer”` and `autnid=“Queue”`. The statistics provide information on the number of index jobs currently at each stage of processing. You can use the statistics to monitor whether a backlog of uncompleted jobs is building up.

The `Queued` statistic for the Content component lists the number of jobs in the queue that are still awaiting processing.

The `Queued` statistic for the DIH lists only those jobs that DIH has not yet assigned to a child engine; the `QueuedForChildren` statistic lists the number of jobs waiting to be sent to, or processed by, child engines. DIH also provides an `Uncompleted` statistic, which lists the total number of uncompleted jobs.

TIP: You can also use the `GetStatus` ACI action to retrieve index queue statistics for Content and DIH. If you need to monitor other information from the `GetStatus` response, it might be more efficient to use it to monitor the size of the index queue as well, rather than submitting an additional `GetStatistics` request.

You can also use the Indexer secondary tab on the Statistics tab of the Performance page in the Monitor section of Knowledge Discovery to monitor index queue statistics.

## Memory Report

The ``MemoryReport`` ACI action returns the total amount of memory used by the Knowledge Discovery process (`processmemoryinfo/procsize_kb`) as well as its current physical memory size (`processmemoryinfo/procresident_kb`). You can use this information to check for runaway memory usage.

Some components provide a more detailed breakdown of memory usage; for example, you can use the Content component `MemoryReport` response to monitor the amount of memory that is currently in use by a particular field type, or by different caches.

Various statistics on system-wide use of memory resources are also provided under `systemmemoryinfo`.

For more information on this action, refer to the Content Component Help.

You can also use the Memory and Memory Map tabs on the Performance page in the Monitor section of Knowledge Discovery Admin to view information about system and process memory usage.

## Disk Report

The `DiskReport` ACI action returns the amount of disk space used by the component’s data directories. Some Knowledge Discovery components break this down by the type of data stored; for example, Content reports figures for disk space used by the Index, Received Data, License, Logs, and Language Files.

You can specify the `MaxDepth` parameter to break this down further, for example to monitor when the Content index exceeds a specified threshold in terms of size on disk.

For more information on this action, refer to the relevant component reference, such as the Content Component Help.

You can also use the Disk Report tab on the Performance page in the Monitor section of Knowledge Discovery Admin to view information about the disk usage of directories and files in the working directory for each component.

Related Topics

- File System Connector

- Monitor the Status of Knowledge Discovery Components

- Reduce_Memory_Usage

Copyright 2024 Open Text
Version 25.1 | Last updated January 2025

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to MFI-swpdl.idoldocsfeedback@opentext.com.

We appreciate your feedback!

Product: Knowledge Discovery 25.1

Topic Title: Use Statistics to Monitor Your Components