ARGetServerStatistics


Note

You can continue to use C APIs to customize your application, but C APIs are not enhanced to support new capabilities provided by Java APIs and REST APIs.

Description

Retrieves the requested statistics for the specified server. The counts returned generally represent the number of occurrences since starting the server. If a statistic reaches the maximum value for a long integer, the system resets the counter and begins incrementing again.

Privileges

All users.

Synopsis

#include "ar.h"
#include "arerrno.h"
#include "arextern.h"

int ARGetServerStatistics(
  ARControlStruct *control,
  ARServerInfoRequestList *requestList,
  ARServerInfoList *serverInfo,
  ARStatusList *status)

Input arguments

control

The control record for the operation. It contains information about the user requesting the operation, where that operation is to be performed, and which session is used to perform it. The user and server fields are required.

requestList

A list of one or more statistics to return (see the Statistics Options section that follows).

Return values

serverInfo

The statistics retrieved from the server (see the Statistic Options that follows). The system returns NULL (AR_DATA_TYPE_NULL) for statistics not retrieved due to error.

status

A list of zero or more notes, warnings, or errors generated from a call to this function. For a description of all possible values, see Error-checking.

Statistics options

Field Name (Server Statistics form)

Statistics options

Description

API Calls Count

AR_SERVER_STAT_API_REQUESTS (integer)

The total number of API requests received.

Bad Password Attempts

AR_SERVER_STAT_BAD_PASSWORD (integer)

The total number of times an incorrect password was specified during login.

API Requests Proc-Time

AR_SERVER_STAT_API_TIME (integer)

The total processor time (in 1/100 of a second) spent performing API function calls.

Floating Write Token Denied

AR_SERVER_STAT_NO_WRITE_TOKEN (integer)

The total number of times a user tried to connect and no floating write token was available.

Floating FTS Token Denied

AR_SERVER_STAT_NO_FULL_TOKEN (integer)

The total number of times a user tried to connect and no floating FTS token was available.

Number of Current Users

AR_SERVER_STAT_CURRENT_USERS (integer)

The total number of users currently accessing the system.

Fixed Write Lic Connections

AR_SERVER_STAT_WRITE_FIXED (integer)

The total number of connected users with fixed write licenses.

Floating Write Lic Connections

AR_SERVER_STAT_WRITE_FLOATING (integer)

The total number of connected users with floating write licenses.

Read Only Lic Connections

AR_SERVER_STAT_WRITE_READ (integer)

The total number of connected users with no write license.

Fixed FTS Lic Connections

AR_SERVER_STAT_FULL_FIXED (integer)

The total number of connected users with fixed FTS licenses.

Floating FTS Lic Connections

AR_SERVER_STAT_FULL_FLOATING (integer)

The total number of connected users with floating FTS licenses.

Non FTS Lic Connections

AR_SERVER_STAT_FULL_NONE (integer)

The total number of connected users with no FTS license.

Entries Calls Proc-Time

AR_SERVER_STAT_ENTRY_TIME (integer)

The total processor time (in 1/100 of a second) spent performing API function calls that manipulate entries.

DB Restructure Proc-Time

AR_SERVER_STAT_RESTRUCT_TIME (integer)

The total processor time (in 1/100 of a second) spent performing API function calls that restructure the database.

Non DB Restructure Proc-Time

AR_SERVER_STAT_OTHER_TIME (integer)

The total processor time (in 1/100 of a second) spent performing API function calls that do not manipulate entries or restructure the database.

Cache Loading Proc-Time

AR_SERVER_STAT_CACHE_TIME (integer)

The total processor time (in 1/100 of a second) spent loading the internal cache to improve performance.

Get Entry Calls Count

AR_SERVER_STAT_GET_E_COUNT (integer)

The total number of calls made to the ARGetEntry function.

Get Entry Proc-Time

AR_SERVER_STAT_GET_E_TIME (integer)

The total processor time (in 1/100 of a second) spent performing the ARGetEntry function.

Set Entry Calls Count

AR_SERVER_STAT_SET_E_COUNT (integer)

The total number of calls made to the ARSetEntry function.

Set Entry Proc-Time

AR_SERVER_STAT_SET_E_TIME (integer)

The total processor time (in 1/100 of a second) spent performing the ARSetEntry function.

Create Entry Calls Count

AR_SERVER_STAT_CREATE_E_COUNT (integer)

The total number of calls made to the ARCreateEntry function.

Create Entry Proc-Time

AR_SERVER_STAT_CREATE_E_TIME (integer)

The total processor time (in 1/100 of a second) spent performing the ARCreateEntry function.

