Trex Queues Test

The queue server coordinates the processing steps that take place during indexing. It collects incoming document, triggers preprocessing by the preprocessor, and further processing by the index server.

The queue server enables documents to be indexed asynchronously. This has the advantage that you can control the time of indexing. For example, you can schedule indexing for times when the system load is lower because there are fewer search queries.

In addition, the queue server can trigger index replication and integration of the delta index in the main index.

A queue is a store in which the queue server collects documents to be indexed and administration information.

There is a queue for each index. The queue server creates a queue automatically as soon as you create a new index. The queue has the same ID as the index.

A queue has several parameters that control the behavior of the queue. In particular, the parameters specify when the queue server triggers indexing and optimization of documents. It is important for performance reasons that you have optimum settings for the queue parameters.

This test auto-discovers the queue groups in the target SAP TREX server and reports the number of queues that were idle, suspended, stopped etc in each queue group. Using this test, administrators can figure out the exact number of queues that were idle and were taking too long to process the requests.

Target of the test : A SAP TREX

Agent deploying the test : An internal agent

Outputs of the test : One set of results for each queue group of the target SAP TREX server that is to be monitored

Configurable parameters for the test
Parameter Description

Test Period

How often should the test be executed

Host

The host for which the test is to be configured.

Port

Specify the port at which the specified host listens. By default, this is 30001.

TREX Directory

Specify the full path to the SAP TREX instance that is to be monitored for e.g., the location can be specified as D:\usr\sap\TRX\TRX01.

Include Queue Group Patterns

Specify a comma-separated list of patterns (identified on the queues) that should be included in the scope of monitoring of this test. By default, none is specified here.

Exclude Queue Patterns

Specify a comma-separated list of patterns (identified on the queues) that should be excluded from the scope of monitoring of this test. By default, none is specified here.

Timeout

Specify the duration (in seconds) beyond which this test should time out in the Timeout text box. The default is 120 seconds.

Detailed Diagnosis

To make diagnosis more efficient and accurate, the eG Enterprise embeds an optional detailed diagnostic capability. With this capability, the eG agents can be configured to run detailed, more elaborate tests as and when specific problems are detected. To enable the detailed diagnosis capability of this test for a particular server, choose the On option. To disable the capability, click on the Off option.

The option to selectively enable/disable the detailed diagnosis capability will be available only if the following conditions are fulfilled:

  • The eG manager license should allow the detailed diagnosis capability
  • Both the normal and abnormal frequencies configured for the detailed diagnosis measures should not be 0.
Measures made by the test:
Measurement Description Measurement Unit Interpretation

Idle queues

Indicates the number of queues that were idle in this queue group.

Number

The queue server has a status for each queue. If the status of the queue server is idle, then , it means that the queue server is collecting incoming documents and triggering their preprocessing.

Indexing queues

Indicates the number of queues that were in the indexing state in this queue group.

Number

If the queues are in indexing state, then it means that the queue server is transmitting documents to the index server and triggering indexing.

Optimizing queues:

Indicates the number of queues that were in the optimizing state in this queue group.

Number

If the queues are in optimizing state, then, it means that the queue has triggered optimization and is waiting for a response from the index server.

Suspend-in-progress queues

Indicates the number of queues that were in Suspend-in-Progress state in this queue group.

Number

 

Suspended queues

Indicates the number of queues that were in Suspended state in this queue group.

Number

 

Stopped queues

Indicates the number of queues that were in Stopped state in this queue group.

Number

 

Invalid queues

Indicates the number of queues that were invalid in this queue group.

Number

 

Repairing queues

Indicates the number of queues that were in Repairing state in this queue group.

Number

 

Merging queues

Indicates the number of queues that were in Merging state in this queue group.

Number

 

Replicating queues

Indicating the number of queues that were in Replicating state in this queue group.

Number

 

Rolling back queues

Indicates the number of queues that were in Rolling Back state in this queue group.

Number

 

Total queues

Indicates the total number of queues in this queue group.

Number

This measure will not appear for the individual queues being monitored by this test.

Queue documents to be preprocessed

Indicates the number of queue documents that were in the To Be Preprocessed state in this queue group.

Number

 

Preprocessing queue documents

Indicates the number of queue documents that were in the Preprocessing state in this queue group.

Number

 

Queue documents with preprocessing failure

Indicates the number of queue documents that were in the Preprocessing Failed state in this queue group.

Number

 

Queue documents to be transmitted

Indicates the number of queue documents that were preprocessed and waiting to be transmitted for indexing in this queue group.

Number

 

Queue documents being transmitted

Indicates the number of queue documents that were being transmitted to an index server from this queue group.

Number

 

Queue documents with transmission failure

Indicates the number of queue documents that could not be transmitted to the index server from this queue group.

Number

 

Queue documents to be synchronized

Indicates the number of queue documents from this queue group that were waiting to be optimized.

Number

 

Queue documents synchronizing

Indicates the number of queue documents from this queue group that were being optimized.

Number

 

Queue documents undergoing synchronization failure:

Indicates the number of queue documents from this queue group that could not be optimized.

Number

 

Queue documents synchronized

Indicates the number of queue documents from this queue group that were processed successfully.

Number

 

Queue documents delayed

Indicates the number of queue documents from this queue group that were in Delayed state.

Number

 

Invalid queue documents

Indicates the number of queue documents from this queue group that were invalid.

Number