mirror of
https://github.com/open-cluster-management-io/ocm.git
synced 2026-05-22 00:54:00 +00:00
b0bc276437
Some checks failed
Scorecard supply-chain security / Scorecard analysis (push) Failing after 1m34s
Post / coverage (push) Failing after 39m55s
Post / images (amd64, addon-manager) (push) Failing after 8m44s
Post / images (amd64, placement) (push) Failing after 7m55s
Post / images (amd64, registration) (push) Failing after 8m3s
Post / images (amd64, registration-operator) (push) Failing after 7m51s
Post / images (amd64, work) (push) Failing after 8m21s
Post / images (arm64, addon-manager) (push) Failing after 8m30s
Post / images (arm64, placement) (push) Failing after 8m4s
Post / images (arm64, registration) (push) Failing after 7m57s
Post / images (arm64, registration-operator) (push) Failing after 8m0s
Post / images (arm64, work) (push) Failing after 8m3s
Post / image manifest (addon-manager) (push) Has been skipped
Post / image manifest (placement) (push) Has been skipped
Post / image manifest (registration) (push) Has been skipped
Post / image manifest (registration-operator) (push) Has been skipped
Post / image manifest (work) (push) Has been skipped
Post / trigger clusteradm e2e (push) Has been skipped
Bumps [github.com/prometheus/client_golang](https://github.com/prometheus/client_golang) from 1.22.0 to 1.23.0. - [Release notes](https://github.com/prometheus/client_golang/releases) - [Changelog](https://github.com/prometheus/client_golang/blob/main/CHANGELOG.md) - [Commits](https://github.com/prometheus/client_golang/compare/v1.22.0...v1.23.0) --- updated-dependencies: - dependency-name: github.com/prometheus/client_golang dependency-version: 1.23.0 dependency-type: direct:production update-type: version-update:semver-minor ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
62 lines
2.8 KiB
Markdown
62 lines
2.8 KiB
Markdown
# procfs
|
|
|
|
This package provides functions to retrieve system, kernel, and process
|
|
metrics from the pseudo-filesystems /proc and /sys.
|
|
|
|
*WARNING*: This package is a work in progress. Its API may still break in
|
|
backwards-incompatible ways without warnings. Use it at your own risk.
|
|
|
|
[](https://pkg.go.dev/github.com/prometheus/procfs)
|
|
[](https://circleci.com/gh/prometheus/procfs/tree/master)
|
|
[](https://goreportcard.com/report/github.com/prometheus/procfs)
|
|
|
|
## Usage
|
|
|
|
The procfs library is organized by packages based on whether the gathered data is coming from
|
|
/proc, /sys, or both. Each package contains an `FS` type which represents the path to either /proc,
|
|
/sys, or both. For example, cpu statistics are gathered from
|
|
`/proc/stat` and are available via the root procfs package. First, the proc filesystem mount
|
|
point is initialized, and then the stat information is read.
|
|
|
|
```go
|
|
fs, err := procfs.NewFS("/proc")
|
|
stats, err := fs.Stat()
|
|
```
|
|
|
|
Some sub-packages such as `blockdevice`, require access to both the proc and sys filesystems.
|
|
|
|
```go
|
|
fs, err := blockdevice.NewFS("/proc", "/sys")
|
|
stats, err := fs.ProcDiskstats()
|
|
```
|
|
|
|
## Package Organization
|
|
|
|
The packages in this project are organized according to (1) whether the data comes from the `/proc` or
|
|
`/sys` filesystem and (2) the type of information being retrieved. For example, most process information
|
|
can be gathered from the functions in the root `procfs` package. Information about block devices such as disk drives
|
|
is available in the `blockdevices` sub-package.
|
|
|
|
## Building and Testing
|
|
|
|
The procfs library is intended to be built as part of another application, so there are no distributable binaries.
|
|
However, most of the API includes unit tests which can be run with `make test`.
|
|
|
|
### Updating Test Fixtures
|
|
|
|
The procfs library includes a set of test fixtures which include many example files from
|
|
the `/proc` and `/sys` filesystems. These fixtures are included as a [ttar](https://github.com/ideaship/ttar) file
|
|
which is extracted automatically during testing. To add/update the test fixtures, first
|
|
ensure the `testdata/fixtures` directory is up to date by removing the existing directory and then
|
|
extracting the ttar file using `make testdata/fixtures/.unpacked` or just `make test`.
|
|
|
|
```bash
|
|
rm -rf testdata/fixtures
|
|
make test
|
|
```
|
|
|
|
Next, make the required changes to the extracted files in the `testdata/fixtures` directory. When
|
|
the changes are complete, run `make update_fixtures` to create a new `fixtures.ttar` file
|
|
based on the updated `fixtures` directory. And finally, verify the changes using
|
|
`git diff testdata/fixtures.ttar`.
|