host_metrics

Collect logs from Host Metrics

Type: host_metrics

{% code title=”sample.yaml” %}

sources:
  host_metrics_example:
    type: host_metrics
    route_label: ''
    metric_to_log: false
  # optional:
  #   <key>: <value>

{% endcode %}

Fields Reference

Below are tables for Base and Optional sections. Columns: Key, Label, Type, Default, Required, Depends on, Enum / Notes.

Base

Key

Label

Type

Default

Required

Enum / Notes

Depends on

route_label

Event Routing Label

string

β€œβ€

β€”

The label to use in routing these events to a destination. Defaults to source name-type.

β€”

metric_to_log

Metric to Log

bool

false

β€”

Convert a metric event into a log event, which can be useful for sending metrics to log-support downstream components.

β€”

Optional

Key

Label

Type

Default

Required

Enum / Notes

Depends on

description

Description

string

β€œβ€

β€”

The description of the entry.

β€”

collectors

Collectors

enum-multi

[β€œcpu”, β€œdisk”, β€œfilesystem”, β€œload”, β€œhost”, β€œmemory”, β€œnetwork”, β€œprocess”, β€œcgroups”, β€œtcp”]

β€”

The list of host metric collector services to use. Defaults to all collectors. Enum: [β€œcpu”, β€œdisk”, β€œfilesystem”, β€œload”, β€œhost”, β€œmemory”, β€œnetwork”, β€œprocess”, β€œcgroups”, β€œtcp”]

β€”

namespace

Namespace

string

host

β€”

Overrides the default namespace for the metrics emitted by the source.

β€”

scrape_interval_secs

Scrape Interval Secs

int

15

β€”

The interval between metric gathering, in seconds.

β€”

cgroups.base

Cgroups Base

string

β€œβ€

β€”

The base cgroup name to provide metrics for.

β€”

cgroups.groups.excludes

Cgroups Groups Excludes

string

β€œβ€

β€”

CSV list of cgroup name patterns to exclude in gathering usage metrics.

β€”

cgroups.groups.includes

Cgroups Groups Includes

string

β€œβ€

β€”

CSV list of cgroup name patterns to include in gathering usage metrics.

β€”

cgroups.levels

Cgroups Levels

int

100

β€”

The number of levels of the cgroups hierarchy for which to report metrics. A value of 1 means the root or named cgroup.

β€”

disk.devices.excludes

Disk Devices Excludes

string

β€œβ€

β€”

CSV list of device name patterns to exclude in gathering I/O utilization metrics.

β€”

disk.devices.includes

Disk Devices Includes

string

β€œβ€

β€”

CSV list of device name patterns to include in gathering I/O utilization metrics.

β€”

filesystem.devices.excludes

Filesystem Devices Excludes

string

β€œβ€

β€”

CSV list of device name patterns to exclude in gathering usage metrics.

β€”

filesystem.devices.includes

Filesystem Devices Includes

string

β€œβ€

β€”

CSV list of device name patterns to include in gathering usage metrics.

β€”

filesystem.filesystems.excludes

Filesystem Filesystems Excludes

string

β€œβ€

β€”

CSV list of filesystem name patterns to exclude in gathering usage metrics.

β€”

filesystem.filesystems.includes

Filesystem Filesystems Includes

string

β€œβ€

β€”

CSV list of filesystem name patterns to include in gathering usage metrics.

β€”

filesystem.mountpoints.excludes

Filesystem Mountpoints Excludes

string

β€œβ€

β€”

CSV list of mount point path patterns to exclude in gathering usage metrics.

β€”

filesystem.mountpoints.includes

Filesystem Mountpoints Includes

string

β€œβ€

β€”

CSV list of mount point path patterns to include in gathering usage metrics.

β€”

network.devices.excludes

Network Devices Excludes

string

β€œβ€

β€”

CSV list of device name patterns to exclude in gathering network utilization metrics.

β€”

network.devices.includes

Network Devices Includes

string

β€œβ€

β€”

CSV list of device name patterns to include in gathering network utilization metrics.

β€”

process.processes.excludes

Process Processes Excludes

string

β€œβ€

β€”

CSV list of process name patterns to exclude.

β€”

process.processes.includes

Process Processes Includes

string

β€œβ€

β€”

CSV list of process name patterns to include.

β€”