Back to the list of connectors[1]

Linux - Processes (ps)

Description

Monitors performance metrics (CPU, memory, etc.) of the processes that match the specified criteria in `matchName`, `matchCommand`, and `matchUser`.

linux[2] system[3]

Source[4]

Target

Typical platform: Any Linux system

Operating system: Linux

Prerequisites

Leverages: Linux ps command

Technology and protocols: Command Lines

Variables:

  • matchCommand: Regular expression pattern to match process command lines for monitoring. (default: .*)
  • matchName: Regular expression pattern to match process names for monitoring. (default: .*)
  • matchUser: Regular expression pattern to match process users for inclusion. (default: .*)

Examples

CLI

metricshub HOSTNAME -t linux -c +LinuxProcess --ssh -u USER

metricshub.yaml

resourceGroups:
  <RESOURCE_GROUP>:
    resources:
      <HOSTNAME-ID>:
        attributes:
          host.name: <HOSTNAME> # Change with actual host name
          host.type: linux
        connectors: [ +LinuxProcess ] # Optional, to load only this connector
        protocols:
          ssh:
            username: <USERNAME> # Change with actual credentials
            password: <PASSWORD> # Encrypted using metricshub-encrypt
        variables:
          matchCommand: <VALUE> # Replace with desired value.
          matchName: <VALUE> # Replace with desired value.
          matchUser: <VALUE> # Replace with desired value.

Connector Activation Criteria

The Linux - Processes (ps) connector must be selected manually, and its status will be reported as OK if all the below criteria are met:

  • The command below succeeds on the monitored host
    • Command: /usr/bin/which ps || /bin/which ps
    • Output contains: /bin/ps (regex)

Metrics

Type Collected Metrics Specific Attributes
process
  • process.cpu.time
  • process.cpu.utilization
  • process.memory.usage
  • process.memory.utilization
  • process.memory.virtual
  • process.thread.count
  • process.time
  • id
  • process.id
  • process.match.command
  • process.match.name
  • process.match.user
  • process.name
  • process.parent.id
No results.