System¶
The system collector collects system load, uptime, the number of CPU cores, and the number of users logged in.
Configuration¶
Preconditions¶
None
Collector Configuration¶
Go to the conf.d/host
directory under the DataKit installation directory, copy system.conf.sample
and name it system.conf
. Examples are as follows:
[[inputs.system]]
##(optional) collect interval, default is 10 seconds
interval = '10s'
[inputs.system.tags]
# some_tag = "some_value"
# more_tag = "some_other_value"
After configuration, restart DataKit.
Can be turned on by ConfigMap Injection Collector Configuration or Config ENV_DATAKIT_INPUTS .
Can also be turned on by environment variables, (needs to be added as the default collector in ENV_DEFAULT_ENABLED_INPUTS):
-
ENV_INPUT_SYSTEM_INTERVAL
Collect interval
Type: TimeDuration
input.conf:
interval
Default: 10s
-
ENV_INPUT_SYSTEM_TAGS
Customize tags. If there is a tag with the same name in the configuration file, it will be overwritten
Type: Map
input.conf:
tags
Example: tag1=value1,tag2=value2
Metric¶
For all of the following data collections, a global tag named host
is appended by default (the tag value is the host name of the DataKit), or other tags can be specified in the configuration through [inputs.system.tags]
:
system
¶
Basic information about system operation.
- tag
Tag | Description |
---|---|
host |
hostname |
- metric list
Metric | Description | Type | Unit |
---|---|---|---|
cpu_total_usage |
The percentage of used CPU. | float | percent |
load1 |
CPU load average over the past 1 minute. | float | - |
load15 |
CPU load average over the past 15 minutes. | float | - |
load15_per_core |
CPU single core load average over the past 15 minutes. | float | - |
load1_per_core |
CPU single core load average over the past 1 minute. | float | - |
load5 |
CPU load average over the past 5 minutes. | float | - |
load5_per_core |
CPU single core load average over the last 5 minutes. | float | - |
memory_usage |
The percentage of used memory. | float | percent |
n_cpus |
CPU logical core count. | int | count |
n_users |
User number. | int | count |
process_count |
Number of Processes running on the machine. | int | - |
uptime |
System uptime. | int | s |
conntrack
¶
Connection track metrics (Linux only).
- tag
Tag | Description |
---|---|
host |
hostname |
- metric list
Metric | Description | Type | Unit |
---|---|---|---|
entries |
Current number of connections. | int | count |
entries_limit |
The size of the connection tracking table. | int | count |
stat_drop |
The number of packets dropped due to connection tracking failure. | int | count |
stat_early_drop |
The number of partially tracked packet entries dropped due to connection tracking table full. | int | count |
stat_found |
The number of successful search entries. | int | count |
stat_ignore |
The number of reports that have been tracked. | int | count |
stat_insert |
The number of packets inserted. | int | count |
stat_insert_failed |
The number of packages that failed to insert. | int | count |
stat_invalid |
The number of packets that cannot be tracked. | int | count |
stat_search_restart |
The number of connection tracking table query restarts due to hash table size modification. | int | count |
filefd
¶
System file handle metrics (Linux only).
- tag
Tag | Description |
---|---|
host |
hostname |
- metric list
Metric | Description | Type | Unit |
---|---|---|---|
allocated |
The number of allocated file handles. | int | count |
maximum_mega |
The maximum number of file handles, unit M(10^6). | float | count |
FAQ¶
Why no cpu_total_usage
?¶
Some CPU acquisition features are not supported on some platforms, such as macOS.