Server-Related Information

Use

The Landscape: Services window displays information about the TREX servers.

Features

The window consists of the tab pages MMC, Services, Threads, Handles and Load.

Tab Page 'MCC' (SAP Management Console)

The tab page MCC (SAP Management Console) displays the following data in tabular form:

Column	Description
Host	Displays the hosts on which the TREX servers are running.
Instance	Displays the name of the TREX instance.
Process	Displays the central TREX process.
Description	Description of the displayed process.
Status	Displays the status of the TREX server (running, stopped, started).
Start Time	Starting time
Elapsed Time	Time elapsed since the TREX server was started.

With the function keys Start and Stop and with the context menu you can start and stop the relevant TREX servers. More information:Starting and Stopping the TREX Servers.

Services Tab Page

The tab page displays the load on the TREX servers in a table. There is a separate row for each TREX server. The columns contain the following information:

Column	Description
<traffic light>, Host, Port, Service	Displays which TREX servers are available, the hosts on which they are running, and the ports they use. Note The Service column displays the server type, for example indexserver. There might be not only TREX servers but also other programs such as Python scripts. In the case of programs of this type, the column contains the value other.
Process ID	Process IDs of the running TREX processes. The TREX RFC server can be configured so that more than one instance runs. The column then displays the corresponding number of process IDs.
CPU/Service Parameters	CPU load. The CPU load is displayed graphically in the form of a bar. The bar displays the CPU load for the entire host (hatched) as well as the proportion of the process (block). The proportion of the process is not precise in the case of most operating systems. It is merely a guide. If you display the context menu you can see the CPU load in percentage form. If the CPU load is more than 75% the system status may be critical. However, it may also be the case that the system was deliberately configured to allow such a load. For detailed information on CPU load, use operating system methods such as the Windows Task Manager. In the case of some TREX processes, the load cannot be depicted. Instead, the column contains the following information: In the case of the TREX Web server, the URL is displayed. In the case of the TREX RFC server, the RFC destination is displayed. In the case of other programs, such as Python scripts, the section name that is entered in the TREXDaemon.ini configuration file is displayed.
Memory	Memory load. The memory load is displayed graphically in the form of a bar. The bar displays the memory load for the entire host (hatched) as well as the proportion of the process (block). When you open the context menu for a process, you can see the following information about the memory: Main memory in KB that is used by all processes (Memory (All)) Main memory in KB that is used by the selected process (Memory (<Process>)) Total main memory available in KB (Memory Available) The entire amount of main memory available include physical and virtual memory (swap file). The higher the memory load, the slower the processing. A very high load can indicate a critical system status. This may occur if a process takes up almost the maximum amount of main memory. Depending on the operating system configuration, the maximum lies between 2 and 3.75 GB per process.
Threads	Number of active threads.
Act. Req., Pend. Req.	Number of requests that a TREX server is currently processing and that are waiting to be processed. If the values in these two columns are particularly high, the TREX server may be overloaded.
Finished Req.	Number of requests that the TREX server has processed since it was started.
Resp. Time	Average duration of a request in seconds. If a TREX server has the value 0, it has not received any requests. This might indicate that the TREX server is configured incorrectly. In the case of a distributed TREX system, the absolute value of a TREX server is less interesting that its value in comparison with other the TREX servers. For example, you can check whether all index servers have similar values. If this is the case, the load is equally distributed among the index server.
Request/Sec	Average number of requests processed by a TREX server per second.

If a cell does not contain any values, the TREX server has not returned any values to the TREX admin tool. Possible reasons are:

The TREX server is not available
The TREX server is overloaded

Threads Tab Page

On the Threads tab page, you can see which threads are currently executing which methods. You can also see how long processing of a method has taken so far.

Column	Description
Host, Port, Service	Displays which TREX servers are running on which hosts and which ports they are using.
Hierarchy	Specifies whether the thread was generated by another thread. If this is the case, the thread is displayed with a circle. If there are no dependencies, a triangle is displayed.
Thread ID	Thread ID
Thread Type	Thread type, for example, request
Method	Specifies the method that the thread is executing.
Detail	Specifies details on the active thread.
Duration	Specifies the time that the thread has already required for processing the method.

To export the information displayed, use the secondary mouse button to click an entry in the table and choose the command Export Table As CSV.

Handles Tab Page

On the Handles tab page, you can see the number of handles that a process has generated and is using.

The open_handles check in the TREX alert server also lists all handles used.

Column	Description
Host, Port, Command	Displays which command is executed on which host and which port is used.
Process ID	Process IDs of the running TREX processes.
Handles	Number of handles used by the process. The value comes from the total of sockets, files, and unknown handles.
Sockets	Number of sockets used by the process.
Files	Number of files opened by the process.

To export the information displayed, use the secondary mouse button to click an entry in the table and choose the command Export Table As CSV.

To list all handles for a process or the handles for all services in a separate window, use the secondary mouse button to click a table entry and choose the command Handles for Process <Process ID@Host> or Handles for All Services @<Host>.

Note

You have specified the maximum permitted number of handles during installation in the Number of open files per process parameter.

Load Tab Page

On the Load tab page, you can display various key figures for the TREX servers in relation to time in a graphic. The key figures include memory load and CPU load, for example.

In the bottom-left screen area, you can select the host for which you want to display the key figures.

In the bottom-right screen area, you can select the key figures that you want to display in the diagram (upper screen area). This screen area also displays information about the Y-axis and the maximum and average values for the key figures.

You can see the division of the X-axis, which shows the time, in a dropdown box below the tab pages.

The key figures are displayed in different colors. The graph for a selected key figure is displayed in bold.

Exporting Key Figures

You can use the Export button to export the values displayed to a csv file.