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

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

# Linux System

## Description

Collects system metrics from Linux hosts using the /proc filesystem and various Linux commands. Implements the OpenTelemetry semantic conventions for system metrics.

[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/Linux/Linux.yaml)

## Target

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

Operating system: **Linux**

## Prerequisites

Leverages: **Linux commands and /proc**

Technology and protocols: **Commands**

## Examples

### CLI

```batch
metricshub HOSTNAME -t linux -c +Linux --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: [ +Linux ] # Optional, to load only this connector
        protocols:
          ssh:
            username: <USERNAME> # Change with actual credentials
            password: <PASSWORD> # Encrypted using metricshub-encrypt
```

## Connector Activation Criteria

The **Linux System** connector will be automatically activated, 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/uname -o || /bin/uname -o`
    - Output contains: `GNU/Linux` (regex)

## Metrics

| Type | Collected Metrics | Specific Attributes |
| --- | --- | --- |
| **cpu** | - `hw.status{hw.type="cpu", state="present"}` - `system.cpu.time{system.cpu.state="idle"}` - `system.cpu.time{system.cpu.state="io_wait"}` - `system.cpu.time{system.cpu.state="nice"}` - `system.cpu.time{system.cpu.state="system"}` - `system.cpu.time{system.cpu.state="user"}` - `system.cpu.utilization{system.cpu.state="idle"}` - `system.cpu.utilization{system.cpu.state="io_wait"}` - `system.cpu.utilization{system.cpu.state="nice"}` - `system.cpu.utilization{system.cpu.state="system"}` - `system.cpu.utilization{system.cpu.state="user"}` | - `id` - `name` - `system.cpu.logical_number` |
| **file_system** | - `system.filesystem.usage{system.filesystem.state="free"}` - `system.filesystem.usage{system.filesystem.state="reserved"}` - `system.filesystem.usage{system.filesystem.state="used"}` - `system.filesystem.utilization{system.filesystem.state="free"}` - `system.filesystem.utilization{system.filesystem.state="reserved"}` - `system.filesystem.utilization{system.filesystem.state="used"}` | - `id` - `system.device` - `system.filesystem.mountpoint` - `system.filesystem.type` |
| **memory** | - `hw.status{hw.type="memory", state="present"}` - `system.memory.limit` - `system.memory.usage{system.memory.state="buffers"}` - `system.memory.usage{system.memory.state="cached"}` - `system.memory.usage{system.memory.state="free"}` - `system.memory.usage{system.memory.state="used"}` - `system.memory.utilization{system.memory.state="buffers"}` - `system.memory.utilization{system.memory.state="cached"}` - `system.memory.utilization{system.memory.state="free"}` - `system.memory.utilization{system.memory.state="used"}` | - `id` |
| **network** | - `hw.status{hw.type="network", state="present"}` - `system.network.bandwidth.limit` - `system.network.dropped{network.io.direction="receive"}` - `system.network.dropped{network.io.direction="transmit"}` - `system.network.errors{network.io.direction="receive"}` - `system.network.errors{network.io.direction="transmit"}` - `system.network.io{network.io.direction="receive"}` - `system.network.io{network.io.direction="transmit"}` - `system.network.packets{network.io.direction="receive"}` - `system.network.packets{network.io.direction="transmit"}` | - `id` - `network.interface.name` |
| **paging** | - `system.paging.usage{system.paging.state="free"}` - `system.paging.usage{system.paging.state="used"}` - `system.paging.utilization{system.paging.state="free"}` - `system.paging.utilization{system.paging.state="used"}` | - `id` - `system.device` |
| **paging_activity** | - `system.paging.faults{system.paging.type="major"}` - `system.paging.faults{system.paging.type="minor"}` - `system.paging.operations{system.paging.direction="in"}` - `system.paging.operations{system.paging.direction="out"}` | - `id` |
| **physical_disk** | - `hw.status{hw.type="physical_disk", state="present"}` - `system.disk.io_time` - `system.disk.io{disk.io.direction="read"}` - `system.disk.io{disk.io.direction="write"}` - `system.disk.merged{disk.io.direction="read"}` - `system.disk.merged{disk.io.direction="write"}` - `system.disk.operation_time{disk.io.direction="read"}` - `system.disk.operation_time{disk.io.direction="write"}` - `system.disk.operations{disk.io.direction="read"}` - `system.disk.operations{disk.io.direction="write"}` | - `id` - `system.device` |
| **system** | - `system.uptime` | - `id` - `name` - `os_version` - `version` |