Process service
Process service
Log Track Supported: Yes
Config Track Supported: Yes
Custom Properties Supported:
| Name | Description |
|---|---|
| user | User |
| group | Group |
| exe | Executable |
| cwd | Current Working Directory |
Supported Control Actions: kill,SIGHUP,SIGINT,SIGQUIT,SIGKILL,SIGTERM,SIGUSR1,SIGUSR2
Supported Metrics:
| Name | Alias | Units | Category | Default On | Default Interval |
|---|---|---|---|---|---|
| Availability | Availability | percentage | AVAILABILITY | true | 10 min |
| Virtual Memory Size | VirtualMemSize | B | UTILIZATION | false | 5 min |
| Resident Memory Size | ResidentMemSize | B | UTILIZATION | true | 5 min |
| Cpu System Time | SystemTime | ms | UTILIZATION | false | 10 min |
| Cpu System Time per Minute | SystemTime1m | ms | UTILIZATION | false | 10 min |
| Cpu User Time | UserTime | ms | UTILIZATION | false | 10 min |
| Cpu User Time per Minute | UserTime1m | ms | UTILIZATION | false | 10 min |
| Cpu Total Time | TotalTime | ms | UTILIZATION | false | 10 min |
| Cpu Total Time per Minute | TotalTime1m | ms | UTILIZATION | false | 10 min |
| Cpu Usage | Usage | percentage | UTILIZATION | true | 5 min |
| Start Time | StartTime | epoch-millis | AVAILABILITY | false | 10 min |
| Open File Descriptors | OpenFd | none | UTILIZATION | false | 5 min |
| Threads | Threads | none | UTILIZATION | false | 5 min |
Configuration help:
Monitoring of an individual process or group of processes requires a process query to differentiate them from other system processes. This is achieved using Process Table Query Language, or PTQL, a simple query language for finding processes based based on their attributes.
PTQL Queries must be in the following format:
Class.Attribute.operator=value
Where:
- Class is the name of the Sigar class minus the Proc prefix.
- Attribute is an attribute of the given Class, index into an array or key in a Map class.
- operator is one of the following for String values:
- eq - Equal to value
- ne - Not Equal to value
- ew - Ends with value
- sw - Starts with value
- ct - Contains value (substring)
- re - Regular expression value matches
- operator is one of the following for numeric values:
- eq - Equal to value
- ne - Not Equal to value
- gt - Greater than value
- ge - Greater than or equal value
- lt - Less than value
- le - Less than or equal value
Multiple queries must delimited by a comma.
Examples:
Find JBoss using process name
State.Name.eq=java,Args.*.eq=org.jboss.Main
Find SSHd using a pid file
Pid.PidFile.eq=/var/run/sshd.pid
For more examples see the pdk/lib/.sigar_shellrc file included in the HQ agent distribution and the Sigar PTQL Documentation.
General Log and Config Track Properties
- Enable Config Tracking - Check to enable config tracking.
- Configuration Files - Comma delimited list of configuration files to track. Relative files are resolved to ${installpath}.
- Enable Log Tracking - Check to enable log tracking.
- Track event log level - Only track events of level greater than or equal to this level. Order is: [Error, Warn, Info, Debug]
- Log Pattern Match - Include messages that match the given regular expression. The given pattern can be a substring to look for in log messages or a regular expression. See: java.util.regex.Pattern.
- Log Pattern Exclude - Exclude messages that match the given regular expression.
- Log Files - Comma delimited list of log files to track. Relative files are resolved to ${installpath}.