Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/k1low/grouped_process_exporter

Exporter for grouped process
https://github.com/k1low/grouped_process_exporter

cgroup metrics process-group procfs prometheus prometheus-exporter

Last synced: about 15 hours ago
JSON representation

Exporter for grouped process

Host: GitHub
URL: https://github.com/k1low/grouped_process_exporter
Owner: k1LoW
License: mit
Created: 2019-08-28T07:39:39.000Z (about 5 years ago)
Default Branch: master
Last Pushed: 2023-02-15T04:23:39.000Z (over 1 year ago)
Last Synced: 2024-06-19T05:36:29.520Z (4 months ago)
Topics: cgroup, metrics, process-group, procfs, prometheus, prometheus-exporter
Language: Go
Homepage:
Size: 779 KB
Stars: 10
Watchers: 3
Forks: 2
Open Issues: 0
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE

Awesome Lists containing this project

README

        # Exporter for grouped process [![Build Status](https://github.com/k1LoW/grouped_process_exporter/workflows/build/badge.svg)](https://github.com/k1LoW/grouped_process_exporter/actions) [![GitHub release](https://img.shields.io/github/release/k1LoW/grouped_process_exporter.svg)](https://github.com/k1LoW/grouped_process_exporter/releases)

## Supported grouping

- control group v1 ( `cgroup`, default )

- /proc/[PID]/status.Name: ( `proc_status_name` / `name` )

### Default port

