MetricsHub
MetricsHub Community Connectors 1.0.07

 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`.

community[2] linux[3] system[4]

Source[5]

Target

Typical platform: Any platform running Linux

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
        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:
              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
metricshub community connector hardware system
Links:
  • [1] ../metricshub-connectors-directory.html
  • [2] tags/community.html
  • [3] tags/linux.html
  • [4] tags/system.html
  • [5] https://github.com/sentrysoftware/metricshub-community-connectors/tree/main/src/main/connector/system/LinuxProcess/LinuxProcess.yaml
No results.