Linux - Processes (ps)

Description

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

linux system

Target

Typical platform: Linux

Operating system: Linux

Prerequisites

Leverages: Linux ps command

Technology and protocols: Commands

Variables:

• matchName: Regular expression pattern to match process names for monitoring. (default: .*)
• matchCommand: Regular expression pattern to match process command lines 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
        additionalConnectors:
          LinuxProcess: # Unique ID. Use 'uses' if different from the original connector ID
            uses: LinuxProcess # Optional - Original ID if not in key
            force: true # Optional (default: true); false for auto-detection only
            variables:
              matchName: <VALUE> # Replace with desired value.
              matchCommand: <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