- [`9644`](https://github.com/prometheus/prometheus/wiki/Default-port-allocations)

### :unlock: Advanced grouping

#### `--group.normalize`

Normalize exported group names using the regexp `--group.normalize` option.

For example, by setting `--group.normalize='^.+(tcpdp).+$'`, the exporter normalizes the group names `/path/to/tcpdp-eth0` and `/path/to/tcpdp-eth1` to `tcpdp`.

#### `--group.exclude`

Exclude exported groups using the regexp `--group.exclude` option.

For example, by setting `--group.exclude='user.\slice'`, the exporter excludes the group names `/user.slice` , `/user.slice/user-10503.slice`.

> Note: the exporter excludes group before group name normalization.

## Available Metrics

### Amount of grouped procs ( default on )

| Name | Type | Description |

| --- | --- | --- |

| grouped_process_num_procs | Gauge | Number of processes in the group |

| grouped_process_num_grouped | Gauge | Number of grouped |

### Grouped /proc/[PID]/stat ( `--collector.stat` )

| Name | Type | Description |

| --- | --- | --- |

| grouped_process_stat_minflt_total | Counter | Total number of grouped /proc/[PID]/stat.minflt |

| grouped_process_stat_cminflt_total | Counter | Total number of grouped /proc/[PID]/stat.rchar |

| grouped_process_stat_majflt_total | Counter | Total number of grouped /proc/[PID]/stat.majflt |

| grouped_process_stat_cmajflt_total | Counter | Total number of grouped /proc/[PID]/stat.cmajflt |

| grouped_process_stat_utime_total | Counter | Total number of grouped /proc/[PID]/stat.utime |

| grouped_process_stat_stime_total | Counter | Total number of grouped /proc/[PID]/stat.stime |

| grouped_process_stat_cutime_total | Counter | Total number of grouped /proc/[PID]/stat.cutime |

| grouped_process_stat_cstime_total | Counter | Total number of grouped /proc/[PID]/stat.cstime |

| grouped_process_stat_numthreads | Gauge | Grouped /proc/[PID]/stat.numthreads |

| grouped_process_stat_vsize_bytes | Gauge | Grouped /proc/[PID]/stat.vsize |

| grouped_process_stat_rss | Gauge | Grouped /proc/[PID]/stat.rss |

| grouped_process_stat_clk_tck | Gauge | clock ticks (divide by sysconf(_SC_CLK_TCK)) |

### Grouped /proc/[PID]/io ( `--collector.io` )

| Name | Type | Description |

| --- | --- | --- |

| grouped_process_io_r_char_total | Counter | Total number of grouped /proc/[PID]/io.rchar |

| grouped_process_io_w_char_total | Counter | Total number of grouped /proc/[PID]/io.wchar |

| grouped_process_io_sysc_r_total | Counter | Total number of grouped /proc/[PID]/io.syscr |

| grouped_process_io_sysc_w_total | Counter | Total number of grouped /proc/[PID]/io.syscw |

| grouped_process_io_read_bytes_total | Counter | Total number of grouped /proc/[PID]/io.read_bytes |

| grouped_process_io_write_bytes_total | Counter | Total number of grouped /proc/[PID]/io.write_bytes |

| grouped_process_io_cancelled_write_bytes_total | Counter | Total number of grouped /proc/[PID]/io.cancelled_write_bytes |

### Grouped /proc/[PID]/status ( `--collector.status` )

| Name | Type | Description |

| --- | --- | --- |

| grouped_process_status_VmPeak_bytes_total | Gauge | Total size of grouped /proc/[PID]/status.VmPeak. Peak virtual memory size |

| grouped_process_status_VmSize_bytes_total | Gauge | Total size of grouped /proc/[PID]/status.VmSize. Virtual memory size |

| grouped_process_status_VmLck_bytes_total | Gauge | Total size of grouped /proc/[PID]/status.VmLck. Locked memory size |

| grouped_process_status_VmPin_bytes_total | Gauge | Total size of grouped /proc/[PID]/status.VmPin. Pinned memory size |

| grouped_process_status_VmHWM_bytes_total | Gauge | Total size of grouped /proc/[PID]/status.VmHWM. Peak resident set size |

| grouped_process_status_VmRSS_bytes_total | Gauge | Total size of grouped /proc/[PID]/status.VmRSS. Resident set size (sum of RssAnnon RssFile and RssShmem) |

| grouped_process_status_RssAnon_bytes_total | Gauge | Total size of grouped /proc/[PID]/status.RssAnon. Size of resident anonymous memory |

| grouped_process_status_RssFile_bytes_total | Gauge | Total size of grouped /proc/[PID]/status.RssFile. Size of resident file mappings |

| grouped_process_status_RssShmem_bytes_total | Gauge | Total size of grouped /proc/[PID]/status.RssShmem. Size of resident shared memory |

| grouped_process_status_VmData_bytes_total | Gauge | Total size of grouped /proc/[PID]/status.VmData. Size of data segments |

| grouped_process_status_VmStk_bytes_total | Gauge | Total size of grouped /proc/[PID]/status.VmStk. Size of stack segments |

| grouped_process_status_VmExe_bytes_total | Gauge | Total size of grouped /proc/[PID]/status.VmExe. Size of text segments |

| grouped_process_status_VmLib_bytes_total | Gauge | Total size of grouped /proc/[PID]/status.VmLib. Shared library code size |

| grouped_process_status_VmPTE_bytes_total | Gauge | Total size of grouped /proc/[PID]/status.VmPTE. Page table entries size |

| grouped_process_status_VmPMD_bytes_total | Gauge | Total size of grouped /proc/[PID]/status.VmPMD. Size of second-level page tables |

| grouped_process_status_VmSwap_bytes_total | Gauge | Total size of grouped /proc/[PID]/status.VmSwap. Swapped-out virtual memory size by anonymous private |

| grouped_process_status_HugetlbPages_bytes_total | Gauge | Total size of grouped /proc/[PID]/status.HugetlbPages. Size of hugetlb memory portions |

| grouped_process_status_VoluntaryCtxtSwitches_total | Counter| Total number of grouped /proc/[PID]/status.VoluntaryCtxtSwitches. Number of voluntary context switches |

| grouped_process_status_NonVoluntaryCtxtSwitches_total | Counter| Total number of grouped /proc/[PID]/status.NonVoluntaryCtxtSwitches. Number of involuntary context switches |

## Alternatives

- [process-exporter](https://github.com/ncabatoff/process-exporter): Prometheus exporter that mines /proc to report on selected processes