Skip to content

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]:

 [inputs.system.tags]
  # some_tag = "some_value"
  # more_tag = "some_other_value"
  # ...

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.

Feedback

Is this page helpful? ×