---
date_published: 2026-08-13
date_modified: 2026-08-13
canonical_url: https://metricshub.org/community-connectors/connectors/linuxprocess.html
---

 [Supported Platforms](../supported-platforms.html)   [Connectors Directory](../connectors-directory.html)

# Linux - Processes (ps)

## Description

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

[community](tags/community.html) [linux](tags/linux.html) [system](tags/system.html)

[Source](https://github.com/metricshub/community-connectors/tree/main/src/main/connector/system/LinuxProcess/LinuxProcess.yaml)

## Target

Typical platform: **[Linux](platforms/linux.html)**

Operating system: **Linux**

## Prerequisites

Leverages: **Linux ps command**

Technology and protocols: **Commands**

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

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

### metricshub.yaml

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