Delete Entry Calls Count

AR_SERVER_STAT_DELETE_E_COUNT (integer)

The total number of calls made to the ARDeleteEntry function.

Delete Entry Proc-time

AR_SERVER_STAT_DELETE_E_TIME (integer)

The total processor time (in 1/100 of a second) spent performing the ARDeleteEntry function.

Merge Entry Calls Count

AR_SERVER_STAT_MERGE_E_COUNT (integer)

The total number of calls made to the ARMergeEntry function.

Merge Entry Proc-Time

AR_SERVER_STAT_MERGE_E_TIME (integer)

The total processor time (in 1/100 of a second) spent performing the ARMergeEntry function.

Get List Entry Proc-Time

AR_SERVER_STAT_GETLIST_E_TIME (integer)

The total processor time (in 1/100 of a second) spent performing the ARGetListEntry function.

Get List entry Calls Count

AR_SERVER_STAT_GETLIST_E_COUNT (integer)

The total number of calls made to the ARGetListEntry function.

Get Entry Stats Calls Count

AR_SERVER_STAT_E_STATS_COUNT (integer)

The total number of calls made to the ARGetEntryStatistics function.

Get Entry Stats Proc-Time

AR_SERVER_STAT_E_STATS_TIME (integer)

The total processor time (in 1/100 of a second) spent performing the ARGetEntryStatistics function.

Filter Execute Count

AR_SERVER_STAT_FILTER_PASSED (integer)

The total number of filters that were executed (qualification criteria met).

Filter Skipped Count

AR_SERVER_STAT_FILTER_FAILED (integer)

The total number of filters that were skipped (qualification criteria not met).

Filter Execute Disable Count

AR_SERVER_STAT_FILTER_DISABLE (integer)

The total number of filters that were evaluated but skipped because they were marked disabled.

Filter Notify Action Count

AR_SERVER_STAT_FILTER_NOTIFY (integer)

The total number of notify filter actions performed.

Filter Msg Action Count

AR_SERVER_STAT_FILTER_MESSAGE (integer)

The total number of message filter actions performed.

Filter Logging Action Count

AR_SERVER_STAT_FILTER_LOG (integer)

The total number of log filter actions performed.

Filter Set Field Action Count

AR_SERVER_STAT_FILTER_FIELDS (integer)

The total number of Set Fields filter actions performed.

Filter Run Process Action Count

AR_SERVER_STAT_FILTER_PROCESS (integer)

The total number of run process filter actions performed.

Filter Proc-Time

AR_SERVER_STAT_FILTER_TIME (integer)

The total processor time (in 1/100 of a second) spent checking and processing filters.

Escal Executed Count

AR_SERVER_STAT_ESCL_PASSED (integer)

The total number of escalations that were executed (qualification criteria met).

Escal Skipped Count

AR_SERVER_STAT_ESCL_FAILED (integer)

The total number of escalations that were skipped (qualification criteria not met).

Escal Execute Disable Count

AR_SERVER_STAT_ESCL_DISABLE (integer)

The total number of escalations that were evaluated but skipped because they were marked disabled.

Escal Notify Action Count

AR_SERVER_STAT_ESCL_NOTIFY (integer)

The total number of notify escalation actions performed.

Escal Log Action Count

AR_SERVER_STAT_ESCL_LOG (integer)

The total number of log escalation actions performed.

Escal Set Field Action Count

AR_SERVER_STAT_ESCL_FIELDS (integer)

The total number of Set Fields escalation actions performed.

Escal Run Process Action Count

AR_SERVER_STAT_ESCL_PROCESS (integer)

The total number of run process escalation actions performed.

Escal Proc-Time

AR_SERVER_STAT_ESCL_TIME (integer)

The total processor time (in 1/100 of a second) spent checking and processing escalations.

Queue Items Blocked Count

AR_SERVER_STAT_NUMBER_BLOCKED (integer)

The total number of blocked processes. This statistic, in conjunction with the AR_SERVER_STAT_TIMES_BLOCKED statistic, enables you to determine the approximate number of processes being blocked per instance. For example, if AR_SERVER_STAT_TIMES_BLOCKED is three and AR_SERVER_STAT_NUMBER_BLOCKED is six, the six blocked processes could be distributed in the following possible ways:

  • Two blocked processes in each of the three instances (2+2+2 = 6).
  • Three blocked processes in one instance, two blocked processes in one instance, and one blocked process in one instance (3+2+1 = 6).
  • Four blocked processes in one instance and one blocked process in both of the other two instances (4+1+1 = 6). In this example, the blocked processes could not be distributed as five in one instance, one in one instance, and none in one instance because, by definition, the number of instances represents those times when at least one process is blocked.

