Agent and modules generated by the plugin
The plugin will create one agent per instance. In simple mode, the name will be taken from the URL. In advanced mode, one agent will be created for each block sent, and the name will be defined by the agent name field; if not specified, the name will be taken from the URL. The metrics depend on the configuration and version of the Apache server. On a recent Apache installation with all features enabled, you will get all metrics. Each agent will contain the modules obtained by interacting with the server status page. The modules to be created are as follows:
Translated with DeepL.com (free version)
| Module | Description |
|---|---|
| ServerVersion | The Apache service version (e.g., Apache/2.4.62) |
| ServerMPM | The Multi-Processing Module (MPM) currently in use by Apache (e.g., event, prefork, worker) |
| ServerBuilt | The date and time when the Apache server binary was compiled |
| ParentServerConfigGeneration | The configuration generation of the parent Apache process. Increments with each graceful restart. |
| ParentServerMPMGeneration | The MPM generation of the parent Apache process |
| ServerUptimeSeconds | The service uptime expressed in seconds |
| Load1 | The system load average over the last 1 minute |
| Load5 | The system load average over the last 5 minutes |
| Load15 | The system load average over the last 15 minutes |
| TotalAccesses | The total number of client requests received by the server since its last start/restart. Calculated as a rate of change for the Total requests statistics. |
| TotalKBytes | The total kilobytes of data served by the Apache server since its last start/restart |
| TotalDuration | The cumulative time spent processing all requests since the server started (in microseconds or milliseconds, depending on Apache version and configuration) |
| CPUUser | The CPU time used by Apache processes in user mode since the server started, expressed as a percentage |
| CPUSystem | The CPU time used by Apache processes in system (kernel) mode since the server started, expressed as a percentage |
| CPUChildrenUser | The CPU time used by child processes of Apache in user mode |
| CPUChildrenSystem | The CPU time used by child processes of Apache in system (kernel) mode |
| CPULoad | The overall CPU load percentage consumed by all Apache processes combined since the server started |
| Uptime | The human-readable representation of the server's uptime (e.g., '2 days 4 hours 40 minutes'). Derived from ServerUptimeSeconds. |
| ReqPerSec | The average number of requests served per second since the server was started/restarted. Not used, as it counts the average since the last Apache server start. |
| BytesPerSec | The average number of bytes served per second since the server was started/restarted. Not used, as it counts the average since the last Apache server start. |
| BytesPerReq | The average number of bytes served per request since the server was started/restarted |
| DurationPerReq | The average duration (time) it took to serve each request since the server was started/restarted (in milliseconds or microseconds) |
| BusyWorkers | The total number of worker threads/processes that are currently busy handling requests |
| GracefulWorkers | The number of worker processes that are currently in a graceful shutdown state |
| IdleWorkers | The total number of worker threads/processes that are currently idle and ready to handle new requests |
| Processes | The number of active Apache processes (not threads) currently running |
| Stopping | The number of worker processes that are in a stopping state |
| ConnsTotal | The total number of connections to the Apache server |
| ConnsAsyncWriting | The number of asynchronous connections in writing state (applicable only to the event MPM) |
| ConnsAsyncKeepAlive | The number of asynchronous connections in keep-alive state (applicable only to the event MPM) |
| ConnsAsyncClosing | The number of asynchronous connections in closing state (applicable only to the event MPM) |
| CacheType | The type of cache mechanism being used by Apache (e.g., SHMCB for shared memory caching) |
| CacheSharedMemory | The total amount of shared memory allocated for the cache (in bytes or kilobytes) |
| CacheCurrentEntries | The current number of entries stored in the cache |
| CacheSubcaches | The number of subcaches within the main cache |
| CacheIndexesPerSubcaches | The number of index entries per subcache |
| CacheIndexUsage | The percentage of the cache index space currently in use |
| CacheUsage | The overall percentage of the cache memory currently in use |
| CacheStoreCount | The total number of times an item has been successfully stored in the cache |
| CacheReplaceCount | The total number of times an existing cache entry has been replaced |
| CacheExpireCount | The total number of times a cache entry has expired |
| CacheDiscardCount | The total number of times a cache entry has been discarded (e.g., due to space limits or errors) |
| CacheRetrieveHitCount | The total number of times a requested item was found in the cache (cache hit) |
| CacheRetrieveMissCount | The total number of times a requested item was not found in the cache (cache miss) |
| CacheRemoveHitCount | The total number of times an item was successfully removed from the cache when it was found |
| CacheRemoveMissCount | The total number of times an item was attempted to be removed from the cache but was not found |
