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:
|
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 |
| The number of goto guide actions. |
Filter Set Field Action - SQL Count |
| 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 |
| 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
.
Comments
Log in or register to comment.