Num Queue Items Blocked Count

AR_SERVER_STAT_TIMES_BLOCKED (integer)

The total number of instances in which at least one process was blocked by the current process. This statistic, in conjunction with the AR_SERVER_STAT_NUMBER_BLOCKED statistic, enables you to determine the approximate number of processes being blocked per instance.

ARServer CPU Proc-Time

AR_SERVER_STAT_CPU (integer)

The total CPU time (in 1/100 of a second) used by the server.

DB SQL Commands Count

AR_SERVER_STAT_SQL_DB_COUNT (integer)

The total number of SQL commands sent to the database.

DB SQL Commands Proc-Time

AR_SERVER_STAT_SQL_DB_TIME (integer)

The total processor time (in 1/100 of a second) spent performing SQL commands.

FTS Execution Count

AR_SERVER_STAT_FTS_SRCH_COUNT (integer)

The total number of FTS operations performed.

FTS Execution Proc-Time

AR_SERVER_STAT_FTS_SRCH_TIME (integer)

The total processor time (in 1/100 of a second) spent performing FTS operations.

ARServer Idle Time

AR_SERVER_STAT_IDLE_TIME (integer)

The total idle time (in 1/100 of a second) of the server threads when the threads are not processing any requests. The idle time for each thread is determined each time it begins to process a new request. The idle time accumulated after the most recent activity in each thread is not included in this value. Therefore, the total idle time value can grow in an unexpected manner depending on the frequency of requests being handled by the server threads and how those requests are distributed amongst various threads. The accuracy of the idle time value will increase as the level of activity on the server increases and all threads are handling requests.

Network Responding Time

AR_SERVER_STAT_NET_RESP_TIME (integer)

The total time (in 1/100 of a second) spent on the network responding to the client.

Filter Push Field Action Count

AR_SERVER_STAT_FILTER_FIELDP (integer)

The total number of Push Fields filter actions performed.

Escal Push Field Action Count

AR_SERVER_STAT_ESCL_FIELDP (integer)

The total number of Push Fields escalation actions performed.

Filter Direct SQL Action Count

AR_SERVER_STAT_FILTER_SQL (integer)

The total number of direct SQL filter actions performed.

Escal Direct SQL Action Count

AR_SERVER_STAT_ESCL_SQL (integer)

The total number of direct SQL escalation actions performed.

Number of Threads

AR_SERVER_STAT_NUM_THREADS (integer)

The number of threads in a particular queue.

Filter Goto Action Count

AR_SERVER_STAT_FILTER_GOTO_ACTION (integer)

The number of filter actions that branch to another process.

Filter Call Guide Action Count

AR_SERVER_STAT_FILTER_CALL_GUIDE (integer)

The number of filter guide actions that call another process.

Filter Exit Guide Action Count

AR_SERVER_STAT_FILTER_EXIT_GUIDE (integer)

The number of filter guide actions that are terminated.

Filter Goto Guide Label Action Count

AR_SERVER_STAT_FILTER_GOTO_GUIDE_LB

 

The number of goto guide actions.

Filter Set Field Action - SQL Count

AR_SERVER_STAT_FILTER_FIELDS_SQL (integer)

The number of filters that modify SQL fields.

Filter Set Field Action - $Process$ Count

AR_SERVER_STAT_FILTER_FIELDS_PROCESS (integer)

The number of filter actions that modify fields.

Filter Set Field Action - Filter API Count

AR_SERVER_STAT_FILTER_FIELDS_FLTAPI70 (integer)

The number of filter actions that modify fields through the API.

Filter Set Field Action - Filter API Count

AR_SERVER_STAT_FILTER_FIELDS_FLTAPI

The number of filters that modify fields through the API.

Escalation Set Field Action - SQL Count

AR_SERVER_STAT_ESCL_FIELDS_SQL (integer)

The number of escalations that modify SQL fields.

Escalation Set Field Action - $Process$ Count

AR_SERVER_STAT_ESCL_FIELDS_PROCESS (integer)

The number of escalations that modify fields.

Escalation Set Field Action - Filter API Count

AR_SERVER_STAT_ESCL_FIELDS_FLTAPI

The number of escalations that modify fields through the API.

Restricted Read Only Connections

AR_SERVER_STAT_WRITE_RESTRICTED_READ (integer)

The total number of connected users with restricted read licenses.

See also

ARGetServerInfo. See FreeAR for: FreeARServerInfoList, FreeARServerInfoRequestList, FreeARStatusList.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*