Skip to content

AIX Process

AIX Process collector collects process objects through ps and reports them in the DataKit host_processes object format.

Configuration

[collectors.process]
# Whether to enable the process object collector.
enabled = true
# Collection interval.
interval = "300s"
# Ignore short-lived processes whose runtime is less than this value.
min_run_time = "10m"

min_run_time filters out processes that have run for too short a time. If ps output cannot provide runtime and min_run_time is configured, this collection reports an error and emits no data to avoid excessive object volume from short-lived processes.

Command Dependencies

Command Description
ps -eo user,pid,ppid,pcpu,pmem,etime,time,state,args Collect user, PID, parent PID, CPU, memory, elapsed runtime, CPU time, state, and command line.

Objects

host_processes

Tags & Fields Description
name
(tag)
Unique process object name in the format <host>_<pid>.
process_name
(tag)
Short process name extracted from the first command-line field.
state
(tag)
First letter of the process state.
username
(tag)
Process user.
host
(tag)
Hostname.
pid Process PID.
Type: int | (gauge)
ppid Parent process PID.
Type: int | (gauge)
cmdline Full command line.
Type: string | (gauge)
cpu_usage ps Current CPU usage.
Type: float | (gauge)
Unit: percent
cpu_usage_top Top-style CPU usage calculated from the CPU time delta; the first collection falls back to cpu_usage.
Type: float | (gauge)
Unit: percent
mem_used_percent Process memory usage.
Type: float | (gauge)
Unit: percent
started_duration Process runtime in seconds.
Type: int | (gauge)
Unit: sec
start_time Process start time, in Unix milliseconds.
Type: int | (gauge)
Unit: ms
state_zombie Whether the process is a zombie.
Type: bool | (gauge)
message Object detail JSON.
Type: string | (gauge)

Feedback

Is this page helpful? ×