Wala shell

Advanced PHP File Manager

Server IP: 127.0.0.1 | PHP Version: 8.3.30 | Domains Hosted: 54

Name	Size	Last Modified
📁 ..	-	2025-05-25 12:27
📁 .circleci	-	2025-05-25 12:27
📁 .github	-	2025-05-25 12:27
📄 .gitignore /testdata/fixtures/ /fixtures	30 B	2025-05-25 12:27
📄 .golangci.yml --- linters: enable: - errcheck - godot - gosimple - govet - ineffassign - misspell - revive - staticcheck - testifylint - unused linter-settings: godot: capital: true exclude: # Ignore "See: URL" - 'See:' misspell: locale: US	274 B	2025-05-25 12:27
📄 CODE_OF_CONDUCT.md # Prometheus Community Code of Conduct Prometheus follows the [CNCF Code of Conduct](https://github.com/cncf/foundation/blob/main/code-of-conduct.md).	152 B	2025-05-25 12:27
📄 CONTRIBUTING.md # Contributing Prometheus uses GitHub to manage reviews of pull requests. * If you are a new contributor see: [Steps to Contribute](#steps-to-contribute) * If you have a trivial fix or improvement, go ahead and create a pull request, addressing (with `@...`) a suitable maintainer of this repository (see [MAINTAINERS.md](MAINTAINERS.md)) in the description of the pull request. * If you plan to do something more involved, first discuss your ideas on our [mailing list](https://groups.google.com/forum/?fromgroups#!forum/prometheus-developers). This will avoid unnecessary work and surely give you and us a good deal of inspiration. Also please see our [non-goals issue](https://github.com/prometheus/docs/issues/149) on areas that the Prometheus community doesn't plan to work on. * Relevant coding style guidelines are the [Go Code Review Comments](https://code.google.com/p/go-wiki/wiki/CodeReviewComments) and the _Formatting and style_ section of Peter Bourgon's [Go: Best Practices for Production Environments](https://peter.bourgon.org/go-in-production/#formatting-and-style). * Be sure to sign off on the [DCO](https://github.com/probot/dco#how-it-works) ## Steps to Contribute Should you wish to work on an issue, please claim it first by commenting on the GitHub issue that you want to work on it. This is to prevent duplicated efforts from contributors on the same issue. Please check the [`help-wanted`](https://github.com/prometheus/procfs/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22) label to find issues that are good for getting started. If you have questions about one of the issues, with or without the tag, please comment on them and one of the maintainers will clarify it. For a quicker response, contact us over [IRC](https://prometheus.io/community). For quickly compiling and testing your changes do: ``` make test # Make sure all the tests pass before you commit and push :) ``` We use [`golangci-lint`](https://github.com/golangci/golangci-lint) for linting the code. If it reports an issue and you think that the warning needs to be disregarded or is a false-positive, you can add a special comment `//nolint:linter1[,linter2,...]` before the offending line. Use this sparingly though, fixing the code to comply with the linter's recommendation is in general the preferred course of action. ## Pull Request Checklist * Branch from the master branch and, if needed, rebase to the current master branch before submitting your pull request. If it doesn't merge cleanly with master you may be asked to rebase your changes. * Commits should be as small as possible, while ensuring that each commit is correct independently (i.e., each commit should compile and pass tests). * If your patch is not getting reviewed or you need a specific person to review it, you can @-reply a reviewer asking for a review in the pull request or a comment, or you can ask for a review on IRC channel [#prometheus](https://webchat.freenode.net/?channels=#prometheus) on irc.freenode.net (for the easiest start, [join via Riot](https://riot.im/app/#/room/#prometheus:matrix.org)). * Add tests relevant to the fixed bug or new feature. ## Dependency management The Prometheus project uses [Go modules](https://golang.org/cmd/go/#hdr-Modules__module_versions__and_more) to manage dependencies on external packages. This requires a working Go environment with version 1.12 or greater installed. All dependencies are vendored in the `vendor/` directory. To add or update a new dependency, use the `go get` command: ```bash # Pick the latest tagged release. go get example.com/some/module/pkg # Pick a specific version. go get example.com/some/module/pkg@vX.Y.Z ``` Tidy up the `go.mod` and `go.sum` files and copy the new/updated dependency to the `vendor/` directory: ```bash # The GO111MODULE variable can be omitted when the code isn't located in GOPATH. GO111MODULE=on go mod tidy GO111MODULE=on go mod vendor ``` You have to commit the changes to `go.mod`, `go.sum` and the `vendor/` directory before submitting the pull request. ## API Implementation Guidelines ### Naming and Documentation Public functions and structs should normally be named according to the file(s) being read and parsed. For example, the `fs.BuddyInfo()` function reads the file `/proc/buddyinfo`. In addition, the godoc for each public function should contain the path to the file(s) being read and a URL of the linux kernel documentation describing the file(s). ### Reading vs. Parsing Most functionality in this library consists of reading files and then parsing the text into structured data. In most cases reading and parsing should be separated into different functions/methods with a public `fs.Thing()` method and a private `parseThing(r Reader)` function. This provides a logical separation and allows parsing to be tested directly without the need to read from the filesystem. Using a `Reader` argument is preferred over other data types such as `string` or `*File` because it provides the most flexibility regarding the data source. When a set of files in a directory needs to be parsed, then a `path` string parameter to the parse function can be used instead. ### /proc and /sys filesystem I/O The `proc` and `sys` filesystems are pseudo file systems and work a bit differently from standard disk I/O. Many of the files are changing continuously and the data being read can in some cases change between subsequent reads in the same file. Also, most of the files are relatively small (less than a few KBs), and system calls to the `stat` function will often return the wrong size. Therefore, for most files it's recommended to read the full file in a single operation using an internal utility function called `util.ReadFileNoStat`. This function is similar to `os.ReadFile`, but it avoids the system call to `stat` to get the current size of the file. Note that parsing the file's contents can still be performed one line at a time. This is done by first reading the full file, and then using a scanner on the `[]byte` or `string` containing the data. ``` data, err := util.ReadFileNoStat("/proc/cpuinfo") if err != nil { return err } reader := bytes.NewReader(data) scanner := bufio.NewScanner(reader) ``` The `/sys` filesystem contains many very small files which contain only a single numeric or text value. These files can be read using an internal function called `util.SysReadFile` which is similar to `os.ReadFile` but does not bother to check the size of the file before reading. ``` data, err := util.SysReadFile("/sys/class/power_supply/BAT0/capacity") ```	6.53 KB	2025-05-25 12:27
📄 LICENSE Apache License Version 2.0, January 2004 http://www.apache.org/licenses/ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 1. Definitions. "License" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document. "Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License. "Legal Entity" shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, "control" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity. "You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this License. "Source" form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files. "Object" form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types. "Work" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below). "Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof. "Contribution" shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as "Not a Contribution." "Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work. 2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form. 3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed. 4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions: (a) You must give any other recipients of the Work or Derivative Works a copy of this License; and (b) You must cause any modified files to carry prominent notices stating that You changed the files; and (c) You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and (d) If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License. You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License. 5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions. 6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file. 7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License. 8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages. 9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability. END OF TERMS AND CONDITIONS APPENDIX: How to apply the Apache License to your work. To apply the Apache License to your work, attach the following boilerplate notice, with the fields enclosed by brackets "[]" replaced with your own identifying information. (Don't include the brackets!) The text should be enclosed in the appropriate comment syntax for the file format. We also recommend that a file or class name and description of purpose be included on the same "printed page" as the copyright notice for easier identification within third-party archives. Copyright [yyyy] [name of copyright owner] Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.	11.09 KB	2025-05-25 12:27
📄 MAINTAINERS.md * Johannes 'fish' Ziemke <github@freigeist.org> @discordianfish * Paul Gier <paulgier@gmail.com> @pgier * Ben Kochie <superq@gmail.com> @SuperQ	144 B	2025-05-25 12:27
📄 Makefile # Copyright 2018 The Prometheus Authors # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. include Makefile.common %/.unpacked: %.ttar @echo ">> extracting fixtures $" ./ttar -C $(dir $) -x -f $*.ttar touch $@ fixtures: testdata/fixtures/.unpacked update_fixtures: rm -vf testdata/fixtures/.unpacked ./ttar -c -f testdata/fixtures.ttar -C testdata/ fixtures/ .PHONY: build build: .PHONY: test test: testdata/fixtures/.unpacked common-test	941 B	2025-05-25 12:27
📄 Makefile.common # Copyright 2018 The Prometheus Authors # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. # A common Makefile that includes rules to be reused in different prometheus projects. # !!! Open PRs only against the prometheus/prometheus/Makefile.common repository! # Example usage : # Create the main Makefile in the root project directory. # include Makefile.common # customTarget: # @echo ">> Running customTarget" # # Ensure GOBIN is not set during build so that promu is installed to the correct path unexport GOBIN GO ?= go GOFMT ?= $(GO)fmt FIRST_GOPATH := $(firstword $(subst :, ,$(shell $(GO) env GOPATH))) GOOPTS ?= GOHOSTOS ?= $(shell $(GO) env GOHOSTOS) GOHOSTARCH ?= $(shell $(GO) env GOHOSTARCH) GO_VERSION ?= $(shell $(GO) version) GO_VERSION_NUMBER ?= $(word 3, $(GO_VERSION)) PRE_GO_111 ?= $(shell echo $(GO_VERSION_NUMBER) \| grep -E 'go1\.(10\|[0-9])\.') PROMU := $(FIRST_GOPATH)/bin/promu pkgs = ./... ifeq (arm, $(GOHOSTARCH)) GOHOSTARM ?= $(shell GOARM= $(GO) env GOARM) GO_BUILD_PLATFORM ?= $(GOHOSTOS)-$(GOHOSTARCH)v$(GOHOSTARM) else GO_BUILD_PLATFORM ?= $(GOHOSTOS)-$(GOHOSTARCH) endif GOTEST := $(GO) test GOTEST_DIR := ifneq ($(CIRCLE_JOB),) ifneq ($(shell command -v gotestsum 2> /dev/null),) GOTEST_DIR := test-results GOTEST := gotestsum --junitfile $(GOTEST_DIR)/unit-tests.xml -- endif endif PROMU_VERSION ?= 0.17.0 PROMU_URL := https://github.com/prometheus/promu/releases/download/v$(PROMU_VERSION)/promu-$(PROMU_VERSION).$(GO_BUILD_PLATFORM).tar.gz SKIP_GOLANGCI_LINT := GOLANGCI_LINT := GOLANGCI_LINT_OPTS ?= GOLANGCI_LINT_VERSION ?= v1.59.0 # golangci-lint only supports linux, darwin and windows platforms on i386/amd64/arm64. # windows isn't included here because of the path separator being different. ifeq ($(GOHOSTOS),$(filter $(GOHOSTOS),linux darwin)) ifeq ($(GOHOSTARCH),$(filter $(GOHOSTARCH),amd64 i386 arm64)) # If we're in CI and there is an Actions file, that means the linter # is being run in Actions, so we don't need to run it here. ifneq (,$(SKIP_GOLANGCI_LINT)) GOLANGCI_LINT := else ifeq (,$(CIRCLE_JOB)) GOLANGCI_LINT := $(FIRST_GOPATH)/bin/golangci-lint else ifeq (,$(wildcard .github/workflows/golangci-lint.yml)) GOLANGCI_LINT := $(FIRST_GOPATH)/bin/golangci-lint endif endif endif PREFIX ?= $(shell pwd) BIN_DIR ?= $(shell pwd) DOCKER_IMAGE_TAG ?= $(subst /,-,$(shell git rev-parse --abbrev-ref HEAD)) DOCKERFILE_PATH ?= ./Dockerfile DOCKERBUILD_CONTEXT ?= ./ DOCKER_REPO ?= prom DOCKER_ARCHS ?= amd64 BUILD_DOCKER_ARCHS = $(addprefix common-docker-,$(DOCKER_ARCHS)) PUBLISH_DOCKER_ARCHS = $(addprefix common-docker-publish-,$(DOCKER_ARCHS)) TAG_DOCKER_ARCHS = $(addprefix common-docker-tag-latest-,$(DOCKER_ARCHS)) SANITIZED_DOCKER_IMAGE_TAG := $(subst +,-,$(DOCKER_IMAGE_TAG)) ifeq ($(GOHOSTARCH),amd64) ifeq ($(GOHOSTOS),$(filter $(GOHOSTOS),linux freebsd darwin windows)) # Only supported on amd64 test-flags := -race endif endif # This rule is used to forward a target like "build" to "common-build". This # allows a new "build" target to be defined in a Makefile which includes this # one and override "common-build" without override warnings. %: common-% ; .PHONY: common-all common-all: precheck style check_license lint yamllint unused build test .PHONY: common-style common-style: @echo ">> checking code style" @fmtRes=$$($(GOFMT) -d $$(find . -path ./vendor -prune -o -name '.go' -print)); \ if [ -n "$${fmtRes}" ]; then \ echo "gofmt checking failed!"; echo "$${fmtRes}"; echo; \ echo "Please ensure you are using $$($(GO) version) for formatting code."; \ exit 1; \ fi .PHONY: common-check_license common-check_license: @echo ">> checking license header" @licRes=$$(for file in $$(find . -type f -iname '.go' ! -path './vendor/') ; do \ awk 'NR<=3' $$file \| grep -Eq "(Copyright\|generated\|GENERATED)" \|\| echo $$file; \ done); \ if [ -n "$${licRes}" ]; then \ echo "license header checking failed:"; echo "$${licRes}"; \ exit 1; \ fi .PHONY: common-deps common-deps: @echo ">> getting dependencies" $(GO) mod download .PHONY: update-go-deps update-go-deps: @echo ">> updating Go dependencies" @for m in $$($(GO) list -mod=readonly -m -f '{{ if and (not .Indirect) (not .Main)}}{{.Path}}{{end}}' all); do \ $(GO) get -d $$m; \ done $(GO) mod tidy .PHONY: common-test-short common-test-short: $(GOTEST_DIR) @echo ">> running short tests" $(GOTEST) -short $(GOOPTS) $(pkgs) .PHONY: common-test common-test: $(GOTEST_DIR) @echo ">> running all tests" $(GOTEST) $(test-flags) $(GOOPTS) $(pkgs) $(GOTEST_DIR): @mkdir -p $@ .PHONY: common-format common-format: @echo ">> formatting code" $(GO) fmt $(pkgs) .PHONY: common-vet common-vet: @echo ">> vetting code" $(GO) vet $(GOOPTS) $(pkgs) .PHONY: common-lint common-lint: $(GOLANGCI_LINT) ifdef GOLANGCI_LINT @echo ">> running golangci-lint" $(GOLANGCI_LINT) run $(GOLANGCI_LINT_OPTS) $(pkgs) endif .PHONY: common-lint-fix common-lint-fix: $(GOLANGCI_LINT) ifdef GOLANGCI_LINT @echo ">> running golangci-lint fix" $(GOLANGCI_LINT) run --fix $(GOLANGCI_LINT_OPTS) $(pkgs) endif .PHONY: common-yamllint common-yamllint: @echo ">> running yamllint on all YAML files in the repository" ifeq (, $(shell command -v yamllint 2> /dev/null)) @echo "yamllint not installed so skipping" else yamllint . endif # For backward-compatibility. .PHONY: common-staticcheck common-staticcheck: lint .PHONY: common-unused common-unused: @echo ">> running check for unused/missing packages in go.mod" $(GO) mod tidy @git diff --exit-code -- go.sum go.mod .PHONY: common-build common-build: promu @echo ">> building binaries" $(PROMU) build --prefix $(PREFIX) $(PROMU_BINARIES) .PHONY: common-tarball common-tarball: promu @echo ">> building release tarball" $(PROMU) tarball --prefix $(PREFIX) $(BIN_DIR) .PHONY: common-docker-repo-name common-docker-repo-name: @echo "$(DOCKER_REPO)/$(DOCKER_IMAGE_NAME)" .PHONY: common-docker $(BUILD_DOCKER_ARCHS) common-docker: $(BUILD_DOCKER_ARCHS) $(BUILD_DOCKER_ARCHS): common-docker-%: docker build -t "$(DOCKER_REPO)/$(DOCKER_IMAGE_NAME)-linux-$:$(SANITIZED_DOCKER_IMAGE_TAG)" \ -f $(DOCKERFILE_PATH) \ --build-arg ARCH="$" \ --build-arg OS="linux" \ $(DOCKERBUILD_CONTEXT) .PHONY: common-docker-publish $(PUBLISH_DOCKER_ARCHS) common-docker-publish: $(PUBLISH_DOCKER_ARCHS) $(PUBLISH_DOCKER_ARCHS): common-docker-publish-%: docker push "$(DOCKER_REPO)/$(DOCKER_IMAGE_NAME)-linux-$:$(SANITIZED_DOCKER_IMAGE_TAG)" DOCKER_MAJOR_VERSION_TAG = $(firstword $(subst ., ,$(shell cat VERSION))) .PHONY: common-docker-tag-latest $(TAG_DOCKER_ARCHS) common-docker-tag-latest: $(TAG_DOCKER_ARCHS) $(TAG_DOCKER_ARCHS): common-docker-tag-latest-%: docker tag "$(DOCKER_REPO)/$(DOCKER_IMAGE_NAME)-linux-$:$(SANITIZED_DOCKER_IMAGE_TAG)" "$(DOCKER_REPO)/$(DOCKER_IMAGE_NAME)-linux-$:latest" docker tag "$(DOCKER_REPO)/$(DOCKER_IMAGE_NAME)-linux-$:$(SANITIZED_DOCKER_IMAGE_TAG)" "$(DOCKER_REPO)/$(DOCKER_IMAGE_NAME)-linux-$:v$(DOCKER_MAJOR_VERSION_TAG)" .PHONY: common-docker-manifest common-docker-manifest: DOCKER_CLI_EXPERIMENTAL=enabled docker manifest create -a "$(DOCKER_REPO)/$(DOCKER_IMAGE_NAME):$(SANITIZED_DOCKER_IMAGE_TAG)" $(foreach ARCH,$(DOCKER_ARCHS),$(DOCKER_REPO)/$(DOCKER_IMAGE_NAME)-linux-$(ARCH):$(SANITIZED_DOCKER_IMAGE_TAG)) DOCKER_CLI_EXPERIMENTAL=enabled docker manifest push "$(DOCKER_REPO)/$(DOCKER_IMAGE_NAME):$(SANITIZED_DOCKER_IMAGE_TAG)" .PHONY: promu promu: $(PROMU) $(PROMU): $(eval PROMU_TMP := $(shell mktemp -d)) curl -s -L $(PROMU_URL) \| tar -xvzf - -C $(PROMU_TMP) mkdir -p $(FIRST_GOPATH)/bin cp $(PROMU_TMP)/promu-$(PROMU_VERSION).$(GO_BUILD_PLATFORM)/promu $(FIRST_GOPATH)/bin/promu rm -r $(PROMU_TMP) .PHONY: proto proto: @echo ">> generating code from proto files" @./scripts/genproto.sh ifdef GOLANGCI_LINT $(GOLANGCI_LINT): mkdir -p $(FIRST_GOPATH)/bin curl -sfL https://raw.githubusercontent.com/golangci/golangci-lint/$(GOLANGCI_LINT_VERSION)/install.sh \ \| sed -e '/install -d/d' \ \| sh -s -- -b $(FIRST_GOPATH)/bin $(GOLANGCI_LINT_VERSION) endif .PHONY: precheck precheck:: define PRECHECK_COMMAND_template = precheck:: $(1)_precheck PRECHECK_COMMAND_$(1) ?= $(1) $$(strip $$(PRECHECK_OPTIONS_$(1))) .PHONY: $(1)_precheck $(1)_precheck: @if ! $$(PRECHECK_COMMAND_$(1)) 1>/dev/null 2>&1; then \ echo "Execution of '$$(PRECHECK_COMMAND_$(1))' command failed. Is $(1) installed?"; \ exit 1; \ fi endef	8.95 KB	2025-05-25 12:27
📄 NOTICE procfs provides functions to retrieve system, kernel and process metrics from the pseudo-filesystem proc. Copyright 2014-2015 The Prometheus Authors This product includes software developed at SoundCloud Ltd. (http://soundcloud.com/).	237 B	2025-05-25 12:27
📄 README.md # 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. [![Go Reference](https://pkg.go.dev/badge/github.com/prometheus/procfs.svg)](https://pkg.go.dev/github.com/prometheus/procfs) [![CircleCI](https://circleci.com/gh/prometheus/procfs/tree/master.svg?style=svg)](https://circleci.com/gh/prometheus/procfs/tree/master) [![Go Report Card](https://goreportcard.com/badge/github.com/prometheus/procfs)](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 `fixtures` directory is up to date by removing the existing directory and then extracting the ttar file using `make fixtures/.unpacked` or just `make test`. ```bash rm -rf testdata/fixtures make test ``` Next, make the required changes to the extracted files in the `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`.	2.77 KB	2025-05-25 12:27
📄 SECURITY.md # Reporting a security issue The Prometheus security policy, including how to report vulnerabilities, can be found here: <https://prometheus.io/docs/operating/security/>	172 B	2025-05-25 12:27
📄 arp.go // Copyright 2019 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "fmt" "net" "os" "strconv" "strings" ) // Learned from include/uapi/linux/if_arp.h. const ( // completed entry (ha valid). ATFComplete = 0x02 // permanent entry. ATFPermanent = 0x04 // Publish entry. ATFPublish = 0x08 // Has requested trailers. ATFUseTrailers = 0x10 // Obsoleted: Want to use a netmask (only for proxy entries). ATFNetmask = 0x20 // Don't answer this addresses. ATFDontPublish = 0x40 ) // ARPEntry contains a single row of the columnar data represented in // /proc/net/arp. type ARPEntry struct { // IP address IPAddr net.IP // MAC address HWAddr net.HardwareAddr // Name of the device Device string // Flags Flags byte } // GatherARPEntries retrieves all the ARP entries, parse the relevant columns, // and then return a slice of ARPEntry's. func (fs FS) GatherARPEntries() ([]ARPEntry, error) { data, err := os.ReadFile(fs.proc.Path("net/arp")) if err != nil { return nil, fmt.Errorf("%w: error reading arp %s: %w", ErrFileRead, fs.proc.Path("net/arp"), err) } return parseARPEntries(data) } func parseARPEntries(data []byte) ([]ARPEntry, error) { lines := strings.Split(string(data), "\n") entries := make([]ARPEntry, 0) var err error const ( expectedDataWidth = 6 expectedHeaderWidth = 9 ) for _, line := range lines { columns := strings.Fields(line) width := len(columns) if width == expectedHeaderWidth \|\| width == 0 { continue } else if width == expectedDataWidth { entry, err := parseARPEntry(columns) if err != nil { return []ARPEntry{}, fmt.Errorf("%w: Failed to parse ARP entry: %v: %w", ErrFileParse, entry, err) } entries = append(entries, entry) } else { return []ARPEntry{}, fmt.Errorf("%w: %d columns found, but expected %d: %w", ErrFileParse, width, expectedDataWidth, err) } } return entries, err } func parseARPEntry(columns []string) (ARPEntry, error) { entry := ARPEntry{Device: columns[5]} ip := net.ParseIP(columns[0]) entry.IPAddr = ip if mac, err := net.ParseMAC(columns[3]); err == nil { entry.HWAddr = mac } else { return ARPEntry{}, err } if flags, err := strconv.ParseUint(columns[2], 0, 8); err == nil { entry.Flags = byte(flags) } else { return ARPEntry{}, err } return entry, nil } // IsComplete returns true if ARP entry is marked with complete flag. func (entry *ARPEntry) IsComplete() bool { return entry.Flags&ATFComplete != 0 }	2.94 KB	2025-05-25 12:27
📄 arp_test.go // Copyright 2019 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "net" "testing" ) func TestARP(t *testing.T) { fs, err := NewFS(procTestFixtures) if err != nil { t.Fatal(err) } arpFile, err := fs.GatherARPEntries() if err != nil { t.Fatal(err) } if want, got := "192.168.224.1", arpFile[0].IPAddr.String(); want != got { t.Errorf("want 192.168.224.1, got %s", got) } if want, got := "00:50:56:c0:00:08", arpFile[0].HWAddr.String(); want != got { t.Errorf("want %s, got %s", want, got) } if want, got := "ens33", arpFile[0].Device; want != got { t.Errorf("want ens33, got %s", got) } if want, got := true, arpFile[0].IsComplete(); want != got { t.Errorf("want %t, got %t", want, got) } if want, got := "192.168.224.2", arpFile[1].IPAddr.String(); want != got { t.Errorf("want 192.168.224.2, got %s", got) } if want, got := make(net.HardwareAddr, 6).String(), arpFile[1].HWAddr.String(); want != got { t.Errorf("expected empty MAC, got %s", got) } if want, got := "ens33", arpFile[1].Device; want != got { t.Errorf("want %s, got %s", want, got) } if want, got := byte(0x0), arpFile[1].Flags; want != got { t.Errorf("want %b, got %b", want, got) } if want, got := false, arpFile[1].IsComplete(); want != got { t.Errorf("want %t, got %t", want, got) } }	1.82 KB	2025-05-25 12:27
📁 bcache	-	2025-05-25 12:27
📁 blockdevice	-	2025-05-25 12:27
📁 btrfs	-	2025-05-25 12:27
📄 buddyinfo.go // Copyright 2017 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "bufio" "fmt" "io" "os" "strconv" "strings" ) // A BuddyInfo is the details parsed from /proc/buddyinfo. // The data is comprised of an array of free fragments of each size. // The sizes are 2^n*PAGE_SIZE, where n is the array index. type BuddyInfo struct { Node string Zone string Sizes []float64 } // BuddyInfo reads the buddyinfo statistics from the specified `proc` filesystem. func (fs FS) BuddyInfo() ([]BuddyInfo, error) { file, err := os.Open(fs.proc.Path("buddyinfo")) if err != nil { return nil, err } defer file.Close() return parseBuddyInfo(file) } func parseBuddyInfo(r io.Reader) ([]BuddyInfo, error) { var ( buddyInfo = []BuddyInfo{} scanner = bufio.NewScanner(r) bucketCount = -1 ) for scanner.Scan() { var err error line := scanner.Text() parts := strings.Fields(line) if len(parts) < 4 { return nil, fmt.Errorf("%w: Invalid number of fields, found: %v", ErrFileParse, parts) } node := strings.TrimSuffix(parts[1], ",") zone := strings.TrimSuffix(parts[3], ",") arraySize := len(parts[4:]) if bucketCount == -1 { bucketCount = arraySize } else { if bucketCount != arraySize { return nil, fmt.Errorf("%w: mismatch in number of buddyinfo buckets, previous count %d, new count %d", ErrFileParse, bucketCount, arraySize) } } sizes := make([]float64, arraySize) for i := 0; i < arraySize; i++ { sizes[i], err = strconv.ParseFloat(parts[i+4], 64) if err != nil { return nil, fmt.Errorf("%w: Invalid valid in buddyinfo: %f: %w", ErrFileParse, sizes[i], err) } } buddyInfo = append(buddyInfo, BuddyInfo{node, zone, sizes}) } return buddyInfo, scanner.Err() }	2.24 KB	2025-05-25 12:27
📄 buddyinfo_test.go // Copyright 2017 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "strings" "testing" ) func TestBuddyInfo(t testing.T) { buddyInfo, err := getProcFixtures(t).BuddyInfo() if err != nil { t.Fatal(err) } if want, got := "DMA", buddyInfo[0].Zone; want != got { t.Errorf("want Node 0, Zone %s, got %s", want, got) } if want, got := "Normal", buddyInfo[2].Zone; want != got { t.Errorf("want Node 0, Zone %s, got %s", want, got) } if want, got := 4381.0, buddyInfo[2].Sizes[0]; want != got { t.Errorf("want Node 0, Zone Normal %f, got %f", want, got) } if want, got := 572.0, buddyInfo[1].Sizes[1]; want != got { t.Errorf("want Node 0, Zone DMA32 %f, got %f", want, got) } } func TestParseBuddyInfoShort(t testing.T) { testdata := `Node 0, zone Node 0, zone Node 0, zone ` reader := strings.NewReader(testdata) _, err := parseBuddyInfo(reader) if err == nil { t.Fatalf("expected error, but none occurred") } if want, got := "Error Parsing File: Invalid number of fields, found: [Node 0, zone]", err.Error(); want != got { t.Fatalf("Error Parsing File: Invalid number of fields, found: [Node %q, %q]", want, got) } } func TestParseBuddyInfoSizeMismatch(t *testing.T) { testdata := `Node 0, zone DMA 1 0 1 0 2 1 1 0 1 1 3 Node 0, zone DMA32 759 572 791 475 194 45 12 0 0 0 0 0 Node 0, zone Normal 4381 1093 185 1530 567 102 4 0 0 0 ` reader := strings.NewReader(testdata) _, err := parseBuddyInfo(reader) if err == nil { t.Fatalf("expected error, but none occurred") } if want, got := "Error Parsing File: mismatch in number of buddyinfo buckets, previous count 11, new count 12", err.Error(); !strings.HasPrefix(got, want) { t.Fatalf("Error Parsing File: mismatch in number of buddyinfo buckets, previous count %q, new count %q", want, got) } }	2.44 KB	2025-05-25 12:27
📄 cmdline.go // Copyright 2021 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "strings" "github.com/prometheus/procfs/internal/util" ) // CmdLine returns the command line of the kernel. func (fs FS) CmdLine() ([]string, error) { data, err := util.ReadFileNoStat(fs.proc.Path("cmdline")) if err != nil { return nil, err } return strings.Fields(string(data)), nil }	915 B	2025-05-25 12:27
📄 cmdline_test.go // Copyright 2021 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. //go:build linux // +build linux package procfs import ( "testing" "github.com/google/go-cmp/cmp" ) func TestCmdline(t *testing.T) { fs, err := NewFS(procTestFixtures) if err != nil { t.Fatal(err) } got, err := fs.CmdLine() if err != nil { t.Fatal(err) } want := []string{ "BOOT_IMAGE=/vmlinuz-5.11.0-22-generic", "root=UUID=456a0345-450d-4f7b-b7c9-43e3241d99ad", "ro", "quiet", "splash", "vt.handoff=7", } if diff := cmp.Diff(want, got); diff != "" { t.Fatalf("unexpected CmdLine (-want +got):\n%s", diff) } }	1.11 KB	2025-05-25 12:27
📄 cpuinfo.go // Copyright 2019 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. //go:build linux // +build linux package procfs import ( "bufio" "bytes" "errors" "fmt" "regexp" "strconv" "strings" "github.com/prometheus/procfs/internal/util" ) // CPUInfo contains general information about a system CPU found in /proc/cpuinfo. type CPUInfo struct { Processor uint VendorID string CPUFamily string Model string ModelName string Stepping string Microcode string CPUMHz float64 CacheSize string PhysicalID string Siblings uint CoreID string CPUCores uint APICID string InitialAPICID string FPU string FPUException string CPUIDLevel uint WP string Flags []string Bugs []string BogoMips float64 CLFlushSize uint CacheAlignment uint AddressSizes string PowerManagement string } var ( cpuinfoClockRegexp = regexp.MustCompile(`([\d.]+)`) cpuinfoS390XProcessorRegexp = regexp.MustCompile(`^processor\s+(\d+):.`) ) // CPUInfo returns information about current system CPUs. // See https://www.kernel.org/doc/Documentation/filesystems/proc.txt func (fs FS) CPUInfo() ([]CPUInfo, error) { data, err := util.ReadFileNoStat(fs.proc.Path("cpuinfo")) if err != nil { return nil, err } return parseCPUInfo(data) } func parseCPUInfoX86(info []byte) ([]CPUInfo, error) { scanner := bufio.NewScanner(bytes.NewReader(info)) // find the first "processor" line firstLine := firstNonEmptyLine(scanner) if !strings.HasPrefix(firstLine, "processor") \|\| !strings.Contains(firstLine, ":") { return nil, fmt.Errorf("%w: Cannot parse line: %q", ErrFileParse, firstLine) } field := strings.SplitN(firstLine, ": ", 2) v, err := strconv.ParseUint(field[1], 0, 32) if err != nil { return nil, err } firstcpu := CPUInfo{Processor: uint(v)} cpuinfo := []CPUInfo{firstcpu} i := 0 for scanner.Scan() { line := scanner.Text() if !strings.Contains(line, ":") { continue } field := strings.SplitN(line, ": ", 2) switch strings.TrimSpace(field[0]) { case "processor": cpuinfo = append(cpuinfo, CPUInfo{}) // start of the next processor i++ v, err := strconv.ParseUint(field[1], 0, 32) if err != nil { return nil, err } cpuinfo[i].Processor = uint(v) case "vendor", "vendor_id": cpuinfo[i].VendorID = field[1] case "cpu family": cpuinfo[i].CPUFamily = field[1] case "model": cpuinfo[i].Model = field[1] case "model name": cpuinfo[i].ModelName = field[1] case "stepping": cpuinfo[i].Stepping = field[1] case "microcode": cpuinfo[i].Microcode = field[1] case "cpu MHz": v, err := strconv.ParseFloat(field[1], 64) if err != nil { return nil, err } cpuinfo[i].CPUMHz = v case "cache size": cpuinfo[i].CacheSize = field[1] case "physical id": cpuinfo[i].PhysicalID = field[1] case "siblings": v, err := strconv.ParseUint(field[1], 0, 32) if err != nil { return nil, err } cpuinfo[i].Siblings = uint(v) case "core id": cpuinfo[i].CoreID = field[1] case "cpu cores": v, err := strconv.ParseUint(field[1], 0, 32) if err != nil { return nil, err } cpuinfo[i].CPUCores = uint(v) case "apicid": cpuinfo[i].APICID = field[1] case "initial apicid": cpuinfo[i].InitialAPICID = field[1] case "fpu": cpuinfo[i].FPU = field[1] case "fpu_exception": cpuinfo[i].FPUException = field[1] case "cpuid level": v, err := strconv.ParseUint(field[1], 0, 32) if err != nil { return nil, err } cpuinfo[i].CPUIDLevel = uint(v) case "wp": cpuinfo[i].WP = field[1] case "flags": cpuinfo[i].Flags = strings.Fields(field[1]) case "bugs": cpuinfo[i].Bugs = strings.Fields(field[1]) case "bogomips": v, err := strconv.ParseFloat(field[1], 64) if err != nil { return nil, err } cpuinfo[i].BogoMips = v case "clflush size": v, err := strconv.ParseUint(field[1], 0, 32) if err != nil { return nil, err } cpuinfo[i].CLFlushSize = uint(v) case "cache_alignment": v, err := strconv.ParseUint(field[1], 0, 32) if err != nil { return nil, err } cpuinfo[i].CacheAlignment = uint(v) case "address sizes": cpuinfo[i].AddressSizes = field[1] case "power management": cpuinfo[i].PowerManagement = field[1] } } return cpuinfo, nil } func parseCPUInfoARM(info []byte) ([]CPUInfo, error) { scanner := bufio.NewScanner(bytes.NewReader(info)) firstLine := firstNonEmptyLine(scanner) match, err := regexp.MatchString("^[Pp]rocessor", firstLine) if !match \|\| !strings.Contains(firstLine, ":") { return nil, fmt.Errorf("%w: Cannot parse line: %q: %w", ErrFileParse, firstLine, err) } field := strings.SplitN(firstLine, ": ", 2) cpuinfo := []CPUInfo{} featuresLine := "" commonCPUInfo := CPUInfo{} i := 0 if strings.TrimSpace(field[0]) == "Processor" { commonCPUInfo = CPUInfo{ModelName: field[1]} i = -1 } else { v, err := strconv.ParseUint(field[1], 0, 32) if err != nil { return nil, err } firstcpu := CPUInfo{Processor: uint(v)} cpuinfo = []CPUInfo{firstcpu} } for scanner.Scan() { line := scanner.Text() if !strings.Contains(line, ":") { continue } field := strings.SplitN(line, ": ", 2) switch strings.TrimSpace(field[0]) { case "processor": cpuinfo = append(cpuinfo, commonCPUInfo) // start of the next processor i++ v, err := strconv.ParseUint(field[1], 0, 32) if err != nil { return nil, err } cpuinfo[i].Processor = uint(v) case "BogoMIPS": if i == -1 { cpuinfo = append(cpuinfo, commonCPUInfo) // There is only one processor i++ cpuinfo[i].Processor = 0 } v, err := strconv.ParseFloat(field[1], 64) if err != nil { return nil, err } cpuinfo[i].BogoMips = v case "Features": featuresLine = line case "model name": cpuinfo[i].ModelName = field[1] } } fields := strings.SplitN(featuresLine, ": ", 2) for i := range cpuinfo { cpuinfo[i].Flags = strings.Fields(fields[1]) } return cpuinfo, nil } func parseCPUInfoS390X(info []byte) ([]CPUInfo, error) { scanner := bufio.NewScanner(bytes.NewReader(info)) firstLine := firstNonEmptyLine(scanner) if !strings.HasPrefix(firstLine, "vendor_id") \|\| !strings.Contains(firstLine, ":") { return nil, fmt.Errorf("%w: Cannot parse line: %q", ErrFileParse, firstLine) } field := strings.SplitN(firstLine, ": ", 2) cpuinfo := []CPUInfo{} commonCPUInfo := CPUInfo{VendorID: field[1]} for scanner.Scan() { line := scanner.Text() if !strings.Contains(line, ":") { continue } field := strings.SplitN(line, ": ", 2) switch strings.TrimSpace(field[0]) { case "bogomips per cpu": v, err := strconv.ParseFloat(field[1], 64) if err != nil { return nil, err } commonCPUInfo.BogoMips = v case "features": commonCPUInfo.Flags = strings.Fields(field[1]) } if strings.HasPrefix(line, "processor") { match := cpuinfoS390XProcessorRegexp.FindStringSubmatch(line) if len(match) < 2 { return nil, fmt.Errorf("%w: %q", ErrFileParse, firstLine) } cpu := commonCPUInfo v, err := strconv.ParseUint(match[1], 0, 32) if err != nil { return nil, err } cpu.Processor = uint(v) cpuinfo = append(cpuinfo, cpu) } if strings.HasPrefix(line, "cpu number") { break } } i := 0 for scanner.Scan() { line := scanner.Text() if !strings.Contains(line, ":") { continue } field := strings.SplitN(line, ": ", 2) switch strings.TrimSpace(field[0]) { case "cpu number": i++ case "cpu MHz dynamic": clock := cpuinfoClockRegexp.FindString(strings.TrimSpace(field[1])) v, err := strconv.ParseFloat(clock, 64) if err != nil { return nil, err } cpuinfo[i].CPUMHz = v case "physical id": cpuinfo[i].PhysicalID = field[1] case "core id": cpuinfo[i].CoreID = field[1] case "cpu cores": v, err := strconv.ParseUint(field[1], 0, 32) if err != nil { return nil, err } cpuinfo[i].CPUCores = uint(v) case "siblings": v, err := strconv.ParseUint(field[1], 0, 32) if err != nil { return nil, err } cpuinfo[i].Siblings = uint(v) } } return cpuinfo, nil } func parseCPUInfoMips(info []byte) ([]CPUInfo, error) { scanner := bufio.NewScanner(bytes.NewReader(info)) // find the first "processor" line firstLine := firstNonEmptyLine(scanner) if !strings.HasPrefix(firstLine, "system type") \|\| !strings.Contains(firstLine, ":") { return nil, fmt.Errorf("%w: %q", ErrFileParse, firstLine) } field := strings.SplitN(firstLine, ": ", 2) cpuinfo := []CPUInfo{} systemType := field[1] i := 0 for scanner.Scan() { line := scanner.Text() if !strings.Contains(line, ":") { continue } field := strings.SplitN(line, ": ", 2) switch strings.TrimSpace(field[0]) { case "processor": v, err := strconv.ParseUint(field[1], 0, 32) if err != nil { return nil, err } i = int(v) cpuinfo = append(cpuinfo, CPUInfo{}) // start of the next processor cpuinfo[i].Processor = uint(v) cpuinfo[i].VendorID = systemType case "cpu model": cpuinfo[i].ModelName = field[1] case "BogoMIPS": v, err := strconv.ParseFloat(field[1], 64) if err != nil { return nil, err } cpuinfo[i].BogoMips = v } } return cpuinfo, nil } func parseCPUInfoLoong(info []byte) ([]CPUInfo, error) { scanner := bufio.NewScanner(bytes.NewReader(info)) // find the first "processor" line firstLine := firstNonEmptyLine(scanner) if !strings.HasPrefix(firstLine, "system type") \|\| !strings.Contains(firstLine, ":") { return nil, fmt.Errorf("%w: %q", ErrFileParse, firstLine) } field := strings.SplitN(firstLine, ": ", 2) cpuinfo := []CPUInfo{} systemType := field[1] i := 0 for scanner.Scan() { line := scanner.Text() if !strings.Contains(line, ":") { continue } field := strings.SplitN(line, ": ", 2) switch strings.TrimSpace(field[0]) { case "processor": v, err := strconv.ParseUint(field[1], 0, 32) if err != nil { return nil, err } i = int(v) cpuinfo = append(cpuinfo, CPUInfo{}) // start of the next processor cpuinfo[i].Processor = uint(v) cpuinfo[i].VendorID = systemType case "CPU Family": cpuinfo[i].CPUFamily = field[1] case "Model Name": cpuinfo[i].ModelName = field[1] } } return cpuinfo, nil } func parseCPUInfoPPC(info []byte) ([]CPUInfo, error) { scanner := bufio.NewScanner(bytes.NewReader(info)) firstLine := firstNonEmptyLine(scanner) if !strings.HasPrefix(firstLine, "processor") \|\| !strings.Contains(firstLine, ":") { return nil, fmt.Errorf("%w: %q", ErrFileParse, firstLine) } field := strings.SplitN(firstLine, ": ", 2) v, err := strconv.ParseUint(field[1], 0, 32) if err != nil { return nil, err } firstcpu := CPUInfo{Processor: uint(v)} cpuinfo := []CPUInfo{firstcpu} i := 0 for scanner.Scan() { line := scanner.Text() if !strings.Contains(line, ":") { continue } field := strings.SplitN(line, ": ", 2) switch strings.TrimSpace(field[0]) { case "processor": cpuinfo = append(cpuinfo, CPUInfo{}) // start of the next processor i++ v, err := strconv.ParseUint(field[1], 0, 32) if err != nil { return nil, err } cpuinfo[i].Processor = uint(v) case "cpu": cpuinfo[i].VendorID = field[1] case "clock": clock := cpuinfoClockRegexp.FindString(strings.TrimSpace(field[1])) v, err := strconv.ParseFloat(clock, 64) if err != nil { return nil, err } cpuinfo[i].CPUMHz = v } } return cpuinfo, nil } func parseCPUInfoRISCV(info []byte) ([]CPUInfo, error) { scanner := bufio.NewScanner(bytes.NewReader(info)) firstLine := firstNonEmptyLine(scanner) if !strings.HasPrefix(firstLine, "processor") \|\| !strings.Contains(firstLine, ":") { return nil, fmt.Errorf("%w: %q", ErrFileParse, firstLine) } field := strings.SplitN(firstLine, ": ", 2) v, err := strconv.ParseUint(field[1], 0, 32) if err != nil { return nil, err } firstcpu := CPUInfo{Processor: uint(v)} cpuinfo := []CPUInfo{firstcpu} i := 0 for scanner.Scan() { line := scanner.Text() if !strings.Contains(line, ":") { continue } field := strings.SplitN(line, ": ", 2) switch strings.TrimSpace(field[0]) { case "processor": v, err := strconv.ParseUint(field[1], 0, 32) if err != nil { return nil, err } i = int(v) cpuinfo = append(cpuinfo, CPUInfo{}) // start of the next processor cpuinfo[i].Processor = uint(v) case "hart": cpuinfo[i].CoreID = field[1] case "isa": cpuinfo[i].ModelName = field[1] } } return cpuinfo, nil } func parseCPUInfoDummy(_ []byte) ([]CPUInfo, error) { // nolint:unused,deadcode return nil, errors.New("not implemented") } // firstNonEmptyLine advances the scanner to the first non-empty line // and returns the contents of that line. func firstNonEmptyLine(scanner bufio.Scanner) string { for scanner.Scan() { line := scanner.Text() if strings.TrimSpace(line) != "" { return line } } return "" }	13.25 KB	2025-05-25 12:27
📄 cpuinfo_armx.go // Copyright 2020 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. //go:build linux && (arm \|\| arm64) // +build linux // +build arm arm64 package procfs var parseCPUInfo = parseCPUInfoARM	716 B	2025-05-25 12:27
📄 cpuinfo_loong64.go // Copyright 2022 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. //go:build linux // +build linux package procfs var parseCPUInfo = parseCPUInfoLoong	680 B	2025-05-25 12:27
📄 cpuinfo_mipsx.go // Copyright 2020 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. //go:build linux && (mips \|\| mipsle \|\| mips64 \|\| mips64le) // +build linux // +build mips mipsle mips64 mips64le package procfs var parseCPUInfo = parseCPUInfoMips	759 B	2025-05-25 12:27
📄 cpuinfo_others.go // Copyright 2020 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. //go:build linux && !386 && !amd64 && !arm && !arm64 && !loong64 && !mips && !mips64 && !mips64le && !mipsle && !ppc64 && !ppc64le && !riscv64 && !s390x // +build linux,!386,!amd64,!arm,!arm64,!loong64,!mips,!mips64,!mips64le,!mipsle,!ppc64,!ppc64le,!riscv64,!s390x package procfs var parseCPUInfo = parseCPUInfoDummy	913 B	2025-05-25 12:27
📄 cpuinfo_ppcx.go // Copyright 2020 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. //go:build linux && (ppc64 \|\| ppc64le) // +build linux // +build ppc64 ppc64le package procfs var parseCPUInfo = parseCPUInfoPPC	724 B	2025-05-25 12:27
📄 cpuinfo_riscvx.go // Copyright 2020 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. //go:build linux && (riscv \|\| riscv64) // +build linux // +build riscv riscv64 package procfs var parseCPUInfo = parseCPUInfoRISCV	726 B	2025-05-25 12:27
📄 cpuinfo_s390x.go // Copyright 2020 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. //go:build linux // +build linux package procfs var parseCPUInfo = parseCPUInfoS390X	680 B	2025-05-25 12:27
📄 cpuinfo_test.go // Copyright 2019 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. //go:build linux // +build linux package procfs import "testing" const ( cpuinfoArm7Legacy = ` Processor : ARMv7 Processor rev 5 (v7l) processor : 0 BogoMIPS : 2400.00 processor : 1 BogoMIPS : 2400.00 Features : swp half thumb fastmult vfp edsp thumbee neon vfpv3 tls vfpv4 idiva idivt CPU implementer : 0x41 CPU architecture: 7 CPU variant : 0x0 CPU part : 0xc07 CPU revision : 5 Hardware : sun8i Revision : 0000 Serial : 5400503583203c3c040e` cpuinfoArm7LegacyV1 = ` Processor : ARMv6-compatible processor rev 5 (v6l) BogoMIPS : 791.34 Features : swp half thumb fastmult vfp edsp java CPU implementer : 0x41 CPU architecture: 6TEJ CPU variant : 0x1 CPU part : 0xb36 CPU revision : 5 Hardware : IMAPX200 Revision : 0000 Serial : 0000000000000000` cpuinfoArm7 = ` processor : 0 model name : ARMv7 Processor rev 3 (v7l) BogoMIPS : 108.00 Features : half thumb fastmult vfp edsp neon vfpv3 tls vfpv4 idiva idivt vfpd32 lpae evtstrm crc32 CPU implementer : 0x41 CPU architecture: 7 CPU variant : 0x0 CPU part : 0xd08 CPU revision : 3 processor : 1 model name : ARMv7 Processor rev 3 (v7l) BogoMIPS : 108.00 Features : half thumb fastmult vfp edsp neon vfpv3 tls vfpv4 idiva idivt vfpd32 lpae evtstrm crc32 CPU implementer : 0x41 CPU architecture: 7 CPU variant : 0x0 CPU part : 0xd08 CPU revision : 3 processor : 2 model name : ARMv7 Processor rev 3 (v7l) BogoMIPS : 108.00 Features : half thumb fastmult vfp edsp neon vfpv3 tls vfpv4 idiva idivt vfpd32 lpae evtstrm crc32 CPU implementer : 0x41 CPU architecture: 7 CPU variant : 0x0 CPU part : 0xd08 CPU revision : 3 processor : 3 model name : ARMv7 Processor rev 3 (v7l) BogoMIPS : 108.00 Features : half thumb fastmult vfp edsp neon vfpv3 tls vfpv4 idiva idivt vfpd32 lpae evtstrm crc32 CPU implementer : 0x41 CPU architecture: 7 CPU variant : 0x0 CPU part : 0xd08 CPU revision : 3 Hardware : BCM2835 Revision : c03111 ` cpuinfoS390x = ` vendor_id : IBM/S390 # processors : 4 bogomips per cpu: 3033.00 max thread id : 0 features : esan3 zarch stfle msa ldisp eimm dfp edat etf3eh highgprs te vx sie facilities : 0 1 2 3 4 6 7 8 9 10 12 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 30 31 32 33 34 35 36 37 40 41 42 43 44 45 46 47 48 49 50 51 52 53 55 57 73 74 75 76 77 80 81 82 128 129 131 cache0 : level=1 type=Data scope=Private size=128K line_size=256 associativity=8 cache1 : level=1 type=Instruction scope=Private size=96K line_size=256 associativity=6 cache2 : level=2 type=Data scope=Private size=2048K line_size=256 associativity=8 cache3 : level=2 type=Instruction scope=Private size=2048K line_size=256 associativity=8 cache4 : level=3 type=Unified scope=Shared size=65536K line_size=256 associativity=16 cache5 : level=4 type=Unified scope=Shared size=491520K line_size=256 associativity=30 processor 0: version = FF, identification = 2733E8, machine = 2964 processor 1: version = FF, identification = 2733E8, machine = 2964 processor 2: version = FF, identification = 2733E8, machine = 2964 processor 3: version = FF, identification = 2733E8, machine = 2964 cpu number : 0 physical id : 2 core id : 0 siblings : 8 cpu cores : 4 cpu MHz dynamic : 5000 cpu MHz static : 5000 cpu number : 1 physical id : 2 core id : 0 siblings : 8 cpu cores : 4 cpu MHz dynamic : 5000 cpu MHz static : 5000 cpu number : 2 physical id : 2 core id : 1 siblings : 8 cpu cores : 4 cpu MHz dynamic : 5000 cpu MHz static : 5000 cpu number : 3 physical id : 2 core id : 1 siblings : 8 cpu cores : 4 cpu MHz dynamic : 5000 cpu MHz static : 5000 ` cpuinfoMips = ` system type : UBNT_E100 machine : Unknown processor : 0 cpu model : Cavium Octeon+ V0.1 BogoMIPS : 1000.00 wait instruction : yes microsecond timers : yes tlb_entries : 64 extra interrupt vector : yes hardware watchpoint : yes, count: 2, address/irw mask: [0x0ffc, 0x0ffb] isa : mips1 mips2 mips3 mips4 mips5 mips64r2 ASEs implemented : shadow register sets : 1 kscratch registers : 0 core : 0 VCED exceptions : not available VCEI exceptions : not available processor : 1 cpu model : Cavium Octeon+ V0.1 BogoMIPS : 1000.00 wait instruction : yes microsecond timers : yes tlb_entries : 64 extra interrupt vector : yes hardware watchpoint : yes, count: 2, address/irw mask: [0x0ffc, 0x0ffb] isa : mips1 mips2 mips3 mips4 mips5 mips64r2 ASEs implemented : shadow register sets : 1 kscratch registers : 0 core : 1 VCED exceptions : not available VCEI exceptions : not available ` cpuinfoPpc64 = ` processor : 0 cpu : POWER7 (architected), altivec supported clock : 3000.000000MHz revision : 2.1 (pvr 003f 0201) processor : 1 cpu : POWER7 (architected), altivec supported clock : 3000.000000MHz revision : 2.1 (pvr 003f 0201) processor : 2 cpu : POWER7 (architected), altivec supported clock : 3000.000000MHz revision : 2.1 (pvr 003f 0201) processor : 3 cpu : POWER7 (architected), altivec supported clock : 3000.000000MHz revision : 2.1 (pvr 003f 0201) processor : 4 cpu : POWER7 (architected), altivec supported clock : 3000.000000MHz revision : 2.1 (pvr 003f 0201) processor : 5 cpu : POWER7 (architected), altivec supported clock : 3000.000000MHz revision : 2.1 (pvr 003f 0201) timebase : 512000000 platform : pSeries model : IBM,8233-E8B machine : CHRP IBM,8233-E8B ` cpuinfoRiscv64 = ` processor : 0 hart : 0 isa : rv64imafdcsu mmu : sv48 processor : 1 hart : 1 isa : rv64imafdcsu mmu : sv48 ` cpuinfoLoong64 = ` system type : generic-loongson-machine processor : 0 package : 0 core : 0 CPU Family : Loongson-64bit Model Name : Loongson-3A5000 CPU Revision : 0x10 FPU Revision : 0x00 CPU MHz : 2500.00 BogoMIPS : 5000.00 TLB Entries : 2112 Address Sizes : 48 bits physical, 48 bits virtual ISA : loongarch32 loongarch64 Features : cpucfg lam ual fpu complex crypto lvz Hardware Watchpoint : yes, iwatch count: 0, dwatch count: 0 processor : 1 package : 0 core : 1 CPU Family : Loongson-64bit Model Name : Loongson-3A5000 CPU Revision : 0x10 FPU Revision : 0x00 CPU MHz : 2500.00 BogoMIPS : 5000.00 TLB Entries : 2112 Address Sizes : 48 bits physical, 48 bits virtual ISA : loongarch32 loongarch64 Features : cpucfg lam ual fpu complex crypto lvz Hardware Watchpoint : yes, iwatch count: 0, dwatch count: 0 processor : 2 package : 0 core : 2 CPU Family : Loongson-64bit Model Name : Loongson-3A5000 CPU Revision : 0x10 FPU Revision : 0x00 CPU MHz : 2500.00 BogoMIPS : 5000.00 TLB Entries : 2112 Address Sizes : 48 bits physical, 48 bits virtual ISA : loongarch32 loongarch64 Features : cpucfg lam ual fpu complex crypto lvz Hardware Watchpoint : yes, iwatch count: 0, dwatch count: 0 processor : 3 package : 0 core : 3 CPU Family : Loongson-64bit Model Name : Loongson-3A5000 CPU Revision : 0x10 FPU Revision : 0x00 CPU MHz : 2500.00 BogoMIPS : 5000.00 TLB Entries : 2112 Address Sizes : 48 bits physical, 48 bits virtual ISA : loongarch32 loongarch64 Features : cpucfg lam ual fpu complex crypto lvz Hardware Watchpoint : yes, iwatch count: 0, dwatch count: 0 ` ) func TestCPUInfoX86(t testing.T) { parseCPUInfo = parseCPUInfoX86 cpuinfo, err := getProcFixtures(t).CPUInfo() if err != nil { t.Fatal(err) } if cpuinfo == nil { t.Fatal("cpuinfo is nil") } if want, have := 8, len(cpuinfo); want != have { t.Errorf("want number of processors %v, have %v", want, have) } if want, have := uint(7), cpuinfo[7].Processor; want != have { t.Errorf("want processor %v, have %v", want, have) } if want, have := "GenuineIntel", cpuinfo[0].VendorID; want != have { t.Errorf("want vendor %v, have %v", want, have) } if want, have := "6", cpuinfo[1].CPUFamily; want != have { t.Errorf("want family %v, have %v", want, have) } if want, have := "142", cpuinfo[2].Model; want != have { t.Errorf("want model %v, have %v", want, have) } if want, have := "Intel(R) Core(TM) i7-8650U CPU @ 1.90GHz", cpuinfo[3].ModelName; want != have { t.Errorf("want model %v, have %v", want, have) } if want, have := uint(8), cpuinfo[4].Siblings; want != have { t.Errorf("want siblings %v, have %v", want, have) } if want, have := "1", cpuinfo[5].CoreID; want != have { t.Errorf("want core id %v, have %v", want, have) } if want, have := uint(4), cpuinfo[6].CPUCores; want != have { t.Errorf("want cpu cores %v, have %v", want, have) } if want, have := "vme", cpuinfo[7].Flags[1]; want != have { t.Errorf("want flag %v, have %v", want, have) } } func TestCPUInfoParseARMLegacy(t testing.T) { cpuinfo, err := parseCPUInfoARM([]byte(cpuinfoArm7Legacy)) if err != nil \|\| cpuinfo == nil { t.Fatalf("unable to parse arm cpu info: %v", err) } if want, have := 2, len(cpuinfo); want != have { t.Errorf("want number of processors %v, have %v", want, have) } if want, have := "ARMv7 Processor rev 5 (v7l)", cpuinfo[0].ModelName; want != have { t.Errorf("want vendor %v, have %v", want, have) } if want, have := "thumb", cpuinfo[1].Flags[2]; want != have { t.Errorf("want flag %v, have %v", want, have) } } func TestCPUInfoParseARMLegacyV1(t testing.T) { cpuinfo, err := parseCPUInfoARM([]byte(cpuinfoArm7LegacyV1)) if err != nil \|\| cpuinfo == nil { t.Fatalf("unable to parse arm cpu info: %v", err) } if want, have := 1, len(cpuinfo); want != have { t.Errorf("want number of processors %v, have %v", want, have) } if want, have := "ARMv6-compatible processor rev 5 (v6l)", cpuinfo[0].ModelName; want != have { t.Errorf("want vendor %v, have %v", want, have) } if want, have := "thumb", cpuinfo[0].Flags[2]; want != have { t.Errorf("want flag %v, have %v", want, have) } } func TestCPUInfoParseARM(t testing.T) { cpuinfo, err := parseCPUInfoARM([]byte(cpuinfoArm7)) if err != nil \|\| cpuinfo == nil { t.Fatalf("unable to parse arm cpu info: %v", err) } if want, have := 4, len(cpuinfo); want != have { t.Errorf("want number of processors %v, have %v", want, have) } if want, have := "ARMv7 Processor rev 3 (v7l)", cpuinfo[0].ModelName; want != have { t.Errorf("want vendor %v, have %v", want, have) } if want, have := "thumb", cpuinfo[1].Flags[1]; want != have { t.Errorf("want flag %v, have %v", want, have) } } func TestCPUInfoParseS390X(t testing.T) { cpuinfo, err := parseCPUInfoS390X([]byte(cpuinfoS390x)) if err != nil \|\| cpuinfo == nil { t.Fatalf("unable to parse s390x cpu info: %v", err) } if want, have := 4, len(cpuinfo); want != have { t.Errorf("want number of processors %v, have %v", want, have) } if want, have := "IBM/S390", cpuinfo[0].VendorID; want != have { t.Errorf("want vendor %v, have %v", want, have) } if want, have := "ldisp", cpuinfo[1].Flags[4]; want != have { t.Errorf("want flag %v, have %v", want, have) } if want, have := 5000.0, cpuinfo[2].CPUMHz; want != have { t.Errorf("want cpu MHz %v, have %v", want, have) } if want, have := uint(8), cpuinfo[3].Siblings; want != have { t.Errorf("want siblings %v, have %v", want, have) } if want, have := "1", cpuinfo[3].CoreID; want != have { t.Errorf("want core id %v, have %v", want, have) } if want, have := uint(4), cpuinfo[2].CPUCores; want != have { t.Errorf("want cpu cores %v, have %v", want, have) } if want, have := "2", cpuinfo[2].PhysicalID; want != have { t.Errorf("want physical id %v, have %v", want, have) } } func TestCPUInfoParseMips(t testing.T) { cpuinfo, err := parseCPUInfoMips([]byte(cpuinfoMips)) if err != nil \|\| cpuinfo == nil { t.Fatalf("unable to parse mips cpu info: %v", err) } if want, have := 2, len(cpuinfo); want != have { t.Errorf("want number of processors %v, have %v", want, have) } if want, have := 1000.00, cpuinfo[0].BogoMips; want != have { t.Errorf("want BogoMIPS %v, have %v", want, have) } if want, have := "Cavium Octeon+ V0.1", cpuinfo[1].ModelName; want != have { t.Errorf("want ModelName '%v', have '%v'", want, have) } } func TestCPUInfoParsePPC(t testing.T) { cpuinfo, err := parseCPUInfoPPC([]byte(cpuinfoPpc64)) if err != nil \|\| cpuinfo == nil { t.Fatalf("unable to parse ppc cpu info: %v", err) } if want, have := 6, len(cpuinfo); want != have { t.Errorf("want number of processors %v, have %v", want, have) } if want, have := 3000.00, cpuinfo[2].CPUMHz; want != have { t.Errorf("want cpu mhz %v, have %v", want, have) } } func TestCPUInfoParseRISCV64(t testing.T) { cpuinfo, err := parseCPUInfoRISCV([]byte(cpuinfoRiscv64)) if err != nil \|\| cpuinfo == nil { t.Fatalf("unable to parse ppc cpu info: %v", err) } if want, have := 2, len(cpuinfo); want != have { t.Errorf("want number of processors %v, have %v", want, have) } if want, have := "1", cpuinfo[1].CoreID; want != have { t.Errorf("want CoreId %v, have %v", want, have) } if want, have := "rv64imafdcsu", cpuinfo[1].ModelName; want != have { t.Errorf("want ModelName %v, have %v", want, have) } } func TestCPUInfoParseLoong64(t *testing.T) { cpuinfo, err := parseCPUInfoLoong([]byte(cpuinfoLoong64)) if err != nil \|\| cpuinfo == nil { t.Fatalf("unable to parse loong cpu info: %v", err) } if want, have := 4, len(cpuinfo); want != have { t.Errorf("want number of processors %v, have %v", want, have) } if want, have := "Loongson-64bit", cpuinfo[1].CPUFamily; want != have { t.Errorf("want CPUFamily '%v', have '%v'", want, have) } }	13.76 KB	2025-05-25 12:27
📄 cpuinfo_x86.go // Copyright 2020 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. //go:build linux && (386 \|\| amd64) // +build linux // +build 386 amd64 package procfs var parseCPUInfo = parseCPUInfoX86	716 B	2025-05-25 12:27
📄 crypto.go // Copyright 2019 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "bufio" "bytes" "fmt" "io" "strings" "github.com/prometheus/procfs/internal/util" ) // Crypto holds info parsed from /proc/crypto. type Crypto struct { Alignmask uint64 Async bool Blocksize uint64 Chunksize uint64 Ctxsize uint64 Digestsize uint64 Driver string Geniv string Internal string Ivsize uint64 Maxauthsize uint64 MaxKeysize uint64 MinKeysize uint64 Module string Name string Priority int64 Refcnt int64 Seedsize uint64 Selftest string Type string Walksize uint64 } // Crypto parses an crypto-file (/proc/crypto) and returns a slice of // structs containing the relevant info. More information available here: // https://kernel.readthedocs.io/en/sphinx-samples/crypto-API.html func (fs FS) Crypto() ([]Crypto, error) { path := fs.proc.Path("crypto") b, err := util.ReadFileNoStat(path) if err != nil { return nil, fmt.Errorf("%w: Cannot read file %v: %w", ErrFileRead, b, err) } crypto, err := parseCrypto(bytes.NewReader(b)) if err != nil { return nil, fmt.Errorf("%w: Cannot parse %v: %w", ErrFileParse, crypto, err) } return crypto, nil } // parseCrypto parses a /proc/crypto stream into Crypto elements. func parseCrypto(r io.Reader) ([]Crypto, error) { var out []Crypto s := bufio.NewScanner(r) for s.Scan() { text := s.Text() switch { case strings.HasPrefix(text, "name"): // Each crypto element begins with its name. out = append(out, Crypto{}) case text == "": continue } kv := strings.Split(text, ":") if len(kv) != 2 { return nil, fmt.Errorf("%w: Cannot parse line: %q", ErrFileParse, text) } k := strings.TrimSpace(kv[0]) v := strings.TrimSpace(kv[1]) // Parse the key/value pair into the currently focused element. c := &out[len(out)-1] if err := c.parseKV(k, v); err != nil { return nil, err } } if err := s.Err(); err != nil { return nil, err } return out, nil } // parseKV parses a key/value pair into the appropriate field of c. func (c Crypto) parseKV(k, v string) error { vp := util.NewValueParser(v) switch k { case "async": // Interpret literal yes as true. c.Async = v == "yes" case "blocksize": c.Blocksize = vp.PUInt64() case "chunksize": c.Chunksize = vp.PUInt64() case "digestsize": c.Digestsize = vp.PUInt64() case "driver": c.Driver = v case "geniv": c.Geniv = v case "internal": c.Internal = v case "ivsize": c.Ivsize = vp.PUInt64() case "maxauthsize": c.Maxauthsize = vp.PUInt64() case "max keysize": c.MaxKeysize = vp.PUInt64() case "min keysize": c.MinKeysize = vp.PUInt64() case "module": c.Module = v case "name": c.Name = v case "priority": c.Priority = vp.PInt64() case "refcnt": c.Refcnt = vp.PInt64() case "seedsize": c.Seedsize = vp.PUInt64() case "selftest": c.Selftest = v case "type": c.Type = v case "walksize": c.Walksize = vp.PUInt64() } return vp.Err() }	3.5 KB	2025-05-25 12:27
📄 crypto_test.go // Copyright 2019 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "testing" "github.com/google/go-cmp/cmp" ) func TestFS_Crypto(t testing.T) { fs := getProcFixtures(t) crypto, err := fs.Crypto() if err != nil { t.Fatalf("parsing of reference-file failed entirely: %s", err) } refs := []Crypto{ { Name: "ccm(aes)", Driver: "ccm_base(ctr(aes-aesni),cbcmac(aes-aesni))", Module: "ccm", Priority: newint64(300), Refcnt: newint64(4), Selftest: "passed", Internal: "no", Type: "aead", Async: false, Blocksize: newuint64(1), Ivsize: newuint64(16), Maxauthsize: newuint64(16), Geniv: "<none>", }, { Name: "cbcmac(aes)", Driver: "cbcmac(aes-aesni)", Module: "ccm", Priority: newint64(300), Refcnt: newint64(7), Selftest: "passed", Internal: "no", Type: "shash", Blocksize: newuint64(1), Digestsize: newuint64(16), }, { Name: "ecdh", Driver: "ecdh-generic", Module: "ecdh_generic", Priority: newint64(100), Refcnt: newint64(1), Selftest: "passed", Internal: "no", Type: "kpp", Async: true, }, { Name: "ecb(arc4)", Driver: "ecb(arc4)-generic", Module: "arc4", Priority: newint64(100), Refcnt: newint64(1), Selftest: "passed", Internal: "no", Type: "skcipher", Async: false, Blocksize: newuint64(1), MinKeysize: newuint64(1), MaxKeysize: newuint64(256), Ivsize: newuint64(0), Chunksize: newuint64(1), Walksize: newuint64(1), }, { Name: "arc4", Driver: "arc4-generic", Module: "arc4", Priority: newint64(0), Refcnt: newint64(3), Selftest: "passed", Internal: "no", Type: "cipher", Blocksize: newuint64(1), MinKeysize: newuint64(1), MaxKeysize: newuint64(256), }, { Name: "crct10dif", Driver: "crct10dif-pclmul", Module: "crct10dif_pclmul", Priority: newint64(200), Refcnt: newint64(2), Selftest: "passed", Internal: "no", Type: "shash", Blocksize: newuint64(1), Digestsize: newuint64(2), }, } if want, have := len(refs), len(crypto); want > have { t.Errorf("want at least %d parsed crypto-entries, have %d", want, have) } for index, ref := range refs { want, got := ref, crypto[index] if diff := cmp.Diff(want, got); diff != "" { t.Fatalf("unexpected crypto entry (-want +got):\n%s", diff) } } } func newint64(i int64) int64 { return &i } func newuint64(i uint64) *uint64 { return &i }	3.12 KB	2025-05-25 12:27
📄 doc.go // Copyright 2014 Prometheus Team // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. // Package procfs provides functions to retrieve system, kernel and process // metrics from the pseudo-filesystem proc. // // Example: // // package main // // import ( // "fmt" // "log" // // "github.com/prometheus/procfs" // ) // // func main() { // p, err := procfs.Self() // if err != nil { // log.Fatalf("could not get process: %s", err) // } // // stat, err := p.Stat() // if err != nil { // log.Fatalf("could not get process stat: %s", err) // } // // fmt.Printf("command: %s\n", stat.Comm) // fmt.Printf("cpu time: %fs\n", stat.CPUTime()) // fmt.Printf("vsize: %dB\n", stat.VirtualMemory()) // fmt.Printf("rss: %dB\n", stat.ResidentMemory()) // } package procfs	1.25 KB	2025-05-25 12:27
📄 fs.go // Copyright 2018 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "github.com/prometheus/procfs/internal/fs" ) // FS represents the pseudo-filesystem sys, which provides an interface to // kernel data structures. type FS struct { proc fs.FS isReal bool } // DefaultMountPoint is the common mount point of the proc filesystem. const DefaultMountPoint = fs.DefaultProcMountPoint // NewDefaultFS returns a new proc FS mounted under the default proc mountPoint. // It will error if the mount point directory can't be read or is a file. func NewDefaultFS() (FS, error) { return NewFS(DefaultMountPoint) } // NewFS returns a new proc FS mounted under the given proc mountPoint. It will error // if the mount point directory can't be read or is a file. func NewFS(mountPoint string) (FS, error) { fs, err := fs.NewFS(mountPoint) if err != nil { return FS{}, err } isReal, err := isRealProc(mountPoint) if err != nil { return FS{}, err } return FS{fs, isReal}, nil }	1.5 KB	2025-05-25 12:27
📄 fs_statfs_notype.go // Copyright 2018 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. //go:build !freebsd && !linux // +build !freebsd,!linux package procfs // isRealProc returns true on architectures that don't have a Type argument // in their Statfs_t struct func isRealProc(mountPoint string) (bool, error) { return true, nil }	841 B	2025-05-25 12:27
📄 fs_statfs_type.go // Copyright 2018 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. //go:build freebsd \|\| linux // +build freebsd linux package procfs import ( "syscall" ) // isRealProc determines whether supplied mountpoint is really a proc filesystem. func isRealProc(mountPoint string) (bool, error) { stat := syscall.Statfs_t{} err := syscall.Statfs(mountPoint, &stat) if err != nil { return false, err } // 0x9fa0 is PROC_SUPER_MAGIC: https://elixir.bootlin.com/linux/v6.1/source/include/uapi/linux/magic.h#L87 return stat.Type == 0x9fa0, nil }	1.05 KB	2025-05-25 12:27
📄 fs_test.go // Copyright 2018 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import "testing" const ( procTestFixtures = "testdata/fixtures/proc" ) func TestNewFS(t testing.T) { if _, err := NewFS("foobar"); err == nil { t.Error("want NewFS to fail for non-existing mount point") } if _, err := NewFS("procfs.go"); err == nil { t.Error("want NewFS to fail if mount point is not a directory") } getProcFixtures(t) } func getProcFixtures(t testing.T) FS { fs, err := NewFS(procTestFixtures) if err != nil { t.Fatalf("Creating pseudo fs from getProcFixtures failed at fixtures/proc with error: %s", err) } return fs }	1.14 KB	2025-05-25 12:27
📄 fscache.go // Copyright 2019 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "bufio" "bytes" "fmt" "io" "strconv" "strings" "github.com/prometheus/procfs/internal/util" ) // Fscacheinfo represents fscache statistics. type Fscacheinfo struct { // Number of index cookies allocated IndexCookiesAllocated uint64 // data storage cookies allocated DataStorageCookiesAllocated uint64 // Number of special cookies allocated SpecialCookiesAllocated uint64 // Number of objects allocated ObjectsAllocated uint64 // Number of object allocation failures ObjectAllocationsFailure uint64 // Number of objects that reached the available state ObjectsAvailable uint64 // Number of objects that reached the dead state ObjectsDead uint64 // Number of objects that didn't have a coherency check ObjectsWithoutCoherencyCheck uint64 // Number of objects that passed a coherency check ObjectsWithCoherencyCheck uint64 // Number of objects that needed a coherency data update ObjectsNeedCoherencyCheckUpdate uint64 // Number of objects that were declared obsolete ObjectsDeclaredObsolete uint64 // Number of pages marked as being cached PagesMarkedAsBeingCached uint64 // Number of uncache page requests seen UncachePagesRequestSeen uint64 // Number of acquire cookie requests seen AcquireCookiesRequestSeen uint64 // Number of acq reqs given a NULL parent AcquireRequestsWithNullParent uint64 // Number of acq reqs rejected due to no cache available AcquireRequestsRejectedNoCacheAvailable uint64 // Number of acq reqs succeeded AcquireRequestsSucceeded uint64 // Number of acq reqs rejected due to error AcquireRequestsRejectedDueToError uint64 // Number of acq reqs failed on ENOMEM AcquireRequestsFailedDueToEnomem uint64 // Number of lookup calls made on cache backends LookupsNumber uint64 // Number of negative lookups made LookupsNegative uint64 // Number of positive lookups made LookupsPositive uint64 // Number of objects created by lookup ObjectsCreatedByLookup uint64 // Number of lookups timed out and requeued LookupsTimedOutAndRequed uint64 InvalidationsNumber uint64 InvalidationsRunning uint64 // Number of update cookie requests seen UpdateCookieRequestSeen uint64 // Number of upd reqs given a NULL parent UpdateRequestsWithNullParent uint64 // Number of upd reqs granted CPU time UpdateRequestsRunning uint64 // Number of relinquish cookie requests seen RelinquishCookiesRequestSeen uint64 // Number of rlq reqs given a NULL parent RelinquishCookiesWithNullParent uint64 // Number of rlq reqs waited on completion of creation RelinquishRequestsWaitingCompleteCreation uint64 // Relinqs rtr RelinquishRetries uint64 // Number of attribute changed requests seen AttributeChangedRequestsSeen uint64 // Number of attr changed requests queued AttributeChangedRequestsQueued uint64 // Number of attr changed rejected -ENOBUFS AttributeChangedRejectDueToEnobufs uint64 // Number of attr changed failed -ENOMEM AttributeChangedFailedDueToEnomem uint64 // Number of attr changed ops given CPU time AttributeChangedOps uint64 // Number of allocation requests seen AllocationRequestsSeen uint64 // Number of successful alloc reqs AllocationOkRequests uint64 // Number of alloc reqs that waited on lookup completion AllocationWaitingOnLookup uint64 // Number of alloc reqs rejected -ENOBUFS AllocationsRejectedDueToEnobufs uint64 // Number of alloc reqs aborted -ERESTARTSYS AllocationsAbortedDueToErestartsys uint64 // Number of alloc reqs submitted AllocationOperationsSubmitted uint64 // Number of alloc reqs waited for CPU time AllocationsWaitedForCPU uint64 // Number of alloc reqs aborted due to object death AllocationsAbortedDueToObjectDeath uint64 // Number of retrieval (read) requests seen RetrievalsReadRequests uint64 // Number of successful retr reqs RetrievalsOk uint64 // Number of retr reqs that waited on lookup completion RetrievalsWaitingLookupCompletion uint64 // Number of retr reqs returned -ENODATA RetrievalsReturnedEnodata uint64 // Number of retr reqs rejected -ENOBUFS RetrievalsRejectedDueToEnobufs uint64 // Number of retr reqs aborted -ERESTARTSYS RetrievalsAbortedDueToErestartsys uint64 // Number of retr reqs failed -ENOMEM RetrievalsFailedDueToEnomem uint64 // Number of retr reqs submitted RetrievalsRequests uint64 // Number of retr reqs waited for CPU time RetrievalsWaitingCPU uint64 // Number of retr reqs aborted due to object death RetrievalsAbortedDueToObjectDeath uint64 // Number of storage (write) requests seen StoreWriteRequests uint64 // Number of successful store reqs StoreSuccessfulRequests uint64 // Number of store reqs on a page already pending storage StoreRequestsOnPendingStorage uint64 // Number of store reqs rejected -ENOBUFS StoreRequestsRejectedDueToEnobufs uint64 // Number of store reqs failed -ENOMEM StoreRequestsFailedDueToEnomem uint64 // Number of store reqs submitted StoreRequestsSubmitted uint64 // Number of store reqs granted CPU time StoreRequestsRunning uint64 // Number of pages given store req processing time StorePagesWithRequestsProcessing uint64 // Number of store reqs deleted from tracking tree StoreRequestsDeleted uint64 // Number of store reqs over store limit StoreRequestsOverStoreLimit uint64 // Number of release reqs against pages with no pending store ReleaseRequestsAgainstPagesWithNoPendingStorage uint64 // Number of release reqs against pages stored by time lock granted ReleaseRequestsAgainstPagesStoredByTimeLockGranted uint64 // Number of release reqs ignored due to in-progress store ReleaseRequestsIgnoredDueToInProgressStore uint64 // Number of page stores cancelled due to release req PageStoresCancelledByReleaseRequests uint64 VmscanWaiting uint64 // Number of times async ops added to pending queues OpsPending uint64 // Number of times async ops given CPU time OpsRunning uint64 // Number of times async ops queued for processing OpsEnqueued uint64 // Number of async ops cancelled OpsCancelled uint64 // Number of async ops rejected due to object lookup/create failure OpsRejected uint64 // Number of async ops initialised OpsInitialised uint64 // Number of async ops queued for deferred release OpsDeferred uint64 // Number of async ops released (should equal ini=N when idle) OpsReleased uint64 // Number of deferred-release async ops garbage collected OpsGarbageCollected uint64 // Number of in-progress alloc_object() cache ops CacheopAllocationsinProgress uint64 // Number of in-progress lookup_object() cache ops CacheopLookupObjectInProgress uint64 // Number of in-progress lookup_complete() cache ops CacheopLookupCompleteInPorgress uint64 // Number of in-progress grab_object() cache ops CacheopGrabObjectInProgress uint64 CacheopInvalidations uint64 // Number of in-progress update_object() cache ops CacheopUpdateObjectInProgress uint64 // Number of in-progress drop_object() cache ops CacheopDropObjectInProgress uint64 // Number of in-progress put_object() cache ops CacheopPutObjectInProgress uint64 // Number of in-progress attr_changed() cache ops CacheopAttributeChangeInProgress uint64 // Number of in-progress sync_cache() cache ops CacheopSyncCacheInProgress uint64 // Number of in-progress read_or_alloc_page() cache ops CacheopReadOrAllocPageInProgress uint64 // Number of in-progress read_or_alloc_pages() cache ops CacheopReadOrAllocPagesInProgress uint64 // Number of in-progress allocate_page() cache ops CacheopAllocatePageInProgress uint64 // Number of in-progress allocate_pages() cache ops CacheopAllocatePagesInProgress uint64 // Number of in-progress write_page() cache ops CacheopWritePagesInProgress uint64 // Number of in-progress uncache_page() cache ops CacheopUncachePagesInProgress uint64 // Number of in-progress dissociate_pages() cache ops CacheopDissociatePagesInProgress uint64 // Number of object lookups/creations rejected due to lack of space CacheevLookupsAndCreationsRejectedLackSpace uint64 // Number of stale objects deleted CacheevStaleObjectsDeleted uint64 // Number of objects retired when relinquished CacheevRetiredWhenReliquished uint64 // Number of objects culled CacheevObjectsCulled uint64 } // Fscacheinfo returns information about current fscache statistics. // See https://www.kernel.org/doc/Documentation/filesystems/caching/fscache.txt func (fs FS) Fscacheinfo() (Fscacheinfo, error) { b, err := util.ReadFileNoStat(fs.proc.Path("fs/fscache/stats")) if err != nil { return Fscacheinfo{}, err } m, err := parseFscacheinfo(bytes.NewReader(b)) if err != nil { return Fscacheinfo{}, fmt.Errorf("%w: Cannot parse %v: %w", ErrFileParse, m, err) } return m, nil } func setFSCacheFields(fields []string, setFields ...uint64) error { var err error if len(fields) < len(setFields) { return fmt.Errorf("%w: Expected %d, but got %d: %w", ErrFileParse, len(setFields), len(fields), err) } for i := range setFields { setFields[i], err = strconv.ParseUint(strings.Split(fields[i], "=")[1], 0, 64) if err != nil { return err } } return nil } func parseFscacheinfo(r io.Reader) (Fscacheinfo, error) { var m Fscacheinfo s := bufio.NewScanner(r) for s.Scan() { fields := strings.Fields(s.Text()) if len(fields) < 2 { return nil, fmt.Errorf("%w: malformed Fscacheinfo line: %q", ErrFileParse, s.Text()) } switch fields[0] { case "Cookies:": err := setFSCacheFields(fields[1:], &m.IndexCookiesAllocated, &m.DataStorageCookiesAllocated, &m.SpecialCookiesAllocated) if err != nil { return &m, err } case "Objects:": err := setFSCacheFields(fields[1:], &m.ObjectsAllocated, &m.ObjectAllocationsFailure, &m.ObjectsAvailable, &m.ObjectsDead) if err != nil { return &m, err } case "ChkAux": err := setFSCacheFields(fields[2:], &m.ObjectsWithoutCoherencyCheck, &m.ObjectsWithCoherencyCheck, &m.ObjectsNeedCoherencyCheckUpdate, &m.ObjectsDeclaredObsolete) if err != nil { return &m, err } case "Pages": err := setFSCacheFields(fields[2:], &m.PagesMarkedAsBeingCached, &m.UncachePagesRequestSeen) if err != nil { return &m, err } case "Acquire:": err := setFSCacheFields(fields[1:], &m.AcquireCookiesRequestSeen, &m.AcquireRequestsWithNullParent, &m.AcquireRequestsRejectedNoCacheAvailable, &m.AcquireRequestsSucceeded, &m.AcquireRequestsRejectedDueToError, &m.AcquireRequestsFailedDueToEnomem) if err != nil { return &m, err } case "Lookups:": err := setFSCacheFields(fields[1:], &m.LookupsNumber, &m.LookupsNegative, &m.LookupsPositive, &m.ObjectsCreatedByLookup, &m.LookupsTimedOutAndRequed) if err != nil { return &m, err } case "Invals": err := setFSCacheFields(fields[2:], &m.InvalidationsNumber, &m.InvalidationsRunning) if err != nil { return &m, err } case "Updates:": err := setFSCacheFields(fields[1:], &m.UpdateCookieRequestSeen, &m.UpdateRequestsWithNullParent, &m.UpdateRequestsRunning) if err != nil { return &m, err } case "Relinqs:": err := setFSCacheFields(fields[1:], &m.RelinquishCookiesRequestSeen, &m.RelinquishCookiesWithNullParent, &m.RelinquishRequestsWaitingCompleteCreation, &m.RelinquishRetries) if err != nil { return &m, err } case "AttrChg:": err := setFSCacheFields(fields[1:], &m.AttributeChangedRequestsSeen, &m.AttributeChangedRequestsQueued, &m.AttributeChangedRejectDueToEnobufs, &m.AttributeChangedFailedDueToEnomem, &m.AttributeChangedOps) if err != nil { return &m, err } case "Allocs": if strings.Split(fields[2], "=")[0] == "n" { err := setFSCacheFields(fields[2:], &m.AllocationRequestsSeen, &m.AllocationOkRequests, &m.AllocationWaitingOnLookup, &m.AllocationsRejectedDueToEnobufs, &m.AllocationsAbortedDueToErestartsys) if err != nil { return &m, err } } else { err := setFSCacheFields(fields[2:], &m.AllocationOperationsSubmitted, &m.AllocationsWaitedForCPU, &m.AllocationsAbortedDueToObjectDeath) if err != nil { return &m, err } } case "Retrvls:": if strings.Split(fields[1], "=")[0] == "n" { err := setFSCacheFields(fields[1:], &m.RetrievalsReadRequests, &m.RetrievalsOk, &m.RetrievalsWaitingLookupCompletion, &m.RetrievalsReturnedEnodata, &m.RetrievalsRejectedDueToEnobufs, &m.RetrievalsAbortedDueToErestartsys, &m.RetrievalsFailedDueToEnomem) if err != nil { return &m, err } } else { err := setFSCacheFields(fields[1:], &m.RetrievalsRequests, &m.RetrievalsWaitingCPU, &m.RetrievalsAbortedDueToObjectDeath) if err != nil { return &m, err } } case "Stores": if strings.Split(fields[2], "=")[0] == "n" { err := setFSCacheFields(fields[2:], &m.StoreWriteRequests, &m.StoreSuccessfulRequests, &m.StoreRequestsOnPendingStorage, &m.StoreRequestsRejectedDueToEnobufs, &m.StoreRequestsFailedDueToEnomem) if err != nil { return &m, err } } else { err := setFSCacheFields(fields[2:], &m.StoreRequestsSubmitted, &m.StoreRequestsRunning, &m.StorePagesWithRequestsProcessing, &m.StoreRequestsDeleted, &m.StoreRequestsOverStoreLimit) if err != nil { return &m, err } } case "VmScan": err := setFSCacheFields(fields[2:], &m.ReleaseRequestsAgainstPagesWithNoPendingStorage, &m.ReleaseRequestsAgainstPagesStoredByTimeLockGranted, &m.ReleaseRequestsIgnoredDueToInProgressStore, &m.PageStoresCancelledByReleaseRequests, &m.VmscanWaiting) if err != nil { return &m, err } case "Ops": if strings.Split(fields[2], "=")[0] == "pend" { err := setFSCacheFields(fields[2:], &m.OpsPending, &m.OpsRunning, &m.OpsEnqueued, &m.OpsCancelled, &m.OpsRejected) if err != nil { return &m, err } } else { err := setFSCacheFields(fields[2:], &m.OpsInitialised, &m.OpsDeferred, &m.OpsReleased, &m.OpsGarbageCollected) if err != nil { return &m, err } } case "CacheOp:": if strings.Split(fields[1], "=")[0] == "alo" { err := setFSCacheFields(fields[1:], &m.CacheopAllocationsinProgress, &m.CacheopLookupObjectInProgress, &m.CacheopLookupCompleteInPorgress, &m.CacheopGrabObjectInProgress) if err != nil { return &m, err } } else if strings.Split(fields[1], "=")[0] == "inv" { err := setFSCacheFields(fields[1:], &m.CacheopInvalidations, &m.CacheopUpdateObjectInProgress, &m.CacheopDropObjectInProgress, &m.CacheopPutObjectInProgress, &m.CacheopAttributeChangeInProgress, &m.CacheopSyncCacheInProgress) if err != nil { return &m, err } } else { err := setFSCacheFields(fields[1:], &m.CacheopReadOrAllocPageInProgress, &m.CacheopReadOrAllocPagesInProgress, &m.CacheopAllocatePageInProgress, &m.CacheopAllocatePagesInProgress, &m.CacheopWritePagesInProgress, &m.CacheopUncachePagesInProgress, &m.CacheopDissociatePagesInProgress) if err != nil { return &m, err } } case "CacheEv:": err := setFSCacheFields(fields[1:], &m.CacheevLookupsAndCreationsRejectedLackSpace, &m.CacheevStaleObjectsDeleted, &m.CacheevRetiredWhenReliquished, &m.CacheevObjectsCulled) if err != nil { return &m, err } } } return &m, nil }	15.45 KB	2025-05-25 12:27
📄 fscache_test.go // Copyright 2019 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "reflect" "testing" ) func TestFscacheinfo(t *testing.T) { expected := Fscacheinfo{ IndexCookiesAllocated: 3, DataStorageCookiesAllocated: 67877, SpecialCookiesAllocated: 0, ObjectsAllocated: 67473, ObjectAllocationsFailure: 0, ObjectsAvailable: 67473, ObjectsDead: 388, ObjectsWithoutCoherencyCheck: 12, ObjectsWithCoherencyCheck: 33, ObjectsNeedCoherencyCheckUpdate: 44, ObjectsDeclaredObsolete: 55, PagesMarkedAsBeingCached: 547164, UncachePagesRequestSeen: 364577, AcquireCookiesRequestSeen: 67880, AcquireRequestsWithNullParent: 98, AcquireRequestsRejectedNoCacheAvailable: 25, AcquireRequestsSucceeded: 67780, AcquireRequestsRejectedDueToError: 39, AcquireRequestsFailedDueToEnomem: 26, LookupsNumber: 67473, LookupsNegative: 67470, LookupsPositive: 58, ObjectsCreatedByLookup: 67473, LookupsTimedOutAndRequed: 85, InvalidationsNumber: 14, InvalidationsRunning: 13, UpdateCookieRequestSeen: 7, UpdateRequestsWithNullParent: 3, UpdateRequestsRunning: 8, RelinquishCookiesRequestSeen: 394, RelinquishCookiesWithNullParent: 1, RelinquishRequestsWaitingCompleteCreation: 2, RelinquishRetries: 3, AttributeChangedRequestsSeen: 6, AttributeChangedRequestsQueued: 5, AttributeChangedRejectDueToEnobufs: 4, AttributeChangedFailedDueToEnomem: 3, AttributeChangedOps: 2, AllocationRequestsSeen: 20, AllocationOkRequests: 19, AllocationWaitingOnLookup: 18, AllocationsRejectedDueToEnobufs: 17, AllocationsAbortedDueToErestartsys: 16, AllocationOperationsSubmitted: 15, AllocationsWaitedForCPU: 14, AllocationsAbortedDueToObjectDeath: 13, RetrievalsReadRequests: 151959, RetrievalsOk: 82823, RetrievalsWaitingLookupCompletion: 23467, RetrievalsReturnedEnodata: 69136, RetrievalsRejectedDueToEnobufs: 15, RetrievalsAbortedDueToErestartsys: 69, RetrievalsFailedDueToEnomem: 43, RetrievalsRequests: 151959, RetrievalsWaitingCPU: 42747, RetrievalsAbortedDueToObjectDeath: 44, StoreWriteRequests: 225565, StoreSuccessfulRequests: 225565, StoreRequestsOnPendingStorage: 12, StoreRequestsRejectedDueToEnobufs: 13, StoreRequestsFailedDueToEnomem: 14, StoreRequestsSubmitted: 69156, StoreRequestsRunning: 294721, StorePagesWithRequestsProcessing: 225565, StoreRequestsDeleted: 225565, StoreRequestsOverStoreLimit: 43, ReleaseRequestsAgainstPagesWithNoPendingStorage: 364512, ReleaseRequestsAgainstPagesStoredByTimeLockGranted: 2, ReleaseRequestsIgnoredDueToInProgressStore: 43, PageStoresCancelledByReleaseRequests: 12, VmscanWaiting: 66, OpsPending: 42753, OpsRunning: 221129, OpsEnqueued: 628798, OpsCancelled: 11, OpsRejected: 88, OpsInitialised: 377538, OpsDeferred: 27, OpsReleased: 377538, OpsGarbageCollected: 37, CacheopAllocationsinProgress: 1, CacheopLookupObjectInProgress: 2, CacheopLookupCompleteInPorgress: 3, CacheopGrabObjectInProgress: 4, CacheopInvalidations: 5, CacheopUpdateObjectInProgress: 6, CacheopDropObjectInProgress: 7, CacheopPutObjectInProgress: 8, CacheopAttributeChangeInProgress: 9, CacheopSyncCacheInProgress: 10, CacheopReadOrAllocPageInProgress: 11, CacheopReadOrAllocPagesInProgress: 12, CacheopAllocatePageInProgress: 13, CacheopAllocatePagesInProgress: 14, CacheopWritePagesInProgress: 15, CacheopUncachePagesInProgress: 16, CacheopDissociatePagesInProgress: 17, CacheevLookupsAndCreationsRejectedLackSpace: 18, CacheevStaleObjectsDeleted: 19, CacheevRetiredWhenReliquished: 20, CacheevObjectsCulled: 21, } have, err := getProcFixtures(t).Fscacheinfo() if err != nil { t.Fatal(err) } if !reflect.DeepEqual(have, expected) { t.Logf("have: %+v", have) t.Logf("expected: %+v", expected) t.Errorf("structs are not equal") } }	6.71 KB	2025-05-25 12:27
📄 go.mod module github.com/prometheus/procfs go 1.20 require ( github.com/google/go-cmp v0.6.0 golang.org/x/sync v0.7.0 golang.org/x/sys v0.20.0 )	143 B	2025-05-25 12:27
📄 go.sum github.com/google/go-cmp v0.6.0 h1:ofyhxvXcZhMsU5ulbFiLKl/XBFqE1GSq7atu8tAmTRI= github.com/google/go-cmp v0.6.0/go.mod h1:17dUlkBOakJ0+DkrSSNjCkIjxS6bF9zb3elmeNGIjoY= golang.org/x/sync v0.7.0 h1:YsImfSBoP9QPYL0xyKJPq0gcaJdG3rInoqxTWbfQu9M= golang.org/x/sync v0.7.0/go.mod h1:Czt+wKu1gCyEFDUtn0jG5QVvpJ6rzVqr5aXyt9drQfk= golang.org/x/sys v0.20.0 h1:Od9JTbYCk261bKm4M/mw7AklTlFYIa0bIp9BgSm1S8Y= golang.org/x/sys v0.20.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA=	473 B	2025-05-25 12:27
📁 internal	-	2025-05-25 12:27
📄 ipvs.go // Copyright 2018 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "bufio" "bytes" "encoding/hex" "errors" "fmt" "io" "net" "os" "strconv" "strings" "github.com/prometheus/procfs/internal/util" ) // IPVSStats holds IPVS statistics, as exposed by the kernel in `/proc/net/ip_vs_stats`. type IPVSStats struct { // Total count of connections. Connections uint64 // Total incoming packages processed. IncomingPackets uint64 // Total outgoing packages processed. OutgoingPackets uint64 // Total incoming traffic. IncomingBytes uint64 // Total outgoing traffic. OutgoingBytes uint64 } // IPVSBackendStatus holds current metrics of one virtual / real address pair. type IPVSBackendStatus struct { // The local (virtual) IP address. LocalAddress net.IP // The remote (real) IP address. RemoteAddress net.IP // The local (virtual) port. LocalPort uint16 // The remote (real) port. RemotePort uint16 // The local firewall mark LocalMark string // The transport protocol (TCP, UDP). Proto string // The current number of active connections for this virtual/real address pair. ActiveConn uint64 // The current number of inactive connections for this virtual/real address pair. InactConn uint64 // The current weight of this virtual/real address pair. Weight uint64 } // IPVSStats reads the IPVS statistics from the specified `proc` filesystem. func (fs FS) IPVSStats() (IPVSStats, error) { data, err := util.ReadFileNoStat(fs.proc.Path("net/ip_vs_stats")) if err != nil { return IPVSStats{}, err } return parseIPVSStats(bytes.NewReader(data)) } // parseIPVSStats performs the actual parsing of `ip_vs_stats`. func parseIPVSStats(r io.Reader) (IPVSStats, error) { var ( statContent []byte statLines []string statFields []string stats IPVSStats ) statContent, err := io.ReadAll(r) if err != nil { return IPVSStats{}, err } statLines = strings.SplitN(string(statContent), "\n", 4) if len(statLines) != 4 { return IPVSStats{}, errors.New("ip_vs_stats corrupt: too short") } statFields = strings.Fields(statLines[2]) if len(statFields) != 5 { return IPVSStats{}, errors.New("ip_vs_stats corrupt: unexpected number of fields") } stats.Connections, err = strconv.ParseUint(statFields[0], 16, 64) if err != nil { return IPVSStats{}, err } stats.IncomingPackets, err = strconv.ParseUint(statFields[1], 16, 64) if err != nil { return IPVSStats{}, err } stats.OutgoingPackets, err = strconv.ParseUint(statFields[2], 16, 64) if err != nil { return IPVSStats{}, err } stats.IncomingBytes, err = strconv.ParseUint(statFields[3], 16, 64) if err != nil { return IPVSStats{}, err } stats.OutgoingBytes, err = strconv.ParseUint(statFields[4], 16, 64) if err != nil { return IPVSStats{}, err } return stats, nil } // IPVSBackendStatus reads and returns the status of all (virtual,real) server pairs from the specified `proc` filesystem. func (fs FS) IPVSBackendStatus() ([]IPVSBackendStatus, error) { file, err := os.Open(fs.proc.Path("net/ip_vs")) if err != nil { return nil, err } defer file.Close() return parseIPVSBackendStatus(file) } func parseIPVSBackendStatus(file io.Reader) ([]IPVSBackendStatus, error) { var ( status []IPVSBackendStatus scanner = bufio.NewScanner(file) proto string localMark string localAddress net.IP localPort uint16 err error ) for scanner.Scan() { fields := strings.Fields(scanner.Text()) if len(fields) == 0 { continue } switch { case fields[0] == "IP" \|\| fields[0] == "Prot" \|\| fields[1] == "RemoteAddress:Port": continue case fields[0] == "TCP" \|\| fields[0] == "UDP": if len(fields) < 2 { continue } proto = fields[0] localMark = "" localAddress, localPort, err = parseIPPort(fields[1]) if err != nil { return nil, err } case fields[0] == "FWM": if len(fields) < 2 { continue } proto = fields[0] localMark = fields[1] localAddress = nil localPort = 0 case fields[0] == "->": if len(fields) < 6 { continue } remoteAddress, remotePort, err := parseIPPort(fields[1]) if err != nil { return nil, err } weight, err := strconv.ParseUint(fields[3], 10, 64) if err != nil { return nil, err } activeConn, err := strconv.ParseUint(fields[4], 10, 64) if err != nil { return nil, err } inactConn, err := strconv.ParseUint(fields[5], 10, 64) if err != nil { return nil, err } status = append(status, IPVSBackendStatus{ LocalAddress: localAddress, LocalPort: localPort, LocalMark: localMark, RemoteAddress: remoteAddress, RemotePort: remotePort, Proto: proto, Weight: weight, ActiveConn: activeConn, InactConn: inactConn, }) } } return status, nil } func parseIPPort(s string) (net.IP, uint16, error) { var ( ip net.IP err error ) switch len(s) { case 13: ip, err = hex.DecodeString(s[0:8]) if err != nil { return nil, 0, err } case 46: ip = net.ParseIP(s[1:40]) if ip == nil { return nil, 0, fmt.Errorf("%w: Invalid IPv6 addr %s: %w", ErrFileParse, s[1:40], err) } default: return nil, 0, fmt.Errorf("%w: Unexpected IP:Port %s: %w", ErrFileParse, s, err) } portString := s[len(s)-4:] if len(portString) != 4 { return nil, 0, fmt.Errorf("%w: Unexpected port string format %s: %w", ErrFileParse, portString, err) } port, err := strconv.ParseUint(portString, 16, 16) if err != nil { return nil, 0, err } return ip, uint16(port), nil }	5.97 KB	2025-05-25 12:27
📄 ipvs_test.go // Copyright 2018 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "net" "testing" ) var ( expectedIPVSStats = IPVSStats{ Connections: 23765872, IncomingPackets: 3811989221, OutgoingPackets: 0, IncomingBytes: 89991519156915, OutgoingBytes: 0, } expectedIPVSBackendStatuses = []IPVSBackendStatus{ { LocalAddress: net.ParseIP("192.168.0.22"), LocalPort: 3306, RemoteAddress: net.ParseIP("192.168.82.22"), RemotePort: 3306, Proto: "TCP", Weight: 100, ActiveConn: 248, InactConn: 2, }, { LocalAddress: net.ParseIP("192.168.0.22"), LocalPort: 3306, RemoteAddress: net.ParseIP("192.168.83.24"), RemotePort: 3306, Proto: "TCP", Weight: 100, ActiveConn: 248, InactConn: 2, }, { LocalAddress: net.ParseIP("192.168.0.22"), LocalPort: 3306, RemoteAddress: net.ParseIP("192.168.83.21"), RemotePort: 3306, Proto: "TCP", Weight: 100, ActiveConn: 248, InactConn: 1, }, { LocalAddress: net.ParseIP("192.168.0.57"), LocalPort: 3306, RemoteAddress: net.ParseIP("192.168.84.22"), RemotePort: 3306, Proto: "TCP", Weight: 0, ActiveConn: 0, InactConn: 0, }, { LocalAddress: net.ParseIP("192.168.0.57"), LocalPort: 3306, RemoteAddress: net.ParseIP("192.168.82.21"), RemotePort: 3306, Proto: "TCP", Weight: 100, ActiveConn: 1499, InactConn: 0, }, { LocalAddress: net.ParseIP("192.168.0.57"), LocalPort: 3306, RemoteAddress: net.ParseIP("192.168.50.21"), RemotePort: 3306, Proto: "TCP", Weight: 100, ActiveConn: 1498, InactConn: 0, }, { LocalAddress: net.ParseIP("192.168.0.55"), LocalPort: 3306, RemoteAddress: net.ParseIP("192.168.50.26"), RemotePort: 3306, Proto: "TCP", Weight: 0, ActiveConn: 0, InactConn: 0, }, { LocalAddress: net.ParseIP("192.168.0.55"), LocalPort: 3306, RemoteAddress: net.ParseIP("192.168.49.32"), RemotePort: 3306, Proto: "TCP", Weight: 100, ActiveConn: 0, InactConn: 0, }, { LocalAddress: net.ParseIP("2620::1"), LocalPort: 80, RemoteAddress: net.ParseIP("2620::2"), RemotePort: 80, Proto: "TCP", Weight: 1, ActiveConn: 0, InactConn: 0, }, { LocalAddress: net.ParseIP("2620::1"), LocalPort: 80, RemoteAddress: net.ParseIP("2620::3"), RemotePort: 80, Proto: "TCP", Weight: 1, ActiveConn: 0, InactConn: 0, }, { LocalAddress: net.ParseIP("2620::1"), LocalPort: 80, RemoteAddress: net.ParseIP("2620::4"), RemotePort: 80, Proto: "TCP", Weight: 1, ActiveConn: 1, InactConn: 1, }, { LocalMark: "10001000", RemoteAddress: net.ParseIP("192.168.50.26"), RemotePort: 3306, Proto: "FWM", Weight: 0, ActiveConn: 0, InactConn: 1, }, { LocalMark: "10001000", RemoteAddress: net.ParseIP("192.168.50.21"), RemotePort: 3306, Proto: "FWM", Weight: 0, ActiveConn: 0, InactConn: 2, }, } ) func TestIPVSStats(t testing.T) { fs, err := NewFS(procTestFixtures) if err != nil { t.Fatal(err) } stats, err := fs.IPVSStats() if err != nil { t.Fatal(err) } if stats != expectedIPVSStats { t.Errorf("want %+v, have %+v", expectedIPVSStats, stats) } } func TestParseIPPort(t testing.T) { ip := net.ParseIP("192.168.0.22") port := uint16(3306) gotIP, gotPort, err := parseIPPort("C0A80016:0CEA") if err != nil { t.Fatal(err) } if !(gotIP.Equal(ip) && port == gotPort) { t.Errorf("want %s:%d, have %s:%d", ip, port, gotIP, gotPort) } } func TestParseIPPortInvalid(t testing.T) { testcases := []string{ "", "C0A80016", "C0A800:1234", "FOOBARBA:1234", "C0A80016:0CEA:1234", } for _, s := range testcases { ip, port, err := parseIPPort(s) if ip != nil \|\| port != uint16(0) \|\| err == nil { t.Errorf("Expected error for input %s, have ip = %s, port = %v, err = %v", s, ip, port, err) } } } func TestParseIPPortIPv6(t testing.T) { ip := net.ParseIP("dead:beef::1") port := uint16(8080) gotIP, gotPort, err := parseIPPort("[DEAD:BEEF:0000:0000:0000:0000:0000:0001]:1F90") if err != nil { t.Fatal(err) } if !(gotIP.Equal(ip) && port == gotPort) { t.Errorf("want %s:%d, have %s:%d", ip, port, gotIP, gotPort) } } func TestIPVSBackendStatus(t *testing.T) { backendStats, err := getProcFixtures(t).IPVSBackendStatus() if err != nil { t.Fatal(err) } if want, have := len(expectedIPVSBackendStatuses), len(backendStats); want != have { t.Fatalf("want %d backend statuses, have %d", want, have) } for idx, expect := range expectedIPVSBackendStatuses { if !backendStats[idx].LocalAddress.Equal(expect.LocalAddress) { t.Errorf("want LocalAddress %s, have %s", expect.LocalAddress, backendStats[idx].LocalAddress) } if backendStats[idx].LocalPort != expect.LocalPort { t.Errorf("want LocalPort %d, have %d", expect.LocalPort, backendStats[idx].LocalPort) } if !backendStats[idx].RemoteAddress.Equal(expect.RemoteAddress) { t.Errorf("want RemoteAddress %s, have %s", expect.RemoteAddress, backendStats[idx].RemoteAddress) } if backendStats[idx].RemotePort != expect.RemotePort { t.Errorf("want RemotePort %d, have %d", expect.RemotePort, backendStats[idx].RemotePort) } if backendStats[idx].Proto != expect.Proto { t.Errorf("want Proto %s, have %s", expect.Proto, backendStats[idx].Proto) } if backendStats[idx].Weight != expect.Weight { t.Errorf("want Weight %d, have %d", expect.Weight, backendStats[idx].Weight) } if backendStats[idx].ActiveConn != expect.ActiveConn { t.Errorf("want ActiveConn %d, have %d", expect.ActiveConn, backendStats[idx].ActiveConn) } if backendStats[idx].InactConn != expect.InactConn { t.Errorf("want InactConn %d, have %d", expect.InactConn, backendStats[idx].InactConn) } } }	6.56 KB	2025-05-25 12:27
📁 iscsi	-	2025-05-25 12:27
📄 kernel_random.go // Copyright 2020 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. //go:build !windows // +build !windows package procfs import ( "os" "github.com/prometheus/procfs/internal/util" ) // KernelRandom contains information about to the kernel's random number generator. type KernelRandom struct { // EntropyAvaliable gives the available entropy, in bits. EntropyAvaliable uint64 // PoolSize gives the size of the entropy pool, in bits. PoolSize uint64 // URandomMinReseedSeconds is the number of seconds after which the DRNG will be reseeded. URandomMinReseedSeconds uint64 // WriteWakeupThreshold the number of bits of entropy below which we wake up processes // that do a select(2) or poll(2) for write access to /dev/random. WriteWakeupThreshold uint64 // ReadWakeupThreshold is the number of bits of entropy required for waking up processes that sleep // waiting for entropy from /dev/random. ReadWakeupThreshold uint64 } // KernelRandom returns values from /proc/sys/kernel/random. func (fs FS) KernelRandom() (KernelRandom, error) { random := KernelRandom{} for file, p := range map[string]uint64{ "entropy_avail": &random.EntropyAvaliable, "poolsize": &random.PoolSize, "urandom_min_reseed_secs": &random.URandomMinReseedSeconds, "write_wakeup_threshold": &random.WriteWakeupThreshold, "read_wakeup_threshold": &random.ReadWakeupThreshold, } { val, err := util.ReadUintFromFile(fs.proc.Path("sys", "kernel", "random", file)) if os.IsNotExist(err) { continue } if err != nil { return random, err } p = &val } return random, nil }	2.1 KB	2025-05-25 12:27
📄 kernel_random_test.go // Copyright 2020 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. //go:build !windows // +build !windows package procfs import ( "testing" ) const procfsFixtures = "testdata/fixtures/proc" func TestKernelRandom(t testing.T) { fs, err := NewFS(procfsFixtures) if err != nil { t.Fatalf("failed to access %s: %v", procfsFixtures, err) } random, err := fs.KernelRandom() if err != nil { t.Fatalf("failed to collect %s/sys/kernel/random: %v", procfsFixtures, err) } if random.EntropyAvaliable != 3943 { t.Errorf("entropy_avail, want %d got %d", 3943, random.EntropyAvaliable) } if random.PoolSize != 4096 { t.Errorf("poolsize, want %d got %d", 4096, random.PoolSize) } if random.URandomMinReseedSeconds != 60 { t.Errorf("urandom_min_reseed_secs, want %d got %d", 60, random.URandomMinReseedSeconds) } if random.WriteWakeupThreshold != 3072 { t.Errorf("write_wakeup_threshold, want %d got %d", 3072, random.WriteWakeupThreshold) } if random.ReadWakeupThreshold != nil { t.Errorf("read_wakeup_threshold, want %v got %d", nil, random.ReadWakeupThreshold) } }	1.59 KB	2025-05-25 12:27
📄 loadavg.go // Copyright 2019 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "fmt" "strconv" "strings" "github.com/prometheus/procfs/internal/util" ) // LoadAvg represents an entry in /proc/loadavg. type LoadAvg struct { Load1 float64 Load5 float64 Load15 float64 } // LoadAvg returns loadavg from /proc. func (fs FS) LoadAvg() (LoadAvg, error) { path := fs.proc.Path("loadavg") data, err := util.ReadFileNoStat(path) if err != nil { return nil, err } return parseLoad(data) } // Parse /proc loadavg and return 1m, 5m and 15m. func parseLoad(loadavgBytes []byte) (LoadAvg, error) { loads := make([]float64, 3) parts := strings.Fields(string(loadavgBytes)) if len(parts) < 3 { return nil, fmt.Errorf("%w: Malformed line %q", ErrFileParse, string(loadavgBytes)) } var err error for i, load := range parts[0:3] { loads[i], err = strconv.ParseFloat(load, 64) if err != nil { return nil, fmt.Errorf("%w: Cannot parse load: %f: %w", ErrFileParse, loads[i], err) } } return &LoadAvg{ Load1: loads[0], Load5: loads[1], Load15: loads[2], }, nil }	1.59 KB	2025-05-25 12:27
📄 loadavg_test.go // Copyright 2019 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "testing" "github.com/google/go-cmp/cmp" ) func TestLoadAvg(t testing.T) { fs, err := NewFS(procTestFixtures) if err != nil { t.Fatalf("failed to open procfs: %v", err) } loadavg, err := fs.LoadAvg() if err != nil { t.Fatalf("failed to get loadavg: %v", err) } if diff := cmp.Diff(0.02, loadavg.Load1); diff != "" { t.Fatalf("unexpected LoadAvg Per a minute:\n%s", diff) } if diff := cmp.Diff(0.04, loadavg.Load5); diff != "" { t.Fatalf("unexpected LoadAvg Per five minutes:\n%s", diff) } if diff := cmp.Diff(0.05, loadavg.Load15); diff != "" { t.Fatalf("unexpected LoadAvg Per fifteen minutes:\n%s", diff) } } func Test_parseLoad(t testing.T) { tests := []struct { name string s string ok bool loadavg LoadAvg }{ { name: "empty", ok: false, }, { name: "not enough fields", s: `0.00 0.03`, ok: false, }, { name: "invalid line", s: `malformed line`, ok: false, }, { name: "valid line", s: `0.00 0.03 0.05 1/502 33634`, ok: true, loadavg: &LoadAvg{Load1: 0, Load5: 0.03, Load15: 0.05}, }, } for _, tt := range tests { t.Run(tt.name, func(t testing.T) { loadavg, err := parseLoad([]byte(tt.s)) if err != nil { if tt.ok { t.Fatalf("failed to parse loadavg: %v", err) } t.Logf("OK error: %v", err) return } if !tt.ok { t.Fatal("expected an error, but none occurred") } if diff := cmp.Diff(tt.loadavg, loadavg); diff != "" { t.Errorf("unexpected loadavg(-want +got):\n%s", diff) } }) } }	2.14 KB	2025-05-25 12:27
📄 mdstat.go // Copyright 2018 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "fmt" "os" "regexp" "strconv" "strings" ) var ( statusLineRE = regexp.MustCompile(`(\d+) blocks .\[(\d+)/(\d+)\] \[([U_]+)\]`) recoveryLineBlocksRE = regexp.MustCompile(`$(\d+/\d+)$`) recoveryLinePctRE = regexp.MustCompile(`= (.+)%`) recoveryLineFinishRE = regexp.MustCompile(`finish=(.+)min`) recoveryLineSpeedRE = regexp.MustCompile(`speed=(.+)[A-Z]`) componentDeviceRE = regexp.MustCompile(`(.)\[\d+\]`) ) // MDStat holds info parsed from /proc/mdstat. type MDStat struct { // Name of the device. Name string // activity-state of the device. ActivityState string // Number of active disks. DisksActive int64 // Total number of disks the device requires. DisksTotal int64 // Number of failed disks. DisksFailed int64 // Number of "down" disks. (the _ indicator in the status line) DisksDown int64 // Spare disks in the device. DisksSpare int64 // Number of blocks the device holds. BlocksTotal int64 // Number of blocks on the device that are in sync. BlocksSynced int64 // Number of blocks on the device that need to be synced. BlocksToBeSynced int64 // progress percentage of current sync BlocksSyncedPct float64 // estimated finishing time for current sync (in minutes) BlocksSyncedFinishTime float64 // current sync speed (in Kilobytes/sec) BlocksSyncedSpeed float64 // Name of md component devices Devices []string } // MDStat parses an mdstat-file (/proc/mdstat) and returns a slice of // structs containing the relevant info. More information available here: // https://raid.wiki.kernel.org/index.php/Mdstat func (fs FS) MDStat() ([]MDStat, error) { data, err := os.ReadFile(fs.proc.Path("mdstat")) if err != nil { return nil, err } mdstat, err := parseMDStat(data) if err != nil { return nil, fmt.Errorf("%w: Cannot parse %v: %w", ErrFileParse, fs.proc.Path("mdstat"), err) } return mdstat, nil } // parseMDStat parses data from mdstat file (/proc/mdstat) and returns a slice of // structs containing the relevant info. func parseMDStat(mdStatData []byte) ([]MDStat, error) { mdStats := []MDStat{} lines := strings.Split(string(mdStatData), "\n") for i, line := range lines { if strings.TrimSpace(line) == "" \|\| line[0] == ' ' \|\| strings.HasPrefix(line, "Personalities") \|\| strings.HasPrefix(line, "unused") { continue } deviceFields := strings.Fields(line) if len(deviceFields) < 3 { return nil, fmt.Errorf("%w: Expected 3+ lines, got %q", ErrFileParse, line) } mdName := deviceFields[0] // mdx state := deviceFields[2] // active or inactive if len(lines) <= i+3 { return nil, fmt.Errorf("%w: Too few lines for md device: %q", ErrFileParse, mdName) } // Failed disks have the suffix (F) & Spare disks have the suffix (S). fail := int64(strings.Count(line, "(F)")) spare := int64(strings.Count(line, "(S)")) active, total, down, size, err := evalStatusLine(lines[i], lines[i+1]) if err != nil { return nil, fmt.Errorf("%w: Cannot parse md device lines: %v: %w", ErrFileParse, active, err) } syncLineIdx := i + 2 if strings.Contains(lines[i+2], "bitmap") { // skip bitmap line syncLineIdx++ } // If device is syncing at the moment, get the number of currently // synced bytes, otherwise that number equals the size of the device. blocksSynced := size blocksToBeSynced := size speed := float64(0) finish := float64(0) pct := float64(0) recovering := strings.Contains(lines[syncLineIdx], "recovery") resyncing := strings.Contains(lines[syncLineIdx], "resync") checking := strings.Contains(lines[syncLineIdx], "check") // Append recovery and resyncing state info. if recovering \|\| resyncing \|\| checking { if recovering { state = "recovering" } else if checking { state = "checking" } else { state = "resyncing" } // Handle case when resync=PENDING or resync=DELAYED. if strings.Contains(lines[syncLineIdx], "PENDING") \|\| strings.Contains(lines[syncLineIdx], "DELAYED") { blocksSynced = 0 } else { blocksSynced, blocksToBeSynced, pct, finish, speed, err = evalRecoveryLine(lines[syncLineIdx]) if err != nil { return nil, fmt.Errorf("%w: Cannot parse sync line in md device: %q: %w", ErrFileParse, mdName, err) } } } mdStats = append(mdStats, MDStat{ Name: mdName, ActivityState: state, DisksActive: active, DisksFailed: fail, DisksDown: down, DisksSpare: spare, DisksTotal: total, BlocksTotal: size, BlocksSynced: blocksSynced, BlocksToBeSynced: blocksToBeSynced, BlocksSyncedPct: pct, BlocksSyncedFinishTime: finish, BlocksSyncedSpeed: speed, Devices: evalComponentDevices(deviceFields), }) } return mdStats, nil } func evalStatusLine(deviceLine, statusLine string) (active, total, down, size int64, err error) { statusFields := strings.Fields(statusLine) if len(statusFields) < 1 { return 0, 0, 0, 0, fmt.Errorf("%w: Unexpected statusline %q: %w", ErrFileParse, statusLine, err) } sizeStr := statusFields[0] size, err = strconv.ParseInt(sizeStr, 10, 64) if err != nil { return 0, 0, 0, 0, fmt.Errorf("%w: Unexpected statusline %q: %w", ErrFileParse, statusLine, err) } if strings.Contains(deviceLine, "raid0") \|\| strings.Contains(deviceLine, "linear") { // In the device deviceLine, only disks have a number associated with them in []. total = int64(strings.Count(deviceLine, "[")) return total, total, 0, size, nil } if strings.Contains(deviceLine, "inactive") { return 0, 0, 0, size, nil } matches := statusLineRE.FindStringSubmatch(statusLine) if len(matches) != 5 { return 0, 0, 0, 0, fmt.Errorf("%w: Could not fild all substring matches %s: %w", ErrFileParse, statusLine, err) } total, err = strconv.ParseInt(matches[2], 10, 64) if err != nil { return 0, 0, 0, 0, fmt.Errorf("%w: Unexpected statusline %q: %w", ErrFileParse, statusLine, err) } active, err = strconv.ParseInt(matches[3], 10, 64) if err != nil { return 0, 0, 0, 0, fmt.Errorf("%w: Unexpected active %d: %w", ErrFileParse, active, err) } down = int64(strings.Count(matches[4], "_")) return active, total, down, size, nil } func evalRecoveryLine(recoveryLine string) (blocksSynced int64, blocksToBeSynced int64, pct float64, finish float64, speed float64, err error) { matches := recoveryLineBlocksRE.FindStringSubmatch(recoveryLine) if len(matches) != 2 { return 0, 0, 0, 0, 0, fmt.Errorf("%w: Unexpected recoveryLine blocks %s: %w", ErrFileParse, recoveryLine, err) } blocks := strings.Split(matches[1], "/") blocksSynced, err = strconv.ParseInt(blocks[0], 10, 64) if err != nil { return 0, 0, 0, 0, 0, fmt.Errorf("%w: Unable to parse recovery blocks synced %q: %w", ErrFileParse, matches[1], err) } blocksToBeSynced, err = strconv.ParseInt(blocks[1], 10, 64) if err != nil { return blocksSynced, 0, 0, 0, 0, fmt.Errorf("%w: Unable to parse recovery to be synced blocks %q: %w", ErrFileParse, matches[2], err) } // Get percentage complete matches = recoveryLinePctRE.FindStringSubmatch(recoveryLine) if len(matches) != 2 { return blocksSynced, blocksToBeSynced, 0, 0, 0, fmt.Errorf("%w: Unexpected recoveryLine matching percentage %s", ErrFileParse, recoveryLine) } pct, err = strconv.ParseFloat(strings.TrimSpace(matches[1]), 64) if err != nil { return blocksSynced, blocksToBeSynced, 0, 0, 0, fmt.Errorf("%w: Error parsing float from recoveryLine %q", ErrFileParse, recoveryLine) } // Get time expected left to complete matches = recoveryLineFinishRE.FindStringSubmatch(recoveryLine) if len(matches) != 2 { return blocksSynced, blocksToBeSynced, pct, 0, 0, fmt.Errorf("%w: Unexpected recoveryLine matching est. finish time: %s", ErrFileParse, recoveryLine) } finish, err = strconv.ParseFloat(matches[1], 64) if err != nil { return blocksSynced, blocksToBeSynced, pct, 0, 0, fmt.Errorf("%w: Unable to parse float from recoveryLine: %q", ErrFileParse, recoveryLine) } // Get recovery speed matches = recoveryLineSpeedRE.FindStringSubmatch(recoveryLine) if len(matches) != 2 { return blocksSynced, blocksToBeSynced, pct, finish, 0, fmt.Errorf("%w: Unexpected recoveryLine value: %s", ErrFileParse, recoveryLine) } speed, err = strconv.ParseFloat(matches[1], 64) if err != nil { return blocksSynced, blocksToBeSynced, pct, finish, 0, fmt.Errorf("%w: Error parsing float from recoveryLine: %q: %w", ErrFileParse, recoveryLine, err) } return blocksSynced, blocksToBeSynced, pct, finish, speed, nil } func evalComponentDevices(deviceFields []string) []string { mdComponentDevices := make([]string, 0) if len(deviceFields) > 3 { for _, field := range deviceFields[4:] { match := componentDeviceRE.FindStringSubmatch(field) if match == nil { continue } mdComponentDevices = append(mdComponentDevices, match[1]) } } return mdComponentDevices }	9.36 KB	2025-05-25 12:27
📄 mdstat_test.go // Copyright 2018 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import "testing" import "github.com/google/go-cmp/cmp" func TestFS_MDStat(t testing.T) { fs := getProcFixtures(t) mdStats, err := fs.MDStat() if err != nil { t.Fatalf("parsing of reference-file failed entirely: %s", err) } refs := map[string]MDStat{ "md127": { Name: "md127", ActivityState: "active", DisksActive: 2, DisksTotal: 2, DisksFailed: 0, DisksDown: 0, DisksSpare: 0, BlocksTotal: 312319552, BlocksSynced: 312319552, BlocksToBeSynced: 312319552, BlocksSyncedPct: 0, BlocksSyncedFinishTime: 0, BlocksSyncedSpeed: 0, Devices: []string{"sdi2", "sdj2"}}, "md0": { Name: "md0", ActivityState: "active", DisksActive: 2, DisksTotal: 2, DisksFailed: 0, DisksDown: 0, DisksSpare: 0, BlocksTotal: 248896, BlocksSynced: 248896, BlocksToBeSynced: 248896, BlocksSyncedPct: 0, BlocksSyncedFinishTime: 0, BlocksSyncedSpeed: 0, Devices: []string{"sdi1", "sdj1"}}, "md4": { Name: "md4", ActivityState: "inactive", DisksActive: 0, DisksTotal: 0, DisksFailed: 1, DisksDown: 0, DisksSpare: 1, BlocksTotal: 4883648, BlocksSynced: 4883648, BlocksToBeSynced: 4883648, BlocksSyncedPct: 0, BlocksSyncedFinishTime: 0, BlocksSyncedSpeed: 0, Devices: []string{"sda3", "sdb3"}}, "md6": { Name: "md6", ActivityState: "recovering", DisksActive: 1, DisksTotal: 2, DisksFailed: 1, DisksDown: 1, DisksSpare: 1, BlocksTotal: 195310144, BlocksSynced: 16775552, BlocksToBeSynced: 195310144, BlocksSyncedPct: 8.5, BlocksSyncedFinishTime: 17, BlocksSyncedSpeed: 259783, Devices: []string{"sdb2", "sdc", "sda2"}}, "md3": { Name: "md3", ActivityState: "active", DisksActive: 8, DisksTotal: 8, DisksFailed: 0, DisksDown: 0, DisksSpare: 2, BlocksTotal: 5853468288, BlocksSynced: 5853468288, BlocksToBeSynced: 5853468288, BlocksSyncedPct: 0, BlocksSyncedFinishTime: 0, BlocksSyncedSpeed: 0, Devices: []string{"sda1", "sdh1", "sdg1", "sdf1", "sde1", "sdd1", "sdc1", "sdb1", "sdd1", "sdd2"}}, "md8": { Name: "md8", ActivityState: "resyncing", DisksActive: 2, DisksTotal: 2, DisksFailed: 0, DisksDown: 0, DisksSpare: 2, BlocksTotal: 195310144, BlocksSynced: 16775552, BlocksToBeSynced: 195310144, BlocksSyncedPct: 8.5, BlocksSyncedFinishTime: 17, BlocksSyncedSpeed: 259783, Devices: []string{"sdb1", "sda1", "sdc", "sde"}}, "md7": { Name: "md7", ActivityState: "active", DisksActive: 3, DisksTotal: 4, DisksFailed: 1, DisksDown: 1, DisksSpare: 0, BlocksTotal: 7813735424, BlocksSynced: 7813735424, BlocksToBeSynced: 7813735424, BlocksSyncedPct: 0, BlocksSyncedFinishTime: 0, BlocksSyncedSpeed: 0, Devices: []string{"sdb1", "sde1", "sdd1", "sdc1"}}, "md9": { Name: "md9", ActivityState: "resyncing", DisksActive: 4, DisksTotal: 4, DisksSpare: 1, DisksDown: 0, DisksFailed: 2, BlocksTotal: 523968, BlocksSynced: 0, BlocksToBeSynced: 523968, BlocksSyncedPct: 0, BlocksSyncedFinishTime: 0, BlocksSyncedSpeed: 0, Devices: []string{"sdc2", "sdd2", "sdb2", "sda2", "sde", "sdf", "sdg"}}, "md10": { Name: "md10", ActivityState: "active", DisksActive: 2, DisksTotal: 2, DisksFailed: 0, DisksDown: 0, DisksSpare: 0, BlocksTotal: 314159265, BlocksSynced: 314159265, BlocksToBeSynced: 314159265, BlocksSyncedPct: 0, BlocksSyncedFinishTime: 0, BlocksSyncedSpeed: 0, Devices: []string{"sda1", "sdb1"}}, "md11": { Name: "md11", ActivityState: "resyncing", DisksActive: 2, DisksTotal: 2, DisksFailed: 1, DisksDown: 0, DisksSpare: 2, BlocksTotal: 4190208, BlocksSynced: 0, BlocksToBeSynced: 4190208, BlocksSyncedPct: 0, BlocksSyncedFinishTime: 0, BlocksSyncedSpeed: 0, Devices: []string{"sdb2", "sdc2", "sdc3", "hda", "ssdc2"}}, "md12": { Name: "md12", ActivityState: "active", DisksActive: 2, DisksTotal: 2, DisksSpare: 0, DisksDown: 0, DisksFailed: 0, BlocksTotal: 3886394368, BlocksSynced: 3886394368, BlocksToBeSynced: 3886394368, BlocksSyncedPct: 0, BlocksSyncedFinishTime: 0, BlocksSyncedSpeed: 0, Devices: []string{"sdc2", "sdd2"}}, "md120": { Name: "md120", ActivityState: "active", DisksActive: 2, DisksTotal: 2, DisksFailed: 0, DisksDown: 0, DisksSpare: 0, BlocksTotal: 2095104, BlocksSynced: 2095104, BlocksToBeSynced: 2095104, BlocksSyncedPct: 0, BlocksSyncedFinishTime: 0, BlocksSyncedSpeed: 0, Devices: []string{"sda1", "sdb1"}}, "md126": { Name: "md126", ActivityState: "active", DisksActive: 2, DisksTotal: 2, DisksFailed: 0, DisksDown: 0, DisksSpare: 0, BlocksTotal: 1855870976, BlocksSynced: 1855870976, BlocksToBeSynced: 1855870976, BlocksSyncedPct: 0, BlocksSyncedFinishTime: 0, BlocksSyncedSpeed: 0, Devices: []string{"sdb", "sdc"}}, "md219": { Name: "md219", ActivityState: "inactive", DisksTotal: 0, DisksFailed: 0, DisksActive: 0, DisksDown: 0, DisksSpare: 3, BlocksTotal: 7932, BlocksSynced: 7932, BlocksToBeSynced: 7932, BlocksSyncedPct: 0, BlocksSyncedFinishTime: 0, BlocksSyncedSpeed: 0, Devices: []string{"sdc", "sda"}}, "md00": { Name: "md00", ActivityState: "active", DisksActive: 1, DisksTotal: 1, DisksFailed: 0, DisksDown: 0, DisksSpare: 0, BlocksTotal: 4186624, BlocksSynced: 4186624, BlocksToBeSynced: 4186624, BlocksSyncedPct: 0, BlocksSyncedFinishTime: 0, BlocksSyncedSpeed: 0, Devices: []string{"xvdb"}}, "md101": { Name: "md101", ActivityState: "active", DisksActive: 3, DisksTotal: 3, DisksFailed: 0, DisksDown: 0, DisksSpare: 0, BlocksTotal: 322560, BlocksSynced: 322560, BlocksToBeSynced: 322560, BlocksSyncedPct: 0, BlocksSyncedFinishTime: 0, BlocksSyncedSpeed: 0, Devices: []string{"sdb", "sdd", "sdc"}}, "md201": { Name: "md201", ActivityState: "checking", DisksActive: 2, DisksTotal: 2, DisksFailed: 0, DisksDown: 0, DisksSpare: 0, BlocksTotal: 1993728, BlocksSynced: 114176, BlocksToBeSynced: 1993728, BlocksSyncedPct: 5.7, BlocksSyncedFinishTime: 0.2, BlocksSyncedSpeed: 114176, Devices: []string{"sda3", "sdb3"}}, } if want, have := len(refs), len(mdStats); want != have { t.Errorf("want %d parsed md-devices, have %d", want, have) } for _, md := range mdStats { if want, have := refs[md.Name], md; !cmp.Equal(want, have) { t.Errorf("%s: want %v, have %v", md.Name, want, have) } } } func TestInvalidMdstat(t testing.T) { invalidMount := [][]byte{[]byte(` Personalities : [invalid] md3 : invalid 314159265 blocks 64k chunks unused devices: <none> `), []byte(` md12 : active raid0 sdc2[0] sdd2[1] 3886394368 blocks super 1.2 512k chunks `)} for _, invalid := range invalidMount { _, err := parseMDStat(invalid) if err == nil { t.Fatalf("parsing of invalid reference file did not find any errors") } } }	9.86 KB	2025-05-25 12:27
📄 meminfo.go // Copyright 2019 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "bufio" "bytes" "fmt" "io" "strconv" "strings" "github.com/prometheus/procfs/internal/util" ) // Meminfo represents memory statistics. type Meminfo struct { // Total usable ram (i.e. physical ram minus a few reserved // bits and the kernel binary code) MemTotal uint64 // The sum of LowFree+HighFree MemFree uint64 // An estimate of how much memory is available for starting // new applications, without swapping. Calculated from // MemFree, SReclaimable, the size of the file LRU lists, and // the low watermarks in each zone. The estimate takes into // account that the system needs some page cache to function // well, and that not all reclaimable slab will be // reclaimable, due to items being in use. The impact of those // factors will vary from system to system. MemAvailable uint64 // Relatively temporary storage for raw disk blocks shouldn't // get tremendously large (20MB or so) Buffers uint64 Cached uint64 // Memory that once was swapped out, is swapped back in but // still also is in the swapfile (if memory is needed it // doesn't need to be swapped out AGAIN because it is already // in the swapfile. This saves I/O) SwapCached uint64 // Memory that has been used more recently and usually not // reclaimed unless absolutely necessary. Active uint64 // Memory which has been less recently used. It is more // eligible to be reclaimed for other purposes Inactive uint64 ActiveAnon uint64 InactiveAnon uint64 ActiveFile uint64 InactiveFile uint64 Unevictable uint64 Mlocked uint64 // total amount of swap space available SwapTotal uint64 // Memory which has been evicted from RAM, and is temporarily // on the disk SwapFree uint64 // Memory which is waiting to get written back to the disk Dirty uint64 // Memory which is actively being written back to the disk Writeback uint64 // Non-file backed pages mapped into userspace page tables AnonPages uint64 // files which have been mapped, such as libraries Mapped uint64 Shmem uint64 // in-kernel data structures cache Slab uint64 // Part of Slab, that might be reclaimed, such as caches SReclaimable uint64 // Part of Slab, that cannot be reclaimed on memory pressure SUnreclaim uint64 KernelStack uint64 // amount of memory dedicated to the lowest level of page // tables. PageTables uint64 // NFS pages sent to the server, but not yet committed to // stable storage NFSUnstable uint64 // Memory used for block device "bounce buffers" Bounce uint64 // Memory used by FUSE for temporary writeback buffers WritebackTmp uint64 // Based on the overcommit ratio ('vm.overcommit_ratio'), // this is the total amount of memory currently available to // be allocated on the system. This limit is only adhered to // if strict overcommit accounting is enabled (mode 2 in // 'vm.overcommit_memory'). // The CommitLimit is calculated with the following formula: // CommitLimit = ([total RAM pages] - [total huge TLB pages]) // overcommit_ratio / 100 + [total swap pages] // For example, on a system with 1G of physical RAM and 7G // of swap with a `vm.overcommit_ratio` of 30 it would // yield a CommitLimit of 7.3G. // For more details, see the memory overcommit documentation // in vm/overcommit-accounting. CommitLimit uint64 // The amount of memory presently allocated on the system. // The committed memory is a sum of all of the memory which // has been allocated by processes, even if it has not been // "used" by them as of yet. A process which malloc()'s 1G // of memory, but only touches 300M of it will show up as // using 1G. This 1G is memory which has been "committed" to // by the VM and can be used at any time by the allocating // application. With strict overcommit enabled on the system // (mode 2 in 'vm.overcommit_memory'),allocations which would // exceed the CommitLimit (detailed above) will not be permitted. // This is useful if one needs to guarantee that processes will // not fail due to lack of memory once that memory has been // successfully allocated. CommittedAS uint64 // total size of vmalloc memory area VmallocTotal uint64 // amount of vmalloc area which is used VmallocUsed uint64 // largest contiguous block of vmalloc area which is free VmallocChunk uint64 Percpu uint64 HardwareCorrupted uint64 AnonHugePages uint64 ShmemHugePages uint64 ShmemPmdMapped uint64 CmaTotal uint64 CmaFree uint64 HugePagesTotal uint64 HugePagesFree uint64 HugePagesRsvd uint64 HugePagesSurp uint64 Hugepagesize uint64 DirectMap4k uint64 DirectMap2M uint64 DirectMap1G uint64 // The struct fields below are the byte-normalized counterparts to the // existing struct fields. Values are normalized using the optional // unit field in the meminfo line. MemTotalBytes uint64 MemFreeBytes uint64 MemAvailableBytes uint64 BuffersBytes uint64 CachedBytes uint64 SwapCachedBytes uint64 ActiveBytes uint64 InactiveBytes uint64 ActiveAnonBytes uint64 InactiveAnonBytes uint64 ActiveFileBytes uint64 InactiveFileBytes uint64 UnevictableBytes uint64 MlockedBytes uint64 SwapTotalBytes uint64 SwapFreeBytes uint64 DirtyBytes uint64 WritebackBytes uint64 AnonPagesBytes uint64 MappedBytes uint64 ShmemBytes uint64 SlabBytes uint64 SReclaimableBytes uint64 SUnreclaimBytes uint64 KernelStackBytes uint64 PageTablesBytes uint64 NFSUnstableBytes uint64 BounceBytes uint64 WritebackTmpBytes uint64 CommitLimitBytes uint64 CommittedASBytes uint64 VmallocTotalBytes uint64 VmallocUsedBytes uint64 VmallocChunkBytes uint64 PercpuBytes uint64 HardwareCorruptedBytes uint64 AnonHugePagesBytes uint64 ShmemHugePagesBytes uint64 ShmemPmdMappedBytes uint64 CmaTotalBytes uint64 CmaFreeBytes uint64 HugepagesizeBytes uint64 DirectMap4kBytes uint64 DirectMap2MBytes uint64 DirectMap1GBytes uint64 } // Meminfo returns an information about current kernel/system memory statistics. // See https://www.kernel.org/doc/Documentation/filesystems/proc.txt func (fs FS) Meminfo() (Meminfo, error) { b, err := util.ReadFileNoStat(fs.proc.Path("meminfo")) if err != nil { return Meminfo{}, err } m, err := parseMemInfo(bytes.NewReader(b)) if err != nil { return Meminfo{}, fmt.Errorf("%w: %w", ErrFileParse, err) } return m, nil } func parseMemInfo(r io.Reader) (Meminfo, error) { var m Meminfo s := bufio.NewScanner(r) for s.Scan() { fields := strings.Fields(s.Text()) var val, valBytes uint64 val, err := strconv.ParseUint(fields[1], 0, 64) if err != nil { return nil, err } switch len(fields) { case 2: // No unit present, use the parsed the value as bytes directly. valBytes = val case 3: // Unit present in optional 3rd field, convert it to // bytes. The only unit supported within the Linux // kernel is `kB`. if fields[2] != "kB" { return nil, fmt.Errorf("%w: Unsupported unit in optional 3rd field %q", ErrFileParse, fields[2]) } valBytes = 1024 val default: return nil, fmt.Errorf("%w: Malformed line %q", ErrFileParse, s.Text()) } switch fields[0] { case "MemTotal:": m.MemTotal = &val m.MemTotalBytes = &valBytes case "MemFree:": m.MemFree = &val m.MemFreeBytes = &valBytes case "MemAvailable:": m.MemAvailable = &val m.MemAvailableBytes = &valBytes case "Buffers:": m.Buffers = &val m.BuffersBytes = &valBytes case "Cached:": m.Cached = &val m.CachedBytes = &valBytes case "SwapCached:": m.SwapCached = &val m.SwapCachedBytes = &valBytes case "Active:": m.Active = &val m.ActiveBytes = &valBytes case "Inactive:": m.Inactive = &val m.InactiveBytes = &valBytes case "Active(anon):": m.ActiveAnon = &val m.ActiveAnonBytes = &valBytes case "Inactive(anon):": m.InactiveAnon = &val m.InactiveAnonBytes = &valBytes case "Active(file):": m.ActiveFile = &val m.ActiveFileBytes = &valBytes case "Inactive(file):": m.InactiveFile = &val m.InactiveFileBytes = &valBytes case "Unevictable:": m.Unevictable = &val m.UnevictableBytes = &valBytes case "Mlocked:": m.Mlocked = &val m.MlockedBytes = &valBytes case "SwapTotal:": m.SwapTotal = &val m.SwapTotalBytes = &valBytes case "SwapFree:": m.SwapFree = &val m.SwapFreeBytes = &valBytes case "Dirty:": m.Dirty = &val m.DirtyBytes = &valBytes case "Writeback:": m.Writeback = &val m.WritebackBytes = &valBytes case "AnonPages:": m.AnonPages = &val m.AnonPagesBytes = &valBytes case "Mapped:": m.Mapped = &val m.MappedBytes = &valBytes case "Shmem:": m.Shmem = &val m.ShmemBytes = &valBytes case "Slab:": m.Slab = &val m.SlabBytes = &valBytes case "SReclaimable:": m.SReclaimable = &val m.SReclaimableBytes = &valBytes case "SUnreclaim:": m.SUnreclaim = &val m.SUnreclaimBytes = &valBytes case "KernelStack:": m.KernelStack = &val m.KernelStackBytes = &valBytes case "PageTables:": m.PageTables = &val m.PageTablesBytes = &valBytes case "NFS_Unstable:": m.NFSUnstable = &val m.NFSUnstableBytes = &valBytes case "Bounce:": m.Bounce = &val m.BounceBytes = &valBytes case "WritebackTmp:": m.WritebackTmp = &val m.WritebackTmpBytes = &valBytes case "CommitLimit:": m.CommitLimit = &val m.CommitLimitBytes = &valBytes case "Committed_AS:": m.CommittedAS = &val m.CommittedASBytes = &valBytes case "VmallocTotal:": m.VmallocTotal = &val m.VmallocTotalBytes = &valBytes case "VmallocUsed:": m.VmallocUsed = &val m.VmallocUsedBytes = &valBytes case "VmallocChunk:": m.VmallocChunk = &val m.VmallocChunkBytes = &valBytes case "Percpu:": m.Percpu = &val m.PercpuBytes = &valBytes case "HardwareCorrupted:": m.HardwareCorrupted = &val m.HardwareCorruptedBytes = &valBytes case "AnonHugePages:": m.AnonHugePages = &val m.AnonHugePagesBytes = &valBytes case "ShmemHugePages:": m.ShmemHugePages = &val m.ShmemHugePagesBytes = &valBytes case "ShmemPmdMapped:": m.ShmemPmdMapped = &val m.ShmemPmdMappedBytes = &valBytes case "CmaTotal:": m.CmaTotal = &val m.CmaTotalBytes = &valBytes case "CmaFree:": m.CmaFree = &val m.CmaFreeBytes = &valBytes case "HugePages_Total:": m.HugePagesTotal = &val case "HugePages_Free:": m.HugePagesFree = &val case "HugePages_Rsvd:": m.HugePagesRsvd = &val case "HugePages_Surp:": m.HugePagesSurp = &val case "Hugepagesize:": m.Hugepagesize = &val m.HugepagesizeBytes = &valBytes case "DirectMap4k:": m.DirectMap4k = &val m.DirectMap4kBytes = &valBytes case "DirectMap2M:": m.DirectMap2M = &val m.DirectMap2MBytes = &valBytes case "DirectMap1G:": m.DirectMap1G = &val m.DirectMap1GBytes = &valBytes } } return &m, nil }	11.64 KB	2025-05-25 12:27
📄 meminfo_test.go // Copyright 2019 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "reflect" "testing" ) func TestMeminfo(t *testing.T) { expected := Meminfo{ MemTotal: newuint64(15666184), MemFree: newuint64(440324), Buffers: newuint64(1020128), Cached: newuint64(12007640), SwapCached: newuint64(0), Active: newuint64(6761276), Inactive: newuint64(6532708), ActiveAnon: newuint64(267256), InactiveAnon: newuint64(268), ActiveFile: newuint64(6494020), InactiveFile: newuint64(6532440), Unevictable: newuint64(0), Mlocked: newuint64(0), SwapTotal: newuint64(0), SwapFree: newuint64(0), Dirty: newuint64(768), Writeback: newuint64(0), AnonPages: newuint64(266216), Mapped: newuint64(44204), Shmem: newuint64(1308), Slab: newuint64(1807264), SReclaimable: newuint64(1738124), SUnreclaim: newuint64(69140), KernelStack: newuint64(1616), PageTables: newuint64(5288), NFSUnstable: newuint64(0), Bounce: newuint64(0), WritebackTmp: newuint64(0), CommitLimit: newuint64(7833092), CommittedAS: newuint64(530844), VmallocTotal: newuint64(34359738367), VmallocUsed: newuint64(36596), VmallocChunk: newuint64(34359637840), Percpu: newuint64(26176), HardwareCorrupted: newuint64(0), AnonHugePages: newuint64(12288), HugePagesTotal: newuint64(0), HugePagesFree: newuint64(0), HugePagesRsvd: newuint64(0), HugePagesSurp: newuint64(0), Hugepagesize: newuint64(2048), DirectMap4k: newuint64(91136), DirectMap2M: newuint64(16039936), MemTotalBytes: newuint64(16042172416), MemFreeBytes: newuint64(450891776), BuffersBytes: newuint64(1044611072), CachedBytes: newuint64(12295823360), SwapCachedBytes: newuint64(0), ActiveBytes: newuint64(6923546624), InactiveBytes: newuint64(6689492992), ActiveAnonBytes: newuint64(273670144), InactiveAnonBytes: newuint64(274432), ActiveFileBytes: newuint64(6649876480), InactiveFileBytes: newuint64(6689218560), UnevictableBytes: newuint64(0), MlockedBytes: newuint64(0), SwapTotalBytes: newuint64(0), SwapFreeBytes: newuint64(0), DirtyBytes: newuint64(786432), WritebackBytes: newuint64(0), AnonPagesBytes: newuint64(272605184), MappedBytes: newuint64(45264896), ShmemBytes: newuint64(1339392), SlabBytes: newuint64(1850638336), SReclaimableBytes: newuint64(1779838976), SUnreclaimBytes: newuint64(70799360), KernelStackBytes: newuint64(1654784), PageTablesBytes: newuint64(5414912), NFSUnstableBytes: newuint64(0), BounceBytes: newuint64(0), WritebackTmpBytes: newuint64(0), CommitLimitBytes: newuint64(8021086208), CommittedASBytes: newuint64(543584256), VmallocTotalBytes: newuint64(35184372087808), VmallocUsedBytes: newuint64(37474304), VmallocChunkBytes: newuint64(35184269148160), PercpuBytes: newuint64(26804224), HardwareCorruptedBytes: newuint64(0), AnonHugePagesBytes: newuint64(12582912), HugepagesizeBytes: newuint64(2097152), DirectMap4kBytes: newuint64(93323264), DirectMap2MBytes: newuint64(16424894464), } have, err := getProcFixtures(t).Meminfo() if err != nil { t.Fatal(err) } if !reflect.DeepEqual(have, expected) { t.Logf("have: %+v", have) t.Logf("expected: %+v", expected) t.Errorf("structs are not equal") } }	4.28 KB	2025-05-25 12:27
📄 mountinfo.go // Copyright 2019 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "bufio" "bytes" "fmt" "strconv" "strings" "github.com/prometheus/procfs/internal/util" ) // A MountInfo is a type that describes the details, options // for each mount, parsed from /proc/self/mountinfo. // The fields described in each entry of /proc/self/mountinfo // is described in the following man page. // http://man7.org/linux/man-pages/man5/proc.5.html type MountInfo struct { // Unique ID for the mount MountID int // The ID of the parent mount ParentID int // The value of `st_dev` for the files on this FS MajorMinorVer string // The pathname of the directory in the FS that forms // the root for this mount Root string // The pathname of the mount point relative to the root MountPoint string // Mount options Options map[string]string // Zero or more optional fields OptionalFields map[string]string // The Filesystem type FSType string // FS specific information or "none" Source string // Superblock options SuperOptions map[string]string } // Reads each line of the mountinfo file, and returns a list of formatted MountInfo structs. func parseMountInfo(info []byte) ([]MountInfo, error) { mounts := []MountInfo{} scanner := bufio.NewScanner(bytes.NewReader(info)) for scanner.Scan() { mountString := scanner.Text() parsedMounts, err := parseMountInfoString(mountString) if err != nil { return nil, err } mounts = append(mounts, parsedMounts) } err := scanner.Err() return mounts, err } // Parses a mountinfo file line, and converts it to a MountInfo struct. // An important check here is to see if the hyphen separator, as if it does not exist, // it means that the line is malformed. func parseMountInfoString(mountString string) (MountInfo, error) { var err error mountInfo := strings.Split(mountString, " ") mountInfoLength := len(mountInfo) if mountInfoLength < 10 { return nil, fmt.Errorf("%w: Too few fields in mount string: %s", ErrFileParse, mountString) } if mountInfo[mountInfoLength-4] != "-" { return nil, fmt.Errorf("%w: couldn't find separator in expected field: %s", ErrFileParse, mountInfo[mountInfoLength-4]) } mount := &MountInfo{ MajorMinorVer: mountInfo[2], Root: mountInfo[3], MountPoint: mountInfo[4], Options: mountOptionsParser(mountInfo[5]), OptionalFields: nil, FSType: mountInfo[mountInfoLength-3], Source: mountInfo[mountInfoLength-2], SuperOptions: mountOptionsParser(mountInfo[mountInfoLength-1]), } mount.MountID, err = strconv.Atoi(mountInfo[0]) if err != nil { return nil, fmt.Errorf("%w: mount ID: %q", ErrFileParse, mount.MountID) } mount.ParentID, err = strconv.Atoi(mountInfo[1]) if err != nil { return nil, fmt.Errorf("%w: parent ID: %q", ErrFileParse, mount.ParentID) } // Has optional fields, which is a space separated list of values. // Example: shared:2 master:7 if mountInfo[6] != "" { mount.OptionalFields, err = mountOptionsParseOptionalFields(mountInfo[6 : mountInfoLength-4]) if err != nil { return nil, fmt.Errorf("%w: %w", ErrFileParse, err) } } return mount, nil } // mountOptionsIsValidField checks a string against a valid list of optional fields keys. func mountOptionsIsValidField(s string) bool { switch s { case "shared", "master", "propagate_from", "unbindable": return true } return false } // mountOptionsParseOptionalFields parses a list of optional fields strings into a double map of strings. func mountOptionsParseOptionalFields(o []string) (map[string]string, error) { optionalFields := make(map[string]string) for _, field := range o { optionSplit := strings.SplitN(field, ":", 2) value := "" if len(optionSplit) == 2 { value = optionSplit[1] } if mountOptionsIsValidField(optionSplit[0]) { optionalFields[optionSplit[0]] = value } } return optionalFields, nil } // mountOptionsParser parses the mount options, superblock options. func mountOptionsParser(mountOptions string) map[string]string { opts := make(map[string]string) options := strings.Split(mountOptions, ",") for _, opt := range options { splitOption := strings.Split(opt, "=") if len(splitOption) < 2 { key := splitOption[0] opts[key] = "" } else { key, value := splitOption[0], splitOption[1] opts[key] = value } } return opts } // GetMounts retrieves mountinfo information from `/proc/self/mountinfo`. func GetMounts() ([]MountInfo, error) { data, err := util.ReadFileNoStat("/proc/self/mountinfo") if err != nil { return nil, err } return parseMountInfo(data) } // GetProcMounts retrieves mountinfo information from a processes' `/proc/<pid>/mountinfo`. func GetProcMounts(pid int) ([]*MountInfo, error) { data, err := util.ReadFileNoStat(fmt.Sprintf("/proc/%d/mountinfo", pid)) if err != nil { return nil, err } return parseMountInfo(data) }	5.31 KB	2025-05-25 12:27
📄 mountinfo_test.go // Copyright 2019 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "reflect" "testing" ) func TestMountInfo(t testing.T) { tests := []struct { name string s string mount MountInfo invalid bool }{ { name: "Regular sysfs mounted at /sys", s: "16 21 0:16 / /sys rw,nosuid,nodev,noexec,relatime shared:7 - sysfs sysfs rw", invalid: false, mount: &MountInfo{ MountID: 16, ParentID: 21, MajorMinorVer: "0:16", Root: "/", MountPoint: "/sys", Options: map[string]string{"rw": "", "nosuid": "", "nodev": "", "noexec": "", "relatime": ""}, OptionalFields: map[string]string{"shared": "7"}, FSType: "sysfs", Source: "sysfs", SuperOptions: map[string]string{"rw": ""}, }, }, { name: "Not enough information", s: "hello", invalid: true, }, { name: "Tmpfs mounted at /run", s: "225 20 0:39 / /run/user/112 rw,nosuid,nodev,relatime shared:177 - tmpfs tmpfs rw,size=405096k,mode=700,uid=112,gid=116", mount: &MountInfo{ MountID: 225, ParentID: 20, MajorMinorVer: "0:39", Root: "/", MountPoint: "/run/user/112", Options: map[string]string{"rw": "", "nosuid": "", "nodev": "", "relatime": ""}, OptionalFields: map[string]string{"shared": "177"}, FSType: "tmpfs", Source: "tmpfs", SuperOptions: map[string]string{"rw": "", "size": "405096k", "mode": "700", "uid": "112", "gid": "116"}, }, invalid: false, }, { name: "Tmpfs mounted at /run, but no optional values", s: "225 20 0:39 / /run/user/112 rw,nosuid,nodev,relatime - tmpfs tmpfs rw,size=405096k,mode=700,uid=112,gid=116", mount: &MountInfo{ MountID: 225, ParentID: 20, MajorMinorVer: "0:39", Root: "/", MountPoint: "/run/user/112", Options: map[string]string{"rw": "", "nosuid": "", "nodev": "", "relatime": ""}, OptionalFields: nil, FSType: "tmpfs", Source: "tmpfs", SuperOptions: map[string]string{"rw": "", "size": "405096k", "mode": "700", "uid": "112", "gid": "116"}, }, invalid: false, }, { name: "Tmpfs mounted at /run, with multiple optional values", s: "225 20 0:39 / /run/user/112 rw,nosuid,nodev,relatime shared:177 master:8 - tmpfs tmpfs rw,size=405096k,mode=700,uid=112,gid=116", mount: &MountInfo{ MountID: 225, ParentID: 20, MajorMinorVer: "0:39", Root: "/", MountPoint: "/run/user/112", Options: map[string]string{"rw": "", "nosuid": "", "nodev": "", "relatime": ""}, OptionalFields: map[string]string{"shared": "177", "master": "8"}, FSType: "tmpfs", Source: "tmpfs", SuperOptions: map[string]string{"rw": "", "size": "405096k", "mode": "700", "uid": "112", "gid": "116"}, }, invalid: false, }, { name: "Tmpfs mounted at /run, with a mixture of valid and invalid optional values", s: "225 20 0:39 / /run/user/112 rw,nosuid,nodev,relatime shared:177 master:8 foo:bar - tmpfs tmpfs rw,size=405096k,mode=700,uid=112,gid=116", mount: &MountInfo{ MountID: 225, ParentID: 20, MajorMinorVer: "0:39", Root: "/", MountPoint: "/run/user/112", Options: map[string]string{"rw": "", "nosuid": "", "nodev": "", "relatime": ""}, OptionalFields: map[string]string{"shared": "177", "master": "8"}, FSType: "tmpfs", Source: "tmpfs", SuperOptions: map[string]string{"rw": "", "size": "405096k", "mode": "700", "uid": "112", "gid": "116"}, }, invalid: false, }, { name: "CIFS mounted at /with/a-hyphen", s: "454 29 0:87 / /with/a-hyphen rw,relatime shared:255 - cifs //remote-storage/Path rw,vers=3.1.1,cache=strict,username=user,uid=1000,forceuid,gid=0,noforcegid,addr=127.0.0.1,file_mode=0755,dir_mode=0755,soft,nounix,serverino,mapposix,echo_interval=60,actimeo=1", mount: &MountInfo{ MountID: 454, ParentID: 29, MajorMinorVer: "0:87", Root: "/", MountPoint: "/with/a-hyphen", Options: map[string]string{"rw": "", "relatime": ""}, OptionalFields: map[string]string{"shared": "255"}, FSType: "cifs", Source: "//remote-storage/Path", SuperOptions: map[string]string{"rw": "", "vers": "3.1.1", "cache": "strict", "username": "user", "uid": "1000", "forceuid": "", "gid": "0", "noforcegid": "", "addr": "127.0.0.1", "file_mode": "0755", "dir_mode": "0755", "soft": "", "nounix": "", "serverino": "", "mapposix": "", "echo_interval": "60", "actimeo": "1"}, }, invalid: false, }, { name: "Docker overlay with 10 fields (no optional fields)", s: "137 45 253:2 /lib/docker/overlay2 /var/lib/docker/overlay2 rw,relatime - ext4 /dev/mapper/vg0-lv_var rw,data=ordered", mount: &MountInfo{ MountID: 137, ParentID: 45, MajorMinorVer: "253:2", Root: "/lib/docker/overlay2", MountPoint: "/var/lib/docker/overlay2", Options: map[string]string{"rw": "", "relatime": ""}, OptionalFields: map[string]string{}, FSType: "ext4", Source: "/dev/mapper/vg0-lv_var", SuperOptions: map[string]string{"rw": "", "data": "ordered"}, }, }, { name: "bind chroot bind mount with 10 fields (no optional fields)", s: "157 47 253:2 /etc/named /var/named/chroot/etc/named rw,relatime - ext4 /dev/mapper/vg0-lv_root rw,data=ordered", mount: &MountInfo{ MountID: 157, ParentID: 47, MajorMinorVer: "253:2", Root: "/etc/named", MountPoint: "/var/named/chroot/etc/named", Options: map[string]string{"rw": "", "relatime": ""}, OptionalFields: map[string]string{}, FSType: "ext4", Source: "/dev/mapper/vg0-lv_root", SuperOptions: map[string]string{"rw": "", "data": "ordered"}, }, }, } for i, test := range tests { t.Logf("[%02d] test %q", i, test.name) mount, err := parseMountInfoString(test.s) if test.invalid && err == nil { t.Error("expected an error, but none occurred") } if !test.invalid && err != nil { t.Errorf("unexpected error: %v", err) } if want, have := test.mount, mount; !reflect.DeepEqual(want, have) { t.Errorf("mounts:\nwant:\n%+v\nhave:\n%+v", want, have) } } }	6.86 KB	2025-05-25 12:27
📄 mountstats.go // Copyright 2018 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs // While implementing parsing of /proc/[pid]/mountstats, this blog was used // heavily as a reference: // https://utcc.utoronto.ca/~cks/space/blog/linux/NFSMountstatsIndex // // Special thanks to Chris Siebenmann for all of his posts explaining the // various statistics available for NFS. import ( "bufio" "fmt" "io" "strconv" "strings" "time" ) // Constants shared between multiple functions. const ( deviceEntryLen = 8 fieldBytesLen = 8 fieldEventsLen = 27 statVersion10 = "1.0" statVersion11 = "1.1" fieldTransport10TCPLen = 10 fieldTransport10UDPLen = 7 fieldTransport11TCPLen = 13 fieldTransport11UDPLen = 10 // kernel version >= 4.14 MaxLen // See: https://elixir.bootlin.com/linux/v6.4.8/source/net/sunrpc/xprtrdma/xprt_rdma.h#L393 fieldTransport11RDMAMaxLen = 28 // kernel version <= 4.2 MinLen // See: https://elixir.bootlin.com/linux/v4.2.8/source/net/sunrpc/xprtrdma/xprt_rdma.h#L331 fieldTransport11RDMAMinLen = 20 ) // A Mount is a device mount parsed from /proc/[pid]/mountstats. type Mount struct { // Name of the device. Device string // The mount point of the device. Mount string // The filesystem type used by the device. Type string // If available additional statistics related to this Mount. // Use a type assertion to determine if additional statistics are available. Stats MountStats } // A MountStats is a type which contains detailed statistics for a specific // type of Mount. type MountStats interface { mountStats() } // A MountStatsNFS is a MountStats implementation for NFSv3 and v4 mounts. type MountStatsNFS struct { // The version of statistics provided. StatVersion string // The mount options of the NFS mount. Opts map[string]string // The age of the NFS mount. Age time.Duration // Statistics related to byte counters for various operations. Bytes NFSBytesStats // Statistics related to various NFS event occurrences. Events NFSEventsStats // Statistics broken down by filesystem operation. Operations []NFSOperationStats // Statistics about the NFS RPC transport. Transport []NFSTransportStats } // mountStats implements MountStats. func (m MountStatsNFS) mountStats() {} // A NFSBytesStats contains statistics about the number of bytes read and written // by an NFS client to and from an NFS server. type NFSBytesStats struct { // Number of bytes read using the read() syscall. Read uint64 // Number of bytes written using the write() syscall. Write uint64 // Number of bytes read using the read() syscall in O_DIRECT mode. DirectRead uint64 // Number of bytes written using the write() syscall in O_DIRECT mode. DirectWrite uint64 // Number of bytes read from the NFS server, in total. ReadTotal uint64 // Number of bytes written to the NFS server, in total. WriteTotal uint64 // Number of pages read directly via mmap()'d files. ReadPages uint64 // Number of pages written directly via mmap()'d files. WritePages uint64 } // A NFSEventsStats contains statistics about NFS event occurrences. type NFSEventsStats struct { // Number of times cached inode attributes are re-validated from the server. InodeRevalidate uint64 // Number of times cached dentry nodes are re-validated from the server. DnodeRevalidate uint64 // Number of times an inode cache is cleared. DataInvalidate uint64 // Number of times cached inode attributes are invalidated. AttributeInvalidate uint64 // Number of times files or directories have been open()'d. VFSOpen uint64 // Number of times a directory lookup has occurred. VFSLookup uint64 // Number of times permissions have been checked. VFSAccess uint64 // Number of updates (and potential writes) to pages. VFSUpdatePage uint64 // Number of pages read directly via mmap()'d files. VFSReadPage uint64 // Number of times a group of pages have been read. VFSReadPages uint64 // Number of pages written directly via mmap()'d files. VFSWritePage uint64 // Number of times a group of pages have been written. VFSWritePages uint64 // Number of times directory entries have been read with getdents(). VFSGetdents uint64 // Number of times attributes have been set on inodes. VFSSetattr uint64 // Number of pending writes that have been forcefully flushed to the server. VFSFlush uint64 // Number of times fsync() has been called on directories and files. VFSFsync uint64 // Number of times locking has been attempted on a file. VFSLock uint64 // Number of times files have been closed and released. VFSFileRelease uint64 // Unknown. Possibly unused. CongestionWait uint64 // Number of times files have been truncated. Truncation uint64 // Number of times a file has been grown due to writes beyond its existing end. WriteExtension uint64 // Number of times a file was removed while still open by another process. SillyRename uint64 // Number of times the NFS server gave less data than expected while reading. ShortRead uint64 // Number of times the NFS server wrote less data than expected while writing. ShortWrite uint64 // Number of times the NFS server indicated EJUKEBOX; retrieving data from // offline storage. JukeboxDelay uint64 // Number of NFS v4.1+ pNFS reads. PNFSRead uint64 // Number of NFS v4.1+ pNFS writes. PNFSWrite uint64 } // A NFSOperationStats contains statistics for a single operation. type NFSOperationStats struct { // The name of the operation. Operation string // Number of requests performed for this operation. Requests uint64 // Number of times an actual RPC request has been transmitted for this operation. Transmissions uint64 // Number of times a request has had a major timeout. MajorTimeouts uint64 // Number of bytes sent for this operation, including RPC headers and payload. BytesSent uint64 // Number of bytes received for this operation, including RPC headers and payload. BytesReceived uint64 // Duration all requests spent queued for transmission before they were sent. CumulativeQueueMilliseconds uint64 // Duration it took to get a reply back after the request was transmitted. CumulativeTotalResponseMilliseconds uint64 // Duration from when a request was enqueued to when it was completely handled. CumulativeTotalRequestMilliseconds uint64 // The count of operations that complete with tk_status < 0. These statuses usually indicate error conditions. Errors uint64 } // A NFSTransportStats contains statistics for the NFS mount RPC requests and // responses. type NFSTransportStats struct { // The transport protocol used for the NFS mount. Protocol string // The local port used for the NFS mount. Port uint64 // Number of times the client has had to establish a connection from scratch // to the NFS server. Bind uint64 // Number of times the client has made a TCP connection to the NFS server. Connect uint64 // Duration (in jiffies, a kernel internal unit of time) the NFS mount has // spent waiting for connections to the server to be established. ConnectIdleTime uint64 // Duration since the NFS mount last saw any RPC traffic. IdleTimeSeconds uint64 // Number of RPC requests for this mount sent to the NFS server. Sends uint64 // Number of RPC responses for this mount received from the NFS server. Receives uint64 // Number of times the NFS server sent a response with a transaction ID // unknown to this client. BadTransactionIDs uint64 // A running counter, incremented on each request as the current difference // ebetween sends and receives. CumulativeActiveRequests uint64 // A running counter, incremented on each request by the current backlog // queue size. CumulativeBacklog uint64 // Stats below only available with stat version 1.1. // Maximum number of simultaneously active RPC requests ever used. MaximumRPCSlotsUsed uint64 // A running counter, incremented on each request as the current size of the // sending queue. CumulativeSendingQueue uint64 // A running counter, incremented on each request as the current size of the // pending queue. CumulativePendingQueue uint64 // Stats below only available with stat version 1.1. // Transport over RDMA // accessed when sending a call ReadChunkCount uint64 WriteChunkCount uint64 ReplyChunkCount uint64 TotalRdmaRequest uint64 // rarely accessed error counters PullupCopyCount uint64 HardwayRegisterCount uint64 FailedMarshalCount uint64 BadReplyCount uint64 MrsRecovered uint64 MrsOrphaned uint64 MrsAllocated uint64 EmptySendctxQ uint64 // accessed when receiving a reply TotalRdmaReply uint64 FixupCopyCount uint64 ReplyWaitsForSend uint64 LocalInvNeeded uint64 NomsgCallCount uint64 BcallCount uint64 } // parseMountStats parses a /proc/[pid]/mountstats file and returns a slice // of Mount structures containing detailed information about each mount. // If available, statistics for each mount are parsed as well. func parseMountStats(r io.Reader) ([]Mount, error) { const ( device = "device" statVersionPrefix = "statvers=" nfs3Type = "nfs" nfs4Type = "nfs4" ) var mounts []Mount s := bufio.NewScanner(r) for s.Scan() { // Only look for device entries in this function ss := strings.Fields(string(s.Bytes())) if len(ss) == 0 \|\| ss[0] != device { continue } m, err := parseMount(ss) if err != nil { return nil, err } // Does this mount also possess statistics information? if len(ss) > deviceEntryLen { // Only NFSv3 and v4 are supported for parsing statistics if m.Type != nfs3Type && m.Type != nfs4Type { return nil, fmt.Errorf("%w: Cannot parse MountStats for %q", ErrFileParse, m.Type) } statVersion := strings.TrimPrefix(ss[8], statVersionPrefix) stats, err := parseMountStatsNFS(s, statVersion) if err != nil { return nil, err } m.Stats = stats } mounts = append(mounts, m) } return mounts, s.Err() } // parseMount parses an entry in /proc/[pid]/mountstats in the format: // // device [device] mounted on [mount] with fstype [type] func parseMount(ss []string) (Mount, error) { if len(ss) < deviceEntryLen { return nil, fmt.Errorf("%w: Invalid device %q", ErrFileParse, ss) } // Check for specific words appearing at specific indices to ensure // the format is consistent with what we expect format := []struct { i int s string }{ {i: 0, s: "device"}, {i: 2, s: "mounted"}, {i: 3, s: "on"}, {i: 5, s: "with"}, {i: 6, s: "fstype"}, } for _, f := range format { if ss[f.i] != f.s { return nil, fmt.Errorf("%w: Invalid device %q", ErrFileParse, ss) } } return &Mount{ Device: ss[1], Mount: ss[4], Type: ss[7], }, nil } // parseMountStatsNFS parses a MountStatsNFS by scanning additional information // related to NFS statistics. func parseMountStatsNFS(s bufio.Scanner, statVersion string) (MountStatsNFS, error) { // Field indicators for parsing specific types of data const ( fieldOpts = "opts:" fieldAge = "age:" fieldBytes = "bytes:" fieldEvents = "events:" fieldPerOpStats = "per-op" fieldTransport = "xprt:" ) stats := &MountStatsNFS{ StatVersion: statVersion, } for s.Scan() { ss := strings.Fields(string(s.Bytes())) if len(ss) == 0 { break } switch ss[0] { case fieldOpts: if len(ss) < 2 { return nil, fmt.Errorf("%w: Incomplete information for NFS stats: %v", ErrFileParse, ss) } if stats.Opts == nil { stats.Opts = map[string]string{} } for _, opt := range strings.Split(ss[1], ",") { split := strings.Split(opt, "=") if len(split) == 2 { stats.Opts[split[0]] = split[1] } else { stats.Opts[opt] = "" } } case fieldAge: if len(ss) < 2 { return nil, fmt.Errorf("%w: Incomplete information for NFS stats: %v", ErrFileParse, ss) } // Age integer is in seconds d, err := time.ParseDuration(ss[1] + "s") if err != nil { return nil, err } stats.Age = d case fieldBytes: if len(ss) < 2 { return nil, fmt.Errorf("%w: Incomplete information for NFS stats: %v", ErrFileParse, ss) } bstats, err := parseNFSBytesStats(ss[1:]) if err != nil { return nil, err } stats.Bytes = bstats case fieldEvents: if len(ss) < 2 { return nil, fmt.Errorf("%w: Incomplete information for NFS events: %v", ErrFileParse, ss) } estats, err := parseNFSEventsStats(ss[1:]) if err != nil { return nil, err } stats.Events = estats case fieldTransport: if len(ss) < 3 { return nil, fmt.Errorf("%w: Incomplete information for NFS transport stats: %v", ErrFileParse, ss) } tstats, err := parseNFSTransportStats(ss[1:], statVersion) if err != nil { return nil, err } stats.Transport = append(stats.Transport, tstats) } // When encountering "per-operation statistics", we must break this // loop and parse them separately to ensure we can terminate parsing // before reaching another device entry; hence why this 'if' statement // is not just another switch case if ss[0] == fieldPerOpStats { break } } if err := s.Err(); err != nil { return nil, err } // NFS per-operation stats appear last before the next device entry perOpStats, err := parseNFSOperationStats(s) if err != nil { return nil, err } stats.Operations = perOpStats return stats, nil } // parseNFSBytesStats parses a NFSBytesStats line using an input set of // integer fields. func parseNFSBytesStats(ss []string) (NFSBytesStats, error) { if len(ss) != fieldBytesLen { return nil, fmt.Errorf("%w: Invalid NFS bytes stats: %v", ErrFileParse, ss) } ns := make([]uint64, 0, fieldBytesLen) for _, s := range ss { n, err := strconv.ParseUint(s, 10, 64) if err != nil { return nil, err } ns = append(ns, n) } return &NFSBytesStats{ Read: ns[0], Write: ns[1], DirectRead: ns[2], DirectWrite: ns[3], ReadTotal: ns[4], WriteTotal: ns[5], ReadPages: ns[6], WritePages: ns[7], }, nil } // parseNFSEventsStats parses a NFSEventsStats line using an input set of // integer fields. func parseNFSEventsStats(ss []string) (NFSEventsStats, error) { if len(ss) != fieldEventsLen { return nil, fmt.Errorf("%w: invalid NFS events stats: %v", ErrFileParse, ss) } ns := make([]uint64, 0, fieldEventsLen) for _, s := range ss { n, err := strconv.ParseUint(s, 10, 64) if err != nil { return nil, err } ns = append(ns, n) } return &NFSEventsStats{ InodeRevalidate: ns[0], DnodeRevalidate: ns[1], DataInvalidate: ns[2], AttributeInvalidate: ns[3], VFSOpen: ns[4], VFSLookup: ns[5], VFSAccess: ns[6], VFSUpdatePage: ns[7], VFSReadPage: ns[8], VFSReadPages: ns[9], VFSWritePage: ns[10], VFSWritePages: ns[11], VFSGetdents: ns[12], VFSSetattr: ns[13], VFSFlush: ns[14], VFSFsync: ns[15], VFSLock: ns[16], VFSFileRelease: ns[17], CongestionWait: ns[18], Truncation: ns[19], WriteExtension: ns[20], SillyRename: ns[21], ShortRead: ns[22], ShortWrite: ns[23], JukeboxDelay: ns[24], PNFSRead: ns[25], PNFSWrite: ns[26], }, nil } // parseNFSOperationStats parses a slice of NFSOperationStats by scanning // additional information about per-operation statistics until an empty // line is reached. func parseNFSOperationStats(s bufio.Scanner) ([]NFSOperationStats, error) { const ( // Minimum number of expected fields in each per-operation statistics set minFields = 9 ) var ops []NFSOperationStats for s.Scan() { ss := strings.Fields(string(s.Bytes())) if len(ss) == 0 { // Must break when reading a blank line after per-operation stats to // enable top-level function to parse the next device entry break } if len(ss) < minFields { return nil, fmt.Errorf("%w: invalid NFS per-operations stats: %v", ErrFileParse, ss) } // Skip string operation name for integers ns := make([]uint64, 0, minFields-1) for _, st := range ss[1:] { n, err := strconv.ParseUint(st, 10, 64) if err != nil { return nil, err } ns = append(ns, n) } opStats := NFSOperationStats{ Operation: strings.TrimSuffix(ss[0], ":"), Requests: ns[0], Transmissions: ns[1], MajorTimeouts: ns[2], BytesSent: ns[3], BytesReceived: ns[4], CumulativeQueueMilliseconds: ns[5], CumulativeTotalResponseMilliseconds: ns[6], CumulativeTotalRequestMilliseconds: ns[7], } if len(ns) > 8 { opStats.Errors = ns[8] } ops = append(ops, opStats) } return ops, s.Err() } // parseNFSTransportStats parses a NFSTransportStats line using an input set of // integer fields matched to a specific stats version. func parseNFSTransportStats(ss []string, statVersion string) (NFSTransportStats, error) { // Extract the protocol field. It is the only string value in the line protocol := ss[0] ss = ss[1:] switch statVersion { case statVersion10: var expectedLength int if protocol == "tcp" { expectedLength = fieldTransport10TCPLen } else if protocol == "udp" { expectedLength = fieldTransport10UDPLen } else { return nil, fmt.Errorf("%w: Invalid NFS protocol \"%s\" in stats 1.0 statement: %v", ErrFileParse, protocol, ss) } if len(ss) != expectedLength { return nil, fmt.Errorf("%w: Invalid NFS transport stats 1.0 statement: %v", ErrFileParse, ss) } case statVersion11: var expectedLength int if protocol == "tcp" { expectedLength = fieldTransport11TCPLen } else if protocol == "udp" { expectedLength = fieldTransport11UDPLen } else if protocol == "rdma" { expectedLength = fieldTransport11RDMAMinLen } else { return nil, fmt.Errorf("%w: invalid NFS protocol \"%s\" in stats 1.1 statement: %v", ErrFileParse, protocol, ss) } if (len(ss) != expectedLength && (protocol == "tcp" \|\| protocol == "udp")) \|\| (protocol == "rdma" && len(ss) < expectedLength) { return nil, fmt.Errorf("%w: invalid NFS transport stats 1.1 statement: %v, protocol: %v", ErrFileParse, ss, protocol) } default: return nil, fmt.Errorf("%w: Unrecognized NFS transport stats version: %q, protocol: %v", ErrFileParse, statVersion, protocol) } // Allocate enough for v1.1 stats since zero value for v1.1 stats will be okay // in a v1.0 response. Since the stat length is bigger for TCP stats, we use // the TCP length here. // // Note: slice length must be set to length of v1.1 stats to avoid a panic when // only v1.0 stats are present. // See: https://github.com/prometheus/node_exporter/issues/571. // // Note: NFS Over RDMA slice length is fieldTransport11RDMAMaxLen ns := make([]uint64, fieldTransport11RDMAMaxLen+3) for i, s := range ss { n, err := strconv.ParseUint(s, 10, 64) if err != nil { return nil, err } ns[i] = n } // The fields differ depending on the transport protocol (TCP or UDP) // From https://utcc.utoronto.ca/%7Ecks/space/blog/linux/NFSMountstatsXprt // // For the udp RPC transport there is no connection count, connect idle time, // or idle time (fields #3, #4, and #5); all other fields are the same. So // we set them to 0 here. if protocol == "udp" { ns = append(ns[:2], append(make([]uint64, 3), ns[2:]...)...) } else if protocol == "tcp" { ns = append(ns[:fieldTransport11TCPLen], make([]uint64, fieldTransport11RDMAMaxLen-fieldTransport11TCPLen+3)...) } else if protocol == "rdma" { ns = append(ns[:fieldTransport10TCPLen], append(make([]uint64, 3), ns[fieldTransport10TCPLen:]...)...) } return &NFSTransportStats{ // NFS xprt over tcp or udp Protocol: protocol, Port: ns[0], Bind: ns[1], Connect: ns[2], ConnectIdleTime: ns[3], IdleTimeSeconds: ns[4], Sends: ns[5], Receives: ns[6], BadTransactionIDs: ns[7], CumulativeActiveRequests: ns[8], CumulativeBacklog: ns[9], // NFS xprt over tcp or udp // And statVersion 1.1 MaximumRPCSlotsUsed: ns[10], CumulativeSendingQueue: ns[11], CumulativePendingQueue: ns[12], // NFS xprt over rdma // And stat Version 1.1 ReadChunkCount: ns[13], WriteChunkCount: ns[14], ReplyChunkCount: ns[15], TotalRdmaRequest: ns[16], PullupCopyCount: ns[17], HardwayRegisterCount: ns[18], FailedMarshalCount: ns[19], BadReplyCount: ns[20], MrsRecovered: ns[21], MrsOrphaned: ns[22], MrsAllocated: ns[23], EmptySendctxQ: ns[24], TotalRdmaReply: ns[25], FixupCopyCount: ns[26], ReplyWaitsForSend: ns[27], LocalInvNeeded: ns[28], NomsgCallCount: ns[29], BcallCount: ns[30], }, nil }	21.1 KB	2025-05-25 12:27
📄 mountstats_test.go // Copyright 2018 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "fmt" "reflect" "strings" "testing" "time" ) func TestMountStats(t testing.T) { tests := []struct { name string s string mounts []Mount invalid bool }{ { name: "no devices", s: `hello`, }, { name: "device has too few fields", s: `device foo`, invalid: true, }, { name: "device incorrect format", s: `device rootfs BAD on / with fstype rootfs`, invalid: true, }, { name: "device incorrect format", s: `device rootfs mounted BAD / with fstype rootfs`, invalid: true, }, { name: "device incorrect format", s: `device rootfs mounted on / BAD fstype rootfs`, invalid: true, }, { name: "device incorrect format", s: `device rootfs mounted on / with BAD rootfs`, invalid: true, }, { name: "device rootfs cannot have stats", s: `device rootfs mounted on / with fstype rootfs stats`, invalid: true, }, { name: "NFSv4 device with too little info", s: "device 192.168.1.1:/srv mounted on /mnt/nfs with fstype nfs4 statvers=1.1\nopts:", invalid: true, }, { name: "NFSv4 device with bad bytes", s: "device 192.168.1.1:/srv mounted on /mnt/nfs with fstype nfs4 statvers=1.1\nbytes: 0", invalid: true, }, { name: "NFSv4 device with bad events", s: "device 192.168.1.1:/srv mounted on /mnt/nfs with fstype nfs4 statvers=1.1\nevents: 0", invalid: true, }, { name: "NFSv4 device with bad per-op stats", s: "device 192.168.1.1:/srv mounted on /mnt/nfs with fstype nfs4 statvers=1.1\nper-op statistics\nFOO 0", invalid: true, }, { name: "NFSv4 device with bad transport stats", s: "device 192.168.1.1:/srv mounted on /mnt/nfs with fstype nfs4 statvers=1.1\nxprt: tcp", invalid: true, }, { name: "NFSv4 device with bad transport version", s: "device 192.168.1.1:/srv mounted on /mnt/nfs with fstype nfs4 statvers=foo\nxprt: tcp 0", invalid: true, }, { name: "NFSv4 device with bad transport stats version 1.0", s: "device 192.168.1.1:/srv mounted on /mnt/nfs with fstype nfs4 statvers=1.0\nxprt: tcp 0 0 0 0 0 0 0 0 0 0 0 0 0", invalid: true, }, { name: "NFSv4 device with bad transport stats version 1.1", s: "device 192.168.1.1:/srv mounted on /mnt/nfs with fstype nfs4 statvers=1.1\nxprt: tcp 0 0 0 0 0 0 0 0 0 0", invalid: true, }, { name: "NFSv3 device with bad transport protocol", s: "device 192.168.1.1:/srv mounted on /mnt/nfs with fstype nfs4 statvers=1.1\nxprt: tcpx 0 0 0 0 0 0 0 0 0 0", invalid: true, }, { name: "NFSv3 device using TCP with transport stats version 1.0 OK", s: "device 192.168.1.1:/srv mounted on /mnt/nfs with fstype nfs statvers=1.0\nxprt: tcp 1 2 3 4 5 6 7 8 9 10", mounts: []Mount{{ Device: "192.168.1.1:/srv", Mount: "/mnt/nfs", Type: "nfs", Stats: &MountStatsNFS{ StatVersion: "1.0", Transport: []NFSTransportStats{ { Protocol: "tcp", Port: 1, Bind: 2, Connect: 3, ConnectIdleTime: 4, IdleTimeSeconds: 5, Sends: 6, Receives: 7, BadTransactionIDs: 8, CumulativeActiveRequests: 9, CumulativeBacklog: 10, MaximumRPCSlotsUsed: 0, // these three are not CumulativeSendingQueue: 0, // present in statvers=1.0 CumulativePendingQueue: 0, // }, }, }, }}, }, { name: "NFSv3 device using UDP with transport stats version 1.0 OK", s: "device 192.168.1.1:/srv mounted on /mnt/nfs with fstype nfs statvers=1.0\nxprt: udp 1 2 3 4 5 6 7", mounts: []Mount{{ Device: "192.168.1.1:/srv", Mount: "/mnt/nfs", Type: "nfs", Stats: &MountStatsNFS{ StatVersion: "1.0", Transport: []NFSTransportStats{ { Protocol: "udp", Port: 1, Bind: 2, Connect: 0, ConnectIdleTime: 0, IdleTimeSeconds: 0, Sends: 3, Receives: 4, BadTransactionIDs: 5, CumulativeActiveRequests: 6, CumulativeBacklog: 7, MaximumRPCSlotsUsed: 0, // these three are not CumulativeSendingQueue: 0, // present in statvers=1.0 CumulativePendingQueue: 0, // }, }, }, }}, }, { name: "NFSv3 device using TCP with transport stats version 1.1 OK", s: "device 192.168.1.1:/srv mounted on /mnt/nfs with fstype nfs statvers=1.1\nxprt: tcp 1 2 3 4 5 6 7 8 9 10 11 12 13", mounts: []Mount{{ Device: "192.168.1.1:/srv", Mount: "/mnt/nfs", Type: "nfs", Stats: &MountStatsNFS{ StatVersion: "1.1", Transport: []NFSTransportStats{ { Protocol: "tcp", Port: 1, Bind: 2, Connect: 3, ConnectIdleTime: 4, IdleTimeSeconds: 5, Sends: 6, Receives: 7, BadTransactionIDs: 8, CumulativeActiveRequests: 9, CumulativeBacklog: 10, MaximumRPCSlotsUsed: 11, CumulativeSendingQueue: 12, CumulativePendingQueue: 13, }, }, }, }}, }, { name: "NFSv3 device using UDP with transport stats version 1.1 OK", s: "device 192.168.1.1:/srv mounted on /mnt/nfs with fstype nfs statvers=1.1\nxprt: udp 1 2 3 4 5 6 7 8 9 10", mounts: []Mount{{ Device: "192.168.1.1:/srv", Mount: "/mnt/nfs", Type: "nfs", Stats: &MountStatsNFS{ StatVersion: "1.1", Transport: []NFSTransportStats{ { Protocol: "udp", Port: 1, Bind: 2, Connect: 0, // these three are not ConnectIdleTime: 0, // present for UDP IdleTimeSeconds: 0, // Sends: 3, Receives: 4, BadTransactionIDs: 5, CumulativeActiveRequests: 6, CumulativeBacklog: 7, MaximumRPCSlotsUsed: 8, CumulativeSendingQueue: 9, CumulativePendingQueue: 10, }, }, }, }}, }, { name: "NFSv3 device with mountaddr OK", s: "device 192.168.1.1:/srv mounted on /mnt/nfs with fstype nfs statvers=1.1\nopts: rw,vers=3,mountaddr=192.168.1.1,proto=udp\n", mounts: []Mount{{ Device: "192.168.1.1:/srv", Mount: "/mnt/nfs", Type: "nfs", Stats: &MountStatsNFS{ StatVersion: "1.1", Opts: map[string]string{"rw": "", "vers": "3", "mountaddr": "192.168.1.1", "proto": "udp"}, }, }}, }, { name: "device rootfs OK", s: `device rootfs mounted on / with fstype rootfs`, mounts: []Mount{{ Device: "rootfs", Mount: "/", Type: "rootfs", }}, }, { name: "NFSv3 device with minimal stats OK", s: `device 192.168.1.1:/srv mounted on /mnt/nfs with fstype nfs statvers=1.1`, mounts: []Mount{{ Device: "192.168.1.1:/srv", Mount: "/mnt/nfs", Type: "nfs", Stats: &MountStatsNFS{ StatVersion: "1.1", }, }}, }, { name: "NFS4.1 device with multiline impl_id OK", s: "device 192.168.0.1:/srv mounted on /mnt/nfs with fstype nfs4 statvers=1.1\nopts: rw,vers=4.1,rsize=131072,wsize=131072,namlen=255,acregmin=3,acregmax=60,acdirmin=30,acdirmax=60,hard,proto=tcp,timeo=600,retrans=2,sec=sys,clientaddr=192.168.0.2,fsc,local_lock=none\nage: 1234567\nimpl_id: name='FreeBSD 11.2-STABLE #0 r325575+c9231c7d6bd(HEAD): Mon Nov 18 22:46:47 UTC 2019\nuser@host:/path/to/something'\n,domain='something.org',date='1293840000,0'", mounts: []Mount{{ Device: "192.168.0.1:/srv", Mount: "/mnt/nfs", Type: "nfs4", Stats: &MountStatsNFS{ StatVersion: "1.1", Opts: map[string]string{"rw": "", "vers": "4.1", "rsize": "131072", "wsize": "131072", "namlen": "255", "acregmin": "3", "acregmax": "60", "acdirmin": "30", "acdirmax": "60", "fsc": "", "hard": "", "proto": "tcp", "timeo": "600", "retrans": "2", "sec": "sys", "clientaddr": "192.168.0.2", "local_lock": "none", }, Age: 1234567 * time.Second, }, }}, }, { name: "fixtures/proc OK", mounts: []Mount{ { Device: "rootfs", Mount: "/", Type: "rootfs", }, { Device: "sysfs", Mount: "/sys", Type: "sysfs", }, { Device: "proc", Mount: "/proc", Type: "proc", }, { Device: "/dev/sda1", Mount: "/", Type: "ext4", }, { Device: "192.168.1.1:/srv/test", Mount: "/mnt/nfs/test", Type: "nfs4", Stats: &MountStatsNFS{ StatVersion: "1.1", Opts: map[string]string{"rw": "", "vers": "4.0", "rsize": "1048576", "wsize": "1048576", "namlen": "255", "acregmin": "3", "acregmax": "60", "acdirmin": "30", "acdirmax": "60", "hard": "", "proto": "tcp", "port": "0", "timeo": "600", "retrans": "2", "sec": "sys", "mountaddr": "192.168.1.1", "clientaddr": "192.168.1.5", "local_lock": "none", }, Age: 13968 time.Second, Bytes: NFSBytesStats{ Read: 1207640230, ReadTotal: 1210214218, ReadPages: 295483, }, Events: NFSEventsStats{ InodeRevalidate: 52, DnodeRevalidate: 226, VFSOpen: 1, VFSLookup: 13, VFSAccess: 398, VFSReadPages: 331, VFSWritePages: 47, VFSFlush: 77, VFSFileRelease: 77, }, Operations: []NFSOperationStats{ { Operation: "NULL", }, { Operation: "READ", Requests: 1298, Transmissions: 1298, BytesSent: 207680, BytesReceived: 1210292152, CumulativeQueueMilliseconds: 6, CumulativeTotalResponseMilliseconds: 79386, CumulativeTotalRequestMilliseconds: 79407, }, { Operation: "WRITE", }, { Operation: "ACCESS", Requests: 2927395007, Transmissions: 2927394995, BytesSent: 526931094212, BytesReceived: 362996810236, CumulativeQueueMilliseconds: 18446743919241604546, CumulativeTotalResponseMilliseconds: 1667369447, CumulativeTotalRequestMilliseconds: 1953587717, }, }, Transport: []NFSTransportStats{ { Protocol: "tcp", Port: 832, Connect: 1, IdleTimeSeconds: 11, Sends: 6428, Receives: 6428, CumulativeActiveRequests: 12154, MaximumRPCSlotsUsed: 24, CumulativeSendingQueue: 26, CumulativePendingQueue: 5726, }, }, }, }, }, }, { name: "NFS xprt over rdma proto", s: `device <nfsserver>:<nfsmount> mounted on <mountpoint> with fstype nfs statvers=1.1 opts: ro,vers=3,rsize=1048576,wsize=1048576,namlen=255,acregmin=120,acregmax=120,acdirmin=120,acdirmax=120,hard,nocto,forcerdirplus,proto=rdma,nconnect=16,port=20049,timeo=600,retrans=2,sec=sys,mountaddr=172.16.40.20,mountvers=3,mountport=0,mountproto=tcp,local_lock=none age: 1270876 caps: caps=0xf,wtmult=4096,dtsize=131072,bsize=0,namlen=255 sec: flavor=1,pseudoflavor=1 events: 512052 36601115 0 68 1498583 16514 38815015 0 41584 2654459933 0 0 0 0 1527715 0 0 1498575 0 0 0 0 0 0 0 0 0 bytes: 3104202770327296 0 0 0 2013200952170479 0 491504202537 0 RPC iostats version: 1.1 p/v: 100003/3 (nfs) xprt: rdma 0 0 5808 62 0 494490723 494490687 36 10032963746 1282789 107150285 1226637531 2673889 135120843409861 135119397156505 266368832 75716996 0 7853 0 0 0 0 119328 1336431717 0 96 per-op statistics NULL: 16 16 0 640 384 320 11 331 0 `, mounts: []Mount{{ Device: "<nfsserver>:<nfsmount>", Mount: "<mountpoint>", Type: "nfs", Stats: &MountStatsNFS{ StatVersion: "1.1", Opts: map[string]string{"acdirmax": "120", "acdirmin": "120", "acregmax": "120", "acregmin": "120", "forcerdirplus": "", "hard": "", "local_lock": "none", "mountaddr": "172.16.40.20", "mountport": "0", "mountproto": "tcp", "mountvers": "3", "namlen": "255", "nconnect": "16", "nocto": "", "port": "20049", "proto": "rdma", "retrans": "2", "ro": "", "rsize": "1048576", "sec": "sys", "timeo": "600", "vers": "3", "wsize": "1048576"}, Age: 1270876 time.Second, Bytes: NFSBytesStats{ Read: 3104202770327296, ReadTotal: 2013200952170479, ReadPages: 491504202537, }, Events: NFSEventsStats{ InodeRevalidate: 512052, DnodeRevalidate: 36601115, AttributeInvalidate: 68, VFSOpen: 1498583, VFSLookup: 16514, VFSAccess: 38815015, VFSReadPage: 41584, VFSReadPages: 2654459933, VFSFlush: 1527715, VFSFileRelease: 1498575, }, Operations: []NFSOperationStats{ { Operation: "NULL", Requests: 16, Transmissions: 16, MajorTimeouts: 0, BytesSent: 640, BytesReceived: 384, CumulativeQueueMilliseconds: 320, CumulativeTotalResponseMilliseconds: 11, CumulativeTotalRequestMilliseconds: 331, Errors: 0, }, }, Transport: []NFSTransportStats{ { Protocol: "rdma", Port: 0, Bind: 0, Connect: 5808, ConnectIdleTime: 62, IdleTimeSeconds: 0, Sends: 494490723, Receives: 494490687, BadTransactionIDs: 36, CumulativeActiveRequests: 10032963746, CumulativeBacklog: 1282789, MaximumRPCSlotsUsed: 0, CumulativeSendingQueue: 0, CumulativePendingQueue: 0, ReadChunkCount: 107150285, WriteChunkCount: 1226637531, ReplyChunkCount: 2673889, TotalRdmaRequest: 135120843409861, PullupCopyCount: 135119397156505, HardwayRegisterCount: 266368832, FailedMarshalCount: 75716996, BadReplyCount: 0, MrsRecovered: 7853, MrsOrphaned: 0, MrsAllocated: 0, EmptySendctxQ: 0, TotalRdmaReply: 0, FixupCopyCount: 119328, ReplyWaitsForSend: 1336431717, LocalInvNeeded: 0, NomsgCallCount: 96, BcallCount: 0, }, }, }, }}, }, } for i, tt := range tests { t.Logf("[%02d] test %q", i, tt.name) var mounts []Mount var err error if tt.s != "" { mounts, err = parseMountStats(strings.NewReader(tt.s)) } else { proc, e := getProcFixtures(t).Proc(26231) if e != nil { t.Fatalf("failed to create proc: %v", err) } mounts, err = proc.MountStats() } if tt.invalid && err == nil { t.Error("expected an error, but none occurred") } if !tt.invalid && err != nil { t.Errorf("unexpected error: %v", err) } if want, have := tt.mounts, mounts; !reflect.DeepEqual(want, have) { t.Errorf("mounts:\nwant:\n%v\nhave:\n%v", mountsStr(want), mountsStr(have)) } } } func mountsStr(mounts []Mount) string { var out string for i, m := range mounts { out += fmt.Sprintf("[%d] %q on %q (%q)", i, m.Device, m.Mount, m.Type) stats, ok := m.Stats.(MountStatsNFS) if !ok { out += "\n" continue } out += fmt.Sprintf("\n\t- opts: %s", stats.Opts) out += fmt.Sprintf("\n\t- v%s, age: %s", stats.StatVersion, stats.Age) out += fmt.Sprintf("\n\t- bytes: %v", stats.Bytes) out += fmt.Sprintf("\n\t- events: %v", stats.Events) out += fmt.Sprintf("\n\t- transport: %v", stats.Transport) out += "\n\t- per-operation stats:" for _, o := range stats.Operations { out += fmt.Sprintf("\n\t\t- %v", o) } out += "\n" } return out } func TestMountStatsExtendedOperationStats(t testing.T) { r := strings.NewReader(extendedOpsExampleMountstats) _, err := parseMountStats(r) if err != nil { t.Errorf("failed to parse mount stats with extended per-op statistics: %v", err) } } const ( extendedOpsExampleMountstats = ` device fs.example.com:/volume4/apps/home-automation/node-red-data mounted on /var/lib/kubelet/pods/1c2215a7-0d92-4df5-83ce-a807bcc2f8c8/volumes/kubernetes.io~nfs/home-automation--node-red-data--pv0001 with fstype nfs4 statvers=1.1 opts: rw,vers=4.1,rsize=131072,wsize=131072,namlen=255,acregmin=3,acregmax=60,acdirmin=30,acdirmax=60,hard,proto=tcp,timeo=600,retrans=2,sec=sys,clientaddr=192.168.1.191,local_lock=none age: 83520 impl_id: name='',domain='',date='0,0' caps: caps=0x3fff7,wtmult=512,dtsize=32768,bsize=0,namlen=255 nfsv4: bm0=0xfdffafff,bm1=0xf9be3e,bm2=0x800,acl=0x0,sessions,pnfs=not configured,lease_time=90,lease_expired=0 sec: flavor=1,pseudoflavor=1 events: 52472 472680 16671 57552 2104 9565 749555 9568641 168 24103 1 267134 3350 20097 116581 18214 43757 111141 0 28 9563845 34 0 0 0 0 0 bytes: 2021340783 39056395530 0 0 1788561151 39087991255 442605 9557343 RPC iostats version: 1.1 p/v: 100003/4 (nfs) xprt: tcp 940 0 2 0 1 938505 938504 0 12756069 0 32 254729 10823602 per-op statistics NULL: 1 1 0 44 24 0 0 0 0 READ: 34096 34096 0 7103096 1792122744 2272 464840 467945 0 WRITE: 322308 322308 0 39161277084 56725504 401718334 10139998 411864389 0 COMMIT: 12541 12541 0 2709896 1304264 342 7179 7819 0 OPEN: 12637 12637 0 3923256 4659940 871 57185 58251 394 OPEN_CONFIRM: 0 0 0 0 0 0 0 0 0 OPEN_NOATTR: 98741 98741 0 25656212 31630800 3366 77710 82693 0 OPEN_DOWNGRADE: 0 0 0 0 0 0 0 0 0 CLOSE: 87075 87075 0 18778608 15308496 2026 49131 52399 116 SETATTR: 24576 24576 0 5825876 6522260 643 34384 35650 0 FSINFO: 1 1 0 168 152 0 0 0 0 RENEW: 0 0 0 0 0 0 0 0 0 SETCLIENTID: 0 0 0 0 0 0 0 0 0 SETCLIENTID_CONFIRM: 0 0 0 0 0 0 0 0 0 LOCK: 22512 22512 0 5417628 2521312 1088 17407 18794 2 LOCKT: 0 0 0 0 0 0 0 0 0 LOCKU: 21247 21247 0 4589352 2379664 315 8409 9003 0 ACCESS: 1466 1466 0 298160 246288 22 1394 1492 0 GETATTR: 52480 52480 0 10015464 12694076 2930 30069 34502 0 LOOKUP: 11727 11727 0 2518200 2886376 272 16935 17662 3546 LOOKUP_ROOT: 0 0 0 0 0 0 0 0 0 REMOVE: 833 833 0 172236 95268 15 4566 4617 68 RENAME: 11431 11431 0 3150708 1737512 211 52649 53091 0 LINK: 1 1 0 288 292 0 0 0 0 SYMLINK: 0 0 0 0 0 0 0 0 0 CREATE: 77 77 0 18292 23496 0 363 371 11 PATHCONF: 1 1 0 164 116 0 0 0 0 STATFS: 7420 7420 0 1394960 1187200 144 4672 4975 0 READLINK: 4 4 0 704 488 0 1 1 0 READDIR: 1353 1353 0 304024 2902928 11 4326 4411 0 SERVER_CAPS: 9 9 0 1548 1476 0 3 3 0 DELEGRETURN: 232 232 0 48896 37120 811 300 1115 0 GETACL: 0 0 0 0 0 0 0 0 0 SETACL: 0 0 0 0 0 0 0 0 0 FS_LOCATIONS: 0 0 0 0 0 0 0 0 0 RELEASE_LOCKOWNER: 0 0 0 0 0 0 0 0 0 SECINFO: 0 0 0 0 0 0 0 0 0 FSID_PRESENT: 0 0 0 0 0 0 0 0 0 EXCHANGE_ID: 2 2 0 464 200 0 0 0 0 CREATE_SESSION: 1 1 0 192 124 0 0 0 0 DESTROY_SESSION: 0 0 0 0 0 0 0 0 0 SEQUENCE: 0 0 0 0 0 0 0 0 0 GET_LEASE_TIME: 0 0 0 0 0 0 0 0 0 RECLAIM_COMPLETE: 1 1 0 124 88 0 81 81 0 LAYOUTGET: 0 0 0 0 0 0 0 0 0 GETDEVICEINFO: 0 0 0 0 0 0 0 0 0 LAYOUTCOMMIT: 0 0 0 0 0 0 0 0 0 LAYOUTRETURN: 0 0 0 0 0 0 0 0 0 SECINFO_NO_NAME: 0 0 0 0 0 0 0 0 0 TEST_STATEID: 0 0 0 0 0 0 0 0 0 FREE_STATEID: 10413 10413 0 1416168 916344 147 3518 3871 10413 GETDEVICELIST: 0 0 0 0 0 0 0 0 0 BIND_CONN_TO_SESSION: 0 0 0 0 0 0 0 0 0 DESTROY_CLIENTID: 0 0 0 0 0 0 0 0 0 SEEK: 0 0 0 0 0 0 0 0 0 ALLOCATE: 0 0 0 0 0 0 0 0 0 DEALLOCATE: 0 0 0 0 0 0 0 0 0 LAYOUTSTATS: 0 0 0 0 0 0 0 0 0 CLONE: 0 0 0 0 0 0 0 0 0 COPY: 0 0 0 0 0 0 0 0 0 OFFLOAD_CANCEL: 0 0 0 0 0 0 0 0 0 LOOKUPP: 0 0 0 0 0 0 0 0 0 LAYOUTERROR: 0 0 0 0 0 0 0 0 0 ` extendedRDMAExampleALLMountstats = `device <nfsserver>:<nfsmount> mounted on <mountpoint> with fstype nfs statvers=1.1 opts: ro,vers=3,rsize=1048576,wsize=1048576,namlen=255,acregmin=120,acregmax=120,acdirmin=120,acdirmax=120,hard,nocto,forcerdirplus,proto=rdma,nconnect=16,port=20049,timeo=600,retrans=2,sec=sys,mountaddr=172.16.40.20,mountvers=3,mountport=0,mountproto=tcp,local_lock=none age: 1270876 caps: caps=0xf,wtmult=4096,dtsize=131072,bsize=0,namlen=255 sec: flavor=1,pseudoflavor=1 events: 512052 36601115 0 68 1498583 16514 38815015 0 41584 2654459933 0 0 0 0 1527715 0 0 1498575 0 0 0 0 0 0 0 0 0 bytes: 3104202770327296 0 0 0 2013200952170479 0 491504202537 0 RPC iostats version: 1.1 p/v: 100003/3 (nfs) xprt: rdma 0 0 5808 62 0 494490723 494490687 36 10032963746 1282789 107150285 1226637531 2673889 135120843409861 135119397156505 266368832 75716996 0 7853 0 0 0 0 119328 1336431717 0 96 xprt: rdma 0 0 14094 145 0 492392334 492392307 27 7078693624 2509627 105561370 1280878332 2659446 142218924010291 142217463504063 276368040 94761838 0 7610 0 0 0 0 207977 1389069860 0 103 xprt: rdma 0 0 16107 156 0 522755125 522755092 33 9119562599 1147699 109077860 1491898147 2566003 167152062826463 167149287506014 284931680 83011025 0 6229 0 0 0 0 221408 1603518232 0 82 xprt: rdma 0 0 7808 82 0 441542046 441542010 36 7226132207 2519174 111096004 955223347 2676765 105741904708009 105740125663595 275613584 80373159 0 8893 0 0 0 0 149479 1068962768 0 76 xprt: rdma 0 0 15018 167 0 508091827 508091764 63 19817677255 36702583 108265928 1258185459 2438516 138247436686102 138246196289594 270162080 74962306 0 13328 0 0 0 0 268433 1368837472 0 66 xprt: rdma 0 0 14321 149 0 530246310 530246275 35 9723190432 2392024 111099700 1494204555 2589805 166691166581904 166689567426908 289995492 85067377 0 8010 0 0 0 0 214511 1607864447 0 100 xprt: rdma 0 0 7863 84 0 459019689 459019642 47 11809253102 1716688 111825219 1032758664 2564226 114416685286438 114414936423706 290494252 73702102 0 6927 0 0 0 0 134453 1147121864 0 79 xprt: rdma 0 0 7702 84 3 497598986 497598931 55 11816221496 3924722 106922130 1382063307 2506108 153967067193941 153965665472218 286222584 84094006 0 5875 0 0 0 0 127347 1491469045 0 66 xprt: rdma 0 0 18341 202 0 477721151 477721073 78 15204400959 40562626 106645745 1291616653 3091375 144533696686651 144529688231163 278135800 73821525 0 6795 0 0 0 0 251097 1401327563 0 64 xprt: rdma 0 0 8228 90 4 453155092 453155063 29 7884786894 1591225 112197590 1026006338 2742688 114591819605673 114590175821191 275541944 85857259 0 7487 0 0 0 0 143044 1140917892 0 76 xprt: rdma 0 0 7843 83 0 446480377 446480324 53 12267986428 2958997 111971246 963162784 2693433 107176282309753 107174637802555 290269096 101100410 0 7825 0 0 0 0 141735 1077797328 0 83 xprt: rdma 0 0 7582 86 0 423315608 423315567 41 10197484604 2076993 109207538 785978455 2650354 86090211449474 86088475571312 279912524 87676008 0 7491 0 0 0 0 137533 897807641 0 101 xprt: rdma 0 0 7767 84 0 482538465 482538424 41 8935200479 1344778 112200583 1192341640 2644896 132860698423762 132858881459050 273354060 75337030 0 5941 0 0 0 0 127842 1307164736 0 97 xprt: rdma 0 0 14526 148 2 537745063 537745007 56 20756072620 3970332320 109539564 1363647371 2503250 148793734936250 148791264145401 291888720 90344151 0 7471 0 0 0 0 211057 1475661285 0 82 xprt: rdma 0 0 14300 151 0 495357347 495357316 31 8703101643 1451809 112315311 1303804607 2620502 145680743007170 145678880292235 288046696 98018259 0 7241 0 0 0 0 209396 1418712657 0 139 xprt: rdma 0 0 7700 82 0 466611083 466611050 33 8540498291 4082864 114740300 1059770596 2523155 117376668239921 117375375683167 260927576 78437075 0 6691 0 0 0 0 130878 1177008175 1 76 per-op statistics NULL: 16 16 0 640 384 320 11 331 0 GETATTR: 512052 512052 0 79823516 57349824 107131 612667 751847 0 SETATTR: 0 0 0 0 0 0 0 0 0 LOOKUP: 16713 16713 0 3040536 3706344 560 17488 20232 346 ACCESS: 211705 211705 0 33860920 25404600 37059 229754 283822 0 READLINK: 0 0 0 0 0 0 0 0 0 READ: 2654501510 2654501510 0 445911966900 2013540728551504 6347457114 31407021389 37927280438 0 WRITE: 0 0 0 0 0 0 0 0 0 CREATE: 0 0 0 0 0 0 0 0 0 MKDIR: 0 0 0 0 0 0 0 0 0 SYMLINK: 0 0 0 0 0 0 0 0 0 MKNOD: 0 0 0 0 0 0 0 0 0 REMOVE: 0 0 0 0 0 0 0 0 0 RMDIR: 0 0 0 0 0 0 0 0 0 RENAME: 0 0 0 0 0 0 0 0 0 LINK: 0 0 0 0 0 0 0 0 0 READDIR: 0 0 0 0 0 0 0 0 0 READDIRPLUS: 0 0 0 0 0 0 0 0 0 FSSTAT: 56356 56356 0 6243572 9467808 82068 74356 159001 0 FSINFO: 2 2 0 184 328 0 0 0 0 PATHCONF: 1 1 0 92 140 0 0 0 0 COMMIT: 0 0 0 0 0 0 0 0 0 ` ) func TestMountStatsExtendedRDMAStats(t *testing.T) { r := strings.NewReader(extendedRDMAExampleALLMountstats) _, err := parseMountStats(r) if err != nil { t.Errorf("failed to parse mount stats with extended RDMA statistics: %v", err) } }	26.23 KB	2025-05-25 12:27
📄 net_conntrackstat.go // Copyright 2020 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "bufio" "bytes" "fmt" "io" "strings" "github.com/prometheus/procfs/internal/util" ) // A ConntrackStatEntry represents one line from net/stat/nf_conntrack // and contains netfilter conntrack statistics at one CPU core. type ConntrackStatEntry struct { Entries uint64 Searched uint64 Found uint64 New uint64 Invalid uint64 Ignore uint64 Delete uint64 DeleteList uint64 Insert uint64 InsertFailed uint64 Drop uint64 EarlyDrop uint64 SearchRestart uint64 } // ConntrackStat retrieves netfilter's conntrack statistics, split by CPU cores. func (fs FS) ConntrackStat() ([]ConntrackStatEntry, error) { return readConntrackStat(fs.proc.Path("net", "stat", "nf_conntrack")) } // Parses a slice of ConntrackStatEntries from the given filepath. func readConntrackStat(path string) ([]ConntrackStatEntry, error) { // This file is small and can be read with one syscall. b, err := util.ReadFileNoStat(path) if err != nil { // Do not wrap this error so the caller can detect os.IsNotExist and // similar conditions. return nil, err } stat, err := parseConntrackStat(bytes.NewReader(b)) if err != nil { return nil, fmt.Errorf("%w: Cannot read file: %v: %w", ErrFileRead, path, err) } return stat, nil } // Reads the contents of a conntrack statistics file and parses a slice of ConntrackStatEntries. func parseConntrackStat(r io.Reader) ([]ConntrackStatEntry, error) { var entries []ConntrackStatEntry scanner := bufio.NewScanner(r) scanner.Scan() for scanner.Scan() { fields := strings.Fields(scanner.Text()) conntrackEntry, err := parseConntrackStatEntry(fields) if err != nil { return nil, err } entries = append(entries, conntrackEntry) } return entries, nil } // Parses a ConntrackStatEntry from given array of fields. func parseConntrackStatEntry(fields []string) (ConntrackStatEntry, error) { entries, err := util.ParseHexUint64s(fields) if err != nil { return nil, fmt.Errorf("%w: Cannot parse entry: %d: %w", ErrFileParse, entries, err) } numEntries := len(entries) if numEntries < 16 \|\| numEntries > 17 { return nil, fmt.Errorf("%w: invalid conntrackstat entry, invalid number of fields: %d", ErrFileParse, numEntries) } stats := &ConntrackStatEntry{ Entries: entries[0], Searched: entries[1], Found: entries[2], New: entries[3], Invalid: entries[4], Ignore: entries[5], Delete: entries[6], DeleteList: entries[7], Insert: entries[8], InsertFailed: entries[9], Drop: entries[10], EarlyDrop: entries[11], } // Ignore missing search_restart on Linux < 2.6.35. if numEntries == 17 { stats.SearchRestart = *entries[16] } return stats, nil }	3.33 KB	2025-05-25 12:27
📄 net_conntrackstat_test.go // Copyright 2020 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "bytes" "reflect" "testing" ) func TestParseConntrackStat(t testing.T) { var nfConntrackStat = []byte(`entries searched found new invalid ignore delete delete_list insert insert_failed drop early_drop icmp_error expect_new expect_create expect_delete search_restart 00000021 00000000 00000000 00000000 00000003 0000588a 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000021 00000000 00000000 00000000 00000002 000056a4 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000002 00000021 00000000 00000000 00000000 00000001 000058d4 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000001 00000021 00000000 00000000 00000000 0000002f 00005688 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000004 `) r := bytes.NewReader(nfConntrackStat) have, err := parseConntrackStat(r) if err != nil { t.Fatal(err) } want := []ConntrackStatEntry{ ConntrackStatEntry{ Entries: 33, Found: 0, Invalid: 3, Ignore: 22666, Insert: 0, InsertFailed: 0, Drop: 0, EarlyDrop: 0, SearchRestart: 0, }, ConntrackStatEntry{ Entries: 33, Found: 0, Invalid: 2, Ignore: 22180, Insert: 0, InsertFailed: 0, Drop: 0, EarlyDrop: 0, SearchRestart: 2, }, ConntrackStatEntry{ Entries: 33, Found: 0, Invalid: 1, Ignore: 22740, Insert: 0, InsertFailed: 0, Drop: 0, EarlyDrop: 0, SearchRestart: 1, }, ConntrackStatEntry{ Entries: 33, Found: 0, Invalid: 47, Ignore: 22152, Insert: 0, InsertFailed: 0, Drop: 0, EarlyDrop: 0, SearchRestart: 4, }, } if !reflect.DeepEqual(want, have) { t.Errorf("want %v, have %v", want, have) } } func TestParseOldConntrackStat(t testing.T) { var nfConntrackStat = []byte(`entries searched found new invalid ignore delete delete_list insert insert_failed drop early_drop icmp_error expect_new expect_create expect_delete 0000002b 0003159f 02e6786a 00142562 0001bf93 00e1a051 00142537 000b8fe0 000b900b 00000000 00000000 00000000 0001b46a 00000000 00000000 00000000 `) r := bytes.NewReader(nfConntrackStat) have, err := parseConntrackStat(r) if err != nil { t.Fatal(err) } want := []ConntrackStatEntry{ ConntrackStatEntry{ Entries: 43, Searched: 202143, Found: 48658538, New: 1320290, Invalid: 114579, Ignore: 14786641, Delete: 1320247, DeleteList: 757728, Insert: 757771, InsertFailed: 0, Drop: 0, EarlyDrop: 0, SearchRestart: 0, }, } if !reflect.DeepEqual(want, have) { t.Errorf("want %v, have %v", want, have) } }	3.5 KB	2025-05-25 12:27
📄 net_dev.go // Copyright 2018 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "bufio" "errors" "os" "sort" "strconv" "strings" ) // NetDevLine is single line parsed from /proc/net/dev or /proc/[pid]/net/dev. type NetDevLine struct { Name string `json:"name"` // The name of the interface. RxBytes uint64 `json:"rx_bytes"` // Cumulative count of bytes received. RxPackets uint64 `json:"rx_packets"` // Cumulative count of packets received. RxErrors uint64 `json:"rx_errors"` // Cumulative count of receive errors encountered. RxDropped uint64 `json:"rx_dropped"` // Cumulative count of packets dropped while receiving. RxFIFO uint64 `json:"rx_fifo"` // Cumulative count of FIFO buffer errors. RxFrame uint64 `json:"rx_frame"` // Cumulative count of packet framing errors. RxCompressed uint64 `json:"rx_compressed"` // Cumulative count of compressed packets received by the device driver. RxMulticast uint64 `json:"rx_multicast"` // Cumulative count of multicast frames received by the device driver. TxBytes uint64 `json:"tx_bytes"` // Cumulative count of bytes transmitted. TxPackets uint64 `json:"tx_packets"` // Cumulative count of packets transmitted. TxErrors uint64 `json:"tx_errors"` // Cumulative count of transmit errors encountered. TxDropped uint64 `json:"tx_dropped"` // Cumulative count of packets dropped while transmitting. TxFIFO uint64 `json:"tx_fifo"` // Cumulative count of FIFO buffer errors. TxCollisions uint64 `json:"tx_collisions"` // Cumulative count of collisions detected on the interface. TxCarrier uint64 `json:"tx_carrier"` // Cumulative count of carrier losses detected by the device driver. TxCompressed uint64 `json:"tx_compressed"` // Cumulative count of compressed packets transmitted by the device driver. } // NetDev is parsed from /proc/net/dev or /proc/[pid]/net/dev. The map keys // are interface names. type NetDev map[string]NetDevLine // NetDev returns kernel/system statistics read from /proc/net/dev. func (fs FS) NetDev() (NetDev, error) { return newNetDev(fs.proc.Path("net/dev")) } // NetDev returns kernel/system statistics read from /proc/[pid]/net/dev. func (p Proc) NetDev() (NetDev, error) { return newNetDev(p.path("net/dev")) } // newNetDev creates a new NetDev from the contents of the given file. func newNetDev(file string) (NetDev, error) { f, err := os.Open(file) if err != nil { return NetDev{}, err } defer f.Close() netDev := NetDev{} s := bufio.NewScanner(f) for n := 0; s.Scan(); n++ { // Skip the 2 header lines. if n < 2 { continue } line, err := netDev.parseLine(s.Text()) if err != nil { return netDev, err } netDev[line.Name] = line } return netDev, s.Err() } // parseLine parses a single line from the /proc/net/dev file. Header lines // must be filtered prior to calling this method. func (netDev NetDev) parseLine(rawLine string) (NetDevLine, error) { idx := strings.LastIndex(rawLine, ":") if idx == -1 { return nil, errors.New("invalid net/dev line, missing colon") } fields := strings.Fields(strings.TrimSpace(rawLine[idx+1:])) var err error line := &NetDevLine{} // Interface Name line.Name = strings.TrimSpace(rawLine[:idx]) if line.Name == "" { return nil, errors.New("invalid net/dev line, empty interface name") } // RX line.RxBytes, err = strconv.ParseUint(fields[0], 10, 64) if err != nil { return nil, err } line.RxPackets, err = strconv.ParseUint(fields[1], 10, 64) if err != nil { return nil, err } line.RxErrors, err = strconv.ParseUint(fields[2], 10, 64) if err != nil { return nil, err } line.RxDropped, err = strconv.ParseUint(fields[3], 10, 64) if err != nil { return nil, err } line.RxFIFO, err = strconv.ParseUint(fields[4], 10, 64) if err != nil { return nil, err } line.RxFrame, err = strconv.ParseUint(fields[5], 10, 64) if err != nil { return nil, err } line.RxCompressed, err = strconv.ParseUint(fields[6], 10, 64) if err != nil { return nil, err } line.RxMulticast, err = strconv.ParseUint(fields[7], 10, 64) if err != nil { return nil, err } // TX line.TxBytes, err = strconv.ParseUint(fields[8], 10, 64) if err != nil { return nil, err } line.TxPackets, err = strconv.ParseUint(fields[9], 10, 64) if err != nil { return nil, err } line.TxErrors, err = strconv.ParseUint(fields[10], 10, 64) if err != nil { return nil, err } line.TxDropped, err = strconv.ParseUint(fields[11], 10, 64) if err != nil { return nil, err } line.TxFIFO, err = strconv.ParseUint(fields[12], 10, 64) if err != nil { return nil, err } line.TxCollisions, err = strconv.ParseUint(fields[13], 10, 64) if err != nil { return nil, err } line.TxCarrier, err = strconv.ParseUint(fields[14], 10, 64) if err != nil { return nil, err } line.TxCompressed, err = strconv.ParseUint(fields[15], 10, 64) if err != nil { return nil, err } return line, nil } // Total aggregates the values across interfaces and returns a new NetDevLine. // The Name field will be a sorted comma separated list of interface names. func (netDev NetDev) Total() NetDevLine { total := NetDevLine{} names := make([]string, 0, len(netDev)) for _, ifc := range netDev { names = append(names, ifc.Name) total.RxBytes += ifc.RxBytes total.RxPackets += ifc.RxPackets total.RxErrors += ifc.RxErrors total.RxDropped += ifc.RxDropped total.RxFIFO += ifc.RxFIFO total.RxFrame += ifc.RxFrame total.RxCompressed += ifc.RxCompressed total.RxMulticast += ifc.RxMulticast total.TxBytes += ifc.TxBytes total.TxPackets += ifc.TxPackets total.TxErrors += ifc.TxErrors total.TxDropped += ifc.TxDropped total.TxFIFO += ifc.TxFIFO total.TxCollisions += ifc.TxCollisions total.TxCarrier += ifc.TxCarrier total.TxCompressed += ifc.TxCompressed } sort.Strings(names) total.Name = strings.Join(names, ", ") return total }	6.35 KB	2025-05-25 12:27
📄 net_dev_test.go // Copyright 2018 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "fmt" "testing" ) func TestNetDevParseLine(t testing.T) { tc := []string{"eth0", "eth0:1"} for i := range tc { rawLine := fmt.Sprintf(` %v: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16`, tc[i]) have, err := NetDev{}.parseLine(rawLine) if err != nil { t.Fatal(err) } want := NetDevLine{tc[i], 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16} if want != have { t.Errorf("want %v, have %v", want, have) } } } func TestNetDev(t testing.T) { fs, err := NewFS(procTestFixtures) if err != nil { t.Fatal(err) } netDev, err := fs.NetDev() if err != nil { t.Fatal(err) } lines := map[string]NetDevLine{ "vethf345468": {Name: "vethf345468", RxBytes: 648, RxPackets: 8, TxBytes: 438, TxPackets: 5}, "lo": {Name: "lo", RxBytes: 1664039048, RxPackets: 1566805, TxBytes: 1664039048, TxPackets: 1566805}, "docker0": {Name: "docker0", RxBytes: 2568, RxPackets: 38, TxBytes: 438, TxPackets: 5}, "eth0": {Name: "eth0", RxBytes: 874354587, RxPackets: 1036395, TxBytes: 563352563, TxPackets: 732147}, } if want, have := len(lines), len(netDev); want != have { t.Errorf("want %d parsed net/dev lines, have %d", want, have) } for _, line := range netDev { if want, have := lines[line.Name], line; want != have { t.Errorf("%s: want %v, have %v", line.Name, want, have) } } } func TestProcNetDev(t testing.T) { p, err := getProcFixtures(t).Proc(26231) if err != nil { t.Fatal(err) } netDev, err := p.NetDev() if err != nil { t.Fatal(err) } lines := map[string]NetDevLine{ "lo": {Name: "lo"}, "eth0": {Name: "eth0", RxBytes: 438, RxPackets: 5, TxBytes: 648, TxPackets: 8}, } if want, have := len(lines), len(netDev); want != have { t.Errorf("want %d parsed net/dev lines, have %d", want, have) } for _, line := range netDev { if want, have := lines[line.Name], line; want != have { t.Errorf("%s: want %v, have %v", line.Name, want, have) } } }	2.55 KB	2025-05-25 12:27
📄 net_ip_socket.go // Copyright 2020 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "bufio" "encoding/hex" "fmt" "io" "net" "os" "strconv" "strings" ) const ( // readLimit is used by io.LimitReader while reading the content of the // /proc/net/udp{,6} files. The number of lines inside such a file is dynamic // as each line represents a single used socket. // In theory, the number of available sockets is 65535 (2^16 - 1) per IP. // With e.g. 150 Byte per line and the maximum number of 65535, // the reader needs to handle 150 Byte * 65535 =~ 10 MB for a single IP. readLimit = 4294967296 // Byte -> 4 GiB ) // This contains generic data structures for both udp and tcp sockets. type ( // NetIPSocket represents the contents of /proc/net/{t,u}dp{,6} file without the header. NetIPSocket []netIPSocketLine // NetIPSocketSummary provides already computed values like the total queue lengths or // the total number of used sockets. In contrast to NetIPSocket it does not collect // the parsed lines into a slice. NetIPSocketSummary struct { // TxQueueLength shows the total queue length of all parsed tx_queue lengths. TxQueueLength uint64 // RxQueueLength shows the total queue length of all parsed rx_queue lengths. RxQueueLength uint64 // UsedSockets shows the total number of parsed lines representing the // number of used sockets. UsedSockets uint64 // Drops shows the total number of dropped packets of all UPD sockets. Drops uint64 } // netIPSocketLine represents the fields parsed from a single line // in /proc/net/{t,u}dp{,6}. Fields which are not used by IPSocket are skipped. // Drops is non-nil for udp{,6}, but nil for tcp{,6}. // For the proc file format details, see https://linux.die.net/man/5/proc. netIPSocketLine struct { Sl uint64 LocalAddr net.IP LocalPort uint64 RemAddr net.IP RemPort uint64 St uint64 TxQueue uint64 RxQueue uint64 UID uint64 Inode uint64 Drops uint64 } ) func newNetIPSocket(file string) (NetIPSocket, error) { f, err := os.Open(file) if err != nil { return nil, err } defer f.Close() var netIPSocket NetIPSocket isUDP := strings.Contains(file, "udp") lr := io.LimitReader(f, readLimit) s := bufio.NewScanner(lr) s.Scan() // skip first line with headers for s.Scan() { fields := strings.Fields(s.Text()) line, err := parseNetIPSocketLine(fields, isUDP) if err != nil { return nil, err } netIPSocket = append(netIPSocket, line) } if err := s.Err(); err != nil { return nil, err } return netIPSocket, nil } // newNetIPSocketSummary creates a new NetIPSocket{,6} from the contents of the given file. func newNetIPSocketSummary(file string) (NetIPSocketSummary, error) { f, err := os.Open(file) if err != nil { return nil, err } defer f.Close() var netIPSocketSummary NetIPSocketSummary var udpPacketDrops uint64 isUDP := strings.Contains(file, "udp") lr := io.LimitReader(f, readLimit) s := bufio.NewScanner(lr) s.Scan() // skip first line with headers for s.Scan() { fields := strings.Fields(s.Text()) line, err := parseNetIPSocketLine(fields, isUDP) if err != nil { return nil, err } netIPSocketSummary.TxQueueLength += line.TxQueue netIPSocketSummary.RxQueueLength += line.RxQueue netIPSocketSummary.UsedSockets++ if isUDP { udpPacketDrops += line.Drops netIPSocketSummary.Drops = &udpPacketDrops } } if err := s.Err(); err != nil { return nil, err } return &netIPSocketSummary, nil } // the /proc/net/{t,u}dp{,6} files are network byte order for ipv4 and for ipv6 the address is four words consisting of four bytes each. In each of those four words the four bytes are written in reverse order. func parseIP(hexIP string) (net.IP, error) { var byteIP []byte byteIP, err := hex.DecodeString(hexIP) if err != nil { return nil, fmt.Errorf("%w: Cannot parse socket field in %q: %w", ErrFileParse, hexIP, err) } switch len(byteIP) { case 4: return net.IP{byteIP[3], byteIP[2], byteIP[1], byteIP[0]}, nil case 16: i := net.IP{ byteIP[3], byteIP[2], byteIP[1], byteIP[0], byteIP[7], byteIP[6], byteIP[5], byteIP[4], byteIP[11], byteIP[10], byteIP[9], byteIP[8], byteIP[15], byteIP[14], byteIP[13], byteIP[12], } return i, nil default: return nil, fmt.Errorf("%w: Unable to parse IP %s: %v", ErrFileParse, hexIP, nil) } } // parseNetIPSocketLine parses a single line, represented by a list of fields. func parseNetIPSocketLine(fields []string, isUDP bool) (netIPSocketLine, error) { line := &netIPSocketLine{} if len(fields) < 10 { return nil, fmt.Errorf( "%w: Less than 10 columns found %q", ErrFileParse, strings.Join(fields, " "), ) } var err error // parse error // sl s := strings.Split(fields[0], ":") if len(s) != 2 { return nil, fmt.Errorf("%w: Unable to parse sl field in line %q", ErrFileParse, fields[0]) } if line.Sl, err = strconv.ParseUint(s[0], 0, 64); err != nil { return nil, fmt.Errorf("%w: Unable to parse sl field in %q: %w", ErrFileParse, line.Sl, err) } // local_address l := strings.Split(fields[1], ":") if len(l) != 2 { return nil, fmt.Errorf("%w: Unable to parse local_address field in %q", ErrFileParse, fields[1]) } if line.LocalAddr, err = parseIP(l[0]); err != nil { return nil, err } if line.LocalPort, err = strconv.ParseUint(l[1], 16, 64); err != nil { return nil, fmt.Errorf("%w: Unable to parse local_address port value line %q: %w", ErrFileParse, line.LocalPort, err) } // remote_address r := strings.Split(fields[2], ":") if len(r) != 2 { return nil, fmt.Errorf("%w: Unable to parse rem_address field in %q", ErrFileParse, fields[1]) } if line.RemAddr, err = parseIP(r[0]); err != nil { return nil, err } if line.RemPort, err = strconv.ParseUint(r[1], 16, 64); err != nil { return nil, fmt.Errorf("%w: Cannot parse rem_address port value in %q: %w", ErrFileParse, line.RemPort, err) } // st if line.St, err = strconv.ParseUint(fields[3], 16, 64); err != nil { return nil, fmt.Errorf("%w: Cannot parse st value in %q: %w", ErrFileParse, line.St, err) } // tx_queue and rx_queue q := strings.Split(fields[4], ":") if len(q) != 2 { return nil, fmt.Errorf( "%w: Missing colon for tx/rx queues in socket line %q", ErrFileParse, fields[4], ) } if line.TxQueue, err = strconv.ParseUint(q[0], 16, 64); err != nil { return nil, fmt.Errorf("%w: Cannot parse tx_queue value in %q: %w", ErrFileParse, line.TxQueue, err) } if line.RxQueue, err = strconv.ParseUint(q[1], 16, 64); err != nil { return nil, fmt.Errorf("%w: Cannot parse trx_queue value in %q: %w", ErrFileParse, line.RxQueue, err) } // uid if line.UID, err = strconv.ParseUint(fields[7], 0, 64); err != nil { return nil, fmt.Errorf("%w: Cannot parse UID value in %q: %w", ErrFileParse, line.UID, err) } // inode if line.Inode, err = strconv.ParseUint(fields[9], 0, 64); err != nil { return nil, fmt.Errorf("%w: Cannot parse inode value in %q: %w", ErrFileParse, line.Inode, err) } // drops if isUDP { drops, err := strconv.ParseUint(fields[12], 0, 64) if err != nil { return nil, fmt.Errorf("%w: Cannot parse drops value in %q: %w", ErrFileParse, drops, err) } line.Drops = &drops } return line, nil }	7.63 KB	2025-05-25 12:27
📄 net_ip_socket_test.go // Copyright 2020 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "net" "reflect" "testing" ) func Test_parseNetIPSocketLine(t testing.T) { tests := []struct { fields []string name string want netIPSocketLine wantErr bool isUDP bool }{ { name: "reading valid lines, no issue should happened", fields: []string{"11:", "00000000:0000", "00000000:0000", "0A", "00000017:0000002A", "0:0", "0", "1000", "0", "39309"}, want: &netIPSocketLine{ Sl: 11, LocalAddr: net.IP{0, 0, 0, 0}, LocalPort: 0, RemAddr: net.IP{0, 0, 0, 0}, RemPort: 0, St: 10, TxQueue: 23, RxQueue: 42, UID: 1000, Inode: 39309, }, }, { name: "error case - invalid line - number of fields/columns < 10", fields: []string{"1:", "00000000:0000", "00000000:0000", "07", "0:0", "0", "0"}, want: nil, wantErr: true, }, { name: "error case - parse sl - not a valid uint", fields: []string{"a:", "00000000:0000", "00000000:0000", "07", "00000000:00000001", "0:0", "0", "0", "0", "39309"}, want: nil, wantErr: true, }, { name: "error case - parse local_address - not a valid hex", fields: []string{"1:", "0000000O:0000", "00000000:0000", "07", "00000000:00000001", "0:0", "0", "0", "0", "39309"}, want: nil, wantErr: true, }, { name: "error case - parse rem_address - not a valid hex", fields: []string{"1:", "00000000:0000", "0000000O:0000", "07", "00000000:00000001", "0:0", "0", "0", "0", "39309"}, want: nil, wantErr: true, }, { name: "error case - cannot parse line - missing colon", fields: []string{"1:", "00000000:0000", "00000000:0000", "07", "0000000000000001", "0:0", "0", "0", "0", "39309"}, want: nil, wantErr: true, }, { name: "error case - parse tx_queue - not a valid hex", fields: []string{"1:", "00000000:0000", "00000000:0000", "07", "DEADCODE:00000001", "0:0", "0", "0", "0", "39309"}, want: nil, wantErr: true, }, { name: "error case - parse rx_queue - not a valid hex", fields: []string{"1:", "00000000:0000", "00000000:0000", "07", "00000000:FEEDCODE", "0:0", "0", "0", "0", "39309"}, want: nil, wantErr: true, }, { name: "error case - parse UID - not a valid uint", fields: []string{"1:", "00000000:0000", "00000000:0000", "07", "00000000:00000001", "0:0", "0", "-10", "0", "39309"}, want: nil, wantErr: true, }, { name: "error case - parse Inode - not a valid uint", fields: []string{"1:", "00000000:0000", "00000000:0000", "07", "00000000:00000001", "0:0", "0", "-10", "0", "-39309"}, want: nil, wantErr: true, }, { name: "error case - parse Drops - not a valid uint", fields: []string{"1:", "00000000:0000", "00000000:0000", "07", "00000000:00000001", "0:0", "0", "10", "0", "39309", "2", "000000009bd60d72", "-5"}, want: nil, wantErr: true, isUDP: true, }, } for _, tt := range tests { t.Run(tt.name, func(t *testing.T) { got, err := parseNetIPSocketLine(tt.fields, tt.isUDP) if (err != nil) != tt.wantErr { t.Errorf("parseNetIPSocketLine() error = %v, wantErr %v", err, tt.wantErr) return } if tt.want == nil && got != nil { t.Errorf("parseNetIPSocketLine() = %v, want %v", got, tt.want) } if !reflect.DeepEqual(got, tt.want) { t.Errorf("parseNetIPSocketLine() = %#v, want %#v", got, tt.want) } }) } }	3.94 KB	2025-05-25 12:27
📄 net_protocols.go // Copyright 2020 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "bufio" "bytes" "fmt" "strconv" "strings" "github.com/prometheus/procfs/internal/util" ) // NetProtocolStats stores the contents from /proc/net/protocols. type NetProtocolStats map[string]NetProtocolStatLine // NetProtocolStatLine contains a single line parsed from /proc/net/protocols. We // only care about the first six columns as the rest are not likely to change // and only serve to provide a set of capabilities for each protocol. type NetProtocolStatLine struct { Name string // 0 The name of the protocol Size uint64 // 1 The size, in bytes, of a given protocol structure. e.g. sizeof(struct tcp_sock) or sizeof(struct unix_sock) Sockets int64 // 2 Number of sockets in use by this protocol Memory int64 // 3 Number of 4KB pages allocated by all sockets of this protocol Pressure int // 4 This is either yes, no, or NI (not implemented). For the sake of simplicity we treat NI as not experiencing memory pressure. MaxHeader uint64 // 5 Protocol specific max header size Slab bool // 6 Indicates whether or not memory is allocated from the SLAB ModuleName string // 7 The name of the module that implemented this protocol or "kernel" if not from a module Capabilities NetProtocolCapabilities } // NetProtocolCapabilities contains a list of capabilities for each protocol. type NetProtocolCapabilities struct { Close bool // 8 Connect bool // 9 Disconnect bool // 10 Accept bool // 11 IoCtl bool // 12 Init bool // 13 Destroy bool // 14 Shutdown bool // 15 SetSockOpt bool // 16 GetSockOpt bool // 17 SendMsg bool // 18 RecvMsg bool // 19 SendPage bool // 20 Bind bool // 21 BacklogRcv bool // 22 Hash bool // 23 UnHash bool // 24 GetPort bool // 25 EnterMemoryPressure bool // 26 } // NetProtocols reads stats from /proc/net/protocols and returns a map of // PortocolStatLine entries. As of this writing no official Linux Documentation // exists, however the source is fairly self-explanatory and the format seems // stable since its introduction in 2.6.12-rc2 // Linux 2.6.12-rc2 - https://elixir.bootlin.com/linux/v2.6.12-rc2/source/net/core/sock.c#L1452 // Linux 5.10 - https://elixir.bootlin.com/linux/v5.10.4/source/net/core/sock.c#L3586 func (fs FS) NetProtocols() (NetProtocolStats, error) { data, err := util.ReadFileNoStat(fs.proc.Path("net/protocols")) if err != nil { return NetProtocolStats{}, err } return parseNetProtocols(bufio.NewScanner(bytes.NewReader(data))) } func parseNetProtocols(s bufio.Scanner) (NetProtocolStats, error) { nps := NetProtocolStats{} // Skip the header line s.Scan() for s.Scan() { line, err := nps.parseLine(s.Text()) if err != nil { return NetProtocolStats{}, err } nps[line.Name] = line } return nps, nil } func (ps NetProtocolStats) parseLine(rawLine string) (NetProtocolStatLine, error) { line := &NetProtocolStatLine{Capabilities: NetProtocolCapabilities{}} var err error const enabled = "yes" const disabled = "no" fields := strings.Fields(rawLine) line.Name = fields[0] line.Size, err = strconv.ParseUint(fields[1], 10, 64) if err != nil { return nil, err } line.Sockets, err = strconv.ParseInt(fields[2], 10, 64) if err != nil { return nil, err } line.Memory, err = strconv.ParseInt(fields[3], 10, 64) if err != nil { return nil, err } if fields[4] == enabled { line.Pressure = 1 } else if fields[4] == disabled { line.Pressure = 0 } else { line.Pressure = -1 } line.MaxHeader, err = strconv.ParseUint(fields[5], 10, 64) if err != nil { return nil, err } if fields[6] == enabled { line.Slab = true } else if fields[6] == disabled { line.Slab = false } else { return nil, fmt.Errorf("%w: capability for protocol: %s", ErrFileParse, line.Name) } line.ModuleName = fields[7] err = line.Capabilities.parseCapabilities(fields[8:]) if err != nil { return nil, err } return line, nil } func (pc NetProtocolCapabilities) parseCapabilities(capabilities []string) error { // The capabilities are all bools so we can loop over to map them capabilityFields := [...]bool{ &pc.Close, &pc.Connect, &pc.Disconnect, &pc.Accept, &pc.IoCtl, &pc.Init, &pc.Destroy, &pc.Shutdown, &pc.SetSockOpt, &pc.GetSockOpt, &pc.SendMsg, &pc.RecvMsg, &pc.SendPage, &pc.Bind, &pc.BacklogRcv, &pc.Hash, &pc.UnHash, &pc.GetPort, &pc.EnterMemoryPressure, } for i := 0; i < len(capabilities); i++ { if capabilities[i] == "y" { capabilityFields[i] = true } else if capabilities[i] == "n" { *capabilityFields[i] = false } else { return fmt.Errorf("%w: capability block for protocol: position %d", ErrFileParse, i) } } return nil }	5.4 KB	2025-05-25 12:27
📄 net_protocols_test.go // Copyright 2020 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "strings" "testing" ) func TestParseCapabilities(t testing.T) { rawStr := "y y y y y y y y y y y y y n y y y y y\n" have := NetProtocolCapabilities{} err := have.parseCapabilities(strings.Fields(rawStr)) if err != nil { t.Fatal(err) } want := NetProtocolCapabilities{true, true, true, true, true, true, true, true, true, true, true, true, true, false, true, true, true, true, true} if want != have { t.Errorf("want %+v\nhave %+v\n", want, have) } } func TestProtocolsParseLine(t testing.T) { rawStr := "TCP 1984 93064 1225378 no 320 yes kernel y y y y y y y y y y y y y n y y y y y\n" protocols := NetProtocolStats{} have, err := protocols.parseLine(rawStr) if err != nil { t.Fatal(err) } want := NetProtocolStatLine{"TCP", 1984, 93064, 1225378, 0, 320, true, "kernel", NetProtocolCapabilities{true, true, true, true, true, true, true, true, true, true, true, true, true, false, true, true, true, true, true}} if want != have { t.Errorf("want %+v\nhave %+v\n", want, have) } } func TestProtocolsParseProtocols(t testing.T) { fs, err := NewFS(procTestFixtures) if err != nil { t.Fatal(err) } protocolStats, err := fs.NetProtocols() if err != nil { t.Fatal(err) } lines := map[string]NetProtocolStatLine{ "PACKET": {"PACKET", 1344, 2, -1, -1, 0, false, "kernel", NetProtocolCapabilities{false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false}}, "PINGv6": {"PINGv6", 1112, 0, -1, -1, 0, true, "kernel", NetProtocolCapabilities{true, true, true, false, false, true, false, false, true, true, true, true, false, true, true, true, true, true, false}}, "RAWv6": {"RAWv6", 1112, 1, -1, -1, 0, true, "kernel", NetProtocolCapabilities{true, true, true, false, true, true, true, false, true, true, true, true, false, true, true, true, true, false, false}}, "UDPLITEv6": {"UDPLITEv6", 1216, 0, 57, -1, 0, true, "kernel", NetProtocolCapabilities{true, true, true, false, true, true, true, false, true, true, true, true, false, false, false, true, true, true, false}}, "UDPv6": {"UDPv6", 1216, 10, 57, -1, 0, true, "kernel", NetProtocolCapabilities{true, true, true, false, true, true, true, false, true, true, true, true, false, false, false, true, true, true, false}}, "TCPv6": {"TCPv6", 2144, 1937, 1225378, 0, 320, true, "kernel", NetProtocolCapabilities{true, true, true, true, true, true, true, true, true, true, true, true, true, false, true, true, true, true, true}}, "UNIX": {"UNIX", 1024, 120, -1, -1, 0, true, "kernel", NetProtocolCapabilities{false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false}}, "UDP-Lite": {"UDP-Lite", 1024, 0, 57, -1, 0, true, "kernel", NetProtocolCapabilities{true, true, true, false, true, true, true, false, true, true, true, true, true, false, false, true, true, true, false}}, "PING": {"PING", 904, 0, -1, -1, 0, true, "kernel", NetProtocolCapabilities{true, true, true, false, false, true, false, false, true, true, true, true, false, true, true, true, true, true, false}}, "RAW": {"RAW", 912, 0, -1, -1, 0, true, "kernel", NetProtocolCapabilities{true, true, true, false, true, true, true, false, true, true, true, true, false, true, true, true, true, false, false}}, "UDP": {"UDP", 1024, 73, 57, -1, 0, true, "kernel", NetProtocolCapabilities{true, true, true, false, true, true, true, false, true, true, true, true, true, false, false, true, true, true, false}}, "TCP": {"TCP", 1984, 93064, 1225378, 1, 320, true, "kernel", NetProtocolCapabilities{true, true, true, true, true, true, true, true, true, true, true, true, true, false, true, true, true, true, true}}, "NETLINK": {"NETLINK", 1040, 16, -1, -1, 0, false, "kernel", NetProtocolCapabilities{false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false}}, } if want, have := len(lines), len(protocolStats); want != have { t.Errorf("want %d parsed net/protocols lines, have %d", want, have) } for _, line := range protocolStats { if want, have := lines[line.Name], line; want != have { t.Errorf("%s: want %v, have %v", line.Name, want, have) } } }	4.86 KB	2025-05-25 12:27
📄 net_route.go // Copyright 2023 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "bufio" "bytes" "fmt" "io" "strconv" "strings" "github.com/prometheus/procfs/internal/util" ) const ( blackholeRepresentation string = "" blackholeIfaceName string = "blackhole" routeLineColumns int = 11 ) // A NetRouteLine represents one line from net/route. type NetRouteLine struct { Iface string Destination uint32 Gateway uint32 Flags uint32 RefCnt uint32 Use uint32 Metric uint32 Mask uint32 MTU uint32 Window uint32 IRTT uint32 } func (fs FS) NetRoute() ([]NetRouteLine, error) { return readNetRoute(fs.proc.Path("net", "route")) } func readNetRoute(path string) ([]NetRouteLine, error) { b, err := util.ReadFileNoStat(path) if err != nil { return nil, err } routelines, err := parseNetRoute(bytes.NewReader(b)) if err != nil { return nil, fmt.Errorf("failed to read net route from %s: %w", path, err) } return routelines, nil } func parseNetRoute(r io.Reader) ([]NetRouteLine, error) { var routelines []NetRouteLine scanner := bufio.NewScanner(r) scanner.Scan() for scanner.Scan() { fields := strings.Fields(scanner.Text()) routeline, err := parseNetRouteLine(fields) if err != nil { return nil, err } routelines = append(routelines, routeline) } return routelines, nil } func parseNetRouteLine(fields []string) (*NetRouteLine, error) { if len(fields) != routeLineColumns { return nil, fmt.Errorf("invalid routeline, num of digits: %d", len(fields)) } iface := fields[0] if iface == blackholeRepresentation { iface = blackholeIfaceName } destination, err := strconv.ParseUint(fields[1], 16, 32) if err != nil { return nil, err } gateway, err := strconv.ParseUint(fields[2], 16, 32) if err != nil { return nil, err } flags, err := strconv.ParseUint(fields[3], 10, 32) if err != nil { return nil, err } refcnt, err := strconv.ParseUint(fields[4], 10, 32) if err != nil { return nil, err } use, err := strconv.ParseUint(fields[5], 10, 32) if err != nil { return nil, err } metric, err := strconv.ParseUint(fields[6], 10, 32) if err != nil { return nil, err } mask, err := strconv.ParseUint(fields[7], 16, 32) if err != nil { return nil, err } mtu, err := strconv.ParseUint(fields[8], 10, 32) if err != nil { return nil, err } window, err := strconv.ParseUint(fields[9], 10, 32) if err != nil { return nil, err } irtt, err := strconv.ParseUint(fields[10], 10, 32) if err != nil { return nil, err } routeline := &NetRouteLine{ Iface: iface, Destination: uint32(destination), Gateway: uint32(gateway), Flags: uint32(flags), RefCnt: uint32(refcnt), Use: uint32(use), Metric: uint32(metric), Mask: uint32(mask), MTU: uint32(mtu), Window: uint32(window), IRTT: uint32(irtt), } return routeline, nil }	3.42 KB	2025-05-25 12:27
📄 net_route_test.go // Copyright 2023 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "bytes" "reflect" "testing" ) func TestParseNetRoute(t *testing.T) { var netRoute = []byte(`Iface Destination Gateway Flags RefCnt Use Metric Mask MTU Window IRTT eno16780032 00000000 9503A8C0 0003 0 0 100 00000000 0 0 0 eno16780032 0000A8C0 00000000 0001 0 0 100 0000FFFF 0 0 0`) r := bytes.NewReader(netRoute) parsed, _ := parseNetRoute(r) want := []NetRouteLine{ { Iface: "eno16780032", Destination: 0, Gateway: 2500044992, Flags: 3, RefCnt: 0, Use: 0, Metric: 100, Mask: 0, MTU: 0, Window: 0, IRTT: 0, }, { Iface: "eno16780032", Destination: 43200, Gateway: 0, Flags: 1, RefCnt: 0, Use: 0, Metric: 100, Mask: 65535, MTU: 0, Window: 0, IRTT: 0, }, } if !reflect.DeepEqual(want, parsed) { t.Errorf("want %v, parsed %v", want, parsed) } }	1.62 KB	2025-05-25 12:27
📄 net_sockstat.go // Copyright 2019 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "bufio" "bytes" "fmt" "io" "strings" "github.com/prometheus/procfs/internal/util" ) // A NetSockstat contains the output of /proc/net/sockstat{,6} for IPv4 or IPv6, // respectively. type NetSockstat struct { // Used is non-nil for IPv4 sockstat results, but nil for IPv6. Used int Protocols []NetSockstatProtocol } // A NetSockstatProtocol contains statistics about a given socket protocol. // Pointer fields indicate that the value may or may not be present on any // given protocol. type NetSockstatProtocol struct { Protocol string InUse int Orphan int TW int Alloc int Mem int Memory int } // NetSockstat retrieves IPv4 socket statistics. func (fs FS) NetSockstat() (NetSockstat, error) { return readSockstat(fs.proc.Path("net", "sockstat")) } // NetSockstat6 retrieves IPv6 socket statistics. // // If IPv6 is disabled on this kernel, the returned error can be checked with // os.IsNotExist. func (fs FS) NetSockstat6() (NetSockstat, error) { return readSockstat(fs.proc.Path("net", "sockstat6")) } // readSockstat opens and parses a NetSockstat from the input file. func readSockstat(name string) (NetSockstat, error) { // This file is small and can be read with one syscall. b, err := util.ReadFileNoStat(name) if err != nil { // Do not wrap this error so the caller can detect os.IsNotExist and // similar conditions. return nil, err } stat, err := parseSockstat(bytes.NewReader(b)) if err != nil { return nil, fmt.Errorf("%w: sockstats from %q: %w", ErrFileRead, name, err) } return stat, nil } // parseSockstat reads the contents of a sockstat file and parses a NetSockstat. func parseSockstat(r io.Reader) (NetSockstat, error) { var stat NetSockstat s := bufio.NewScanner(r) for s.Scan() { // Expect a minimum of a protocol and one key/value pair. fields := strings.Split(s.Text(), " ") if len(fields) < 3 { return nil, fmt.Errorf("%w: Malformed sockstat line: %q", ErrFileParse, s.Text()) } // The remaining fields are key/value pairs. kvs, err := parseSockstatKVs(fields[1:]) if err != nil { return nil, fmt.Errorf("%w: sockstat key/value pairs from %q: %w", ErrFileParse, s.Text(), err) } // The first field is the protocol. We must trim its colon suffix. proto := strings.TrimSuffix(fields[0], ":") switch proto { case "sockets": // Special case: IPv4 has a sockets "used" key/value pair that we // embed at the top level of the structure. used := kvs["used"] stat.Used = &used default: // Parse all other lines as individual protocols. nsp := parseSockstatProtocol(kvs) nsp.Protocol = proto stat.Protocols = append(stat.Protocols, nsp) } } if err := s.Err(); err != nil { return nil, err } return &stat, nil } // parseSockstatKVs parses a string slice into a map of key/value pairs. func parseSockstatKVs(kvs []string) (map[string]int, error) { if len(kvs)%2 != 0 { return nil, fmt.Errorf("%w:: Odd number of fields in key/value pairs %q", ErrFileParse, kvs) } // Iterate two values at a time to gather key/value pairs. out := make(map[string]int, len(kvs)/2) for i := 0; i < len(kvs); i += 2 { vp := util.NewValueParser(kvs[i+1]) out[kvs[i]] = vp.Int() if err := vp.Err(); err != nil { return nil, err } } return out, nil } // parseSockstatProtocol parses a NetSockstatProtocol from the input kvs map. func parseSockstatProtocol(kvs map[string]int) NetSockstatProtocol { var nsp NetSockstatProtocol for k, v := range kvs { // Capture the range variable to ensure we get unique pointers for // each of the optional fields. v := v switch k { case "inuse": nsp.InUse = v case "orphan": nsp.Orphan = &v case "tw": nsp.TW = &v case "alloc": nsp.Alloc = &v case "mem": nsp.Mem = &v case "memory": nsp.Memory = &v } } return nsp }	4.37 KB	2025-05-25 12:27
📄 net_sockstat_test.go // Copyright 2019 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "os" "strings" "testing" "github.com/google/go-cmp/cmp" ) // The majority of test cases are covered in Test_parseSockstat. The top level // tests just check the basics for integration test purposes. func TestNetSockstat(t testing.T) { fs, err := NewFS(procTestFixtures) if err != nil { t.Fatalf("failed to open procfs: %v", err) } stat, err := fs.NetSockstat() if err != nil { t.Fatalf("failed to get sockstat: %v", err) } // IPv4 stats should include Used. if stat.Used == nil { t.Fatalf("IPv4 sockstat used value was nil") } if diff := cmp.Diff(1602, stat.Used); diff != "" { t.Fatalf("unexpected IPv4 used sockets (-want +got):\n%s", diff) } // TCP occurs first; do a basic sanity check. if diff := cmp.Diff("TCP", stat.Protocols[0].Protocol); diff != "" { t.Fatalf("unexpected socket protocol (-want +got):\n%s", diff) } if diff := cmp.Diff(35, stat.Protocols[0].InUse); diff != "" { t.Fatalf("unexpected number of TCP sockets (-want +got):\n%s", diff) } } func TestNetSockstat6(t testing.T) { fs, err := NewFS(procTestFixtures) if err != nil { t.Fatalf("failed to open procfs: %v", err) } stat, err := fs.NetSockstat6() if err != nil { t.Fatalf("failed to get sockstat: %v", err) } // IPv6 stats should not include Used. if stat.Used != nil { t.Fatalf("IPv6 sockstat used value was not nil") } // TCP6 occurs first; do a basic sanity check. if diff := cmp.Diff("TCP6", stat.Protocols[0].Protocol); diff != "" { t.Fatalf("unexpected socket protocol (-want +got):\n%s", diff) } if diff := cmp.Diff(17, stat.Protocols[0].InUse); diff != "" { t.Fatalf("unexpected number of TCP sockets (-want +got):\n%s", diff) } } func Test_readSockstatIsNotExist(t testing.T) { // On a machine with IPv6 disabled for example, we want to ensure that // readSockstat returns an error that is compatible with os.IsNotExist. // // We can use a synthetic file path here to verify this behavior. _, err := readSockstat("/does/not/exist") if err == nil \|\| !os.IsNotExist(err) { t.Fatalf("error is not compatible with os.IsNotExist: %#v", err) } } func Test_parseSockstat(t testing.T) { tests := []struct { name string s string ok bool stat NetSockstat }{ { name: "empty", ok: true, stat: &NetSockstat{}, }, { name: "bad line", s: ` sockets: used `, }, { name: "bad key/value pairs", s: ` TCP: inuse 32 orphan `, }, { name: "IPv4", s: ` sockets: used 1591 TCP: inuse 32 orphan 0 tw 0 alloc 58 mem 13 UDP: inuse 8 mem 115 UDPLITE: inuse 0 RAW: inuse 0 FRAG: inuse 0 memory 0 `, ok: true, stat: &NetSockstat{ Used: intp(1591), Protocols: []NetSockstatProtocol{ { Protocol: "TCP", InUse: 32, Orphan: intp(0), TW: intp(0), Alloc: intp(58), Mem: intp(13), }, { Protocol: "UDP", InUse: 8, Mem: intp(115), }, { Protocol: "UDPLITE", }, { Protocol: "RAW", }, { Protocol: "FRAG", Memory: intp(0), }, }, }, }, { name: "IPv6", s: ` TCP6: inuse 24 UDP6: inuse 9 UDPLITE6: inuse 0 RAW6: inuse 1 FRAG6: inuse 0 memory 0 `, ok: true, stat: &NetSockstat{ Protocols: []NetSockstatProtocol{ { Protocol: "TCP6", InUse: 24, }, { Protocol: "UDP6", InUse: 9, }, { Protocol: "UDPLITE6", }, { Protocol: "RAW6", InUse: 1, }, { Protocol: "FRAG6", Memory: intp(0), }, }, }, }, } for _, tt := range tests { t.Run(tt.name, func(t testing.T) { stat, err := parseSockstat(strings.NewReader(strings.TrimSpace(tt.s))) if err != nil { if tt.ok { t.Fatalf("failed to parse sockstats: %v", err) } t.Logf("OK error: %v", err) return } if !tt.ok { t.Fatal("expected an error, but none occurred") } if diff := cmp.Diff(tt.stat, stat); diff != "" { t.Errorf("unexpected sockstats (-want +got):\n%s", diff) } }) } } func intp(i int) int { return &i }	4.63 KB	2025-05-25 12:27
📄 net_softnet.go // Copyright 2019 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "bufio" "bytes" "fmt" "io" "strconv" "strings" "github.com/prometheus/procfs/internal/util" ) // For the proc file format details, // See: // * Linux 2.6.23 https://elixir.bootlin.com/linux/v2.6.23/source/net/core/dev.c#L2343 // * Linux 2.6.39 https://elixir.bootlin.com/linux/v2.6.39/source/net/core/dev.c#L4086 // * Linux 4.18 https://elixir.bootlin.com/linux/v4.18/source/net/core/net-procfs.c#L162 // * Linux 5.14 https://elixir.bootlin.com/linux/v5.14/source/net/core/net-procfs.c#L169 // SoftnetStat contains a single row of data from /proc/net/softnet_stat. type SoftnetStat struct { // Number of processed packets. Processed uint32 // Number of dropped packets. Dropped uint32 // Number of times processing packets ran out of quota. TimeSqueezed uint32 // Number of collision occur while obtaining device lock while transmitting. CPUCollision uint32 // Number of times cpu woken up received_rps. ReceivedRps uint32 // number of times flow limit has been reached. FlowLimitCount uint32 // Softnet backlog status. SoftnetBacklogLen uint32 // CPU id owning this softnet_data. Index uint32 // softnet_data's Width. Width int } var softNetProcFile = "net/softnet_stat" // NetSoftnetStat reads data from /proc/net/softnet_stat. func (fs FS) NetSoftnetStat() ([]SoftnetStat, error) { b, err := util.ReadFileNoStat(fs.proc.Path(softNetProcFile)) if err != nil { return nil, err } entries, err := parseSoftnet(bytes.NewReader(b)) if err != nil { return nil, fmt.Errorf("%w: /proc/net/softnet_stat: %w", ErrFileParse, err) } return entries, nil } func parseSoftnet(r io.Reader) ([]SoftnetStat, error) { const minColumns = 9 s := bufio.NewScanner(r) var stats []SoftnetStat cpuIndex := 0 for s.Scan() { columns := strings.Fields(s.Text()) width := len(columns) softnetStat := SoftnetStat{} if width < minColumns { return nil, fmt.Errorf("%w: detected %d columns, but expected at least %d", ErrFileParse, width, minColumns) } // Linux 2.6.23 https://elixir.bootlin.com/linux/v2.6.23/source/net/core/dev.c#L2347 if width >= minColumns { us, err := parseHexUint32s(columns[0:9]) if err != nil { return nil, err } softnetStat.Processed = us[0] softnetStat.Dropped = us[1] softnetStat.TimeSqueezed = us[2] softnetStat.CPUCollision = us[8] } // Linux 2.6.39 https://elixir.bootlin.com/linux/v2.6.39/source/net/core/dev.c#L4086 if width >= 10 { us, err := parseHexUint32s(columns[9:10]) if err != nil { return nil, err } softnetStat.ReceivedRps = us[0] } // Linux 4.18 https://elixir.bootlin.com/linux/v4.18/source/net/core/net-procfs.c#L162 if width >= 11 { us, err := parseHexUint32s(columns[10:11]) if err != nil { return nil, err } softnetStat.FlowLimitCount = us[0] } // Linux 5.14 https://elixir.bootlin.com/linux/v5.14/source/net/core/net-procfs.c#L169 if width >= 13 { us, err := parseHexUint32s(columns[11:13]) if err != nil { return nil, err } softnetStat.SoftnetBacklogLen = us[0] softnetStat.Index = us[1] } else { // For older kernels, create the Index based on the scan line number. softnetStat.Index = uint32(cpuIndex) } softnetStat.Width = width stats = append(stats, softnetStat) cpuIndex++ } return stats, nil } func parseHexUint32s(ss []string) ([]uint32, error) { us := make([]uint32, 0, len(ss)) for _, s := range ss { u, err := strconv.ParseUint(s, 16, 32) if err != nil { return nil, err } us = append(us, uint32(u)) } return us, nil }	4.08 KB	2025-05-25 12:27
📄 net_softnet_test.go // Copyright 2019 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "testing" "github.com/google/go-cmp/cmp" ) func TestNetSoftnet(t testing.T) { fs, err := NewFS(procTestFixtures) if err != nil { t.Fatal(err) } want := []SoftnetStat{ { Processed: 0x00358fe3, Dropped: 0x00006283, TimeSqueezed: 0x00000000, CPUCollision: 0x00000000, ReceivedRps: 0x000855fc, FlowLimitCount: 0x00000076, SoftnetBacklogLen: 0x00000000, Index: 0x00000000, Width: 13, }, { Processed: 0x00953d1a, Dropped: 0x00000446, TimeSqueezed: 0x000000b1, CPUCollision: 0x00000000, ReceivedRps: 0x008eeb9a, FlowLimitCount: 0x0000002b, SoftnetBacklogLen: 0x000000dc, Index: 0x00000001, Width: 13, }, { Processed: 0x00015c73, Dropped: 0x00020e76, TimeSqueezed: 0xf0000769, CPUCollision: 0x00000004, ReceivedRps: 0x00000003, FlowLimitCount: 0x00000002, Index: 0x00000002, Width: 11, }, { Processed: 0x01663fb2, Dropped: 0x00000000, TimeSqueezed: 0x0109a4, CPUCollision: 0x00020e76, Index: 0x00000003, Width: 9, }, { Processed: 0x00008e78, Dropped: 0x00000001, TimeSqueezed: 0x00000011, CPUCollision: 0x00000020, ReceivedRps: 0x00000010, Index: 0x00000004, Width: 10, }, } got, err := fs.NetSoftnetStat() if err != nil { t.Fatal(err) } if diff := cmp.Diff(want, got); diff != "" { t.Fatalf("unexpected softnet stats(-want +got):\n%s", diff) } } func TestBadSoftnet(t testing.T) { softNetProcFile = "net/softnet_stat.broken" fs, err := NewFS(procTestFixtures) if err != nil { t.Fatal(err) } _, err = fs.NetSoftnetStat() if err == nil { t.Fatal("expected error, got nil") } }	2.41 KB	2025-05-25 12:27
📄 net_tcp.go // Copyright 2020 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs type ( // NetTCP represents the contents of /proc/net/tcp{,6} file without the header. NetTCP []netIPSocketLine // NetTCPSummary provides already computed values like the total queue lengths or // the total number of used sockets. In contrast to NetTCP it does not collect // the parsed lines into a slice. NetTCPSummary NetIPSocketSummary ) // NetTCP returns the IPv4 kernel/networking statistics for TCP datagrams // read from /proc/net/tcp. func (fs FS) NetTCP() (NetTCP, error) { return newNetTCP(fs.proc.Path("net/tcp")) } // NetTCP6 returns the IPv6 kernel/networking statistics for TCP datagrams // read from /proc/net/tcp6. func (fs FS) NetTCP6() (NetTCP, error) { return newNetTCP(fs.proc.Path("net/tcp6")) } // NetTCPSummary returns already computed statistics like the total queue lengths // for TCP datagrams read from /proc/net/tcp. func (fs FS) NetTCPSummary() (NetTCPSummary, error) { return newNetTCPSummary(fs.proc.Path("net/tcp")) } // NetTCP6Summary returns already computed statistics like the total queue lengths // for TCP datagrams read from /proc/net/tcp6. func (fs FS) NetTCP6Summary() (NetTCPSummary, error) { return newNetTCPSummary(fs.proc.Path("net/tcp6")) } // newNetTCP creates a new NetTCP{,6} from the contents of the given file. func newNetTCP(file string) (NetTCP, error) { n, err := newNetIPSocket(file) n1 := NetTCP(n) return n1, err } func newNetTCPSummary(file string) (NetTCPSummary, error) { n, err := newNetIPSocketSummary(file) if n == nil { return nil, err } n1 := NetTCPSummary(*n) return &n1, err }	2.13 KB	2025-05-25 12:27
📄 net_tcp_test.go // Copyright 2020 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "net" "reflect" "testing" ) func Test_newNetTCP(t testing.T) { tests := []struct { name string file string want NetTCP wantErr bool }{ { name: "tcp file found, no error should come up", file: "testdata/fixtures/proc/net/tcp", want: []netIPSocketLine{ { Sl: 0, LocalAddr: net.IP{10, 0, 0, 5}, LocalPort: 22, RemAddr: net.IP{0, 0, 0, 0}, RemPort: 0, St: 10, TxQueue: 0, RxQueue: 1, UID: 0, Inode: 2740, }, { Sl: 1, LocalAddr: net.IP{0, 0, 0, 0}, LocalPort: 22, RemAddr: net.IP{0, 0, 0, 0}, RemPort: 0, St: 10, TxQueue: 1, RxQueue: 0, UID: 0, Inode: 2740, }, { Sl: 2, LocalAddr: net.IP{0, 0, 0, 0}, LocalPort: 22, RemAddr: net.IP{0, 0, 0, 0}, RemPort: 0, St: 10, TxQueue: 1, RxQueue: 1, UID: 0, Inode: 2740, }, }, wantErr: false, }, { name: "tcp6 file found, no error should come up", file: "testdata/fixtures/proc/net/tcp6", want: []netIPSocketLine{ { Sl: 1315, LocalAddr: net.IP{0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0}, LocalPort: 5355, RemAddr: net.IP{0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0}, RemPort: 0, St: 7, TxQueue: 0, RxQueue: 0, UID: 981, Inode: 21040, }, { Sl: 6073, LocalAddr: net.IP{254, 128, 0, 0, 0, 0, 0, 0, 86, 225, 173, 255, 254, 124, 102, 9}, LocalPort: 51073, RemAddr: net.IP{0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0}, RemPort: 0, St: 7, TxQueue: 0, RxQueue: 0, UID: 1000, Inode: 11337031, }, }, wantErr: false, }, { name: "error case - file not found", file: "somewhere over the rainbow", want: nil, wantErr: true, }, { name: "error case - parse error", file: "testdata/fixtures/proc/net/tcp_broken", want: nil, wantErr: true, }, } for _, tt := range tests { t.Run(tt.name, func(t testing.T) { got, err := newNetTCP(tt.file) if (err != nil) != tt.wantErr { t.Errorf("newNetTCP() error = %v, wantErr %v", err, tt.wantErr) return } if !reflect.DeepEqual(got, tt.want) { t.Errorf("newNetTCP() = %v, want %v", got, tt.want) } }) } } func Test_newNetTCPSummary(t testing.T) { tests := []struct { name string file string want NetTCPSummary wantErr bool }{ { name: "tcp file found, no error should come up", file: "testdata/fixtures/proc/net/tcp", want: &NetTCPSummary{TxQueueLength: 2, RxQueueLength: 2, UsedSockets: 3}, wantErr: false, }, { name: "tcp6 file found, no error should come up", file: "testdata/fixtures/proc/net/tcp6", want: &NetTCPSummary{TxQueueLength: 0, RxQueueLength: 0, UsedSockets: 2}, wantErr: false, }, { name: "error case - file not found", file: "somewhere over the rainbow", want: nil, wantErr: true, }, { name: "error case - parse error", file: "testdata/fixtures/proc/net/tcp_broken", want: nil, wantErr: true, }, } for _, tt := range tests { t.Run(tt.name, func(t *testing.T) { got, err := newNetTCPSummary(tt.file) if (err != nil) != tt.wantErr { t.Errorf("newNetTCPSummary() error = %v, wantErr %v", err, tt.wantErr) return } if !reflect.DeepEqual(got, tt.want) { t.Errorf("newNetTCPSummary() = %v, want %v", got, tt.want) } }) } }	4.17 KB	2025-05-25 12:27
📄 net_tls_stat.go // Copyright 2023 Prometheus Team // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "bufio" "fmt" "os" "strconv" "strings" ) // TLSStat struct represents data in /proc/net/tls_stat. // See https://docs.kernel.org/networking/tls.html#statistics type TLSStat struct { // number of TX sessions currently installed where host handles cryptography TLSCurrTxSw int // number of RX sessions currently installed where host handles cryptography TLSCurrRxSw int // number of TX sessions currently installed where NIC handles cryptography TLSCurrTxDevice int // number of RX sessions currently installed where NIC handles cryptography TLSCurrRxDevice int //number of TX sessions opened with host cryptography TLSTxSw int //number of RX sessions opened with host cryptography TLSRxSw int // number of TX sessions opened with NIC cryptography TLSTxDevice int // number of RX sessions opened with NIC cryptography TLSRxDevice int // record decryption failed (e.g. due to incorrect authentication tag) TLSDecryptError int // number of RX resyncs sent to NICs handling cryptography TLSRxDeviceResync int // number of RX records which had to be re-decrypted due to TLS_RX_EXPECT_NO_PAD mis-prediction. Note that this counter will also increment for non-data records. TLSDecryptRetry int // number of data RX records which had to be re-decrypted due to TLS_RX_EXPECT_NO_PAD mis-prediction. TLSRxNoPadViolation int } // NewTLSStat reads the tls_stat statistics. func NewTLSStat() (TLSStat, error) { fs, err := NewFS(DefaultMountPoint) if err != nil { return TLSStat{}, err } return fs.NewTLSStat() } // NewTLSStat reads the tls_stat statistics. func (fs FS) NewTLSStat() (TLSStat, error) { file, err := os.Open(fs.proc.Path("net/tls_stat")) if err != nil { return TLSStat{}, err } defer file.Close() var ( tlsstat = TLSStat{} s = bufio.NewScanner(file) ) for s.Scan() { fields := strings.Fields(s.Text()) if len(fields) != 2 { return TLSStat{}, fmt.Errorf("%w: %q line %q", ErrFileParse, file.Name(), s.Text()) } name := fields[0] value, err := strconv.Atoi(fields[1]) if err != nil { return TLSStat{}, err } switch name { case "TlsCurrTxSw": tlsstat.TLSCurrTxSw = value case "TlsCurrRxSw": tlsstat.TLSCurrRxSw = value case "TlsCurrTxDevice": tlsstat.TLSCurrTxDevice = value case "TlsCurrRxDevice": tlsstat.TLSCurrRxDevice = value case "TlsTxSw": tlsstat.TLSTxSw = value case "TlsRxSw": tlsstat.TLSRxSw = value case "TlsTxDevice": tlsstat.TLSTxDevice = value case "TlsRxDevice": tlsstat.TLSRxDevice = value case "TlsDecryptError": tlsstat.TLSDecryptError = value case "TlsRxDeviceResync": tlsstat.TLSRxDeviceResync = value case "TlsDecryptRetry": tlsstat.TLSDecryptRetry = value case "TlsRxNoPadViolation": tlsstat.TLSRxNoPadViolation = value } } return tlsstat, s.Err() }	3.35 KB	2025-05-25 12:27
📄 net_tls_stat_test.go // Copyright 2023 Prometheus Team // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "testing" ) func TestTLSStat(t *testing.T) { tlsStats, err := getProcFixtures(t).NewTLSStat() if err != nil { t.Fatal(err) } for _, test := range []struct { name string want int got int }{ {name: "TLSCurrTxSw", want: 5, got: tlsStats.TLSCurrTxSw}, {name: "TLSCurrRxSw", want: 5, got: tlsStats.TLSCurrRxSw}, {name: "TLSCurrTxDevice", want: 0, got: tlsStats.TLSCurrTxDevice}, {name: "TLSCurrRxDevice", want: 0, got: tlsStats.TLSCurrRxDevice}, {name: "TLSTxSw", want: 8711, got: tlsStats.TLSTxSw}, {name: "TLSTxSw", want: 8711, got: tlsStats.TLSRxSw}, {name: "TLSTxDevice", want: 0, got: tlsStats.TLSTxDevice}, {name: "TLSRxDevice", want: 0, got: tlsStats.TLSRxDevice}, {name: "TLSDecryptError", want: 13, got: tlsStats.TLSDecryptError}, {name: "TLSRxDeviceResync", want: 0, got: tlsStats.TLSRxDeviceResync}, {name: "TLSDecryptRetry", want: 0, got: tlsStats.TLSDecryptRetry}, {name: "TLSRxNoPadViolation", want: 0, got: tlsStats.TLSRxNoPadViolation}, } { if test.want != test.got { t.Errorf("Want %s %d, have %d", test.name, test.want, test.got) } } }	1.67 KB	2025-05-25 12:27
📄 net_udp.go // Copyright 2020 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs type ( // NetUDP represents the contents of /proc/net/udp{,6} file without the header. NetUDP []netIPSocketLine // NetUDPSummary provides already computed values like the total queue lengths or // the total number of used sockets. In contrast to NetUDP it does not collect // the parsed lines into a slice. NetUDPSummary NetIPSocketSummary ) // NetUDP returns the IPv4 kernel/networking statistics for UDP datagrams // read from /proc/net/udp. func (fs FS) NetUDP() (NetUDP, error) { return newNetUDP(fs.proc.Path("net/udp")) } // NetUDP6 returns the IPv6 kernel/networking statistics for UDP datagrams // read from /proc/net/udp6. func (fs FS) NetUDP6() (NetUDP, error) { return newNetUDP(fs.proc.Path("net/udp6")) } // NetUDPSummary returns already computed statistics like the total queue lengths // for UDP datagrams read from /proc/net/udp. func (fs FS) NetUDPSummary() (NetUDPSummary, error) { return newNetUDPSummary(fs.proc.Path("net/udp")) } // NetUDP6Summary returns already computed statistics like the total queue lengths // for UDP datagrams read from /proc/net/udp6. func (fs FS) NetUDP6Summary() (NetUDPSummary, error) { return newNetUDPSummary(fs.proc.Path("net/udp6")) } // newNetUDP creates a new NetUDP{,6} from the contents of the given file. func newNetUDP(file string) (NetUDP, error) { n, err := newNetIPSocket(file) n1 := NetUDP(n) return n1, err } func newNetUDPSummary(file string) (NetUDPSummary, error) { n, err := newNetIPSocketSummary(file) if n == nil { return nil, err } n1 := NetUDPSummary(*n) return &n1, err }	2.13 KB	2025-05-25 12:27
📄 net_udp_test.go // Copyright 2020 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "net" "reflect" "testing" ) func Test_newNetUDP(t testing.T) { tests := []struct { name string file string want NetUDP wantErr bool }{ { name: "udp file found, no error should come up", file: "testdata/fixtures/proc/net/udp", want: []netIPSocketLine{ &netIPSocketLine{ Sl: 0, LocalAddr: net.IP{10, 0, 0, 5}, LocalPort: 22, RemAddr: net.IP{0, 0, 0, 0}, RemPort: 0, St: 10, TxQueue: 0, RxQueue: 1, UID: 0, Inode: 2740, Drops: intToU64(100), }, &netIPSocketLine{ Sl: 1, LocalAddr: net.IP{0, 0, 0, 0}, LocalPort: 22, RemAddr: net.IP{0, 0, 0, 0}, RemPort: 0, St: 10, TxQueue: 1, RxQueue: 0, UID: 0, Inode: 2740, Drops: intToU64(100), }, &netIPSocketLine{ Sl: 2, LocalAddr: net.IP{0, 0, 0, 0}, LocalPort: 22, RemAddr: net.IP{0, 0, 0, 0}, RemPort: 0, St: 10, TxQueue: 1, RxQueue: 1, UID: 0, Inode: 2740, Drops: intToU64(100), }, }, wantErr: false, }, { name: "udp6 file found, no error should come up", file: "testdata/fixtures/proc/net/udp6", want: []netIPSocketLine{ &netIPSocketLine{ Sl: 1315, LocalAddr: net.IP{0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0}, LocalPort: 5355, RemAddr: net.IP{0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0}, RemPort: 0, St: 7, TxQueue: 0, RxQueue: 0, UID: 981, Inode: 21040, Drops: intToU64(0), }, &netIPSocketLine{ Sl: 6073, LocalAddr: net.IP{254, 128, 0, 0, 0, 0, 0, 0, 86, 225, 173, 255, 254, 124, 102, 9}, LocalPort: 51073, RemAddr: net.IP{0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0}, RemPort: 0, St: 7, TxQueue: 0, RxQueue: 0, UID: 1000, Inode: 11337031, Drops: intToU64(0), }, }, wantErr: false, }, { name: "error case - file not found", file: "somewhere over the rainbow", want: nil, wantErr: true, }, { name: "error case - parse error", file: "testdata/fixtures/proc/net/udp_broken", want: nil, wantErr: true, }, } for _, tt := range tests { t.Run(tt.name, func(t testing.T) { got, err := newNetUDP(tt.file) if (err != nil) != tt.wantErr { t.Errorf("newNetUDP() error = %v, wantErr %v", err, tt.wantErr) return } if !reflect.DeepEqual(got, tt.want) { t.Errorf("newNetUDP() = %v, want %v", got, tt.want) } }) } } func Test_newNetUDPSummary(t testing.T) { tests := []struct { name string file string want NetUDPSummary wantErr bool }{ { name: "udp file found, no error should come up", file: "testdata/fixtures/proc/net/udp", want: &NetUDPSummary{TxQueueLength: 2, RxQueueLength: 2, UsedSockets: 3, Drops: intToU64(300)}, wantErr: false, }, { name: "udp6 file found, no error should come up", file: "testdata/fixtures/proc/net/udp6", want: &NetUDPSummary{TxQueueLength: 0, RxQueueLength: 0, UsedSockets: 2, Drops: intToU64(0)}, wantErr: false, }, { name: "error case - file not found", file: "somewhere over the rainbow", want: nil, wantErr: true, }, { name: "error case - parse error", file: "testdata/fixtures/proc/net/udp_broken", want: nil, wantErr: true, }, } for _, tt := range tests { t.Run(tt.name, func(t testing.T) { got, err := newNetUDPSummary(tt.file) if (err != nil) != tt.wantErr { t.Errorf("newNetUDPSummary() error = %v, wantErr %v", err, tt.wantErr) return } if !reflect.DeepEqual(got, tt.want) { t.Errorf("newNetUDPSummary() = %v, want %v", got, tt.want) } }) } } // intToU64 convert int to uint64 and return it pointer. func intToU64(i int) uint64 { cast := uint64(i) return &cast }	4.56 KB	2025-05-25 12:27
📄 net_unix.go // Copyright 2018 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "bufio" "fmt" "io" "os" "strconv" "strings" ) // For the proc file format details, // see https://elixir.bootlin.com/linux/v4.17/source/net/unix/af_unix.c#L2815 // and https://elixir.bootlin.com/linux/latest/source/include/uapi/linux/net.h#L48. // Constants for the various /proc/net/unix enumerations. // TODO: match against x/sys/unix or similar? const ( netUnixTypeStream = 1 netUnixTypeDgram = 2 netUnixTypeSeqpacket = 5 netUnixFlagDefault = 0 netUnixFlagListen = 1 << 16 netUnixStateUnconnected = 1 netUnixStateConnecting = 2 netUnixStateConnected = 3 netUnixStateDisconnected = 4 ) // NetUNIXType is the type of the type field. type NetUNIXType uint64 // NetUNIXFlags is the type of the flags field. type NetUNIXFlags uint64 // NetUNIXState is the type of the state field. type NetUNIXState uint64 // NetUNIXLine represents a line of /proc/net/unix. type NetUNIXLine struct { KernelPtr string RefCount uint64 Protocol uint64 Flags NetUNIXFlags Type NetUNIXType State NetUNIXState Inode uint64 Path string } // NetUNIX holds the data read from /proc/net/unix. type NetUNIX struct { Rows []NetUNIXLine } // NetUNIX returns data read from /proc/net/unix. func (fs FS) NetUNIX() (NetUNIX, error) { return readNetUNIX(fs.proc.Path("net/unix")) } // readNetUNIX reads data in /proc/net/unix format from the specified file. func readNetUNIX(file string) (NetUNIX, error) { // This file could be quite large and a streaming read is desirable versus // reading the entire contents at once. f, err := os.Open(file) if err != nil { return nil, err } defer f.Close() return parseNetUNIX(f) } // parseNetUNIX creates a NetUnix structure from the incoming stream. func parseNetUNIX(r io.Reader) (NetUNIX, error) { // Begin scanning by checking for the existence of Inode. s := bufio.NewScanner(r) s.Scan() // From the man page of proc(5), it does not contain an Inode field, // but in actually it exists. This code works for both cases. hasInode := strings.Contains(s.Text(), "Inode") // Expect a minimum number of fields, but Inode and Path are optional: // Num RefCount Protocol Flags Type St Inode Path minFields := 6 if hasInode { minFields++ } var nu NetUNIX for s.Scan() { line := s.Text() item, err := nu.parseLine(line, hasInode, minFields) if err != nil { return nil, fmt.Errorf("%w: /proc/net/unix encountered data %q: %w", ErrFileParse, line, err) } nu.Rows = append(nu.Rows, item) } if err := s.Err(); err != nil { return nil, fmt.Errorf("%w: /proc/net/unix encountered data: %w", ErrFileParse, err) } return &nu, nil } func (u NetUNIX) parseLine(line string, hasInode bool, min int) (NetUNIXLine, error) { fields := strings.Fields(line) l := len(fields) if l < min { return nil, fmt.Errorf("%w: expected at least %d fields but got %d", ErrFileParse, min, l) } // Field offsets are as follows: // Num RefCount Protocol Flags Type St Inode Path kernelPtr := strings.TrimSuffix(fields[0], ":") users, err := u.parseUsers(fields[1]) if err != nil { return nil, fmt.Errorf("%w: ref count %q: %w", ErrFileParse, fields[1], err) } flags, err := u.parseFlags(fields[3]) if err != nil { return nil, fmt.Errorf("%w: Unable to parse flags %q: %w", ErrFileParse, fields[3], err) } typ, err := u.parseType(fields[4]) if err != nil { return nil, fmt.Errorf("%w: Failed to parse type %q: %w", ErrFileParse, fields[4], err) } state, err := u.parseState(fields[5]) if err != nil { return nil, fmt.Errorf("%w: Failed to parse state %q: %w", ErrFileParse, fields[5], err) } var inode uint64 if hasInode { inode, err = u.parseInode(fields[6]) if err != nil { return nil, fmt.Errorf("%w failed to parse inode %q: %w", ErrFileParse, fields[6], err) } } n := &NetUNIXLine{ KernelPtr: kernelPtr, RefCount: users, Type: typ, Flags: flags, State: state, Inode: inode, } // Path field is optional. if l > min { // Path occurs at either index 6 or 7 depending on whether inode is // already present. pathIdx := 7 if !hasInode { pathIdx-- } n.Path = fields[pathIdx] } return n, nil } func (u NetUNIX) parseUsers(s string) (uint64, error) { return strconv.ParseUint(s, 16, 32) } func (u NetUNIX) parseType(s string) (NetUNIXType, error) { typ, err := strconv.ParseUint(s, 16, 16) if err != nil { return 0, err } return NetUNIXType(typ), nil } func (u NetUNIX) parseFlags(s string) (NetUNIXFlags, error) { flags, err := strconv.ParseUint(s, 16, 32) if err != nil { return 0, err } return NetUNIXFlags(flags), nil } func (u NetUNIX) parseState(s string) (NetUNIXState, error) { st, err := strconv.ParseInt(s, 16, 8) if err != nil { return 0, err } return NetUNIXState(st), nil } func (u NetUNIX) parseInode(s string) (uint64, error) { return strconv.ParseUint(s, 10, 64) } func (t NetUNIXType) String() string { switch t { case netUnixTypeStream: return "stream" case netUnixTypeDgram: return "dgram" case netUnixTypeSeqpacket: return "seqpacket" } return "unknown" } func (f NetUNIXFlags) String() string { switch f { case netUnixFlagListen: return "listen" default: return "default" } } func (s NetUNIXState) String() string { switch s { case netUnixStateUnconnected: return "unconnected" case netUnixStateConnecting: return "connecting" case netUnixStateConnected: return "connected" case netUnixStateDisconnected: return "disconnected" } return "unknown" }	6.03 KB	2025-05-25 12:27
📄 net_unix_test.go // Copyright 2018 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "testing" "github.com/google/go-cmp/cmp" ) // Whether or not to run tests with inode fixtures. const ( checkInode = true noCheckInode = false ) func TestNetUnix(t testing.T) { fs, err := NewFS(procTestFixtures) if err != nil { t.Fatalf("failed to open procfs: %v", err) } got, err := fs.NetUNIX() if err != nil { t.Fatalf("failed to get UNIX socket data: %v", err) } testNetUNIX(t, checkInode, got) } func TestNetUnixNoInode(t testing.T) { fs, err := NewFS(procTestFixtures) if err != nil { t.Fatalf("failed to open procfs: %v", err) } got, err := readNetUNIX(fs.proc.Path("net/unix_without_inode")) if err != nil { t.Fatalf("failed to read UNIX socket data: %v", err) } testNetUNIX(t, noCheckInode, got) } func testNetUNIX(t testing.T, testInode bool, got NetUNIX) { t.Helper() // First verify that the input data matches a prepopulated structure. want := []*NetUNIXLine{ { KernelPtr: "0000000000000000", RefCount: 2, Flags: 1 << 16, Type: 1, State: 1, Inode: 3442596, Path: "/var/run/postgresql/.s.PGSQL.5432", }, { KernelPtr: "0000000000000000", RefCount: 10, Flags: 1 << 16, Type: 5, State: 1, Inode: 10061, Path: "/run/udev/control", }, { KernelPtr: "0000000000000000", RefCount: 7, Flags: 0, Type: 2, State: 1, Inode: 12392, Path: "/dev/log", }, { KernelPtr: "0000000000000000", RefCount: 3, Flags: 0, Type: 1, State: 3, Inode: 4787297, Path: "/var/run/postgresql/.s.PGSQL.5432", }, { KernelPtr: "0000000000000000", RefCount: 3, Flags: 0, Type: 1, State: 3, Inode: 5091797, }, } // Enable the fixtures to be used for multiple tests by clearing the inode // field when appropriate. if !testInode { for i := 0; i < len(want); i++ { want[i].Inode = 0 } } if diff := cmp.Diff(want, got.Rows); diff != "" { t.Fatalf("unexpected /proc/net/unix data (-want +got):\n%s", diff) } // Now test the field enumerations and ensure they match up correctly // with the constants used to generate readable strings. wantFlags := []NetUNIXFlags{ netUnixFlagListen, netUnixFlagListen, netUnixFlagDefault, netUnixFlagDefault, netUnixFlagDefault, } wantType := []NetUNIXType{ netUnixTypeStream, netUnixTypeSeqpacket, netUnixTypeDgram, netUnixTypeStream, netUnixTypeStream, } wantState := []NetUNIXState{ netUnixStateUnconnected, netUnixStateUnconnected, netUnixStateUnconnected, netUnixStateConnected, netUnixStateConnected, } var ( gotFlags []NetUNIXFlags gotType []NetUNIXType gotState []NetUNIXState ) for _, r := range got.Rows { gotFlags = append(gotFlags, r.Flags) gotType = append(gotType, r.Type) gotState = append(gotState, r.State) } if diff := cmp.Diff(wantFlags, gotFlags); diff != "" { t.Fatalf("unexpected /proc/net/unix flags (-want +got):\n%s", diff) } if diff := cmp.Diff(wantType, gotType); diff != "" { t.Fatalf("unexpected /proc/net/unix types (-want +got):\n%s", diff) } if diff := cmp.Diff(wantState, gotState); diff != "" { t.Fatalf("unexpected /proc/net/unix states (-want +got):\n%s", diff) } }	3.8 KB	2025-05-25 12:27
📄 net_wireless.go // Copyright 2023 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "bufio" "bytes" "fmt" "io" "strconv" "strings" "github.com/prometheus/procfs/internal/util" ) // Wireless models the content of /proc/net/wireless. type Wireless struct { Name string // Status is the current 4-digit hex value status of the interface. Status uint64 // QualityLink is the link quality. QualityLink int // QualityLevel is the signal gain (dBm). QualityLevel int // QualityNoise is the signal noise baseline (dBm). QualityNoise int // DiscardedNwid is the number of discarded packets with wrong nwid/essid. DiscardedNwid int // DiscardedCrypt is the number of discarded packets with wrong code/decode (WEP). DiscardedCrypt int // DiscardedFrag is the number of discarded packets that can't perform MAC reassembly. DiscardedFrag int // DiscardedRetry is the number of discarded packets that reached max MAC retries. DiscardedRetry int // DiscardedMisc is the number of discarded packets for other reasons. DiscardedMisc int // MissedBeacon is the number of missed beacons/superframe. MissedBeacon int } // Wireless returns kernel wireless statistics. func (fs FS) Wireless() ([]Wireless, error) { b, err := util.ReadFileNoStat(fs.proc.Path("net/wireless")) if err != nil { return nil, err } m, err := parseWireless(bytes.NewReader(b)) if err != nil { return nil, fmt.Errorf("%w: wireless: %w", ErrFileParse, err) } return m, nil } // parseWireless parses the contents of /proc/net/wireless. / Inter-\| sta-\| Quality \| Discarded packets \| Missed \| WE face \| tus \| link level noise \| nwid crypt frag retry misc \| beacon \| 22 eth1: 0000 5. -256. -10. 0 1 0 3 0 0 eth2: 0000 5. -256. -20. 0 2 0 4 0 0 / func parseWireless(r io.Reader) ([]Wireless, error) { var ( interfaces []*Wireless scanner = bufio.NewScanner(r) ) for n := 0; scanner.Scan(); n++ { // Skip the 2 header lines. if n < 2 { continue } line := scanner.Text() parts := strings.Split(line, ":") if len(parts) != 2 { return nil, fmt.Errorf("%w: expected 2 parts after splitting line by ':', got %d for line %q", ErrFileParse, len(parts), line) } name := strings.TrimSpace(parts[0]) stats := strings.Fields(parts[1]) if len(stats) < 10 { return nil, fmt.Errorf("%w: invalid number of fields in line %d, expected 10+, got %d: %q", ErrFileParse, n, len(stats), line) } status, err := strconv.ParseUint(stats[0], 16, 16) if err != nil { return nil, fmt.Errorf("%w: invalid status in line %d: %q", ErrFileParse, n, line) } qlink, err := strconv.Atoi(strings.TrimSuffix(stats[1], ".")) if err != nil { return nil, fmt.Errorf("%w: parse Quality:link as integer %q: %w", ErrFileParse, qlink, err) } qlevel, err := strconv.Atoi(strings.TrimSuffix(stats[2], ".")) if err != nil { return nil, fmt.Errorf("%w: Quality:level as integer %q: %w", ErrFileParse, qlevel, err) } qnoise, err := strconv.Atoi(strings.TrimSuffix(stats[3], ".")) if err != nil { return nil, fmt.Errorf("%w: Quality:noise as integer %q: %w", ErrFileParse, qnoise, err) } dnwid, err := strconv.Atoi(stats[4]) if err != nil { return nil, fmt.Errorf("%w: Discarded:nwid as integer %q: %w", ErrFileParse, dnwid, err) } dcrypt, err := strconv.Atoi(stats[5]) if err != nil { return nil, fmt.Errorf("%w: Discarded:crypt as integer %q: %w", ErrFileParse, dcrypt, err) } dfrag, err := strconv.Atoi(stats[6]) if err != nil { return nil, fmt.Errorf("%w: Discarded:frag as integer %q: %w", ErrFileParse, dfrag, err) } dretry, err := strconv.Atoi(stats[7]) if err != nil { return nil, fmt.Errorf("%w: Discarded:retry as integer %q: %w", ErrFileParse, dretry, err) } dmisc, err := strconv.Atoi(stats[8]) if err != nil { return nil, fmt.Errorf("%w: Discarded:misc as integer %q: %w", ErrFileParse, dmisc, err) } mbeacon, err := strconv.Atoi(stats[9]) if err != nil { return nil, fmt.Errorf("%w: Missed:beacon as integer %q: %w", ErrFileParse, mbeacon, err) } w := &Wireless{ Name: name, Status: status, QualityLink: qlink, QualityLevel: qlevel, QualityNoise: qnoise, DiscardedNwid: dnwid, DiscardedCrypt: dcrypt, DiscardedFrag: dfrag, DiscardedRetry: dretry, DiscardedMisc: dmisc, MissedBeacon: mbeacon, } interfaces = append(interfaces, w) } if err := scanner.Err(); err != nil { return nil, fmt.Errorf("%w: Failed to scan /proc/net/wireless: %w", ErrFileRead, err) } return interfaces, nil }	5.1 KB	2025-05-25 12:27
📄 net_wireless_test.go // Copyright 2023 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "reflect" "testing" ) func TestWireless(t testing.T) { fs, err := NewFS(procTestFixtures) if err != nil { t.Fatalf("failed to open procfs: %v", err) } got, err := fs.Wireless() if err != nil { t.Fatal(err) } expected := []Wireless{ { Name: "wlan0", Status: 1, QualityLink: 2, QualityLevel: 3, QualityNoise: 4, DiscardedNwid: 5, DiscardedCrypt: 6, DiscardedFrag: 7, DiscardedRetry: 8, DiscardedMisc: 9, MissedBeacon: 10, }, { Name: "wlan1", Status: 16, QualityLink: 9, QualityLevel: 8, QualityNoise: 7, DiscardedNwid: 6, DiscardedCrypt: 5, DiscardedFrag: 4, DiscardedRetry: 3, DiscardedMisc: 2, MissedBeacon: 1, }, } if len(got) != len(expected) { t.Fatalf("unexpected number of interfaces parsed %d, expected %d", len(got), len(expected)) } for i, iface := range got { if !reflect.DeepEqual(iface, expected[i]) { t.Errorf("unexpected interface got %+v, expected %+v", iface, expected[i]) } } }	1.64 KB	2025-05-25 12:27
📄 net_xfrm.go // Copyright 2017 Prometheus Team // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "bufio" "fmt" "os" "strconv" "strings" ) // XfrmStat models the contents of /proc/net/xfrm_stat. type XfrmStat struct { // All errors which are not matched by other XfrmInError int // No buffer is left XfrmInBufferError int // Header Error XfrmInHdrError int // No state found // i.e. either inbound SPI, address, or IPSEC protocol at SA is wrong XfrmInNoStates int // Transformation protocol specific error // e.g. SA Key is wrong XfrmInStateProtoError int // Transformation mode specific error XfrmInStateModeError int // Sequence error // e.g. sequence number is out of window XfrmInStateSeqError int // State is expired XfrmInStateExpired int // State has mismatch option // e.g. UDP encapsulation type is mismatched XfrmInStateMismatch int // State is invalid XfrmInStateInvalid int // No matching template for states // e.g. Inbound SAs are correct but SP rule is wrong XfrmInTmplMismatch int // No policy is found for states // e.g. Inbound SAs are correct but no SP is found XfrmInNoPols int // Policy discards XfrmInPolBlock int // Policy error XfrmInPolError int // All errors which are not matched by others XfrmOutError int // Bundle generation error XfrmOutBundleGenError int // Bundle check error XfrmOutBundleCheckError int // No state was found XfrmOutNoStates int // Transformation protocol specific error XfrmOutStateProtoError int // Transportation mode specific error XfrmOutStateModeError int // Sequence error // i.e sequence number overflow XfrmOutStateSeqError int // State is expired XfrmOutStateExpired int // Policy discads XfrmOutPolBlock int // Policy is dead XfrmOutPolDead int // Policy Error XfrmOutPolError int // Forward routing of a packet is not allowed XfrmFwdHdrError int // State is invalid, perhaps expired XfrmOutStateInvalid int // State hasn’t been fully acquired before use XfrmAcquireError int } // NewXfrmStat reads the xfrm_stat statistics. func NewXfrmStat() (XfrmStat, error) { fs, err := NewFS(DefaultMountPoint) if err != nil { return XfrmStat{}, err } return fs.NewXfrmStat() } // NewXfrmStat reads the xfrm_stat statistics from the 'proc' filesystem. func (fs FS) NewXfrmStat() (XfrmStat, error) { file, err := os.Open(fs.proc.Path("net/xfrm_stat")) if err != nil { return XfrmStat{}, err } defer file.Close() var ( x = XfrmStat{} s = bufio.NewScanner(file) ) for s.Scan() { fields := strings.Fields(s.Text()) if len(fields) != 2 { return XfrmStat{}, fmt.Errorf("%w: %q line %q", ErrFileParse, file.Name(), s.Text()) } name := fields[0] value, err := strconv.Atoi(fields[1]) if err != nil { return XfrmStat{}, err } switch name { case "XfrmInError": x.XfrmInError = value case "XfrmInBufferError": x.XfrmInBufferError = value case "XfrmInHdrError": x.XfrmInHdrError = value case "XfrmInNoStates": x.XfrmInNoStates = value case "XfrmInStateProtoError": x.XfrmInStateProtoError = value case "XfrmInStateModeError": x.XfrmInStateModeError = value case "XfrmInStateSeqError": x.XfrmInStateSeqError = value case "XfrmInStateExpired": x.XfrmInStateExpired = value case "XfrmInStateInvalid": x.XfrmInStateInvalid = value case "XfrmInTmplMismatch": x.XfrmInTmplMismatch = value case "XfrmInNoPols": x.XfrmInNoPols = value case "XfrmInPolBlock": x.XfrmInPolBlock = value case "XfrmInPolError": x.XfrmInPolError = value case "XfrmOutError": x.XfrmOutError = value case "XfrmInStateMismatch": x.XfrmInStateMismatch = value case "XfrmOutBundleGenError": x.XfrmOutBundleGenError = value case "XfrmOutBundleCheckError": x.XfrmOutBundleCheckError = value case "XfrmOutNoStates": x.XfrmOutNoStates = value case "XfrmOutStateProtoError": x.XfrmOutStateProtoError = value case "XfrmOutStateModeError": x.XfrmOutStateModeError = value case "XfrmOutStateSeqError": x.XfrmOutStateSeqError = value case "XfrmOutStateExpired": x.XfrmOutStateExpired = value case "XfrmOutPolBlock": x.XfrmOutPolBlock = value case "XfrmOutPolDead": x.XfrmOutPolDead = value case "XfrmOutPolError": x.XfrmOutPolError = value case "XfrmFwdHdrError": x.XfrmFwdHdrError = value case "XfrmOutStateInvalid": x.XfrmOutStateInvalid = value case "XfrmAcquireError": x.XfrmAcquireError = value } } return x, s.Err() }	4.88 KB	2025-05-25 12:27
📄 net_xfrm_test.go // Copyright 2017 Prometheus Team // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "testing" ) func TestXfrmStats(t *testing.T) { xfrmStats, err := getProcFixtures(t).NewXfrmStat() if err != nil { t.Fatal(err) } for _, test := range []struct { name string want int got int }{ {name: "XfrmInError", want: 1, got: xfrmStats.XfrmInError}, {name: "XfrmInBufferError", want: 2, got: xfrmStats.XfrmInBufferError}, {name: "XfrmInHdrError", want: 4, got: xfrmStats.XfrmInHdrError}, {name: "XfrmInNoStates", want: 3, got: xfrmStats.XfrmInNoStates}, {name: "XfrmInStateProtoError", want: 40, got: xfrmStats.XfrmInStateProtoError}, {name: "XfrmInStateModeError", want: 100, got: xfrmStats.XfrmInStateModeError}, {name: "XfrmInStateSeqError", want: 6000, got: xfrmStats.XfrmInStateSeqError}, {name: "XfrmInStateExpired", want: 4, got: xfrmStats.XfrmInStateExpired}, {name: "XfrmInStateMismatch", want: 23451, got: xfrmStats.XfrmInStateMismatch}, {name: "XfrmInStateInvalid", want: 55555, got: xfrmStats.XfrmInStateInvalid}, {name: "XfrmInTmplMismatch", want: 51, got: xfrmStats.XfrmInTmplMismatch}, {name: "XfrmInNoPols", want: 65432, got: xfrmStats.XfrmInNoPols}, {name: "XfrmInPolBlock", want: 100, got: xfrmStats.XfrmInPolBlock}, {name: "XfrmInPolError", want: 10000, got: xfrmStats.XfrmInPolError}, {name: "XfrmOutError", want: 1000000, got: xfrmStats.XfrmOutError}, {name: "XfrmOutBundleGenError", want: 43321, got: xfrmStats.XfrmOutBundleGenError}, {name: "XfrmOutBundleCheckError", want: 555, got: xfrmStats.XfrmOutBundleCheckError}, {name: "XfrmOutNoStates", want: 869, got: xfrmStats.XfrmOutNoStates}, {name: "XfrmOutStateProtoError", want: 4542, got: xfrmStats.XfrmOutStateProtoError}, {name: "XfrmOutStateModeError", want: 4, got: xfrmStats.XfrmOutStateModeError}, {name: "XfrmOutStateSeqError", want: 543, got: xfrmStats.XfrmOutStateSeqError}, {name: "XfrmOutStateExpired", want: 565, got: xfrmStats.XfrmOutStateExpired}, {name: "XfrmOutPolBlock", want: 43456, got: xfrmStats.XfrmOutPolBlock}, {name: "XfrmOutPolDead", want: 7656, got: xfrmStats.XfrmOutPolDead}, {name: "XfrmOutPolError", want: 1454, got: xfrmStats.XfrmOutPolError}, {name: "XfrmFwdHdrError", want: 6654, got: xfrmStats.XfrmFwdHdrError}, {name: "XfrmOutStateInvaliad", want: 28765, got: xfrmStats.XfrmOutStateInvalid}, {name: "XfrmAcquireError", want: 24532, got: xfrmStats.XfrmAcquireError}, {name: "XfrmInStateInvalid", want: 55555, got: xfrmStats.XfrmInStateInvalid}, {name: "XfrmOutError", want: 1000000, got: xfrmStats.XfrmOutError}, } { if test.want != test.got { t.Errorf("Want %s %d, have %d", test.name, test.want, test.got) } } }	3.15 KB	2025-05-25 12:27
📄 netstat.go // Copyright 2020 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "bufio" "os" "path/filepath" "strconv" "strings" ) // NetStat contains statistics for all the counters from one file. type NetStat struct { Stats map[string][]uint64 Filename string } // NetStat retrieves stats from `/proc/net/stat/`. func (fs FS) NetStat() ([]NetStat, error) { statFiles, err := filepath.Glob(fs.proc.Path("net/stat/*")) if err != nil { return nil, err } var netStatsTotal []NetStat for _, filePath := range statFiles { procNetstat, err := parseNetstat(filePath) if err != nil { return nil, err } procNetstat.Filename = filepath.Base(filePath) netStatsTotal = append(netStatsTotal, procNetstat) } return netStatsTotal, nil } // parseNetstat parses the metrics from `/proc/net/stat/` file // and returns a NetStat structure. func parseNetstat(filePath string) (NetStat, error) { netStat := NetStat{ Stats: make(map[string][]uint64), } file, err := os.Open(filePath) if err != nil { return netStat, err } defer file.Close() scanner := bufio.NewScanner(file) scanner.Scan() // First string is always a header for stats var headers []string headers = append(headers, strings.Fields(scanner.Text())...) // Other strings represent per-CPU counters for scanner.Scan() { for num, counter := range strings.Fields(scanner.Text()) { value, err := strconv.ParseUint(counter, 16, 64) if err != nil { return NetStat{}, err } netStat.Stats[headers[num]] = append(netStat.Stats[headers[num]], value) } } return netStat, nil }	2.08 KB	2025-05-25 12:27
📄 netstat_test.go // Copyright 2020 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "testing" ) func TestNetStat(t *testing.T) { const ( filesCount = 2 CPUsCount = 2 arpCacheMetricsCount = 13 ndiscCacheMetricsCount = 13 ) fs, err := NewFS(procTestFixtures) if err != nil { t.Fatalf("failed to open procfs: %v", err) } netStats, err := fs.NetStat() if err != nil { t.Fatalf("NetStat() error: %s", err) } if len(netStats) != filesCount { t.Fatalf("unexpected number of files parsed %d, expected %d", len(netStats), filesCount) } expectedStats := [2]NetStat{ { Filename: "arp_cache", Stats: make(map[string][]uint64), }, { Filename: "ndisc_cache", Stats: make(map[string][]uint64), }, } for _, expected := range expectedStats { if expected.Filename == "arp_cache" { expected.Stats["entries"] = []uint64{20, 20} expected.Stats["allocs"] = []uint64{1, 13} expected.Stats["destroys"] = []uint64{2, 14} expected.Stats["hash_grows"] = []uint64{3, 15} expected.Stats["lookups"] = []uint64{4, 16} expected.Stats["hits"] = []uint64{5, 17} expected.Stats["res_failed"] = []uint64{6, 18} expected.Stats["rcv_probes_mcast"] = []uint64{7, 19} expected.Stats["rcv_probes_ucast"] = []uint64{8, 20} expected.Stats["periodic_gc_runs"] = []uint64{9, 21} expected.Stats["forced_gc_runs"] = []uint64{10, 22} expected.Stats["unresolved_discards"] = []uint64{11, 23} expected.Stats["table_fulls"] = []uint64{12, 24} } if expected.Filename == "ndisc_cache" { expected.Stats["entries"] = []uint64{36, 36} expected.Stats["allocs"] = []uint64{240, 252} expected.Stats["destroys"] = []uint64{241, 253} expected.Stats["hash_grows"] = []uint64{242, 254} expected.Stats["lookups"] = []uint64{243, 255} expected.Stats["hits"] = []uint64{244, 256} expected.Stats["res_failed"] = []uint64{245, 257} expected.Stats["rcv_probes_mcast"] = []uint64{246, 258} expected.Stats["rcv_probes_ucast"] = []uint64{247, 259} expected.Stats["periodic_gc_runs"] = []uint64{248, 260} expected.Stats["forced_gc_runs"] = []uint64{249, 261} expected.Stats["unresolved_discards"] = []uint64{250, 262} expected.Stats["table_fulls"] = []uint64{251, 263} } } for _, netStatFile := range netStats { if netStatFile.Filename == "arp_cache" && len(netStatFile.Stats) != arpCacheMetricsCount { t.Fatalf("unexpected arp_cache metrics count %d, expected %d", len(netStatFile.Stats), arpCacheMetricsCount) } if netStatFile.Filename == "ndisc_cache" && len(netStatFile.Stats) != ndiscCacheMetricsCount { t.Fatalf("unexpected ndisc_cache metrics count %d, expected %d", len(netStatFile.Stats), ndiscCacheMetricsCount) } for _, expected := range expectedStats { for header, stats := range netStatFile.Stats { if header == "" { t.Fatalf("Found empty metric name") } if len(stats) != CPUsCount { t.Fatalf("NetStat() parsed %d lines with metrics, expected %d", len(stats), CPUsCount) } if netStatFile.Filename == expected.Filename { if expected.Stats[header] == nil { t.Fatalf("unexpected metric header: %s", header) } for cpu, value := range netStatFile.Stats[header] { if expected.Stats[header][cpu] != value { t.Fatalf("unexpected value for %s for cpu %d in %s: %d, expected %d", header, cpu, netStatFile.Filename, value, expected.Stats[header][cpu]) } } } } } } }	3.92 KB	2025-05-25 12:27
📁 nfs	-	2025-05-25 12:27
📄 proc.go // Copyright 2018 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "bytes" "errors" "fmt" "io" "os" "strconv" "strings" "github.com/prometheus/procfs/internal/util" ) // Proc provides information about a running process. type Proc struct { // The process ID. PID int fs FS } // Procs represents a list of Proc structs. type Procs []Proc var ( ErrFileParse = errors.New("Error Parsing File") ErrFileRead = errors.New("Error Reading File") ErrMountPoint = errors.New("Error Accessing Mount point") ) func (p Procs) Len() int { return len(p) } func (p Procs) Swap(i, j int) { p[i], p[j] = p[j], p[i] } func (p Procs) Less(i, j int) bool { return p[i].PID < p[j].PID } // Self returns a process for the current process read via /proc/self. func Self() (Proc, error) { fs, err := NewFS(DefaultMountPoint) if err != nil \|\| errors.Unwrap(err) == ErrMountPoint { return Proc{}, err } return fs.Self() } // NewProc returns a process for the given pid under /proc. func NewProc(pid int) (Proc, error) { fs, err := NewFS(DefaultMountPoint) if err != nil { return Proc{}, err } return fs.Proc(pid) } // AllProcs returns a list of all currently available processes under /proc. func AllProcs() (Procs, error) { fs, err := NewFS(DefaultMountPoint) if err != nil { return Procs{}, err } return fs.AllProcs() } // Self returns a process for the current process. func (fs FS) Self() (Proc, error) { p, err := os.Readlink(fs.proc.Path("self")) if err != nil { return Proc{}, err } pid, err := strconv.Atoi(strings.Replace(p, string(fs.proc), "", -1)) if err != nil { return Proc{}, err } return fs.Proc(pid) } // NewProc returns a process for the given pid. // // Deprecated: Use fs.Proc() instead. func (fs FS) NewProc(pid int) (Proc, error) { return fs.Proc(pid) } // Proc returns a process for the given pid. func (fs FS) Proc(pid int) (Proc, error) { if _, err := os.Stat(fs.proc.Path(strconv.Itoa(pid))); err != nil { return Proc{}, err } return Proc{PID: pid, fs: fs}, nil } // AllProcs returns a list of all currently available processes. func (fs FS) AllProcs() (Procs, error) { d, err := os.Open(fs.proc.Path()) if err != nil { return Procs{}, err } defer d.Close() names, err := d.Readdirnames(-1) if err != nil { return Procs{}, fmt.Errorf("%w: Cannot read file: %v: %w", ErrFileRead, names, err) } p := Procs{} for _, n := range names { pid, err := strconv.ParseInt(n, 10, 64) if err != nil { continue } p = append(p, Proc{PID: int(pid), fs: fs}) } return p, nil } // CmdLine returns the command line of a process. func (p Proc) CmdLine() ([]string, error) { data, err := util.ReadFileNoStat(p.path("cmdline")) if err != nil { return nil, err } if len(data) < 1 { return []string{}, nil } return strings.Split(string(bytes.TrimRight(data, "\x00")), "\x00"), nil } // Wchan returns the wchan (wait channel) of a process. func (p Proc) Wchan() (string, error) { f, err := os.Open(p.path("wchan")) if err != nil { return "", err } defer f.Close() data, err := io.ReadAll(f) if err != nil { return "", err } wchan := string(data) if wchan == "" \|\| wchan == "0" { return "", nil } return wchan, nil } // Comm returns the command name of a process. func (p Proc) Comm() (string, error) { data, err := util.ReadFileNoStat(p.path("comm")) if err != nil { return "", err } return strings.TrimSpace(string(data)), nil } // Executable returns the absolute path of the executable command of a process. func (p Proc) Executable() (string, error) { exe, err := os.Readlink(p.path("exe")) if os.IsNotExist(err) { return "", nil } return exe, err } // Cwd returns the absolute path to the current working directory of the process. func (p Proc) Cwd() (string, error) { wd, err := os.Readlink(p.path("cwd")) if os.IsNotExist(err) { return "", nil } return wd, err } // RootDir returns the absolute path to the process's root directory (as set by chroot). func (p Proc) RootDir() (string, error) { rdir, err := os.Readlink(p.path("root")) if os.IsNotExist(err) { return "", nil } return rdir, err } // FileDescriptors returns the currently open file descriptors of a process. func (p Proc) FileDescriptors() ([]uintptr, error) { names, err := p.fileDescriptors() if err != nil { return nil, err } fds := make([]uintptr, len(names)) for i, n := range names { fd, err := strconv.ParseInt(n, 10, 32) if err != nil { return nil, fmt.Errorf("%w: Cannot parse line: %v: %w", ErrFileParse, i, err) } fds[i] = uintptr(fd) } return fds, nil } // FileDescriptorTargets returns the targets of all file descriptors of a process. // If a file descriptor is not a symlink to a file (like a socket), that value will be the empty string. func (p Proc) FileDescriptorTargets() ([]string, error) { names, err := p.fileDescriptors() if err != nil { return nil, err } targets := make([]string, len(names)) for i, name := range names { target, err := os.Readlink(p.path("fd", name)) if err == nil { targets[i] = target } } return targets, nil } // FileDescriptorsLen returns the number of currently open file descriptors of // a process. func (p Proc) FileDescriptorsLen() (int, error) { // Use fast path if available (Linux v6.2): https://github.com/torvalds/linux/commit/f1f1f2569901 if p.fs.isReal { stat, err := os.Stat(p.path("fd")) if err != nil { return 0, err } size := stat.Size() if size > 0 { return int(size), nil } } fds, err := p.fileDescriptors() if err != nil { return 0, err } return len(fds), nil } // MountStats retrieves statistics and configuration for mount points in a // process's namespace. func (p Proc) MountStats() ([]Mount, error) { f, err := os.Open(p.path("mountstats")) if err != nil { return nil, err } defer f.Close() return parseMountStats(f) } // MountInfo retrieves mount information for mount points in a // process's namespace. // It supplies information missing in `/proc/self/mounts` and // fixes various other problems with that file too. func (p Proc) MountInfo() ([]MountInfo, error) { data, err := util.ReadFileNoStat(p.path("mountinfo")) if err != nil { return nil, err } return parseMountInfo(data) } func (p Proc) fileDescriptors() ([]string, error) { d, err := os.Open(p.path("fd")) if err != nil { return nil, err } defer d.Close() names, err := d.Readdirnames(-1) if err != nil { return nil, fmt.Errorf("%w: Cannot read file: %v: %w", ErrFileRead, names, err) } return names, nil } func (p Proc) path(pa ...string) string { return p.fs.proc.Path(append([]string{strconv.Itoa(p.PID)}, pa...)...) } // FileDescriptorsInfo retrieves information about all file descriptors of // the process. func (p Proc) FileDescriptorsInfo() (ProcFDInfos, error) { names, err := p.fileDescriptors() if err != nil { return nil, err } var fdinfos ProcFDInfos for _, n := range names { fdinfo, err := p.FDInfo(n) if err != nil { continue } fdinfos = append(fdinfos, *fdinfo) } return fdinfos, nil } // Schedstat returns task scheduling information for the process. func (p Proc) Schedstat() (ProcSchedstat, error) { contents, err := os.ReadFile(p.path("schedstat")) if err != nil { return ProcSchedstat{}, err } return parseProcSchedstat(string(contents)) }	7.73 KB	2025-05-25 12:27
📄 proc_cgroup.go // Copyright 2020 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "bufio" "bytes" "fmt" "strconv" "strings" "github.com/prometheus/procfs/internal/util" ) // Cgroup models one line from /proc/[pid]/cgroup. Each Cgroup struct describes the placement of a PID inside a // specific control hierarchy. The kernel has two cgroup APIs, v1 and v2. v1 has one hierarchy per available resource // controller, while v2 has one unified hierarchy shared by all controllers. Regardless of v1 or v2, all hierarchies // contain all running processes, so the question answerable with a Cgroup struct is 'where is this process in // this hierarchy' (where==what path on the specific cgroupfs). By prefixing this path with the mount point of // this specific hierarchy, you can locate the relevant pseudo-files needed to read/set the data for this PID // in this hierarchy // // Also see http://man7.org/linux/man-pages/man7/cgroups.7.html type Cgroup struct { // HierarchyID that can be matched to a named hierarchy using /proc/cgroups. Cgroups V2 only has one // hierarchy, so HierarchyID is always 0. For cgroups v1 this is a unique ID number HierarchyID int // Controllers using this hierarchy of processes. Controllers are also known as subsystems. For // Cgroups V2 this may be empty, as all active controllers use the same hierarchy Controllers []string // Path of this control group, relative to the mount point of the cgroupfs representing this specific // hierarchy Path string } // parseCgroupString parses each line of the /proc/[pid]/cgroup file // Line format is hierarchyID:[controller1,controller2]:path. func parseCgroupString(cgroupStr string) (Cgroup, error) { var err error fields := strings.SplitN(cgroupStr, ":", 3) if len(fields) < 3 { return nil, fmt.Errorf("%w: 3+ fields required, found %d fields in cgroup string: %s", ErrFileParse, len(fields), cgroupStr) } cgroup := &Cgroup{ Path: fields[2], Controllers: nil, } cgroup.HierarchyID, err = strconv.Atoi(fields[0]) if err != nil { return nil, fmt.Errorf("%w: hierarchy ID: %q", ErrFileParse, cgroup.HierarchyID) } if fields[1] != "" { ssNames := strings.Split(fields[1], ",") cgroup.Controllers = append(cgroup.Controllers, ssNames...) } return cgroup, nil } // parseCgroups reads each line of the /proc/[pid]/cgroup file. func parseCgroups(data []byte) ([]Cgroup, error) { var cgroups []Cgroup scanner := bufio.NewScanner(bytes.NewReader(data)) for scanner.Scan() { mountString := scanner.Text() parsedMounts, err := parseCgroupString(mountString) if err != nil { return nil, err } cgroups = append(cgroups, parsedMounts) } err := scanner.Err() return cgroups, err } // Cgroups reads from /proc/<pid>/cgroups and returns a []*Cgroup struct locating this PID in each process // control hierarchy running on this system. On every system (v1 and v2), all hierarchies contain all processes, // so the len of the returned struct is equal to the number of active hierarchies on this system. func (p Proc) Cgroups() ([]Cgroup, error) { data, err := util.ReadFileNoStat(p.path("cgroup")) if err != nil { return nil, err } return parseCgroups(data) }	3.65 KB	2025-05-25 12:27
📄 proc_cgroup_test.go // Copyright 2020 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "reflect" "testing" ) func TestParseCgroupString(t testing.T) { tests := []struct { name string s string shouldErr bool cgroup Cgroup }{ { name: "cgroups-v1 simple line", s: "10:rdma:/", shouldErr: false, cgroup: &Cgroup{ HierarchyID: 10, Controllers: []string{"rdma"}, Path: "/", }, }, { name: "cgroups-v1 multi-hier line", s: "3:cpu,cpuacct:/user.slice/user-1000.slice/session-10.scope", shouldErr: false, cgroup: &Cgroup{ HierarchyID: 3, Controllers: []string{"cpu", "cpuacct"}, Path: "/user.slice/user-1000.slice/session-10.scope", }, }, { name: "cgroup-v2 line", s: "0::/user.slice/user-1000.slice/user@1000.service/gnome-terminal-server.service", shouldErr: false, cgroup: &Cgroup{ HierarchyID: 0, Controllers: nil, Path: "/user.slice/user-1000.slice/user@1000.service/gnome-terminal-server.service", }, }, { name: "path containing colons", s: "0::/some/long/path:foobar", shouldErr: false, cgroup: &Cgroup{ HierarchyID: 0, Controllers: nil, Path: "/some/long/path:foobar", }, }, { name: "bad hierarchy ID field", s: "a:cpu:/", shouldErr: true, cgroup: nil, }, } for i, test := range tests { t.Logf("[%02d] test %q", i, test.name) cgroup, err := parseCgroupString(test.s) if test.shouldErr && err == nil { t.Errorf("%s: expected an error, but none occurred", test.name) } if !test.shouldErr && err != nil { t.Errorf("%s: unexpected error: %v", test.name, err) } if want, have := test.cgroup, cgroup; !reflect.DeepEqual(want, have) { t.Errorf("cgroup:\nwant:\n%+v\nhave:\n%+v", want, have) } } }	2.36 KB	2025-05-25 12:27
📄 proc_cgroups.go // Copyright 2021 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "bufio" "bytes" "fmt" "strconv" "strings" "github.com/prometheus/procfs/internal/util" ) // CgroupSummary models one line from /proc/cgroups. // This file contains information about the controllers that are compiled into the kernel. // // Also see http://man7.org/linux/man-pages/man7/cgroups.7.html type CgroupSummary struct { // The name of the controller. controller is also known as subsystem. SubsysName string // The unique ID of the cgroup hierarchy on which this controller is mounted. Hierarchy int // The number of control groups in this hierarchy using this controller. Cgroups int // This field contains the value 1 if this controller is enabled, or 0 if it has been disabled Enabled int } // parseCgroupSummary parses each line of the /proc/cgroup file // Line format is `subsys_name hierarchy num_cgroups enabled`. func parseCgroupSummaryString(CgroupSummaryStr string) (CgroupSummary, error) { var err error fields := strings.Fields(CgroupSummaryStr) // require at least 4 fields if len(fields) < 4 { return nil, fmt.Errorf("%w: 4+ fields required, found %d fields in cgroup info string: %s", ErrFileParse, len(fields), CgroupSummaryStr) } CgroupSummary := &CgroupSummary{ SubsysName: fields[0], } CgroupSummary.Hierarchy, err = strconv.Atoi(fields[1]) if err != nil { return nil, fmt.Errorf("%w: Unable to parse hierarchy ID from %q", ErrFileParse, fields[1]) } CgroupSummary.Cgroups, err = strconv.Atoi(fields[2]) if err != nil { return nil, fmt.Errorf("%w: Unable to parse Cgroup Num from %q", ErrFileParse, fields[2]) } CgroupSummary.Enabled, err = strconv.Atoi(fields[3]) if err != nil { return nil, fmt.Errorf("%w: Unable to parse Enabled from %q", ErrFileParse, fields[3]) } return CgroupSummary, nil } // parseCgroupSummary reads each line of the /proc/cgroup file. func parseCgroupSummary(data []byte) ([]CgroupSummary, error) { var CgroupSummarys []CgroupSummary scanner := bufio.NewScanner(bytes.NewReader(data)) for scanner.Scan() { CgroupSummaryString := scanner.Text() // ignore comment lines if strings.HasPrefix(CgroupSummaryString, "#") { continue } CgroupSummary, err := parseCgroupSummaryString(CgroupSummaryString) if err != nil { return nil, err } CgroupSummarys = append(CgroupSummarys, CgroupSummary) } err := scanner.Err() return CgroupSummarys, err } // CgroupSummarys returns information about current /proc/cgroups. func (fs FS) CgroupSummarys() ([]CgroupSummary, error) { data, err := util.ReadFileNoStat(fs.proc.Path("cgroups")) if err != nil { return nil, err } return parseCgroupSummary(data) }	3.17 KB	2025-05-25 12:27
📄 proc_cgroups_test.go // Copyright 2021 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "reflect" "testing" ) func TestParseCgroupSummaryString(t testing.T) { tests := []struct { name string s string shouldErr bool CgroupSummary CgroupSummary }{ { name: "cpuset simple line", s: "cpuset 7 148 1", shouldErr: false, CgroupSummary: &CgroupSummary{ SubsysName: "cpuset", Hierarchy: 7, Cgroups: 148, Enabled: 1, }, }, { name: "memory cgroup number mis format", s: "memory 9 ## 1", shouldErr: true, CgroupSummary: nil, }, } for i, test := range tests { t.Logf("[%02d] test %q", i, test.name) CgroupSummary, err := parseCgroupSummaryString(test.s) if test.shouldErr && err == nil { t.Errorf("%s: expected an error, but none occurred", test.name) } if !test.shouldErr && err != nil { t.Errorf("%s: unexpected error: %v", test.name, err) } if want, have := test.CgroupSummary, CgroupSummary; !reflect.DeepEqual(want, have) { t.Errorf("cgroup:\nwant:\n%+v\nhave:\n%+v", want, have) } } }	1.64 KB	2025-05-25 12:27
📄 proc_environ.go // Copyright 2019 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "strings" "github.com/prometheus/procfs/internal/util" ) // Environ reads process environments from `/proc/<pid>/environ`. func (p Proc) Environ() ([]string, error) { environments := make([]string, 0) data, err := util.ReadFileNoStat(p.path("environ")) if err != nil { return environments, err } environments = strings.Split(string(data), "\000") if len(environments) > 0 { environments = environments[:len(environments)-1] } return environments, nil }	1.06 KB	2025-05-25 12:27
📄 proc_environ_test.go // Copyright 2019 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import "testing" func TestProcEnviron(t *testing.T) { p, err := getProcFixtures(t).Proc(26231) if err != nil { t.Fatal(err) } environments, err := p.Environ() if err != nil { t.Fatal(err) } expectedEnvironments := []string{ "PATH=/go/bin:/usr/local/go/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin", "HOSTNAME=cd24e11f73a5", "TERM=xterm", "GOLANG_VERSION=1.12.5", "GOPATH=/go", "HOME=/root", } if want, have := len(expectedEnvironments), len(environments); want != have { t.Errorf("want %d parsed environments, have %d", want, have) } for i, environment := range environments { if want, have := expectedEnvironments[i], environment; want != have { t.Errorf("%d: want %v, have %v", i, want, have) } } }	1.34 KB	2025-05-25 12:27
📄 proc_fdinfo.go // Copyright 2019 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "bufio" "bytes" "fmt" "regexp" "github.com/prometheus/procfs/internal/util" ) var ( rPos = regexp.MustCompile(`^pos:\s+(\d+)$`) rFlags = regexp.MustCompile(`^flags:\s+(\d+)$`) rMntID = regexp.MustCompile(`^mnt_id:\s+(\d+)$`) rIno = regexp.MustCompile(`^ino:\s+(\d+)$`) rInotify = regexp.MustCompile(`^inotify`) rInotifyParts = regexp.MustCompile(`^inotify\s+wd:([0-9a-f]+)\s+ino:([0-9a-f]+)\s+sdev:([0-9a-f]+)(?:\s+mask:([0-9a-f]+))?`) ) // ProcFDInfo contains represents file descriptor information. type ProcFDInfo struct { // File descriptor FD string // File offset Pos string // File access mode and status flags Flags string // Mount point ID MntID string // Inode number Ino string // List of inotify lines (structured) in the fdinfo file (kernel 3.8+ only) InotifyInfos []InotifyInfo } // FDInfo constructor. On kernels older than 3.8, InotifyInfos will always be empty. func (p Proc) FDInfo(fd string) (ProcFDInfo, error) { data, err := util.ReadFileNoStat(p.path("fdinfo", fd)) if err != nil { return nil, err } var text, pos, flags, mntid, ino string var inotify []InotifyInfo scanner := bufio.NewScanner(bytes.NewReader(data)) for scanner.Scan() { text = scanner.Text() if rPos.MatchString(text) { pos = rPos.FindStringSubmatch(text)[1] } else if rFlags.MatchString(text) { flags = rFlags.FindStringSubmatch(text)[1] } else if rMntID.MatchString(text) { mntid = rMntID.FindStringSubmatch(text)[1] } else if rIno.MatchString(text) { ino = rIno.FindStringSubmatch(text)[1] } else if rInotify.MatchString(text) { newInotify, err := parseInotifyInfo(text) if err != nil { return nil, err } inotify = append(inotify, newInotify) } } i := &ProcFDInfo{ FD: fd, Pos: pos, Flags: flags, MntID: mntid, Ino: ino, InotifyInfos: inotify, } return i, nil } // InotifyInfo represents a single inotify line in the fdinfo file. type InotifyInfo struct { // Watch descriptor number WD string // Inode number Ino string // Device ID Sdev string // Mask of events being monitored Mask string } // InotifyInfo constructor. Only available on kernel 3.8+. func parseInotifyInfo(line string) (*InotifyInfo, error) { m := rInotifyParts.FindStringSubmatch(line) if len(m) >= 4 { var mask string if len(m) == 5 { mask = m[4] } i := &InotifyInfo{ WD: m[1], Ino: m[2], Sdev: m[3], Mask: mask, } return i, nil } return nil, fmt.Errorf("%w: invalid inode entry: %q", ErrFileParse, line) } // ProcFDInfos represents a list of ProcFDInfo structs. type ProcFDInfos []ProcFDInfo func (p ProcFDInfos) Len() int { return len(p) } func (p ProcFDInfos) Swap(i, j int) { p[i], p[j] = p[j], p[i] } func (p ProcFDInfos) Less(i, j int) bool { return p[i].FD < p[j].FD } // InotifyWatchLen returns the total number of inotify watches. func (p ProcFDInfos) InotifyWatchLen() (int, error) { length := 0 for _, f := range p { length += len(f.InotifyInfos) } return length, nil }	3.62 KB	2025-05-25 12:27
📄 proc_fdinfo_test.go // Copyright 2019 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import "testing" func TestInotifyWatchLen(t *testing.T) { p1, err := getProcFixtures(t).Proc(26231) if err != nil { t.Fatal(err) } fdinfos, err := p1.FileDescriptorsInfo() if err != nil { t.Fatal(err) } l, err := fdinfos.InotifyWatchLen() if err != nil { t.Fatal(err) } if want, have := 3, l; want != have { t.Errorf("want length %d, have %d", want, have) } }	989 B	2025-05-25 12:27
📄 proc_interrupts.go // Copyright 2022 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "bufio" "bytes" "errors" "fmt" "io" "strconv" "strings" "github.com/prometheus/procfs/internal/util" ) // Interrupt represents a single interrupt line. type Interrupt struct { // Info is the type of interrupt. Info string // Devices is the name of the device that is located at that IRQ Devices string // Values is the number of interrupts per CPU. Values []string } // Interrupts models the content of /proc/interrupts. Key is the IRQ number. // - https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/6/html/deployment_guide/s2-proc-interrupts // - https://raspberrypi.stackexchange.com/questions/105802/explanation-of-proc-interrupts-output type Interrupts map[string]Interrupt // Interrupts creates a new instance from a given Proc instance. func (p Proc) Interrupts() (Interrupts, error) { data, err := util.ReadFileNoStat(p.path("interrupts")) if err != nil { return nil, err } return parseInterrupts(bytes.NewReader(data)) } func parseInterrupts(r io.Reader) (Interrupts, error) { var ( interrupts = Interrupts{} scanner = bufio.NewScanner(r) ) if !scanner.Scan() { return nil, errors.New("interrupts empty") } cpuNum := len(strings.Fields(scanner.Text())) // one header per cpu for scanner.Scan() { parts := strings.Fields(scanner.Text()) if len(parts) == 0 { // skip empty lines continue } if len(parts) < 2 { return nil, fmt.Errorf("%w: Not enough fields in interrupts (expected 2+ fields but got %d): %s", ErrFileParse, len(parts), parts) } intName := parts[0][:len(parts[0])-1] // remove trailing : if len(parts) == 2 { interrupts[intName] = Interrupt{ Info: "", Devices: "", Values: []string{ parts[1], }, } continue } intr := Interrupt{ Values: parts[1 : cpuNum+1], } if _, err := strconv.Atoi(intName); err == nil { // numeral interrupt intr.Info = parts[cpuNum+1] intr.Devices = strings.Join(parts[cpuNum+2:], " ") } else { intr.Info = strings.Join(parts[cpuNum+1:], " ") } interrupts[intName] = intr } return interrupts, scanner.Err() }	2.65 KB	2025-05-25 12:27
📄 proc_interrupts_test.go // Copyright 2022 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "reflect" "testing" ) func TestProcInterrupts(t testing.T) { p, err := getProcFixtures(t).Proc(26231) if err != nil { t.Fatal(err) } interrupts, err := p.Interrupts() if err != nil { t.Fatal(err) } if want, have := 47, len(interrupts); want != have { t.Errorf("want length %d, have %d", want, have) } for _, test := range []struct { name string irq string want Interrupt }{ { name: "first line", irq: "0", want: Interrupt{ Info: "IO-APIC", Devices: "2-edge timer", Values: []string{"49", "0", "0", "0"}, }, }, { name: "last line", irq: "PIW", want: Interrupt{ Info: "Posted-interrupt wakeup event", Devices: "", Values: []string{"0", "0", "0", "0"}, }, }, { name: "empty devices", irq: "LOC", want: Interrupt{ Info: "Local timer interrupts", Devices: "", Values: []string{"10196", "7429", "8542", "8229"}, }, }, { name: "single value", irq: "ERR", want: Interrupt{ Info: "", Devices: "", Values: []string{"0"}, }, }, } { t.Run(test.name, func(t testing.T) { if value, ok := interrupts[test.irq]; ok { if value.Info != test.want.Info { t.Errorf("info: want %s, have %s", test.want.Info, value.Info) } if value.Devices != test.want.Devices { t.Errorf("devices: want %s, have %s", test.want.Devices, value.Devices) } if !reflect.DeepEqual(value.Values, test.want.Values) { t.Errorf("values: want %v, have %v", test.want.Values, value.Values) } } else { t.Errorf("IRQ %s not found", test.irq) } }) } }	2.18 KB	2025-05-25 12:27
📄 proc_io.go // Copyright 2018 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "fmt" "github.com/prometheus/procfs/internal/util" ) // ProcIO models the content of /proc/<pid>/io. type ProcIO struct { // Chars read. RChar uint64 // Chars written. WChar uint64 // Read syscalls. SyscR uint64 // Write syscalls. SyscW uint64 // Bytes read. ReadBytes uint64 // Bytes written. WriteBytes uint64 // Bytes written, but taking into account truncation. See // Documentation/filesystems/proc.txt in the kernel sources for // detailed explanation. CancelledWriteBytes int64 } // IO creates a new ProcIO instance from a given Proc instance. func (p Proc) IO() (ProcIO, error) { pio := ProcIO{} data, err := util.ReadFileNoStat(p.path("io")) if err != nil { return pio, err } ioFormat := "rchar: %d\nwchar: %d\nsyscr: %d\nsyscw: %d\n" + "read_bytes: %d\nwrite_bytes: %d\n" + "cancelled_write_bytes: %d\n" _, err = fmt.Sscanf(string(data), ioFormat, &pio.RChar, &pio.WChar, &pio.SyscR, &pio.SyscW, &pio.ReadBytes, &pio.WriteBytes, &pio.CancelledWriteBytes) return pio, err }	1.6 KB	2025-05-25 12:27
📄 proc_io_test.go // Copyright 2018 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import "testing" func TestProcIO(t *testing.T) { p, err := getProcFixtures(t).Proc(26231) if err != nil { t.Fatal(err) } s, err := p.IO() if err != nil { t.Fatal(err) } for _, test := range []struct { name string want int64 have int64 }{ {name: "RChar", want: 750339, have: int64(s.RChar)}, {name: "WChar", want: 818609, have: int64(s.WChar)}, {name: "SyscR", want: 7405, have: int64(s.SyscR)}, {name: "SyscW", want: 5245, have: int64(s.SyscW)}, {name: "ReadBytes", want: 1024, have: int64(s.ReadBytes)}, {name: "WriteBytes", want: 2048, have: int64(s.WriteBytes)}, {name: "CancelledWriteBytes", want: -1024, have: s.CancelledWriteBytes}, } { if test.want != test.have { t.Errorf("want %s %d, have %d", test.name, test.want, test.have) } } }	1.36 KB	2025-05-25 12:27
📄 proc_limits.go // Copyright 2018 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "bufio" "fmt" "os" "regexp" "strconv" ) // ProcLimits represents the soft limits for each of the process's resource // limits. For more information see getrlimit(2): // http://man7.org/linux/man-pages/man2/getrlimit.2.html. type ProcLimits struct { // CPU time limit in seconds. CPUTime uint64 // Maximum size of files that the process may create. FileSize uint64 // Maximum size of the process's data segment (initialized data, // uninitialized data, and heap). DataSize uint64 // Maximum size of the process stack in bytes. StackSize uint64 // Maximum size of a core file. CoreFileSize uint64 // Limit of the process's resident set in pages. ResidentSet uint64 // Maximum number of processes that can be created for the real user ID of // the calling process. Processes uint64 // Value one greater than the maximum file descriptor number that can be // opened by this process. OpenFiles uint64 // Maximum number of bytes of memory that may be locked into RAM. LockedMemory uint64 // Maximum size of the process's virtual memory address space in bytes. AddressSpace uint64 // Limit on the combined number of flock(2) locks and fcntl(2) leases that // this process may establish. FileLocks uint64 // Limit of signals that may be queued for the real user ID of the calling // process. PendingSignals uint64 // Limit on the number of bytes that can be allocated for POSIX message // queues for the real user ID of the calling process. MsqqueueSize uint64 // Limit of the nice priority set using setpriority(2) or nice(2). NicePriority uint64 // Limit of the real-time priority set using sched_setscheduler(2) or // sched_setparam(2). RealtimePriority uint64 // Limit (in microseconds) on the amount of CPU time that a process // scheduled under a real-time scheduling policy may consume without making // a blocking system call. RealtimeTimeout uint64 } const ( limitsFields = 4 limitsUnlimited = "unlimited" ) var ( limitsMatch = regexp.MustCompile(`(Max \w+\s{0,1}?\w\s{0,1}\w)\s{2,}(\w+)\s+(\w+)`) ) // NewLimits returns the current soft limits of the process. // // Deprecated: Use p.Limits() instead. func (p Proc) NewLimits() (ProcLimits, error) { return p.Limits() } // Limits returns the current soft limits of the process. func (p Proc) Limits() (ProcLimits, error) { f, err := os.Open(p.path("limits")) if err != nil { return ProcLimits{}, err } defer f.Close() var ( l = ProcLimits{} s = bufio.NewScanner(f) ) s.Scan() // Skip limits header for s.Scan() { //fields := limitsMatch.Split(s.Text(), limitsFields) fields := limitsMatch.FindStringSubmatch(s.Text()) if len(fields) != limitsFields { return ProcLimits{}, fmt.Errorf("%w: couldn't parse %q line %q", ErrFileParse, f.Name(), s.Text()) } switch fields[1] { case "Max cpu time": l.CPUTime, err = parseUint(fields[2]) case "Max file size": l.FileSize, err = parseUint(fields[2]) case "Max data size": l.DataSize, err = parseUint(fields[2]) case "Max stack size": l.StackSize, err = parseUint(fields[2]) case "Max core file size": l.CoreFileSize, err = parseUint(fields[2]) case "Max resident set": l.ResidentSet, err = parseUint(fields[2]) case "Max processes": l.Processes, err = parseUint(fields[2]) case "Max open files": l.OpenFiles, err = parseUint(fields[2]) case "Max locked memory": l.LockedMemory, err = parseUint(fields[2]) case "Max address space": l.AddressSpace, err = parseUint(fields[2]) case "Max file locks": l.FileLocks, err = parseUint(fields[2]) case "Max pending signals": l.PendingSignals, err = parseUint(fields[2]) case "Max msgqueue size": l.MsqqueueSize, err = parseUint(fields[2]) case "Max nice priority": l.NicePriority, err = parseUint(fields[2]) case "Max realtime priority": l.RealtimePriority, err = parseUint(fields[2]) case "Max realtime timeout": l.RealtimeTimeout, err = parseUint(fields[2]) } if err != nil { return ProcLimits{}, err } } return l, s.Err() } func parseUint(s string) (uint64, error) { if s == limitsUnlimited { return 18446744073709551615, nil } i, err := strconv.ParseUint(s, 10, 64) if err != nil { return 0, fmt.Errorf("%w: couldn't parse value %q: %w", ErrFileParse, s, err) } return i, nil }	4.81 KB	2025-05-25 12:27
📄 proc_limits_test.go // Copyright 2018 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import "testing" func TestLimits(t *testing.T) { p, err := getProcFixtures(t).Proc(26231) if err != nil { t.Fatal(err) } l, err := p.Limits() if err != nil { t.Fatal(err) } for _, test := range []struct { name string want uint64 have uint64 }{ {name: "cpu time", want: 18446744073709551615, have: l.CPUTime}, {name: "open files", want: 2048, have: l.OpenFiles}, {name: "msgqueue size", want: 819200, have: l.MsqqueueSize}, {name: "nice priority", want: 0, have: l.NicePriority}, {name: "address space", want: 8589934592, have: l.AddressSpace}, } { if test.want != test.have { t.Errorf("want %s %d, have %d", test.name, test.want, test.have) } } }	1.27 KB	2025-05-25 12:27
📄 proc_maps.go // Copyright 2019 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. //go:build (aix \|\| darwin \|\| dragonfly \|\| freebsd \|\| linux \|\| netbsd \|\| openbsd \|\| solaris) && !js // +build aix darwin dragonfly freebsd linux netbsd openbsd solaris // +build !js package procfs import ( "bufio" "fmt" "os" "strconv" "strings" "golang.org/x/sys/unix" ) // ProcMapPermissions contains permission settings read from `/proc/[pid]/maps`. type ProcMapPermissions struct { // mapping has the [R]ead flag set Read bool // mapping has the [W]rite flag set Write bool // mapping has the [X]ecutable flag set Execute bool // mapping has the [S]hared flag set Shared bool // mapping is marked as [P]rivate (copy on write) Private bool } // ProcMap contains the process memory-mappings of the process // read from `/proc/[pid]/maps`. type ProcMap struct { // The start address of current mapping. StartAddr uintptr // The end address of the current mapping EndAddr uintptr // The permissions for this mapping Perms ProcMapPermissions // The current offset into the file/fd (e.g., shared libs) Offset int64 // Device owner of this mapping (major:minor) in Mkdev format. Dev uint64 // The inode of the device above Inode uint64 // The file or psuedofile (or empty==anonymous) Pathname string } // parseDevice parses the device token of a line and converts it to a dev_t // (mkdev) like structure. func parseDevice(s string) (uint64, error) { i := strings.Index(s, ":") if i == -1 { return 0, fmt.Errorf("%w: expected separator `:` in %s", ErrFileParse, s) } major, err := strconv.ParseUint(s[0:i], 16, 0) if err != nil { return 0, err } minor, err := strconv.ParseUint(s[i+1:], 16, 0) if err != nil { return 0, err } return unix.Mkdev(uint32(major), uint32(minor)), nil } // parseAddress converts a hex-string to a uintptr. func parseAddress(s string) (uintptr, error) { a, err := strconv.ParseUint(s, 16, 0) if err != nil { return 0, err } return uintptr(a), nil } // parseAddresses parses the start-end address. func parseAddresses(s string) (uintptr, uintptr, error) { idx := strings.Index(s, "-") if idx == -1 { return 0, 0, fmt.Errorf("%w: expected separator `-` in %s", ErrFileParse, s) } saddr, err := parseAddress(s[0:idx]) if err != nil { return 0, 0, err } eaddr, err := parseAddress(s[idx+1:]) if err != nil { return 0, 0, err } return saddr, eaddr, nil } // parsePermissions parses a token and returns any that are set. func parsePermissions(s string) (ProcMapPermissions, error) { if len(s) < 4 { return nil, fmt.Errorf("%w: invalid permissions token", ErrFileParse) } perms := ProcMapPermissions{} for _, ch := range s { switch ch { case 'r': perms.Read = true case 'w': perms.Write = true case 'x': perms.Execute = true case 'p': perms.Private = true case 's': perms.Shared = true } } return &perms, nil } // parseProcMap will attempt to parse a single line within a proc/[pid]/maps // buffer. func parseProcMap(text string) (ProcMap, error) { fields := strings.Fields(text) if len(fields) < 5 { return nil, fmt.Errorf("%w: truncated procmap entry", ErrFileParse) } saddr, eaddr, err := parseAddresses(fields[0]) if err != nil { return nil, err } perms, err := parsePermissions(fields[1]) if err != nil { return nil, err } offset, err := strconv.ParseInt(fields[2], 16, 0) if err != nil { return nil, err } device, err := parseDevice(fields[3]) if err != nil { return nil, err } inode, err := strconv.ParseUint(fields[4], 10, 0) if err != nil { return nil, err } pathname := "" if len(fields) >= 5 { pathname = strings.Join(fields[5:], " ") } return &ProcMap{ StartAddr: saddr, EndAddr: eaddr, Perms: perms, Offset: offset, Dev: device, Inode: inode, Pathname: pathname, }, nil } // ProcMaps reads from /proc/[pid]/maps to get the memory-mappings of the // process. func (p Proc) ProcMaps() ([]ProcMap, error) { file, err := os.Open(p.path("maps")) if err != nil { return nil, err } defer file.Close() maps := []*ProcMap{} scan := bufio.NewScanner(file) for scan.Scan() { m, err := parseProcMap(scan.Text()) if err != nil { return nil, err } maps = append(maps, m) } return maps, nil }	4.72 KB	2025-05-25 12:27
📄 proc_maps32_test.go // Copyright 2019 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. //go:build (aix \|\| darwin \|\| dragonfly \|\| freebsd \|\| linux \|\| netbsd \|\| openbsd \|\| solaris) && (386 \|\| arm \|\| mips \|\| mipsle) // +build aix darwin dragonfly freebsd linux netbsd openbsd solaris // +build 386 arm mips mipsle package procfs import ( "testing" "github.com/google/go-cmp/cmp" "golang.org/x/sys/unix" ) func TestProcMaps(t testing.T) { tsts32 := []ProcMap{ { StartAddr: 0x08048000, EndAddr: 0x08089000, Perms: &ProcMapPermissions{true, false, true, false, true}, Offset: 0, Dev: unix.Mkdev(0x03, 0x01), Inode: 104219, Pathname: "/bin/tcsh", }, { StartAddr: 0x08089000, EndAddr: 0x0808c000, Perms: &ProcMapPermissions{true, true, false, false, true}, Offset: 266240, Dev: unix.Mkdev(0x03, 0x01), Inode: 104219, Pathname: "/bin/tcsh", }, { StartAddr: 0x0808c000, EndAddr: 0x08146000, Perms: &ProcMapPermissions{true, true, true, false, true}, Offset: 0, Dev: unix.Mkdev(0x00, 0x00), Inode: 0, Pathname: "", }, { StartAddr: 0x40000000, EndAddr: 0x40015000, Perms: &ProcMapPermissions{true, false, true, false, true}, Offset: 0, Dev: unix.Mkdev(0x03, 0x01), Inode: 61874, Pathname: "/lib/ld-2.3.2.so", }, } // 32-bit test pid and fixtures tpid := 26234 tsts := tsts32 p, err := getProcFixtures(t).Proc(tpid) if err != nil { t.Fatal(err) } maps, err := p.ProcMaps() if err != nil { t.Fatal(err) } if want, have := len(maps), len(tsts); want > have { t.Errorf("want at least %d parsed proc/map entries, have %d", want, have) } for idx, tst := range tsts { want, got := tst, maps[idx] if diff := cmp.Diff(want, got); diff != "" { t.Fatalf("unexpected proc/map entry (-want +got):\n%s", diff) } } }	2.36 KB	2025-05-25 12:27
📄 proc_maps64_test.go // Copyright 2019 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. //go:build (aix \|\| darwin \|\| dragonfly \|\| freebsd \|\| linux \|\| netbsd \|\| openbsd \|\| solaris) && !386 && !arm && !mips && !mipsle // +build aix darwin dragonfly freebsd linux netbsd openbsd solaris // +build !386 // +build !arm // +build !mips // +build !mipsle package procfs import ( "testing" "github.com/google/go-cmp/cmp" "golang.org/x/sys/unix" ) func TestProcMaps(t testing.T) { tsts64 := []ProcMap{ { StartAddr: 0x55680ae1e000, EndAddr: 0x55680ae20000, Perms: &ProcMapPermissions{true, false, false, false, true}, Offset: 0, Dev: unix.Mkdev(0xfd, 0x01), Inode: 47316994, Pathname: "/bin/cat", }, { StartAddr: 0x55680ae29000, EndAddr: 0x55680ae2a000, Perms: &ProcMapPermissions{true, true, true, true, false}, Offset: 40960, Dev: unix.Mkdev(0xfd, 0x01), Inode: 47316994, Pathname: "/bin/cat", }, { StartAddr: 0x55680bed6000, EndAddr: 0x55680bef7000, Perms: &ProcMapPermissions{true, true, false, false, true}, Offset: 0, Dev: unix.Mkdev(0, 0), Inode: 0, Pathname: "[heap]", }, { StartAddr: 0x7fdf964fc000, EndAddr: 0x7fdf973f2000, Perms: &ProcMapPermissions{true, false, false, false, true}, Offset: 0, Dev: unix.Mkdev(0xfd, 0x01), Inode: 17432624, Pathname: "/usr/lib/locale/locale-archive", }, { StartAddr: 0x7fdf973f2000, EndAddr: 0x7fdf97417000, Perms: &ProcMapPermissions{true, false, false, false, true}, Offset: 0, Dev: unix.Mkdev(0xfd, 0x01), Inode: 60571062, Pathname: "/lib/x86_64-linux-gnu/libc-2.29.so", }, { StartAddr: 0x7ffe9215c000, EndAddr: 0x7ffe9217f000, Perms: &ProcMapPermissions{true, true, false, false, true}, Offset: 0, Dev: 0, Inode: 0, Pathname: "[stack]", }, { StartAddr: 0x7ffe921da000, EndAddr: 0x7ffe921dd000, Perms: &ProcMapPermissions{true, false, false, false, true}, Offset: 0, Dev: 0, Inode: 0, Pathname: "[vvar]", }, { StartAddr: 0x7ffe921dd000, EndAddr: 0x7ffe921de000, Perms: &ProcMapPermissions{true, false, true, false, true}, Offset: 0, Dev: 0, Inode: 0, Pathname: "[vdso]", }, { StartAddr: 0xffffffffff600000, EndAddr: 0xffffffffff601000, Perms: &ProcMapPermissions{false, false, true, false, true}, Offset: 0, Dev: 0, Inode: 0, Pathname: "[vsyscall]", }, } // 64-bit test pid and fixtures tpid := 26232 tsts := tsts64 p, err := getProcFixtures(t).Proc(tpid) if err != nil { t.Fatal(err) } maps, err := p.ProcMaps() if err != nil { t.Fatal(err) } if want, have := len(maps), len(tsts); want > have { t.Errorf("want at least %d parsed proc/map entries, have %d", want, have) } for idx, tst := range tsts { want, got := tst, maps[idx] if diff := cmp.Diff(want, got); diff != "" { t.Fatalf("unexpected proc/map entry (-want +got):\n%s", diff) } } } var start, end uintptr func BenchmarkParseAddress(b testing.B) { b.ReportAllocs() var ( s, e uintptr err error ) for i := 0; i < b.N; i++ { s, e, err = parseAddresses("7f7d7469e000-7f7d746a0000") if err != nil { b.Fatal(err) } } // Prevent the compiler from optimizing away benchmark code. start = s end = e } var device uint64 func BenchmarkParseDevice(b testing.B) { b.ReportAllocs() var ( d uint64 err error ) for i := 0; i < b.N; i++ { d, err = parseDevice("00:22") if err != nil { b.Fatal(err) } } // Prevent the compiler from optimizing away benchmark code. device = d }	4.16 KB	2025-05-25 12:27
📄 proc_netstat.go // Copyright 2022 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "bufio" "bytes" "fmt" "io" "strconv" "strings" "github.com/prometheus/procfs/internal/util" ) // ProcNetstat models the content of /proc/<pid>/net/netstat. type ProcNetstat struct { // The process ID. PID int TcpExt IpExt } type TcpExt struct { // nolint:revive SyncookiesSent float64 SyncookiesRecv float64 SyncookiesFailed float64 EmbryonicRsts float64 PruneCalled float64 RcvPruned float64 OfoPruned float64 OutOfWindowIcmps float64 LockDroppedIcmps float64 ArpFilter float64 TW float64 TWRecycled float64 TWKilled float64 PAWSActive float64 PAWSEstab float64 DelayedACKs float64 DelayedACKLocked float64 DelayedACKLost float64 ListenOverflows float64 ListenDrops float64 TCPHPHits float64 TCPPureAcks float64 TCPHPAcks float64 TCPRenoRecovery float64 TCPSackRecovery float64 TCPSACKReneging float64 TCPSACKReorder float64 TCPRenoReorder float64 TCPTSReorder float64 TCPFullUndo float64 TCPPartialUndo float64 TCPDSACKUndo float64 TCPLossUndo float64 TCPLostRetransmit float64 TCPRenoFailures float64 TCPSackFailures float64 TCPLossFailures float64 TCPFastRetrans float64 TCPSlowStartRetrans float64 TCPTimeouts float64 TCPLossProbes float64 TCPLossProbeRecovery float64 TCPRenoRecoveryFail float64 TCPSackRecoveryFail float64 TCPRcvCollapsed float64 TCPDSACKOldSent float64 TCPDSACKOfoSent float64 TCPDSACKRecv float64 TCPDSACKOfoRecv float64 TCPAbortOnData float64 TCPAbortOnClose float64 TCPAbortOnMemory float64 TCPAbortOnTimeout float64 TCPAbortOnLinger float64 TCPAbortFailed float64 TCPMemoryPressures float64 TCPMemoryPressuresChrono float64 TCPSACKDiscard float64 TCPDSACKIgnoredOld float64 TCPDSACKIgnoredNoUndo float64 TCPSpuriousRTOs float64 TCPMD5NotFound float64 TCPMD5Unexpected float64 TCPMD5Failure float64 TCPSackShifted float64 TCPSackMerged float64 TCPSackShiftFallback float64 TCPBacklogDrop float64 PFMemallocDrop float64 TCPMinTTLDrop float64 TCPDeferAcceptDrop float64 IPReversePathFilter float64 TCPTimeWaitOverflow float64 TCPReqQFullDoCookies float64 TCPReqQFullDrop float64 TCPRetransFail float64 TCPRcvCoalesce float64 TCPRcvQDrop float64 TCPOFOQueue float64 TCPOFODrop float64 TCPOFOMerge float64 TCPChallengeACK float64 TCPSYNChallenge float64 TCPFastOpenActive float64 TCPFastOpenActiveFail float64 TCPFastOpenPassive float64 TCPFastOpenPassiveFail float64 TCPFastOpenListenOverflow float64 TCPFastOpenCookieReqd float64 TCPFastOpenBlackhole float64 TCPSpuriousRtxHostQueues float64 BusyPollRxPackets float64 TCPAutoCorking float64 TCPFromZeroWindowAdv float64 TCPToZeroWindowAdv float64 TCPWantZeroWindowAdv float64 TCPSynRetrans float64 TCPOrigDataSent float64 TCPHystartTrainDetect float64 TCPHystartTrainCwnd float64 TCPHystartDelayDetect float64 TCPHystartDelayCwnd float64 TCPACKSkippedSynRecv float64 TCPACKSkippedPAWS float64 TCPACKSkippedSeq float64 TCPACKSkippedFinWait2 float64 TCPACKSkippedTimeWait float64 TCPACKSkippedChallenge float64 TCPWinProbe float64 TCPKeepAlive float64 TCPMTUPFail float64 TCPMTUPSuccess float64 TCPWqueueTooBig float64 } type IpExt struct { // nolint:revive InNoRoutes float64 InTruncatedPkts float64 InMcastPkts float64 OutMcastPkts float64 InBcastPkts float64 OutBcastPkts float64 InOctets float64 OutOctets float64 InMcastOctets float64 OutMcastOctets float64 InBcastOctets float64 OutBcastOctets float64 InCsumErrors float64 InNoECTPkts float64 InECT1Pkts float64 InECT0Pkts float64 InCEPkts float64 ReasmOverlaps *float64 } func (p Proc) Netstat() (ProcNetstat, error) { filename := p.path("net/netstat") data, err := util.ReadFileNoStat(filename) if err != nil { return ProcNetstat{PID: p.PID}, err } procNetstat, err := parseProcNetstat(bytes.NewReader(data), filename) procNetstat.PID = p.PID return procNetstat, err } // parseProcNetstat parses the metrics from proc/<pid>/net/netstat file // and returns a ProcNetstat structure. func parseProcNetstat(r io.Reader, fileName string) (ProcNetstat, error) { var ( scanner = bufio.NewScanner(r) procNetstat = ProcNetstat{} ) for scanner.Scan() { nameParts := strings.Split(scanner.Text(), " ") scanner.Scan() valueParts := strings.Split(scanner.Text(), " ") // Remove trailing :. protocol := strings.TrimSuffix(nameParts[0], ":") if len(nameParts) != len(valueParts) { return procNetstat, fmt.Errorf("%w: mismatch field count mismatch in %s: %s", ErrFileParse, fileName, protocol) } for i := 1; i < len(nameParts); i++ { value, err := strconv.ParseFloat(valueParts[i], 64) if err != nil { return procNetstat, err } key := nameParts[i] switch protocol { case "TcpExt": switch key { case "SyncookiesSent": procNetstat.TcpExt.SyncookiesSent = &value case "SyncookiesRecv": procNetstat.TcpExt.SyncookiesRecv = &value case "SyncookiesFailed": procNetstat.TcpExt.SyncookiesFailed = &value case "EmbryonicRsts": procNetstat.TcpExt.EmbryonicRsts = &value case "PruneCalled": procNetstat.TcpExt.PruneCalled = &value case "RcvPruned": procNetstat.TcpExt.RcvPruned = &value case "OfoPruned": procNetstat.TcpExt.OfoPruned = &value case "OutOfWindowIcmps": procNetstat.TcpExt.OutOfWindowIcmps = &value case "LockDroppedIcmps": procNetstat.TcpExt.LockDroppedIcmps = &value case "ArpFilter": procNetstat.TcpExt.ArpFilter = &value case "TW": procNetstat.TcpExt.TW = &value case "TWRecycled": procNetstat.TcpExt.TWRecycled = &value case "TWKilled": procNetstat.TcpExt.TWKilled = &value case "PAWSActive": procNetstat.TcpExt.PAWSActive = &value case "PAWSEstab": procNetstat.TcpExt.PAWSEstab = &value case "DelayedACKs": procNetstat.TcpExt.DelayedACKs = &value case "DelayedACKLocked": procNetstat.TcpExt.DelayedACKLocked = &value case "DelayedACKLost": procNetstat.TcpExt.DelayedACKLost = &value case "ListenOverflows": procNetstat.TcpExt.ListenOverflows = &value case "ListenDrops": procNetstat.TcpExt.ListenDrops = &value case "TCPHPHits": procNetstat.TcpExt.TCPHPHits = &value case "TCPPureAcks": procNetstat.TcpExt.TCPPureAcks = &value case "TCPHPAcks": procNetstat.TcpExt.TCPHPAcks = &value case "TCPRenoRecovery": procNetstat.TcpExt.TCPRenoRecovery = &value case "TCPSackRecovery": procNetstat.TcpExt.TCPSackRecovery = &value case "TCPSACKReneging": procNetstat.TcpExt.TCPSACKReneging = &value case "TCPSACKReorder": procNetstat.TcpExt.TCPSACKReorder = &value case "TCPRenoReorder": procNetstat.TcpExt.TCPRenoReorder = &value case "TCPTSReorder": procNetstat.TcpExt.TCPTSReorder = &value case "TCPFullUndo": procNetstat.TcpExt.TCPFullUndo = &value case "TCPPartialUndo": procNetstat.TcpExt.TCPPartialUndo = &value case "TCPDSACKUndo": procNetstat.TcpExt.TCPDSACKUndo = &value case "TCPLossUndo": procNetstat.TcpExt.TCPLossUndo = &value case "TCPLostRetransmit": procNetstat.TcpExt.TCPLostRetransmit = &value case "TCPRenoFailures": procNetstat.TcpExt.TCPRenoFailures = &value case "TCPSackFailures": procNetstat.TcpExt.TCPSackFailures = &value case "TCPLossFailures": procNetstat.TcpExt.TCPLossFailures = &value case "TCPFastRetrans": procNetstat.TcpExt.TCPFastRetrans = &value case "TCPSlowStartRetrans": procNetstat.TcpExt.TCPSlowStartRetrans = &value case "TCPTimeouts": procNetstat.TcpExt.TCPTimeouts = &value case "TCPLossProbes": procNetstat.TcpExt.TCPLossProbes = &value case "TCPLossProbeRecovery": procNetstat.TcpExt.TCPLossProbeRecovery = &value case "TCPRenoRecoveryFail": procNetstat.TcpExt.TCPRenoRecoveryFail = &value case "TCPSackRecoveryFail": procNetstat.TcpExt.TCPSackRecoveryFail = &value case "TCPRcvCollapsed": procNetstat.TcpExt.TCPRcvCollapsed = &value case "TCPDSACKOldSent": procNetstat.TcpExt.TCPDSACKOldSent = &value case "TCPDSACKOfoSent": procNetstat.TcpExt.TCPDSACKOfoSent = &value case "TCPDSACKRecv": procNetstat.TcpExt.TCPDSACKRecv = &value case "TCPDSACKOfoRecv": procNetstat.TcpExt.TCPDSACKOfoRecv = &value case "TCPAbortOnData": procNetstat.TcpExt.TCPAbortOnData = &value case "TCPAbortOnClose": procNetstat.TcpExt.TCPAbortOnClose = &value case "TCPDeferAcceptDrop": procNetstat.TcpExt.TCPDeferAcceptDrop = &value case "IPReversePathFilter": procNetstat.TcpExt.IPReversePathFilter = &value case "TCPTimeWaitOverflow": procNetstat.TcpExt.TCPTimeWaitOverflow = &value case "TCPReqQFullDoCookies": procNetstat.TcpExt.TCPReqQFullDoCookies = &value case "TCPReqQFullDrop": procNetstat.TcpExt.TCPReqQFullDrop = &value case "TCPRetransFail": procNetstat.TcpExt.TCPRetransFail = &value case "TCPRcvCoalesce": procNetstat.TcpExt.TCPRcvCoalesce = &value case "TCPRcvQDrop": procNetstat.TcpExt.TCPRcvQDrop = &value case "TCPOFOQueue": procNetstat.TcpExt.TCPOFOQueue = &value case "TCPOFODrop": procNetstat.TcpExt.TCPOFODrop = &value case "TCPOFOMerge": procNetstat.TcpExt.TCPOFOMerge = &value case "TCPChallengeACK": procNetstat.TcpExt.TCPChallengeACK = &value case "TCPSYNChallenge": procNetstat.TcpExt.TCPSYNChallenge = &value case "TCPFastOpenActive": procNetstat.TcpExt.TCPFastOpenActive = &value case "TCPFastOpenActiveFail": procNetstat.TcpExt.TCPFastOpenActiveFail = &value case "TCPFastOpenPassive": procNetstat.TcpExt.TCPFastOpenPassive = &value case "TCPFastOpenPassiveFail": procNetstat.TcpExt.TCPFastOpenPassiveFail = &value case "TCPFastOpenListenOverflow": procNetstat.TcpExt.TCPFastOpenListenOverflow = &value case "TCPFastOpenCookieReqd": procNetstat.TcpExt.TCPFastOpenCookieReqd = &value case "TCPFastOpenBlackhole": procNetstat.TcpExt.TCPFastOpenBlackhole = &value case "TCPSpuriousRtxHostQueues": procNetstat.TcpExt.TCPSpuriousRtxHostQueues = &value case "BusyPollRxPackets": procNetstat.TcpExt.BusyPollRxPackets = &value case "TCPAutoCorking": procNetstat.TcpExt.TCPAutoCorking = &value case "TCPFromZeroWindowAdv": procNetstat.TcpExt.TCPFromZeroWindowAdv = &value case "TCPToZeroWindowAdv": procNetstat.TcpExt.TCPToZeroWindowAdv = &value case "TCPWantZeroWindowAdv": procNetstat.TcpExt.TCPWantZeroWindowAdv = &value case "TCPSynRetrans": procNetstat.TcpExt.TCPSynRetrans = &value case "TCPOrigDataSent": procNetstat.TcpExt.TCPOrigDataSent = &value case "TCPHystartTrainDetect": procNetstat.TcpExt.TCPHystartTrainDetect = &value case "TCPHystartTrainCwnd": procNetstat.TcpExt.TCPHystartTrainCwnd = &value case "TCPHystartDelayDetect": procNetstat.TcpExt.TCPHystartDelayDetect = &value case "TCPHystartDelayCwnd": procNetstat.TcpExt.TCPHystartDelayCwnd = &value case "TCPACKSkippedSynRecv": procNetstat.TcpExt.TCPACKSkippedSynRecv = &value case "TCPACKSkippedPAWS": procNetstat.TcpExt.TCPACKSkippedPAWS = &value case "TCPACKSkippedSeq": procNetstat.TcpExt.TCPACKSkippedSeq = &value case "TCPACKSkippedFinWait2": procNetstat.TcpExt.TCPACKSkippedFinWait2 = &value case "TCPACKSkippedTimeWait": procNetstat.TcpExt.TCPACKSkippedTimeWait = &value case "TCPACKSkippedChallenge": procNetstat.TcpExt.TCPACKSkippedChallenge = &value case "TCPWinProbe": procNetstat.TcpExt.TCPWinProbe = &value case "TCPKeepAlive": procNetstat.TcpExt.TCPKeepAlive = &value case "TCPMTUPFail": procNetstat.TcpExt.TCPMTUPFail = &value case "TCPMTUPSuccess": procNetstat.TcpExt.TCPMTUPSuccess = &value case "TCPWqueueTooBig": procNetstat.TcpExt.TCPWqueueTooBig = &value } case "IpExt": switch key { case "InNoRoutes": procNetstat.IpExt.InNoRoutes = &value case "InTruncatedPkts": procNetstat.IpExt.InTruncatedPkts = &value case "InMcastPkts": procNetstat.IpExt.InMcastPkts = &value case "OutMcastPkts": procNetstat.IpExt.OutMcastPkts = &value case "InBcastPkts": procNetstat.IpExt.InBcastPkts = &value case "OutBcastPkts": procNetstat.IpExt.OutBcastPkts = &value case "InOctets": procNetstat.IpExt.InOctets = &value case "OutOctets": procNetstat.IpExt.OutOctets = &value case "InMcastOctets": procNetstat.IpExt.InMcastOctets = &value case "OutMcastOctets": procNetstat.IpExt.OutMcastOctets = &value case "InBcastOctets": procNetstat.IpExt.InBcastOctets = &value case "OutBcastOctets": procNetstat.IpExt.OutBcastOctets = &value case "InCsumErrors": procNetstat.IpExt.InCsumErrors = &value case "InNoECTPkts": procNetstat.IpExt.InNoECTPkts = &value case "InECT1Pkts": procNetstat.IpExt.InECT1Pkts = &value case "InECT0Pkts": procNetstat.IpExt.InECT0Pkts = &value case "InCEPkts": procNetstat.IpExt.InCEPkts = &value case "ReasmOverlaps": procNetstat.IpExt.ReasmOverlaps = &value } } } } return procNetstat, scanner.Err() }	14.87 KB	2025-05-25 12:27
📄 proc_netstat_test.go // Copyright 2022 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "testing" ) func TestProcNetstat(t testing.T) { p, err := getProcFixtures(t).Proc(26231) if err != nil { t.Fatal(err) } procNetstat, err := p.Netstat() if err != nil { t.Fatal(err) } for _, test := range []struct { name string want float64 have float64 }{ {name: "pid", want: 26231, have: float64(procNetstat.PID)}, {name: "TcpExt:SyncookiesSent", want: 0, have: procNetstat.TcpExt.SyncookiesSent}, {name: "TcpExt:EmbryonicRsts", want: 1, have: procNetstat.TcpExt.EmbryonicRsts}, {name: "TcpExt:TW", want: 83, have: procNetstat.TcpExt.TW}, {name: "TcpExt:PAWSEstab", want: 3640, have: procNetstat.TcpExt.PAWSEstab}, {name: "IpExt:InNoRoutes", want: 0, have: procNetstat.IpExt.InNoRoutes}, {name: "IpExt:InMcastPkts", want: 208, have: procNetstat.IpExt.InMcastPkts}, {name: "IpExt:OutMcastPkts", want: 214, have: procNetstat.IpExt.OutMcastPkts}, } { if test.want != test.have { t.Errorf("want %s %f, have %f", test.name, test.want, test.have) } } }	1.58 KB	2025-05-25 12:27
📄 proc_ns.go // Copyright 2018 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "fmt" "os" "strconv" "strings" ) // Namespace represents a single namespace of a process. type Namespace struct { Type string // Namespace type. Inode uint32 // Inode number of the namespace. If two processes are in the same namespace their inodes will match. } // Namespaces contains all of the namespaces that the process is contained in. type Namespaces map[string]Namespace // Namespaces reads from /proc/<pid>/ns/* to get the namespaces of which the // process is a member. func (p Proc) Namespaces() (Namespaces, error) { d, err := os.Open(p.path("ns")) if err != nil { return nil, err } defer d.Close() names, err := d.Readdirnames(-1) if err != nil { return nil, fmt.Errorf("%w: failed to read contents of ns dir: %w", ErrFileRead, err) } ns := make(Namespaces, len(names)) for _, name := range names { target, err := os.Readlink(p.path("ns", name)) if err != nil { return nil, err } fields := strings.SplitN(target, ":", 2) if len(fields) != 2 { return nil, fmt.Errorf("%w: namespace type and inode from %q", ErrFileParse, target) } typ := fields[0] inode, err := strconv.ParseUint(strings.Trim(fields[1], "[]"), 10, 32) if err != nil { return nil, fmt.Errorf("%w: inode from %q: %w", ErrFileParse, fields[1], err) } ns[name] = Namespace{typ, uint32(inode)} } return ns, nil }	1.92 KB	2025-05-25 12:27
📄 proc_ns_test.go // Copyright 2018 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "testing" ) func TestNewNamespaces(t *testing.T) { p, err := getProcFixtures(t).Proc(26231) if err != nil { t.Fatal(err) } namespaces, err := p.Namespaces() if err != nil { t.Fatal(err) } expectedNamespaces := map[string]Namespace{ "mnt": {"mnt", 4026531840}, "net": {"net", 4026531993}, } if want, have := len(expectedNamespaces), len(namespaces); want != have { t.Errorf("want %d parsed namespaces, have %d", want, have) } for _, ns := range namespaces { if want, have := expectedNamespaces[ns.Type], ns; want != have { t.Errorf("%s: want %v, have %v", ns.Type, want, have) } } }	1.21 KB	2025-05-25 12:27
📄 proc_psi.go // Copyright 2019 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs // The PSI / pressure interface is described at // https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/tree/Documentation/accounting/psi.txt // Each resource (cpu, io, memory, ...) is exposed as a single file. // Each file may contain up to two lines, one for "some" pressure and one for "full" pressure. // Each line contains several averages (over n seconds) and a total in µs. // // Example io pressure file: // > some avg10=0.06 avg60=0.21 avg300=0.99 total=8537362 // > full avg10=0.00 avg60=0.13 avg300=0.96 total=8183134 import ( "bufio" "bytes" "fmt" "io" "strings" "github.com/prometheus/procfs/internal/util" ) const lineFormat = "avg10=%f avg60=%f avg300=%f total=%d" // PSILine is a single line of values as returned by `/proc/pressure/`. // // The Avg entries are averages over n seconds, as a percentage. // The Total line is in microseconds. type PSILine struct { Avg10 float64 Avg60 float64 Avg300 float64 Total uint64 } // PSIStats represent pressure stall information from /proc/pressure/ // // "Some" indicates the share of time in which at least some tasks are stalled. // "Full" indicates the share of time in which all non-idle tasks are stalled simultaneously. type PSIStats struct { Some PSILine Full PSILine } // PSIStatsForResource reads pressure stall information for the specified // resource from /proc/pressure/<resource>. At time of writing this can be // either "cpu", "memory" or "io". func (fs FS) PSIStatsForResource(resource string) (PSIStats, error) { data, err := util.ReadFileNoStat(fs.proc.Path(fmt.Sprintf("%s/%s", "pressure", resource))) if err != nil { return PSIStats{}, fmt.Errorf("%w: psi_stats: unavailable for %q: %w", ErrFileRead, resource, err) } return parsePSIStats(bytes.NewReader(data)) } // parsePSIStats parses the specified file for pressure stall information. func parsePSIStats(r io.Reader) (PSIStats, error) { psiStats := PSIStats{} scanner := bufio.NewScanner(r) for scanner.Scan() { l := scanner.Text() prefix := strings.Split(l, " ")[0] switch prefix { case "some": psi := PSILine{} _, err := fmt.Sscanf(l, fmt.Sprintf("some %s", lineFormat), &psi.Avg10, &psi.Avg60, &psi.Avg300, &psi.Total) if err != nil { return PSIStats{}, err } psiStats.Some = &psi case "full": psi := PSILine{} _, err := fmt.Sscanf(l, fmt.Sprintf("full %s", lineFormat), &psi.Avg10, &psi.Avg60, &psi.Avg300, &psi.Total) if err != nil { return PSIStats{}, err } psiStats.Full = &psi default: // If we encounter a line with an unknown prefix, ignore it and move on // Should new measurement types be added in the future we'll simply ignore them instead // of erroring on retrieval continue } } return psiStats, nil }	3.3 KB	2025-05-25 12:27
📄 proc_psi_test.go // Copyright 2019 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "strings" "testing" ) func TestPSIStats(t testing.T) { t.Run("fake", func(t testing.T) { stats, err := getProcFixtures(t).PSIStatsForResource("fake") if err == nil { t.Fatal("fake resource does not have PSI statistics") } if stats.Some != nil \|\| stats.Full != nil { t.Error("a fake resource cannot have PSILine entries") } }) t.Run("cpu", func(t testing.T) { stats, err := getProcFixtures(t).PSIStatsForResource("cpu") if err != nil { t.Fatal(err) } if stats.Full != nil { t.Fatal("cpu resource cannot have 'full' stats") } if stats.Some == nil { t.Fatal("cpu resource should not have nil 'some' stats") } testCases := []struct { name string got float64 want float64 }{ {"Avg10", stats.Some.Avg10, 0.1}, {"Avg60", stats.Some.Avg60, 2.0}, {"Avg300", stats.Some.Avg300, 3.85}, {"Total", float64(stats.Some.Total), 15.0}, } for _, tc := range testCases { t.Run(tc.name, func(t testing.T) { if tc.got != tc.want { t.Errorf("got: %f, want: %f", tc.got, tc.want) } }) } }) res := []string{"memory", "io"} for _, resource := range res { t.Run(resource, func(t testing.T) { stats, err := getProcFixtures(t).PSIStatsForResource(resource) if err != nil { t.Fatal(err) } if stats.Full == nil { t.Fatalf("%s resource must not have nil 'full' stats", resource) } if stats.Some == nil { t.Fatalf("%s resource must not have nil 'some' stats", resource) } testCases := []struct { name string got float64 want float64 }{ {"some/Avg10", stats.Some.Avg10, 0.1}, {"some/Avg60", stats.Some.Avg60, 2.0}, {"some/Avg300", stats.Some.Avg300, 3.85}, {"some/Total", float64(stats.Some.Total), 15.0}, {"full/Avg10", stats.Full.Avg10, 0.2}, {"full/Avg60", stats.Full.Avg60, 3.0}, {"full/Avg300", stats.Full.Avg300, 4.95}, {"full/Total", float64(stats.Full.Total), 25.0}, } for _, tc := range testCases { t.Run(tc.name, func(t testing.T) { if tc.got != tc.want { t.Errorf("got: %f, want: %f", tc.got, tc.want) } }) } }) } } // TestParsePSIStats tests the edge cases that we won't run into when running TestPSIStats. func TestParsePSIStats(t testing.T) { t.Run("unknown measurement type", func(t testing.T) { raw := "nonsense haha test=fake" _, err := parsePSIStats(strings.NewReader(raw)) if err != nil { t.Error("unknown measurement type must be ignored") } }) t.Run("malformed measurement", func(t testing.T) { t.Run("some", func(t testing.T) { raw := `some avg10=0.10 avg60=2.00 avg300=3.85 total=oops full avg10=0.20 avg60=3.00 avg300=teddy total=25` stats, err := parsePSIStats(strings.NewReader(raw)) if err == nil { t.Error("a malformed line must result in a parse error") } if stats.Some != nil \|\| stats.Full != nil { t.Error("a parse error must result in a nil PSILine") } }) t.Run("full", func(t *testing.T) { raw := `some avg10=0.10 avg60=2.00 avg300=3.85 total=1 full avg10=0.20 avg60=3.00 avg300=test total=25` stats, err := parsePSIStats(strings.NewReader(raw)) t.Log(err) t.Log(stats) if err == nil { t.Error("a malformed line must result in a parse error") } if stats.Some != nil \|\| stats.Full != nil { t.Error("a parse error must result in a nil PSILine") } }) }) }	3.91 KB	2025-05-25 12:27
📄 proc_smaps.go // Copyright 2020 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. //go:build !windows // +build !windows package procfs import ( "bufio" "errors" "fmt" "os" "regexp" "strconv" "strings" "github.com/prometheus/procfs/internal/util" ) var ( // match the header line before each mapped zone in `/proc/pid/smaps`. procSMapsHeaderLine = regexp.MustCompile(`^[a-f0-9].$`) ) type ProcSMapsRollup struct { // Amount of the mapping that is currently resident in RAM. Rss uint64 // Process's proportional share of this mapping. Pss uint64 // Size in bytes of clean shared pages. SharedClean uint64 // Size in bytes of dirty shared pages. SharedDirty uint64 // Size in bytes of clean private pages. PrivateClean uint64 // Size in bytes of dirty private pages. PrivateDirty uint64 // Amount of memory currently marked as referenced or accessed. Referenced uint64 // Amount of memory that does not belong to any file. Anonymous uint64 // Amount would-be-anonymous memory currently on swap. Swap uint64 // Process's proportional memory on swap. SwapPss uint64 } // ProcSMapsRollup reads from /proc/[pid]/smaps_rollup to get summed memory information of the // process. // // If smaps_rollup does not exists (require kernel >= 4.15), the content of /proc/pid/smaps will // we read and summed. func (p Proc) ProcSMapsRollup() (ProcSMapsRollup, error) { data, err := util.ReadFileNoStat(p.path("smaps_rollup")) if err != nil && os.IsNotExist(err) { return p.procSMapsRollupManual() } if err != nil { return ProcSMapsRollup{}, err } lines := strings.Split(string(data), "\n") smaps := ProcSMapsRollup{} // skip first line which don't contains information we need lines = lines[1:] for _, line := range lines { if line == "" { continue } if err := smaps.parseLine(line); err != nil { return ProcSMapsRollup{}, err } } return smaps, nil } // Read /proc/pid/smaps and do the roll-up in Go code. func (p Proc) procSMapsRollupManual() (ProcSMapsRollup, error) { file, err := os.Open(p.path("smaps")) if err != nil { return ProcSMapsRollup{}, err } defer file.Close() smaps := ProcSMapsRollup{} scan := bufio.NewScanner(file) for scan.Scan() { line := scan.Text() if procSMapsHeaderLine.MatchString(line) { continue } if err := smaps.parseLine(line); err != nil { return ProcSMapsRollup{}, err } } return smaps, nil } func (s ProcSMapsRollup) parseLine(line string) error { kv := strings.SplitN(line, ":", 2) if len(kv) != 2 { fmt.Println(line) return errors.New("invalid net/dev line, missing colon") } k := kv[0] if k == "VmFlags" { return nil } v := strings.TrimSpace(kv[1]) v = strings.TrimSuffix(v, " kB") vKBytes, err := strconv.ParseUint(v, 10, 64) if err != nil { return err } vBytes := vKBytes * 1024 s.addValue(k, vBytes) return nil } func (s *ProcSMapsRollup) addValue(k string, vUintBytes uint64) { switch k { case "Rss": s.Rss += vUintBytes case "Pss": s.Pss += vUintBytes case "Shared_Clean": s.SharedClean += vUintBytes case "Shared_Dirty": s.SharedDirty += vUintBytes case "Private_Clean": s.PrivateClean += vUintBytes case "Private_Dirty": s.PrivateDirty += vUintBytes case "Referenced": s.Referenced += vUintBytes case "Anonymous": s.Anonymous += vUintBytes case "Swap": s.Swap += vUintBytes case "SwapPss": s.SwapPss += vUintBytes } }	3.83 KB	2025-05-25 12:27
📄 proc_smaps_test.go // Copyright 2020 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. //go:build !windows // +build !windows package procfs import ( "testing" ) func BenchmarkProcSMapsRollup(b testing.B) { fs, err := NewFS(procTestFixtures) if err != nil { b.Fatalf("Creating pseudo fs from getProcFixtures failed at fixtures/proc with error: %s", err) } p, err := fs.Proc(26231) if err != nil { b.Fatal(err) } b.ResetTimer() for n := 0; n < b.N; n++ { _, _ = p.ProcSMapsRollup() } } func TestProcSmapsRollup(t testing.T) { p, err := getProcFixtures(t).Proc(26231) if err != nil { t.Fatal(err) } s1, err := p.ProcSMapsRollup() if err != nil { t.Fatal(err) } s2, err := p.procSMapsRollupManual() if err != nil { t.Fatal(err) } cases := []struct { name string smaps ProcSMapsRollup }{ { name: "ProcSMapsRollup", smaps: s1, }, { name: "procSMapsRollupManual", smaps: s2, }, } for _, c := range cases { for _, test := range []struct { name string want uint64 have uint64 }{ {name: "Rss", want: 29948 * 1024, have: c.smaps.Rss}, {name: "Pss", want: 29944 * 1024, have: c.smaps.Pss}, {name: "SharedClean", want: 4 * 1024, have: c.smaps.SharedClean}, {name: "SharedDirty", want: 0 * 1024, have: c.smaps.SharedDirty}, {name: "PrivateClean", want: 15548 * 1024, have: c.smaps.PrivateClean}, {name: "PrivateDirty", want: 14396 * 1024, have: c.smaps.PrivateDirty}, {name: "Referenced", want: 24752 * 1024, have: c.smaps.Referenced}, {name: "Anonymous", want: 20756 * 1024, have: c.smaps.Anonymous}, {name: "Swap", want: 1940 * 1024, have: c.smaps.Swap}, {name: "SwapPss", want: 1940 * 1024, have: c.smaps.SwapPss}, } { if test.want != test.have { t.Errorf("want %s %s %d, have %d", c.name, test.name, test.want, test.have) } } } }	2.3 KB	2025-05-25 12:27
📄 proc_snmp.go // Copyright 2022 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "bufio" "bytes" "fmt" "io" "strconv" "strings" "github.com/prometheus/procfs/internal/util" ) // ProcSnmp models the content of /proc/<pid>/net/snmp. type ProcSnmp struct { // The process ID. PID int Ip Icmp IcmpMsg Tcp Udp UdpLite } type Ip struct { // nolint:revive Forwarding float64 DefaultTTL float64 InReceives float64 InHdrErrors float64 InAddrErrors float64 ForwDatagrams float64 InUnknownProtos float64 InDiscards float64 InDelivers float64 OutRequests float64 OutDiscards float64 OutNoRoutes float64 ReasmTimeout float64 ReasmReqds float64 ReasmOKs float64 ReasmFails float64 FragOKs float64 FragFails float64 FragCreates float64 } type Icmp struct { // nolint:revive InMsgs float64 InErrors float64 InCsumErrors float64 InDestUnreachs float64 InTimeExcds float64 InParmProbs float64 InSrcQuenchs float64 InRedirects float64 InEchos float64 InEchoReps float64 InTimestamps float64 InTimestampReps float64 InAddrMasks float64 InAddrMaskReps float64 OutMsgs float64 OutErrors float64 OutDestUnreachs float64 OutTimeExcds float64 OutParmProbs float64 OutSrcQuenchs float64 OutRedirects float64 OutEchos float64 OutEchoReps float64 OutTimestamps float64 OutTimestampReps float64 OutAddrMasks float64 OutAddrMaskReps float64 } type IcmpMsg struct { InType3 float64 OutType3 float64 } type Tcp struct { // nolint:revive RtoAlgorithm float64 RtoMin float64 RtoMax float64 MaxConn float64 ActiveOpens float64 PassiveOpens float64 AttemptFails float64 EstabResets float64 CurrEstab float64 InSegs float64 OutSegs float64 RetransSegs float64 InErrs float64 OutRsts float64 InCsumErrors float64 } type Udp struct { // nolint:revive InDatagrams float64 NoPorts float64 InErrors float64 OutDatagrams float64 RcvbufErrors float64 SndbufErrors float64 InCsumErrors float64 IgnoredMulti float64 } type UdpLite struct { // nolint:revive InDatagrams float64 NoPorts float64 InErrors float64 OutDatagrams float64 RcvbufErrors float64 SndbufErrors float64 InCsumErrors float64 IgnoredMulti *float64 } func (p Proc) Snmp() (ProcSnmp, error) { filename := p.path("net/snmp") data, err := util.ReadFileNoStat(filename) if err != nil { return ProcSnmp{PID: p.PID}, err } procSnmp, err := parseSnmp(bytes.NewReader(data), filename) procSnmp.PID = p.PID return procSnmp, err } // parseSnmp parses the metrics from proc/<pid>/net/snmp file // and returns a map contains those metrics (e.g. {"Ip": {"Forwarding": 2}}). func parseSnmp(r io.Reader, fileName string) (ProcSnmp, error) { var ( scanner = bufio.NewScanner(r) procSnmp = ProcSnmp{} ) for scanner.Scan() { nameParts := strings.Split(scanner.Text(), " ") scanner.Scan() valueParts := strings.Split(scanner.Text(), " ") // Remove trailing :. protocol := strings.TrimSuffix(nameParts[0], ":") if len(nameParts) != len(valueParts) { return procSnmp, fmt.Errorf("%w: mismatch field count mismatch in %s: %s", ErrFileParse, fileName, protocol) } for i := 1; i < len(nameParts); i++ { value, err := strconv.ParseFloat(valueParts[i], 64) if err != nil { return procSnmp, err } key := nameParts[i] switch protocol { case "Ip": switch key { case "Forwarding": procSnmp.Ip.Forwarding = &value case "DefaultTTL": procSnmp.Ip.DefaultTTL = &value case "InReceives": procSnmp.Ip.InReceives = &value case "InHdrErrors": procSnmp.Ip.InHdrErrors = &value case "InAddrErrors": procSnmp.Ip.InAddrErrors = &value case "ForwDatagrams": procSnmp.Ip.ForwDatagrams = &value case "InUnknownProtos": procSnmp.Ip.InUnknownProtos = &value case "InDiscards": procSnmp.Ip.InDiscards = &value case "InDelivers": procSnmp.Ip.InDelivers = &value case "OutRequests": procSnmp.Ip.OutRequests = &value case "OutDiscards": procSnmp.Ip.OutDiscards = &value case "OutNoRoutes": procSnmp.Ip.OutNoRoutes = &value case "ReasmTimeout": procSnmp.Ip.ReasmTimeout = &value case "ReasmReqds": procSnmp.Ip.ReasmReqds = &value case "ReasmOKs": procSnmp.Ip.ReasmOKs = &value case "ReasmFails": procSnmp.Ip.ReasmFails = &value case "FragOKs": procSnmp.Ip.FragOKs = &value case "FragFails": procSnmp.Ip.FragFails = &value case "FragCreates": procSnmp.Ip.FragCreates = &value } case "Icmp": switch key { case "InMsgs": procSnmp.Icmp.InMsgs = &value case "InErrors": procSnmp.Icmp.InErrors = &value case "InCsumErrors": procSnmp.Icmp.InCsumErrors = &value case "InDestUnreachs": procSnmp.Icmp.InDestUnreachs = &value case "InTimeExcds": procSnmp.Icmp.InTimeExcds = &value case "InParmProbs": procSnmp.Icmp.InParmProbs = &value case "InSrcQuenchs": procSnmp.Icmp.InSrcQuenchs = &value case "InRedirects": procSnmp.Icmp.InRedirects = &value case "InEchos": procSnmp.Icmp.InEchos = &value case "InEchoReps": procSnmp.Icmp.InEchoReps = &value case "InTimestamps": procSnmp.Icmp.InTimestamps = &value case "InTimestampReps": procSnmp.Icmp.InTimestampReps = &value case "InAddrMasks": procSnmp.Icmp.InAddrMasks = &value case "InAddrMaskReps": procSnmp.Icmp.InAddrMaskReps = &value case "OutMsgs": procSnmp.Icmp.OutMsgs = &value case "OutErrors": procSnmp.Icmp.OutErrors = &value case "OutDestUnreachs": procSnmp.Icmp.OutDestUnreachs = &value case "OutTimeExcds": procSnmp.Icmp.OutTimeExcds = &value case "OutParmProbs": procSnmp.Icmp.OutParmProbs = &value case "OutSrcQuenchs": procSnmp.Icmp.OutSrcQuenchs = &value case "OutRedirects": procSnmp.Icmp.OutRedirects = &value case "OutEchos": procSnmp.Icmp.OutEchos = &value case "OutEchoReps": procSnmp.Icmp.OutEchoReps = &value case "OutTimestamps": procSnmp.Icmp.OutTimestamps = &value case "OutTimestampReps": procSnmp.Icmp.OutTimestampReps = &value case "OutAddrMasks": procSnmp.Icmp.OutAddrMasks = &value case "OutAddrMaskReps": procSnmp.Icmp.OutAddrMaskReps = &value } case "IcmpMsg": switch key { case "InType3": procSnmp.IcmpMsg.InType3 = &value case "OutType3": procSnmp.IcmpMsg.OutType3 = &value } case "Tcp": switch key { case "RtoAlgorithm": procSnmp.Tcp.RtoAlgorithm = &value case "RtoMin": procSnmp.Tcp.RtoMin = &value case "RtoMax": procSnmp.Tcp.RtoMax = &value case "MaxConn": procSnmp.Tcp.MaxConn = &value case "ActiveOpens": procSnmp.Tcp.ActiveOpens = &value case "PassiveOpens": procSnmp.Tcp.PassiveOpens = &value case "AttemptFails": procSnmp.Tcp.AttemptFails = &value case "EstabResets": procSnmp.Tcp.EstabResets = &value case "CurrEstab": procSnmp.Tcp.CurrEstab = &value case "InSegs": procSnmp.Tcp.InSegs = &value case "OutSegs": procSnmp.Tcp.OutSegs = &value case "RetransSegs": procSnmp.Tcp.RetransSegs = &value case "InErrs": procSnmp.Tcp.InErrs = &value case "OutRsts": procSnmp.Tcp.OutRsts = &value case "InCsumErrors": procSnmp.Tcp.InCsumErrors = &value } case "Udp": switch key { case "InDatagrams": procSnmp.Udp.InDatagrams = &value case "NoPorts": procSnmp.Udp.NoPorts = &value case "InErrors": procSnmp.Udp.InErrors = &value case "OutDatagrams": procSnmp.Udp.OutDatagrams = &value case "RcvbufErrors": procSnmp.Udp.RcvbufErrors = &value case "SndbufErrors": procSnmp.Udp.SndbufErrors = &value case "InCsumErrors": procSnmp.Udp.InCsumErrors = &value case "IgnoredMulti": procSnmp.Udp.IgnoredMulti = &value } case "UdpLite": switch key { case "InDatagrams": procSnmp.UdpLite.InDatagrams = &value case "NoPorts": procSnmp.UdpLite.NoPorts = &value case "InErrors": procSnmp.UdpLite.InErrors = &value case "OutDatagrams": procSnmp.UdpLite.OutDatagrams = &value case "RcvbufErrors": procSnmp.UdpLite.RcvbufErrors = &value case "SndbufErrors": procSnmp.UdpLite.SndbufErrors = &value case "InCsumErrors": procSnmp.UdpLite.InCsumErrors = &value case "IgnoredMulti": procSnmp.UdpLite.IgnoredMulti = &value } } } } return procSnmp, scanner.Err() }	9.19 KB	2025-05-25 12:27
📄 proc_snmp6.go // Copyright 2022 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "bufio" "bytes" "errors" "io" "os" "strconv" "strings" "github.com/prometheus/procfs/internal/util" ) // ProcSnmp6 models the content of /proc/<pid>/net/snmp6. type ProcSnmp6 struct { // The process ID. PID int Ip6 Icmp6 Udp6 UdpLite6 } type Ip6 struct { // nolint:revive InReceives float64 InHdrErrors float64 InTooBigErrors float64 InNoRoutes float64 InAddrErrors float64 InUnknownProtos float64 InTruncatedPkts float64 InDiscards float64 InDelivers float64 OutForwDatagrams float64 OutRequests float64 OutDiscards float64 OutNoRoutes float64 ReasmTimeout float64 ReasmReqds float64 ReasmOKs float64 ReasmFails float64 FragOKs float64 FragFails float64 FragCreates float64 InMcastPkts float64 OutMcastPkts float64 InOctets float64 OutOctets float64 InMcastOctets float64 OutMcastOctets float64 InBcastOctets float64 OutBcastOctets float64 InNoECTPkts float64 InECT1Pkts float64 InECT0Pkts float64 InCEPkts float64 } type Icmp6 struct { InMsgs float64 InErrors float64 OutMsgs float64 OutErrors float64 InCsumErrors float64 InDestUnreachs float64 InPktTooBigs float64 InTimeExcds float64 InParmProblems float64 InEchos float64 InEchoReplies float64 InGroupMembQueries float64 InGroupMembResponses float64 InGroupMembReductions float64 InRouterSolicits float64 InRouterAdvertisements float64 InNeighborSolicits float64 InNeighborAdvertisements float64 InRedirects float64 InMLDv2Reports float64 OutDestUnreachs float64 OutPktTooBigs float64 OutTimeExcds float64 OutParmProblems float64 OutEchos float64 OutEchoReplies float64 OutGroupMembQueries float64 OutGroupMembResponses float64 OutGroupMembReductions float64 OutRouterSolicits float64 OutRouterAdvertisements float64 OutNeighborSolicits float64 OutNeighborAdvertisements float64 OutRedirects float64 OutMLDv2Reports float64 InType1 float64 InType134 float64 InType135 float64 InType136 float64 InType143 float64 OutType133 float64 OutType135 float64 OutType136 float64 OutType143 float64 } type Udp6 struct { // nolint:revive InDatagrams float64 NoPorts float64 InErrors float64 OutDatagrams float64 RcvbufErrors float64 SndbufErrors float64 InCsumErrors float64 IgnoredMulti float64 } type UdpLite6 struct { // nolint:revive InDatagrams float64 NoPorts float64 InErrors float64 OutDatagrams float64 RcvbufErrors float64 SndbufErrors float64 InCsumErrors *float64 } func (p Proc) Snmp6() (ProcSnmp6, error) { filename := p.path("net/snmp6") data, err := util.ReadFileNoStat(filename) if err != nil { // On systems with IPv6 disabled, this file won't exist. // Do nothing. if errors.Is(err, os.ErrNotExist) { return ProcSnmp6{PID: p.PID}, nil } return ProcSnmp6{PID: p.PID}, err } procSnmp6, err := parseSNMP6Stats(bytes.NewReader(data)) procSnmp6.PID = p.PID return procSnmp6, err } // parseSnmp6 parses the metrics from proc/<pid>/net/snmp6 file // and returns a map contains those metrics. func parseSNMP6Stats(r io.Reader) (ProcSnmp6, error) { var ( scanner = bufio.NewScanner(r) procSnmp6 = ProcSnmp6{} ) for scanner.Scan() { stat := strings.Fields(scanner.Text()) if len(stat) < 2 { continue } // Expect to have "6" in metric name, skip line otherwise if sixIndex := strings.Index(stat[0], "6"); sixIndex != -1 { protocol := stat[0][:sixIndex+1] key := stat[0][sixIndex+1:] value, err := strconv.ParseFloat(stat[1], 64) if err != nil { return procSnmp6, err } switch protocol { case "Ip6": switch key { case "InReceives": procSnmp6.Ip6.InReceives = &value case "InHdrErrors": procSnmp6.Ip6.InHdrErrors = &value case "InTooBigErrors": procSnmp6.Ip6.InTooBigErrors = &value case "InNoRoutes": procSnmp6.Ip6.InNoRoutes = &value case "InAddrErrors": procSnmp6.Ip6.InAddrErrors = &value case "InUnknownProtos": procSnmp6.Ip6.InUnknownProtos = &value case "InTruncatedPkts": procSnmp6.Ip6.InTruncatedPkts = &value case "InDiscards": procSnmp6.Ip6.InDiscards = &value case "InDelivers": procSnmp6.Ip6.InDelivers = &value case "OutForwDatagrams": procSnmp6.Ip6.OutForwDatagrams = &value case "OutRequests": procSnmp6.Ip6.OutRequests = &value case "OutDiscards": procSnmp6.Ip6.OutDiscards = &value case "OutNoRoutes": procSnmp6.Ip6.OutNoRoutes = &value case "ReasmTimeout": procSnmp6.Ip6.ReasmTimeout = &value case "ReasmReqds": procSnmp6.Ip6.ReasmReqds = &value case "ReasmOKs": procSnmp6.Ip6.ReasmOKs = &value case "ReasmFails": procSnmp6.Ip6.ReasmFails = &value case "FragOKs": procSnmp6.Ip6.FragOKs = &value case "FragFails": procSnmp6.Ip6.FragFails = &value case "FragCreates": procSnmp6.Ip6.FragCreates = &value case "InMcastPkts": procSnmp6.Ip6.InMcastPkts = &value case "OutMcastPkts": procSnmp6.Ip6.OutMcastPkts = &value case "InOctets": procSnmp6.Ip6.InOctets = &value case "OutOctets": procSnmp6.Ip6.OutOctets = &value case "InMcastOctets": procSnmp6.Ip6.InMcastOctets = &value case "OutMcastOctets": procSnmp6.Ip6.OutMcastOctets = &value case "InBcastOctets": procSnmp6.Ip6.InBcastOctets = &value case "OutBcastOctets": procSnmp6.Ip6.OutBcastOctets = &value case "InNoECTPkts": procSnmp6.Ip6.InNoECTPkts = &value case "InECT1Pkts": procSnmp6.Ip6.InECT1Pkts = &value case "InECT0Pkts": procSnmp6.Ip6.InECT0Pkts = &value case "InCEPkts": procSnmp6.Ip6.InCEPkts = &value } case "Icmp6": switch key { case "InMsgs": procSnmp6.Icmp6.InMsgs = &value case "InErrors": procSnmp6.Icmp6.InErrors = &value case "OutMsgs": procSnmp6.Icmp6.OutMsgs = &value case "OutErrors": procSnmp6.Icmp6.OutErrors = &value case "InCsumErrors": procSnmp6.Icmp6.InCsumErrors = &value case "InDestUnreachs": procSnmp6.Icmp6.InDestUnreachs = &value case "InPktTooBigs": procSnmp6.Icmp6.InPktTooBigs = &value case "InTimeExcds": procSnmp6.Icmp6.InTimeExcds = &value case "InParmProblems": procSnmp6.Icmp6.InParmProblems = &value case "InEchos": procSnmp6.Icmp6.InEchos = &value case "InEchoReplies": procSnmp6.Icmp6.InEchoReplies = &value case "InGroupMembQueries": procSnmp6.Icmp6.InGroupMembQueries = &value case "InGroupMembResponses": procSnmp6.Icmp6.InGroupMembResponses = &value case "InGroupMembReductions": procSnmp6.Icmp6.InGroupMembReductions = &value case "InRouterSolicits": procSnmp6.Icmp6.InRouterSolicits = &value case "InRouterAdvertisements": procSnmp6.Icmp6.InRouterAdvertisements = &value case "InNeighborSolicits": procSnmp6.Icmp6.InNeighborSolicits = &value case "InNeighborAdvertisements": procSnmp6.Icmp6.InNeighborAdvertisements = &value case "InRedirects": procSnmp6.Icmp6.InRedirects = &value case "InMLDv2Reports": procSnmp6.Icmp6.InMLDv2Reports = &value case "OutDestUnreachs": procSnmp6.Icmp6.OutDestUnreachs = &value case "OutPktTooBigs": procSnmp6.Icmp6.OutPktTooBigs = &value case "OutTimeExcds": procSnmp6.Icmp6.OutTimeExcds = &value case "OutParmProblems": procSnmp6.Icmp6.OutParmProblems = &value case "OutEchos": procSnmp6.Icmp6.OutEchos = &value case "OutEchoReplies": procSnmp6.Icmp6.OutEchoReplies = &value case "OutGroupMembQueries": procSnmp6.Icmp6.OutGroupMembQueries = &value case "OutGroupMembResponses": procSnmp6.Icmp6.OutGroupMembResponses = &value case "OutGroupMembReductions": procSnmp6.Icmp6.OutGroupMembReductions = &value case "OutRouterSolicits": procSnmp6.Icmp6.OutRouterSolicits = &value case "OutRouterAdvertisements": procSnmp6.Icmp6.OutRouterAdvertisements = &value case "OutNeighborSolicits": procSnmp6.Icmp6.OutNeighborSolicits = &value case "OutNeighborAdvertisements": procSnmp6.Icmp6.OutNeighborAdvertisements = &value case "OutRedirects": procSnmp6.Icmp6.OutRedirects = &value case "OutMLDv2Reports": procSnmp6.Icmp6.OutMLDv2Reports = &value case "InType1": procSnmp6.Icmp6.InType1 = &value case "InType134": procSnmp6.Icmp6.InType134 = &value case "InType135": procSnmp6.Icmp6.InType135 = &value case "InType136": procSnmp6.Icmp6.InType136 = &value case "InType143": procSnmp6.Icmp6.InType143 = &value case "OutType133": procSnmp6.Icmp6.OutType133 = &value case "OutType135": procSnmp6.Icmp6.OutType135 = &value case "OutType136": procSnmp6.Icmp6.OutType136 = &value case "OutType143": procSnmp6.Icmp6.OutType143 = &value } case "Udp6": switch key { case "InDatagrams": procSnmp6.Udp6.InDatagrams = &value case "NoPorts": procSnmp6.Udp6.NoPorts = &value case "InErrors": procSnmp6.Udp6.InErrors = &value case "OutDatagrams": procSnmp6.Udp6.OutDatagrams = &value case "RcvbufErrors": procSnmp6.Udp6.RcvbufErrors = &value case "SndbufErrors": procSnmp6.Udp6.SndbufErrors = &value case "InCsumErrors": procSnmp6.Udp6.InCsumErrors = &value case "IgnoredMulti": procSnmp6.Udp6.IgnoredMulti = &value } case "UdpLite6": switch key { case "InDatagrams": procSnmp6.UdpLite6.InDatagrams = &value case "NoPorts": procSnmp6.UdpLite6.NoPorts = &value case "InErrors": procSnmp6.UdpLite6.InErrors = &value case "OutDatagrams": procSnmp6.UdpLite6.OutDatagrams = &value case "RcvbufErrors": procSnmp6.UdpLite6.RcvbufErrors = &value case "SndbufErrors": procSnmp6.UdpLite6.SndbufErrors = &value case "InCsumErrors": procSnmp6.UdpLite6.InCsumErrors = &value } } } } return procSnmp6, scanner.Err() }	11.04 KB	2025-05-25 12:27
📄 proc_snmp6_test.go // Copyright 2022 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import "testing" func TestProcSnmp6(t testing.T) { p, err := getProcFixtures(t).Proc(26231) if err != nil { t.Fatal(err) } procSnmp6, err := p.Snmp6() if err != nil { t.Fatal(err) } for _, test := range []struct { name string want float64 have float64 }{ {name: "pid", want: 26231, have: float64(procSnmp6.PID)}, {name: "Ip6InReceives", want: 92166, have: procSnmp6.Ip6.InReceives}, {name: "Ip6InDelivers", want: 92053, have: procSnmp6.Ip6.InDelivers}, {name: "Ip6OutNoRoutes", want: 169, have: procSnmp6.Ip6.OutNoRoutes}, {name: "Ip6InOctets", want: 113479132, have: procSnmp6.Ip6.InOctets}, {name: "Icmp6InMsgs", want: 142, have: procSnmp6.Icmp6.InMsgs}, {name: "Udp6InDatagrams", want: 2016, have: procSnmp6.Udp6.InDatagrams}, {name: "UdpLite6InDatagrams", want: 0, have: procSnmp6.UdpLite6.InDatagrams}, } { if test.want != test.have { t.Errorf("want %s %f, have %f", test.name, test.want, test.have) } } }	1.54 KB	2025-05-25 12:27
📄 proc_snmp_test.go // Copyright 2022 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import "testing" func TestProcSnmp(t testing.T) { p, err := getProcFixtures(t).Proc(26231) if err != nil { t.Fatal(err) } procSnmp, err := p.Snmp() if err != nil { t.Fatal(err) } for _, test := range []struct { name string want float64 have float64 }{ {name: "pid", want: 26231, have: float64(procSnmp.PID)}, {name: "IP:Forwarding", want: 2, have: procSnmp.Ip.Forwarding}, {name: "IP:DefaultTTL", want: 64, have: procSnmp.Ip.DefaultTTL}, {name: "Icmp:InMsgs", want: 45, have: procSnmp.Icmp.InMsgs}, {name: "IcmpMsg:InType3", want: 45, have: procSnmp.IcmpMsg.InType3}, {name: "IcmpMsg:OutType3", want: 50, have: procSnmp.IcmpMsg.OutType3}, {name: "TCP:RtoAlgorithm", want: 1, have: procSnmp.Tcp.RtoAlgorithm}, {name: "TCP:RtoMin", want: 200, have: procSnmp.Tcp.RtoMin}, {name: "Udp:InDatagrams", want: 10179, have: procSnmp.Udp.InDatagrams}, {name: "Udp:NoPorts", want: 50, have: procSnmp.Udp.NoPorts}, {name: "UdpLite:InDatagrams", want: 0, have: procSnmp.UdpLite.NoPorts}, {name: "UdpLite:NoPorts", want: 0, have: procSnmp.UdpLite.NoPorts}, } { if test.want != test.have { t.Errorf("want %s %f, have %f", test.name, test.want, test.have) } } }	1.78 KB	2025-05-25 12:27
📄 proc_stat.go // Copyright 2018 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "bytes" "fmt" "os" "github.com/prometheus/procfs/internal/util" ) // Originally, this USER_HZ value was dynamically retrieved via a sysconf call // which required cgo. However, that caused a lot of problems regarding // cross-compilation. Alternatives such as running a binary to determine the // value, or trying to derive it in some other way were all problematic. After // much research it was determined that USER_HZ is actually hardcoded to 100 on // all Go-supported platforms as of the time of this writing. This is why we // decided to hardcode it here as well. It is not impossible that there could // be systems with exceptions, but they should be very exotic edge cases, and // in that case, the worst outcome will be two misreported metrics. // // See also the following discussions: // // - https://github.com/prometheus/node_exporter/issues/52 // - https://github.com/prometheus/procfs/pull/2 // - http://stackoverflow.com/questions/17410841/how-does-user-hz-solve-the-jiffy-scaling-issue const userHZ = 100 // ProcStat provides status information about the process, // read from /proc/[pid]/stat. type ProcStat struct { // The process ID. PID int // The filename of the executable. Comm string // The process state. State string // The PID of the parent of this process. PPID int // The process group ID of the process. PGRP int // The session ID of the process. Session int // The controlling terminal of the process. TTY int // The ID of the foreground process group of the controlling terminal of // the process. TPGID int // The kernel flags word of the process. Flags uint // The number of minor faults the process has made which have not required // loading a memory page from disk. MinFlt uint // The number of minor faults that the process's waited-for children have // made. CMinFlt uint // The number of major faults the process has made which have required // loading a memory page from disk. MajFlt uint // The number of major faults that the process's waited-for children have // made. CMajFlt uint // Amount of time that this process has been scheduled in user mode, // measured in clock ticks. UTime uint // Amount of time that this process has been scheduled in kernel mode, // measured in clock ticks. STime uint // Amount of time that this process's waited-for children have been // scheduled in user mode, measured in clock ticks. CUTime int // Amount of time that this process's waited-for children have been // scheduled in kernel mode, measured in clock ticks. CSTime int // For processes running a real-time scheduling policy, this is the negated // scheduling priority, minus one. Priority int // The nice value, a value in the range 19 (low priority) to -20 (high // priority). Nice int // Number of threads in this process. NumThreads int // The time the process started after system boot, the value is expressed // in clock ticks. Starttime uint64 // Virtual memory size in bytes. VSize uint // Resident set size in pages. RSS int // Soft limit in bytes on the rss of the process. RSSLimit uint64 // CPU number last executed on. Processor uint // Real-time scheduling priority, a number in the range 1 to 99 for processes // scheduled under a real-time policy, or 0, for non-real-time processes. RTPriority uint // Scheduling policy. Policy uint // Aggregated block I/O delays, measured in clock ticks (centiseconds). DelayAcctBlkIOTicks uint64 // Guest time of the process (time spent running a virtual CPU for a guest // operating system), measured in clock ticks. GuestTime int // Guest time of the process's children, measured in clock ticks. CGuestTime int proc FS } // NewStat returns the current status information of the process. // // Deprecated: Use p.Stat() instead. func (p Proc) NewStat() (ProcStat, error) { return p.Stat() } // Stat returns the current status information of the process. func (p Proc) Stat() (ProcStat, error) { data, err := util.ReadFileNoStat(p.path("stat")) if err != nil { return ProcStat{}, err } var ( ignoreInt64 int64 ignoreUint64 uint64 s = ProcStat{PID: p.PID, proc: p.fs} l = bytes.Index(data, []byte("(")) r = bytes.LastIndex(data, []byte(")")) ) if l < 0 \|\| r < 0 { return ProcStat{}, fmt.Errorf("%w: unexpected format, couldn't extract comm %q", ErrFileParse, data) } s.Comm = string(data[l+1 : r]) // Check the following resources for the details about the particular stat // fields and their data types: // * https://man7.org/linux/man-pages/man5/proc.5.html // * https://man7.org/linux/man-pages/man3/scanf.3.html _, err = fmt.Fscan( bytes.NewBuffer(data[r+2:]), &s.State, &s.PPID, &s.PGRP, &s.Session, &s.TTY, &s.TPGID, &s.Flags, &s.MinFlt, &s.CMinFlt, &s.MajFlt, &s.CMajFlt, &s.UTime, &s.STime, &s.CUTime, &s.CSTime, &s.Priority, &s.Nice, &s.NumThreads, &ignoreInt64, &s.Starttime, &s.VSize, &s.RSS, &s.RSSLimit, &ignoreUint64, &ignoreUint64, &ignoreUint64, &ignoreUint64, &ignoreUint64, &ignoreUint64, &ignoreUint64, &ignoreUint64, &ignoreUint64, &ignoreUint64, &ignoreUint64, &ignoreUint64, &ignoreInt64, &s.Processor, &s.RTPriority, &s.Policy, &s.DelayAcctBlkIOTicks, &s.GuestTime, &s.CGuestTime, ) if err != nil { return ProcStat{}, err } return s, nil } // VirtualMemory returns the virtual memory size in bytes. func (s ProcStat) VirtualMemory() uint { return s.VSize } // ResidentMemory returns the resident memory size in bytes. func (s ProcStat) ResidentMemory() int { return s.RSS * os.Getpagesize() } // StartTime returns the unix timestamp of the process in seconds. func (s ProcStat) StartTime() (float64, error) { stat, err := s.proc.Stat() if err != nil { return 0, err } return float64(stat.BootTime) + (float64(s.Starttime) / userHZ), nil } // CPUTime returns the total CPU user and system time in seconds. func (s ProcStat) CPUTime() float64 { return float64(s.UTime+s.STime) / userHZ }	6.49 KB	2025-05-25 12:27
📄 proc_stat_test.go // Copyright 2018 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "math" "os" "testing" ) func TestProcStat(t testing.T) { p, err := getProcFixtures(t).Proc(26231) if err != nil { t.Fatal(err) } s, err := p.Stat() if err != nil { t.Fatal(err) } // pid stat int fields for _, test := range []struct { name string want int have int }{ {name: "pid", want: 26231, have: s.PID}, {name: "user time", want: 1677, have: int(s.UTime)}, {name: "system time", want: 44, have: int(s.STime)}, {name: "start time", want: 82375, have: int(s.Starttime)}, {name: "virtual memory size", want: 56274944, have: int(s.VSize)}, {name: "resident set size", want: 1981, have: s.RSS}, } { if test.want != test.have { t.Errorf("want %s %d, have %d", test.name, test.want, test.have) } } // pid stat uint64 fields for _, test := range []struct { name string want uint64 have uint64 }{ {name: "RSS Limit", want: 18446744073709551615, have: s.RSSLimit}, {name: "delayacct_blkio_ticks", want: 31, have: s.DelayAcctBlkIOTicks}, } { if test.want != test.have { t.Errorf("want %s %d, have %d", test.name, test.want, test.have) } } // pid stat uint fields for _, test := range []struct { name string want uint have uint }{ {name: "processor", want: 0, have: s.Processor}, {name: "rt_priority", want: 0, have: s.RTPriority}, {name: "policy", want: 0, have: s.Policy}, } { if test.want != test.have { t.Errorf("want %s %d, have %d", test.name, test.want, test.have) } } } func TestProcStatLimits(t testing.T) { p, err := getProcFixtures(t).Proc(26232) if err != nil { t.Fatal(err) } s, err := p.Stat() if err != nil { t.Errorf("want not error, have %s", err) } // max values of stat int fields for _, test := range []struct { name string want int have int }{ {name: "waited for children user time", want: math.MinInt64, have: s.CUTime}, {name: "waited for children system time", want: math.MaxInt64, have: s.CSTime}, } { if test.want != test.have { t.Errorf("want %s %d, have %d", test.name, test.want, test.have) } } } func TestProcStatComm(t testing.T) { s1, err := testProcStat(26231) if err != nil { t.Fatal(err) } if want, have := "vim", s1.Comm; want != have { t.Errorf("want comm %s, have %s", want, have) } s2, err := testProcStat(584) if err != nil { t.Fatal(err) } if want, have := "(a b ) ( c d) ", s2.Comm; want != have { t.Errorf("want comm %s, have %s", want, have) } } func TestProcStatVirtualMemory(t testing.T) { s, err := testProcStat(26231) if err != nil { t.Fatal(err) } if want, have := 56274944, int(s.VirtualMemory()); want != have { t.Errorf("want virtual memory %d, have %d", want, have) } } func TestProcStatResidentMemory(t testing.T) { s, err := testProcStat(26231) if err != nil { t.Fatal(err) } if want, have := 1981os.Getpagesize(), s.ResidentMemory(); want != have { t.Errorf("want resident memory %d, have %d", want, have) } } func TestProcStatStartTime(t testing.T) { s, err := testProcStat(26231) if err != nil { t.Fatal(err) } time, err := s.StartTime() if err != nil { t.Fatal(err) } if want, have := 1418184099.75, time; want != have { t.Errorf("want start time %f, have %f", want, have) } } func TestProcStatCPUTime(t testing.T) { s, err := testProcStat(26231) if err != nil { t.Fatal(err) } if want, have := 17.21, s.CPUTime(); want != have { t.Errorf("want cpu time %f, have %f", want, have) } } func testProcStat(pid int) (ProcStat, error) { fs, err := NewFS(procTestFixtures) if err != nil { return ProcStat{}, err } p, err := fs.Proc(pid) if err != nil { return ProcStat{}, err } return p.Stat() }	4.18 KB	2025-05-25 12:27
📄 proc_status.go // Copyright 2018 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "bytes" "math/bits" "sort" "strconv" "strings" "github.com/prometheus/procfs/internal/util" ) // ProcStatus provides status information about the process, // read from /proc/[pid]/status. type ProcStatus struct { // The process ID. PID int // The process name. Name string // Thread group ID. TGID int // List of Pid namespace. NSpids []uint64 // Peak virtual memory size. VmPeak uint64 // nolint:revive // Virtual memory size. VmSize uint64 // nolint:revive // Locked memory size. VmLck uint64 // nolint:revive // Pinned memory size. VmPin uint64 // nolint:revive // Peak resident set size. VmHWM uint64 // nolint:revive // Resident set size (sum of RssAnnon RssFile and RssShmem). VmRSS uint64 // nolint:revive // Size of resident anonymous memory. RssAnon uint64 // nolint:revive // Size of resident file mappings. RssFile uint64 // nolint:revive // Size of resident shared memory. RssShmem uint64 // nolint:revive // Size of data segments. VmData uint64 // nolint:revive // Size of stack segments. VmStk uint64 // nolint:revive // Size of text segments. VmExe uint64 // nolint:revive // Shared library code size. VmLib uint64 // nolint:revive // Page table entries size. VmPTE uint64 // nolint:revive // Size of second-level page tables. VmPMD uint64 // nolint:revive // Swapped-out virtual memory size by anonymous private. VmSwap uint64 // nolint:revive // Size of hugetlb memory portions HugetlbPages uint64 // Number of voluntary context switches. VoluntaryCtxtSwitches uint64 // Number of involuntary context switches. NonVoluntaryCtxtSwitches uint64 // UIDs of the process (Real, effective, saved set, and filesystem UIDs) UIDs [4]uint64 // GIDs of the process (Real, effective, saved set, and filesystem GIDs) GIDs [4]uint64 // CpusAllowedList: List of cpu cores processes are allowed to run on. CpusAllowedList []uint64 } // NewStatus returns the current status information of the process. func (p Proc) NewStatus() (ProcStatus, error) { data, err := util.ReadFileNoStat(p.path("status")) if err != nil { return ProcStatus{}, err } s := ProcStatus{PID: p.PID} lines := strings.Split(string(data), "\n") for _, line := range lines { if !bytes.Contains([]byte(line), []byte(":")) { continue } kv := strings.SplitN(line, ":", 2) // removes spaces k := strings.TrimSpace(kv[0]) v := strings.TrimSpace(kv[1]) // removes "kB" v = strings.TrimSuffix(v, " kB") // value to int when possible // we can skip error check here, 'cause vKBytes is not used when value is a string vKBytes, _ := strconv.ParseUint(v, 10, 64) // convert kB to B vBytes := vKBytes * 1024 err = s.fillStatus(k, v, vKBytes, vBytes) if err != nil { return ProcStatus{}, err } } return s, nil } func (s *ProcStatus) fillStatus(k string, vString string, vUint uint64, vUintBytes uint64) error { switch k { case "Tgid": s.TGID = int(vUint) case "Name": s.Name = vString case "Uid": var err error for i, v := range strings.Split(vString, "\t") { s.UIDs[i], err = strconv.ParseUint(v, 10, bits.UintSize) if err != nil { return err } } case "Gid": var err error for i, v := range strings.Split(vString, "\t") { s.GIDs[i], err = strconv.ParseUint(v, 10, bits.UintSize) if err != nil { return err } } case "NSpid": s.NSpids = calcNSPidsList(vString) case "VmPeak": s.VmPeak = vUintBytes case "VmSize": s.VmSize = vUintBytes case "VmLck": s.VmLck = vUintBytes case "VmPin": s.VmPin = vUintBytes case "VmHWM": s.VmHWM = vUintBytes case "VmRSS": s.VmRSS = vUintBytes case "RssAnon": s.RssAnon = vUintBytes case "RssFile": s.RssFile = vUintBytes case "RssShmem": s.RssShmem = vUintBytes case "VmData": s.VmData = vUintBytes case "VmStk": s.VmStk = vUintBytes case "VmExe": s.VmExe = vUintBytes case "VmLib": s.VmLib = vUintBytes case "VmPTE": s.VmPTE = vUintBytes case "VmPMD": s.VmPMD = vUintBytes case "VmSwap": s.VmSwap = vUintBytes case "HugetlbPages": s.HugetlbPages = vUintBytes case "voluntary_ctxt_switches": s.VoluntaryCtxtSwitches = vUint case "nonvoluntary_ctxt_switches": s.NonVoluntaryCtxtSwitches = vUint case "Cpus_allowed_list": s.CpusAllowedList = calcCpusAllowedList(vString) } return nil } // TotalCtxtSwitches returns the total context switch. func (s ProcStatus) TotalCtxtSwitches() uint64 { return s.VoluntaryCtxtSwitches + s.NonVoluntaryCtxtSwitches } func calcCpusAllowedList(cpuString string) []uint64 { s := strings.Split(cpuString, ",") var g []uint64 for _, cpu := range s { // parse cpu ranges, example: 1-3=[1,2,3] if l := strings.Split(strings.TrimSpace(cpu), "-"); len(l) > 1 { startCPU, _ := strconv.ParseUint(l[0], 10, 64) endCPU, _ := strconv.ParseUint(l[1], 10, 64) for i := startCPU; i <= endCPU; i++ { g = append(g, i) } } else if len(l) == 1 { cpu, _ := strconv.ParseUint(l[0], 10, 64) g = append(g, cpu) } } sort.Slice(g, func(i, j int) bool { return g[i] < g[j] }) return g } func calcNSPidsList(nspidsString string) []uint64 { s := strings.Split(nspidsString, " ") var nspids []uint64 for _, nspid := range s { nspid, _ := strconv.ParseUint(nspid, 10, 64) if nspid == 0 { continue } nspids = append(nspids, nspid) } return nspids }	5.81 KB	2025-05-25 12:27
📄 proc_status_test.go // Copyright 2018 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "reflect" "testing" ) func TestProcStatus(t testing.T) { p, err := getProcFixtures(t).Proc(26231) if err != nil { t.Fatal(err) } s, err := p.NewStatus() if err != nil { t.Fatal(err) } for _, test := range []struct { name string want int have int }{ {name: "Pid", want: 26231, have: s.PID}, {name: "Tgid", want: 26231, have: s.TGID}, {name: "NSpid", want: 1, have: int(s.NSpids[0])}, {name: "VmPeak", want: 58472 1024, have: int(s.VmPeak)}, {name: "VmSize", want: 58440 * 1024, have: int(s.VmSize)}, {name: "VmLck", want: 0 * 1024, have: int(s.VmLck)}, {name: "VmPin", want: 0 * 1024, have: int(s.VmPin)}, {name: "VmHWM", want: 8028 * 1024, have: int(s.VmHWM)}, {name: "VmRSS", want: 6716 * 1024, have: int(s.VmRSS)}, {name: "RssAnon", want: 2092 * 1024, have: int(s.RssAnon)}, {name: "RssFile", want: 4624 * 1024, have: int(s.RssFile)}, {name: "RssShmem", want: 0 * 1024, have: int(s.RssShmem)}, {name: "VmData", want: 2580 * 1024, have: int(s.VmData)}, {name: "VmStk", want: 136 * 1024, have: int(s.VmStk)}, {name: "VmExe", want: 948 * 1024, have: int(s.VmExe)}, {name: "VmLib", want: 6816 * 1024, have: int(s.VmLib)}, {name: "VmPTE", want: 128 * 1024, have: int(s.VmPTE)}, {name: "VmPMD", want: 12 * 1024, have: int(s.VmPMD)}, {name: "VmSwap", want: 660 * 1024, have: int(s.VmSwap)}, {name: "HugetlbPages", want: 0 * 1024, have: int(s.HugetlbPages)}, {name: "VoluntaryCtxtSwitches", want: 4742839, have: int(s.VoluntaryCtxtSwitches)}, {name: "NonVoluntaryCtxtSwitches", want: 1727500, have: int(s.NonVoluntaryCtxtSwitches)}, {name: "TotalCtxtSwitches", want: 4742839 + 1727500, have: int(s.TotalCtxtSwitches())}, } { if test.want != test.have { t.Errorf("want %s %d, have %d", test.name, test.want, test.have) } } } func TestProcStatusName(t testing.T) { p, err := getProcFixtures(t).Proc(26231) if err != nil { t.Fatal(err) } s, err := p.NewStatus() if err != nil { t.Fatal(err) } if want, have := "prometheus", s.Name; want != have { t.Errorf("want name %s, have %s", want, have) } } func TestProcStatusNameTrim(t testing.T) { p, err := getProcFixtures(t).Proc(26235) if err != nil { t.Fatal(err) } s, err := p.NewStatus() if err != nil { t.Fatal(err) } if want, have := "kube-proxy", s.Name; want != have { t.Errorf("want name %s, have %s", want, have) } } func TestProcStatusUIDs(t testing.T) { p, err := getProcFixtures(t).Proc(26231) if err != nil { t.Fatal(err) } s, err := p.NewStatus() if err != nil { t.Fatal(err) } if want, have := [4]uint64{1000, 1000, 1000, 0}, s.UIDs; want != have { t.Errorf("want uids %v, have %v", want, have) } } func TestProcStatusGIDs(t testing.T) { p, err := getProcFixtures(t).Proc(26231) if err != nil { t.Fatal(err) } s, err := p.NewStatus() if err != nil { t.Fatal(err) } if want, have := [4]uint64{1001, 1001, 1001, 0}, s.GIDs; want != have { t.Errorf("want gids %v, have %v", want, have) } } func TestCpusAllowedList(t *testing.T) { p, err := getProcFixtures(t).Proc(26231) if err != nil { t.Fatal(err) } s, err := p.NewStatus() if err != nil { t.Fatal(err) } if want, have := []uint64{0, 1, 2, 3, 4, 5, 6, 7}, s.CpusAllowedList; !reflect.DeepEqual(want, have) { t.Errorf("want CpusAllowedList %v, have %v", want, have) } }	3.86 KB	2025-05-25 12:27
📄 proc_sys.go // Copyright 2022 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "fmt" "strings" "github.com/prometheus/procfs/internal/util" ) func sysctlToPath(sysctl string) string { return strings.Replace(sysctl, ".", "/", -1) } func (fs FS) SysctlStrings(sysctl string) ([]string, error) { value, err := util.SysReadFile(fs.proc.Path("sys", sysctlToPath(sysctl))) if err != nil { return nil, err } return strings.Fields(value), nil } func (fs FS) SysctlInts(sysctl string) ([]int, error) { fields, err := fs.SysctlStrings(sysctl) if err != nil { return nil, err } values := make([]int, len(fields)) for i, f := range fields { vp := util.NewValueParser(f) values[i] = vp.Int() if err := vp.Err(); err != nil { return nil, fmt.Errorf("%w: field %d in sysctl %s is not a valid int: %w", ErrFileParse, i, sysctl, err) } } return values, nil }	1.38 KB	2025-05-25 12:27
📄 proc_sys_test.go // Copyright 2022 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "testing" "github.com/google/go-cmp/cmp" ) func TestSysctlInts(t testing.T) { fs := getProcFixtures(t) for _, tc := range []struct { sysctl string want []int }{ {"kernel.random.entropy_avail", []int{3943}}, {"vm.lowmem_reserve_ratio", []int{256, 256, 32, 0, 0}}, } { t.Run(tc.sysctl, func(t testing.T) { got, err := fs.SysctlInts(tc.sysctl) if err != nil { t.Fatal(err) } if diff := cmp.Diff(tc.want, got); diff != "" { t.Fatalf("unexpected syscall value(-want +got):\n%s", diff) } }) } } func TestSysctlStrings(t testing.T) { fs := getProcFixtures(t) for _, tc := range []struct { sysctl string want []string }{ {"kernel.seccomp.actions_avail", []string{"kill_process", "kill_thread", "trap", "errno", "trace", "log", "allow"}}, } { t.Run(tc.sysctl, func(t testing.T) { got, err := fs.SysctlStrings(tc.sysctl) if err != nil { t.Fatal(err) } if diff := cmp.Diff(tc.want, got); diff != "" { t.Fatalf("unexpected syscall value(-want +got):\n%s", diff) } }) } } func TestSysctlIntsError(t testing.T) { fs := getProcFixtures(t) for _, tc := range []struct { sysctl string want string }{ {"kernel.seccomp.actions_avail", "Error Parsing File: field 0 in sysctl kernel.seccomp.actions_avail is not a valid int: strconv.ParseInt: parsing \"kill_process\": invalid syntax"}, } { t.Run(tc.sysctl, func(t testing.T) { _, err := fs.SysctlInts(tc.sysctl) if err == nil { t.Fatal("Error Parsing File: expected error") } if diff := cmp.Diff(tc.want, err.Error()); diff != "" { t.Fatalf("unexpected syscall value(-want +got):\n%s", diff) } }) } }	2.23 KB	2025-05-25 12:27
📄 proc_test.go // Copyright 2018 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "reflect" "sort" "testing" ) func TestSelf(t testing.T) { fs := getProcFixtures(t) p1, err := fs.Proc(26231) if err != nil { t.Fatal(err) } p2, err := fs.Self() if err != nil { t.Fatal(err) } if !reflect.DeepEqual(p1, p2) { t.Errorf("want process %v, have %v", p1, p2) } } func TestAllProcs(t testing.T) { procs, err := getProcFixtures(t).AllProcs() if err != nil { t.Fatal(err) } sort.Sort(procs) for i, p := range []Proc{{PID: 584}, {PID: 26231}} { if want, have := p.PID, procs[i].PID; want != have { t.Errorf("want processes %d, have %d", want, have) } } } func TestCmdLine(t testing.T) { for _, tt := range []struct { process int want []string }{ {process: 26231, want: []string{"vim", "test.go", "+10"}}, {process: 26232, want: []string{}}, {process: 26233, want: []string{"com.github.uiautomator"}}, } { p1, err := getProcFixtures(t).Proc(tt.process) if err != nil { t.Fatal(err) } c1, err := p1.CmdLine() if err != nil { t.Fatal(err) } if !reflect.DeepEqual(tt.want, c1) { t.Errorf("want cmdline %v, have %v", tt.want, c1) } } } func TestWchan(t testing.T) { for _, tt := range []struct { process int want string }{ {process: 26231, want: "poll_schedule_timeout"}, {process: 26232, want: ""}, } { p1, err := getProcFixtures(t).Proc(tt.process) if err != nil { t.Fatal(err) } c1, err := p1.Wchan() if err != nil { t.Fatal(err) } if !reflect.DeepEqual(tt.want, c1) { t.Errorf("want wchan %v, have %v", tt.want, c1) } } } func TestComm(t testing.T) { for _, tt := range []struct { process int want string }{ {process: 26231, want: "vim"}, {process: 26232, want: "ata_sff"}, } { p1, err := getProcFixtures(t).Proc(tt.process) if err != nil { t.Fatal(err) } c1, err := p1.Comm() if err != nil { t.Fatal(err) } if !reflect.DeepEqual(tt.want, c1) { t.Errorf("want comm %v, have %v", tt.want, c1) } } } func TestExecutable(t testing.T) { for _, tt := range []struct { process int want string }{ {process: 26231, want: "/usr/bin/vim"}, {process: 26232, want: ""}, } { p, err := getProcFixtures(t).Proc(tt.process) if err != nil { t.Fatal(err) } exe, err := p.Executable() if err != nil { t.Fatal(err) } if !reflect.DeepEqual(tt.want, exe) { t.Errorf("want absolute path to exe %v, have %v", tt.want, exe) } } } func TestCwd(t testing.T) { for _, tt := range []struct { process int want string brokenLink bool }{ {process: 26231, want: "/usr/bin"}, {process: 26232, want: "/does/not/exist", brokenLink: true}, {process: 26233, want: ""}, } { p, err := getProcFixtures(t).Proc(tt.process) if err != nil { t.Fatal(err) } wd, err := p.Cwd() if err != nil { t.Fatal(err) } if !reflect.DeepEqual(tt.want, wd) { if wd == "" && tt.brokenLink { // Allow the result to be empty when can't os.Readlink broken links continue } t.Errorf("want absolute path to cwd %v, have %v", tt.want, wd) } } } func TestRoot(t testing.T) { for _, tt := range []struct { process int want string brokenLink bool }{ {process: 26231, want: "/"}, {process: 26232, want: "/does/not/exist", brokenLink: true}, {process: 26233, want: ""}, } { p, err := getProcFixtures(t).Proc(tt.process) if err != nil { t.Fatal(err) } rdir, err := p.RootDir() if err != nil { t.Fatal(err) } if !reflect.DeepEqual(tt.want, rdir) { if rdir == "" && tt.brokenLink { // Allow the result to be empty when can't os.Readlink broken links continue } t.Errorf("want absolute path to rootdir %v, have %v", tt.want, rdir) } } } func TestFileDescriptors(t testing.T) { p1, err := getProcFixtures(t).Proc(26231) if err != nil { t.Fatal(err) } fds, err := p1.FileDescriptors() if err != nil { t.Fatal(err) } sort.Sort(byUintptr(fds)) if want := []uintptr{0, 1, 2, 3, 10}; !reflect.DeepEqual(want, fds) { t.Errorf("want fds %v, have %v", want, fds) } } func TestFileDescriptorTargets(t testing.T) { p1, err := getProcFixtures(t).Proc(26231) if err != nil { t.Fatal(err) } fds, err := p1.FileDescriptorTargets() if err != nil { t.Fatal(err) } sort.Strings(fds) var want = []string{ "../../symlinktargets/abc", "../../symlinktargets/def", "../../symlinktargets/ghi", "../../symlinktargets/uvw", "../../symlinktargets/xyz", } if !reflect.DeepEqual(want, fds) { t.Errorf("want fds %v, have %v", want, fds) } } func TestFileDescriptorsLen(t testing.T) { p1, err := getProcFixtures(t).Proc(26231) if err != nil { t.Fatal(err) } l, err := p1.FileDescriptorsLen() if err != nil { t.Fatal(err) } if want, have := 5, l; want != have { t.Errorf("want fds %d, have %d", want, have) } } func TestFileDescriptorsInfo(t *testing.T) { p1, err := getProcFixtures(t).Proc(26231) if err != nil { t.Fatal(err) } fdinfos, err := p1.FileDescriptorsInfo() if err != nil { t.Fatal(err) } sort.Sort(fdinfos) var want = ProcFDInfos{ ProcFDInfo{FD: "0", Pos: "0", Flags: "02004000", MntID: "13", InotifyInfos: []InotifyInfo{ InotifyInfo{WD: "3", Ino: "1", Sdev: "34", Mask: "fce"}, InotifyInfo{WD: "2", Ino: "1300016", Sdev: "fd00002", Mask: "fce"}, InotifyInfo{WD: "1", Ino: "2e0001", Sdev: "fd00000", Mask: "fce"}, }}, ProcFDInfo{FD: "1", Pos: "0", Flags: "02004002", MntID: "13", InotifyInfos: nil}, ProcFDInfo{FD: "10", Pos: "0", Flags: "02004002", MntID: "9", InotifyInfos: nil}, ProcFDInfo{FD: "2", Pos: "0", Flags: "02004002", MntID: "9", InotifyInfos: nil}, ProcFDInfo{FD: "3", Pos: "0", Flags: "02004002", MntID: "9", InotifyInfos: nil}, } if !reflect.DeepEqual(want, fdinfos) { t.Errorf("want fdinfos %+v, have %+v", want, fdinfos) } } type byUintptr []uintptr func (a byUintptr) Len() int { return len(a) } func (a byUintptr) Swap(i, j int) { a[i], a[j] = a[j], a[i] } func (a byUintptr) Less(i, j int) bool { return a[i] < a[j] }	6.47 KB	2025-05-25 12:27
📄 schedstat.go // Copyright 2019 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "bufio" "errors" "os" "regexp" "strconv" ) var ( cpuLineRE = regexp.MustCompile(`cpu(\d+) (\d+) (\d+) (\d+) (\d+) (\d+) (\d+) (\d+) (\d+) (\d+)`) procLineRE = regexp.MustCompile(`(\d+) (\d+) (\d+)`) ) // Schedstat contains scheduler statistics from /proc/schedstat // // See // https://www.kernel.org/doc/Documentation/scheduler/sched-stats.txt // for a detailed description of what these numbers mean. // // Note the current kernel documentation claims some of the time units are in // jiffies when they are actually in nanoseconds since 2.6.23 with the // introduction of CFS. A fix to the documentation is pending. See // https://lore.kernel.org/patchwork/project/lkml/list/?series=403473 type Schedstat struct { CPUs []SchedstatCPU } // SchedstatCPU contains the values from one "cpu<N>" line. type SchedstatCPU struct { CPUNum string RunningNanoseconds uint64 WaitingNanoseconds uint64 RunTimeslices uint64 } // ProcSchedstat contains the values from `/proc/<pid>/schedstat`. type ProcSchedstat struct { RunningNanoseconds uint64 WaitingNanoseconds uint64 RunTimeslices uint64 } // Schedstat reads data from `/proc/schedstat`. func (fs FS) Schedstat() (Schedstat, error) { file, err := os.Open(fs.proc.Path("schedstat")) if err != nil { return nil, err } defer file.Close() stats := &Schedstat{} scanner := bufio.NewScanner(file) for scanner.Scan() { match := cpuLineRE.FindStringSubmatch(scanner.Text()) if match != nil { cpu := &SchedstatCPU{} cpu.CPUNum = match[1] cpu.RunningNanoseconds, err = strconv.ParseUint(match[8], 10, 64) if err != nil { continue } cpu.WaitingNanoseconds, err = strconv.ParseUint(match[9], 10, 64) if err != nil { continue } cpu.RunTimeslices, err = strconv.ParseUint(match[10], 10, 64) if err != nil { continue } stats.CPUs = append(stats.CPUs, cpu) } } return stats, nil } func parseProcSchedstat(contents string) (ProcSchedstat, error) { var ( stats ProcSchedstat err error ) match := procLineRE.FindStringSubmatch(contents) if match != nil { stats.RunningNanoseconds, err = strconv.ParseUint(match[1], 10, 64) if err != nil { return stats, err } stats.WaitingNanoseconds, err = strconv.ParseUint(match[2], 10, 64) if err != nil { return stats, err } stats.RunTimeslices, err = strconv.ParseUint(match[3], 10, 64) return stats, err } return stats, errors.New("could not parse schedstat") }	3.02 KB	2025-05-25 12:27
📄 schedstat_test.go // Copyright 2019 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "testing" ) func TestSchedstat(t testing.T) { stats, err := getProcFixtures(t).Schedstat() if err != nil { t.Fatal(err) } if len(stats.CPUs) != 2 { t.Errorf("expected 2 CPUs, got %v", len(stats.CPUs)) } var cpu SchedstatCPU for _, cpu = range stats.CPUs { if cpu.CPUNum == "0" { break } } if cpu == nil \|\| cpu.CPUNum != "0" { t.Error("could not find cpu0") } if want, have := uint64(2045936778163039), cpu.RunningNanoseconds; want != have { t.Errorf("want RunningNanoseconds %v, have %v", want, have) } if want, have := uint64(343796328169361), cpu.WaitingNanoseconds; want != have { t.Errorf("want WaitingNanoseconds %v, have %v", want, have) } if want, have := uint64(4767485306), cpu.RunTimeslices; want != have { t.Errorf("want RunTimeslices %v, have %v", want, have) } } func TestProcSchedstat(t testing.T) { p1, err := getProcFixtures(t).Proc(26231) if err != nil { t.Fatal(err) } schedstat, err := p1.Schedstat() if err != nil { t.Fatal(err) } if want, have := uint64(411605849), schedstat.RunningNanoseconds; want != have { t.Errorf("want RunningNanoseconds %v, have %v", want, have) } if want, have := uint64(93680043), schedstat.WaitingNanoseconds; want != have { t.Errorf("want WaitingNanoseconds %v, have %v", want, have) } if want, have := uint64(79), schedstat.RunTimeslices; want != have { t.Errorf("want RunTimeslices %v, have %v", want, have) } } func TestProcSchedstatErrors(t testing.T) { p1, err := getProcFixtures(t).Proc(26232) if err != nil { t.Fatal(err) } _, err = p1.Schedstat() if err == nil { t.Error("proc 26232 doesn't have schedstat -- should have gotten an error") } p2, err := getProcFixtures(t).Proc(26233) if err != nil { t.Fatal(err) } _, err = p2.Schedstat() if err == nil { t.Error("proc 26233 has malformed schedstat -- should have gotten an error") } } // schedstat can have a 2nd line: it should be ignored. func TestProcSchedstatMultipleLines(t testing.T) { schedstat, err := parseProcSchedstat("123 456 789\n10 11\n") if err != nil { t.Fatal(err) } if want, have := uint64(123), schedstat.RunningNanoseconds; want != have { t.Errorf("want RunningNanoseconds %v, have %v", want, have) } if want, have := uint64(456), schedstat.WaitingNanoseconds; want != have { t.Errorf("want WaitingNanoseconds %v, have %v", want, have) } if want, have := uint64(789), schedstat.RunTimeslices; want != have { t.Errorf("want RunTimeslices %v, have %v", want, have) } } func TestProcSchedstatUnparsableInt(t testing.T) { if _, err := parseProcSchedstat("abc 456 789\n"); err == nil { t.Error("schedstat should have been unparsable\n") } if _, err := parseProcSchedstat("123 abc 789\n"); err == nil { t.Error("schedstat should have been unparsable\n") } if _, err := parseProcSchedstat("123 456 abc\n"); err == nil { t.Error("schedstat should have been unparsable\n") } }	3.46 KB	2025-05-25 12:27
📁 scripts	-	2025-05-25 12:27
📄 slab.go // Copyright 2020 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "bufio" "bytes" "fmt" "regexp" "strconv" "strings" "github.com/prometheus/procfs/internal/util" ) var ( slabSpace = regexp.MustCompile(`\s+`) slabVer = regexp.MustCompile(`slabinfo -`) slabHeader = regexp.MustCompile(`# name`) ) // Slab represents a slab pool in the kernel. type Slab struct { Name string ObjActive int64 ObjNum int64 ObjSize int64 ObjPerSlab int64 PagesPerSlab int64 // tunables Limit int64 Batch int64 SharedFactor int64 SlabActive int64 SlabNum int64 SharedAvail int64 } // SlabInfo represents info for all slabs. type SlabInfo struct { Slabs []Slab } func shouldParseSlab(line string) bool { if slabVer.MatchString(line) { return false } if slabHeader.MatchString(line) { return false } return true } // parseV21SlabEntry is used to parse a line from /proc/slabinfo version 2.1. func parseV21SlabEntry(line string) (Slab, error) { // First cleanup whitespace. l := slabSpace.ReplaceAllString(line, " ") s := strings.Split(l, " ") if len(s) != 16 { return nil, fmt.Errorf("%w: unable to parse: %q", ErrFileParse, line) } var err error i := &Slab{Name: s[0]} i.ObjActive, err = strconv.ParseInt(s[1], 10, 64) if err != nil { return nil, err } i.ObjNum, err = strconv.ParseInt(s[2], 10, 64) if err != nil { return nil, err } i.ObjSize, err = strconv.ParseInt(s[3], 10, 64) if err != nil { return nil, err } i.ObjPerSlab, err = strconv.ParseInt(s[4], 10, 64) if err != nil { return nil, err } i.PagesPerSlab, err = strconv.ParseInt(s[5], 10, 64) if err != nil { return nil, err } i.Limit, err = strconv.ParseInt(s[8], 10, 64) if err != nil { return nil, err } i.Batch, err = strconv.ParseInt(s[9], 10, 64) if err != nil { return nil, err } i.SharedFactor, err = strconv.ParseInt(s[10], 10, 64) if err != nil { return nil, err } i.SlabActive, err = strconv.ParseInt(s[13], 10, 64) if err != nil { return nil, err } i.SlabNum, err = strconv.ParseInt(s[14], 10, 64) if err != nil { return nil, err } i.SharedAvail, err = strconv.ParseInt(s[15], 10, 64) if err != nil { return nil, err } return i, nil } // parseSlabInfo21 is used to parse a slabinfo 2.1 file. func parseSlabInfo21(r bytes.Reader) (SlabInfo, error) { scanner := bufio.NewScanner(r) s := SlabInfo{Slabs: []Slab{}} for scanner.Scan() { line := scanner.Text() if !shouldParseSlab(line) { continue } slab, err := parseV21SlabEntry(line) if err != nil { return s, err } s.Slabs = append(s.Slabs, slab) } return s, nil } // SlabInfo reads data from `/proc/slabinfo`. func (fs FS) SlabInfo() (SlabInfo, error) { // TODO: Consider passing options to allow for parsing different // slabinfo versions. However, slabinfo 2.1 has been stable since // kernel 2.6.10 and later. data, err := util.ReadFileNoStat(fs.proc.Path("slabinfo")) if err != nil { return SlabInfo{}, err } return parseSlabInfo21(bytes.NewReader(data)) }	3.52 KB	2025-05-25 12:27
📄 slab_test.go // Copyright 2020 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "testing" ) func TestSlabInfo(t *testing.T) { slabs, err := getProcFixtures(t).SlabInfo() if err != nil { t.Fatal(err) } if numSlabs := len(slabs.Slabs); numSlabs != 300 { t.Errorf("expected 300 slabs, got %v", numSlabs) } if name := slabs.Slabs[0].Name; name != "pid_3" { t.Errorf("Expected slab name to be 'pid_3', got %v", name) } if objActive := slabs.Slabs[0].ObjActive; objActive != 375 { t.Errorf("Expected slab objects active to be 375, got %v", objActive) } if objNum := slabs.Slabs[0].ObjNum; objNum != 532 { t.Errorf("Expected slab objects number to be 532, got %v", objNum) } if objSize := slabs.Slabs[0].ObjSize; objSize != 576 { t.Errorf("Expected slab objects Size to be 576, got %+v", objSize) } if objPerSlab := slabs.Slabs[0].ObjPerSlab; objPerSlab != 28 { t.Errorf("Expected slab objects per slab to be 28, got %v", objPerSlab) } if pagesPerSlab := slabs.Slabs[0].PagesPerSlab; pagesPerSlab != 4 { t.Errorf("Expected pages per slab to be 4, got %v", pagesPerSlab) } if limit := slabs.Slabs[0].Limit; limit != 0 { t.Errorf("Expected limit to be 0, got %v", limit) } if batch := slabs.Slabs[0].Batch; batch != 0 { t.Errorf("Expected batch to be 0, got %v", batch) } if sharedFactor := slabs.Slabs[0].SharedFactor; sharedFactor != 0 { t.Errorf("Expected shared factor to be 0, got %v", sharedFactor) } if slabActive := slabs.Slabs[0].SlabActive; slabActive != 19 { t.Errorf("Expected slab active to be 19, got %v", slabActive) } if slabNum := slabs.Slabs[0].SlabNum; slabNum != 19 { t.Errorf("Expected slab num to be 19, got %v", slabNum) } if sharedAvail := slabs.Slabs[0].SharedAvail; sharedAvail != 0 { t.Errorf("Expected shared available to be 0, got %v", sharedAvail) } }	2.31 KB	2025-05-25 12:27
📄 softirqs.go // Copyright 2022 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "bufio" "bytes" "fmt" "io" "strconv" "strings" "github.com/prometheus/procfs/internal/util" ) // Softirqs represents the softirq statistics. type Softirqs struct { Hi []uint64 Timer []uint64 NetTx []uint64 NetRx []uint64 Block []uint64 IRQPoll []uint64 Tasklet []uint64 Sched []uint64 HRTimer []uint64 RCU []uint64 } func (fs FS) Softirqs() (Softirqs, error) { fileName := fs.proc.Path("softirqs") data, err := util.ReadFileNoStat(fileName) if err != nil { return Softirqs{}, err } reader := bytes.NewReader(data) return parseSoftirqs(reader) } func parseSoftirqs(r io.Reader) (Softirqs, error) { var ( softirqs = Softirqs{} scanner = bufio.NewScanner(r) ) if !scanner.Scan() { return Softirqs{}, fmt.Errorf("%w: softirqs empty", ErrFileRead) } for scanner.Scan() { parts := strings.Fields(scanner.Text()) var err error // require at least one cpu if len(parts) < 2 { continue } switch { case parts[0] == "HI:": perCPU := parts[1:] softirqs.Hi = make([]uint64, len(perCPU)) for i, count := range perCPU { if softirqs.Hi[i], err = strconv.ParseUint(count, 10, 64); err != nil { return Softirqs{}, fmt.Errorf("%w: couldn't parse %q (HI%d): %w", ErrFileParse, count, i, err) } } case parts[0] == "TIMER:": perCPU := parts[1:] softirqs.Timer = make([]uint64, len(perCPU)) for i, count := range perCPU { if softirqs.Timer[i], err = strconv.ParseUint(count, 10, 64); err != nil { return Softirqs{}, fmt.Errorf("%w: couldn't parse %q (TIMER%d): %w", ErrFileParse, count, i, err) } } case parts[0] == "NET_TX:": perCPU := parts[1:] softirqs.NetTx = make([]uint64, len(perCPU)) for i, count := range perCPU { if softirqs.NetTx[i], err = strconv.ParseUint(count, 10, 64); err != nil { return Softirqs{}, fmt.Errorf("%w: couldn't parse %q (NET_TX%d): %w", ErrFileParse, count, i, err) } } case parts[0] == "NET_RX:": perCPU := parts[1:] softirqs.NetRx = make([]uint64, len(perCPU)) for i, count := range perCPU { if softirqs.NetRx[i], err = strconv.ParseUint(count, 10, 64); err != nil { return Softirqs{}, fmt.Errorf("%w: couldn't parse %q (NET_RX%d): %w", ErrFileParse, count, i, err) } } case parts[0] == "BLOCK:": perCPU := parts[1:] softirqs.Block = make([]uint64, len(perCPU)) for i, count := range perCPU { if softirqs.Block[i], err = strconv.ParseUint(count, 10, 64); err != nil { return Softirqs{}, fmt.Errorf("%w: couldn't parse %q (BLOCK%d): %w", ErrFileParse, count, i, err) } } case parts[0] == "IRQ_POLL:": perCPU := parts[1:] softirqs.IRQPoll = make([]uint64, len(perCPU)) for i, count := range perCPU { if softirqs.IRQPoll[i], err = strconv.ParseUint(count, 10, 64); err != nil { return Softirqs{}, fmt.Errorf("%w: couldn't parse %q (IRQ_POLL%d): %w", ErrFileParse, count, i, err) } } case parts[0] == "TASKLET:": perCPU := parts[1:] softirqs.Tasklet = make([]uint64, len(perCPU)) for i, count := range perCPU { if softirqs.Tasklet[i], err = strconv.ParseUint(count, 10, 64); err != nil { return Softirqs{}, fmt.Errorf("%w: couldn't parse %q (TASKLET%d): %w", ErrFileParse, count, i, err) } } case parts[0] == "SCHED:": perCPU := parts[1:] softirqs.Sched = make([]uint64, len(perCPU)) for i, count := range perCPU { if softirqs.Sched[i], err = strconv.ParseUint(count, 10, 64); err != nil { return Softirqs{}, fmt.Errorf("%w: couldn't parse %q (SCHED%d): %w", ErrFileParse, count, i, err) } } case parts[0] == "HRTIMER:": perCPU := parts[1:] softirqs.HRTimer = make([]uint64, len(perCPU)) for i, count := range perCPU { if softirqs.HRTimer[i], err = strconv.ParseUint(count, 10, 64); err != nil { return Softirqs{}, fmt.Errorf("%w: couldn't parse %q (HRTIMER%d): %w", ErrFileParse, count, i, err) } } case parts[0] == "RCU:": perCPU := parts[1:] softirqs.RCU = make([]uint64, len(perCPU)) for i, count := range perCPU { if softirqs.RCU[i], err = strconv.ParseUint(count, 10, 64); err != nil { return Softirqs{}, fmt.Errorf("%w: couldn't parse %q (RCU%d): %w", ErrFileParse, count, i, err) } } } } if err := scanner.Err(); err != nil { return Softirqs{}, fmt.Errorf("%w: couldn't parse softirqs: %w", ErrFileParse, err) } return softirqs, scanner.Err() }	4.92 KB	2025-05-25 12:27
📄 softirqs_test.go // Copyright 2022 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import "testing" func TestSoftirqs(t *testing.T) { s, err := getProcFixtures(t).Softirqs() if err != nil { t.Fatal(err) } // hi if want, have := uint64(3), s.Hi[0]; want != have { t.Errorf("want softirq HI count %d, have %d", want, have) } // timer if want, have := uint64(247490), s.Timer[1]; want != have { t.Errorf("want softirq TIMER count %d, have %d", want, have) } // net_tx if want, have := uint64(2419), s.NetTx[0]; want != have { t.Errorf("want softirq NET_TX count %d, have %d", want, have) } // net_rx if want, have := uint64(28694), s.NetRx[1]; want != have { t.Errorf("want softirq NET_RX count %d, have %d", want, have) } // block if want, have := uint64(262755), s.Block[1]; want != have { t.Errorf("want softirq BLOCK count %d, have %d", want, have) } // irq_poll if want, have := uint64(0), s.IRQPoll[0]; want != have { t.Errorf("want softirq IRQ_POLL count %d, have %d", want, have) } // tasklet if want, have := uint64(209), s.Tasklet[0]; want != have { t.Errorf("want softirq TASKLET count %d, have %d", want, have) } // sched if want, have := uint64(2278692), s.Sched[0]; want != have { t.Errorf("want softirq SCHED count %d, have %d", want, have) } // hrtimer if want, have := uint64(1281), s.HRTimer[0]; want != have { t.Errorf("want softirq HRTIMER count %d, have %d", want, have) } // rcu if want, have := uint64(532783), s.RCU[1]; want != have { t.Errorf("want softirq RCU count %d, have %d", want, have) } }	2.05 KB	2025-05-25 12:27
📄 stat.go // Copyright 2018 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "bufio" "bytes" "fmt" "io" "strconv" "strings" "github.com/prometheus/procfs/internal/fs" "github.com/prometheus/procfs/internal/util" ) // CPUStat shows how much time the cpu spend in various stages. type CPUStat struct { User float64 Nice float64 System float64 Idle float64 Iowait float64 IRQ float64 SoftIRQ float64 Steal float64 Guest float64 GuestNice float64 } // SoftIRQStat represent the softirq statistics as exported in the procfs stat file. // A nice introduction can be found at https://0xax.gitbooks.io/linux-insides/content/interrupts/interrupts-9.html // It is possible to get per-cpu stats by reading `/proc/softirqs`. type SoftIRQStat struct { Hi uint64 Timer uint64 NetTx uint64 NetRx uint64 Block uint64 BlockIoPoll uint64 Tasklet uint64 Sched uint64 Hrtimer uint64 Rcu uint64 } // Stat represents kernel/system statistics. type Stat struct { // Boot time in seconds since the Epoch. BootTime uint64 // Summed up cpu statistics. CPUTotal CPUStat // Per-CPU statistics. CPU map[int64]CPUStat // Number of times interrupts were handled, which contains numbered and unnumbered IRQs. IRQTotal uint64 // Number of times a numbered IRQ was triggered. IRQ []uint64 // Number of times a context switch happened. ContextSwitches uint64 // Number of times a process was created. ProcessCreated uint64 // Number of processes currently running. ProcessesRunning uint64 // Number of processes currently blocked (waiting for IO). ProcessesBlocked uint64 // Number of times a softirq was scheduled. SoftIRQTotal uint64 // Detailed softirq statistics. SoftIRQ SoftIRQStat } // Parse a cpu statistics line and returns the CPUStat struct plus the cpu id (or -1 for the overall sum). func parseCPUStat(line string) (CPUStat, int64, error) { cpuStat := CPUStat{} var cpu string count, err := fmt.Sscanf(line, "%s %f %f %f %f %f %f %f %f %f %f", &cpu, &cpuStat.User, &cpuStat.Nice, &cpuStat.System, &cpuStat.Idle, &cpuStat.Iowait, &cpuStat.IRQ, &cpuStat.SoftIRQ, &cpuStat.Steal, &cpuStat.Guest, &cpuStat.GuestNice) if err != nil && err != io.EOF { return CPUStat{}, -1, fmt.Errorf("%w: couldn't parse %q (cpu): %w", ErrFileParse, line, err) } if count == 0 { return CPUStat{}, -1, fmt.Errorf("%w: couldn't parse %q (cpu): 0 elements parsed", ErrFileParse, line) } cpuStat.User /= userHZ cpuStat.Nice /= userHZ cpuStat.System /= userHZ cpuStat.Idle /= userHZ cpuStat.Iowait /= userHZ cpuStat.IRQ /= userHZ cpuStat.SoftIRQ /= userHZ cpuStat.Steal /= userHZ cpuStat.Guest /= userHZ cpuStat.GuestNice /= userHZ if cpu == "cpu" { return cpuStat, -1, nil } cpuID, err := strconv.ParseInt(cpu[3:], 10, 64) if err != nil { return CPUStat{}, -1, fmt.Errorf("%w: couldn't parse %q (cpu/cpuid): %w", ErrFileParse, line, err) } return cpuStat, cpuID, nil } // Parse a softirq line. func parseSoftIRQStat(line string) (SoftIRQStat, uint64, error) { softIRQStat := SoftIRQStat{} var total uint64 var prefix string _, err := fmt.Sscanf(line, "%s %d %d %d %d %d %d %d %d %d %d %d", &prefix, &total, &softIRQStat.Hi, &softIRQStat.Timer, &softIRQStat.NetTx, &softIRQStat.NetRx, &softIRQStat.Block, &softIRQStat.BlockIoPoll, &softIRQStat.Tasklet, &softIRQStat.Sched, &softIRQStat.Hrtimer, &softIRQStat.Rcu) if err != nil { return SoftIRQStat{}, 0, fmt.Errorf("%w: couldn't parse %q (softirq): %w", ErrFileParse, line, err) } return softIRQStat, total, nil } // NewStat returns information about current cpu/process statistics. // See https://www.kernel.org/doc/Documentation/filesystems/proc.txt // // Deprecated: Use fs.Stat() instead. func NewStat() (Stat, error) { fs, err := NewFS(fs.DefaultProcMountPoint) if err != nil { return Stat{}, err } return fs.Stat() } // NewStat returns information about current cpu/process statistics. // See: https://www.kernel.org/doc/Documentation/filesystems/proc.txt // // Deprecated: Use fs.Stat() instead. func (fs FS) NewStat() (Stat, error) { return fs.Stat() } // Stat returns information about current cpu/process statistics. // See: https://www.kernel.org/doc/Documentation/filesystems/proc.txt func (fs FS) Stat() (Stat, error) { fileName := fs.proc.Path("stat") data, err := util.ReadFileNoStat(fileName) if err != nil { return Stat{}, err } procStat, err := parseStat(bytes.NewReader(data), fileName) if err != nil { return Stat{}, err } return procStat, nil } // parseStat parses the metrics from /proc/[pid]/stat. func parseStat(r io.Reader, fileName string) (Stat, error) { var ( scanner = bufio.NewScanner(r) stat = Stat{ CPU: make(map[int64]CPUStat), } err error ) // Increase default scanner buffer to handle very long `intr` lines. buf := make([]byte, 0, 81024) scanner.Buffer(buf, 10241024) for scanner.Scan() { line := scanner.Text() parts := strings.Fields(scanner.Text()) // require at least <key> <value> if len(parts) < 2 { continue } switch { case parts[0] == "btime": if stat.BootTime, err = strconv.ParseUint(parts[1], 10, 64); err != nil { return Stat{}, fmt.Errorf("%w: couldn't parse %q (btime): %w", ErrFileParse, parts[1], err) } case parts[0] == "intr": if stat.IRQTotal, err = strconv.ParseUint(parts[1], 10, 64); err != nil { return Stat{}, fmt.Errorf("%w: couldn't parse %q (intr): %w", ErrFileParse, parts[1], err) } numberedIRQs := parts[2:] stat.IRQ = make([]uint64, len(numberedIRQs)) for i, count := range numberedIRQs { if stat.IRQ[i], err = strconv.ParseUint(count, 10, 64); err != nil { return Stat{}, fmt.Errorf("%w: couldn't parse %q (intr%d): %w", ErrFileParse, count, i, err) } } case parts[0] == "ctxt": if stat.ContextSwitches, err = strconv.ParseUint(parts[1], 10, 64); err != nil { return Stat{}, fmt.Errorf("%w: couldn't parse %q (ctxt): %w", ErrFileParse, parts[1], err) } case parts[0] == "processes": if stat.ProcessCreated, err = strconv.ParseUint(parts[1], 10, 64); err != nil { return Stat{}, fmt.Errorf("%w: couldn't parse %q (processes): %w", ErrFileParse, parts[1], err) } case parts[0] == "procs_running": if stat.ProcessesRunning, err = strconv.ParseUint(parts[1], 10, 64); err != nil { return Stat{}, fmt.Errorf("%w: couldn't parse %q (procs_running): %w", ErrFileParse, parts[1], err) } case parts[0] == "procs_blocked": if stat.ProcessesBlocked, err = strconv.ParseUint(parts[1], 10, 64); err != nil { return Stat{}, fmt.Errorf("%w: couldn't parse %q (procs_blocked): %w", ErrFileParse, parts[1], err) } case parts[0] == "softirq": softIRQStats, total, err := parseSoftIRQStat(line) if err != nil { return Stat{}, err } stat.SoftIRQTotal = total stat.SoftIRQ = softIRQStats case strings.HasPrefix(parts[0], "cpu"): cpuStat, cpuID, err := parseCPUStat(line) if err != nil { return Stat{}, err } if cpuID == -1 { stat.CPUTotal = cpuStat } else { stat.CPU[cpuID] = cpuStat } } } if err := scanner.Err(); err != nil { return Stat{}, fmt.Errorf("%w: couldn't parse %q: %w", ErrFileParse, fileName, err) } return stat, nil }	7.67 KB	2025-05-25 12:27
📄 stat_test.go // Copyright 2018 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import "testing" func TestStat(t *testing.T) { s, err := getProcFixtures(t).Stat() if err != nil { t.Fatal(err) } // cpu if want, have := float64(301854)/userHZ, s.CPUTotal.User; want != have { t.Errorf("want cpu/user %v, have %v", want, have) } if want, have := float64(31)/userHZ, s.CPU[7].SoftIRQ; want != have { t.Errorf("want cpu7/softirq %v, have %v", want, have) } // intr if want, have := uint64(73777505), s.IRQTotal; want != have { t.Errorf("want irq/total %d, have %d", want, have) } if want, have := uint64(1), s.IRQ[8]; want != have { t.Errorf("want irq8 %d, have %d", want, have) } // ctxt if want, have := uint64(38014093), s.ContextSwitches; want != have { t.Errorf("want context switches (ctxt) %d, have %d", want, have) } // btime if want, have := uint64(1418183276), s.BootTime; want != have { t.Errorf("want boot time (btime) %d, have %d", want, have) } // processes if want, have := uint64(26442), s.ProcessCreated; want != have { t.Errorf("want process created (processes) %d, have %d", want, have) } // procs_running if want, have := uint64(2), s.ProcessesRunning; want != have { t.Errorf("want processes running (procs_running) %d, have %d", want, have) } // procs_blocked if want, have := uint64(1), s.ProcessesBlocked; want != have { t.Errorf("want processes blocked (procs_blocked) %d, have %d", want, have) } // softirq if want, have := uint64(5057579), s.SoftIRQTotal; want != have { t.Errorf("want softirq total %d, have %d", want, have) } if want, have := uint64(508444), s.SoftIRQ.Rcu; want != have { t.Errorf("want softirq RCU %d, have %d", want, have) } }	2.21 KB	2025-05-25 12:27
📄 swaps.go // Copyright 2019 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "bufio" "bytes" "fmt" "strconv" "strings" "github.com/prometheus/procfs/internal/util" ) // Swap represents an entry in /proc/swaps. type Swap struct { Filename string Type string Size int Used int Priority int } // Swaps returns a slice of all configured swap devices on the system. func (fs FS) Swaps() ([]Swap, error) { data, err := util.ReadFileNoStat(fs.proc.Path("swaps")) if err != nil { return nil, err } return parseSwaps(data) } func parseSwaps(info []byte) ([]Swap, error) { swaps := []Swap{} scanner := bufio.NewScanner(bytes.NewReader(info)) scanner.Scan() // ignore header line for scanner.Scan() { swapString := scanner.Text() parsedSwap, err := parseSwapString(swapString) if err != nil { return nil, err } swaps = append(swaps, parsedSwap) } err := scanner.Err() return swaps, err } func parseSwapString(swapString string) (Swap, error) { var err error swapFields := strings.Fields(swapString) swapLength := len(swapFields) if swapLength < 5 { return nil, fmt.Errorf("%w: too few fields in swap string: %s", ErrFileParse, swapString) } swap := &Swap{ Filename: swapFields[0], Type: swapFields[1], } swap.Size, err = strconv.Atoi(swapFields[2]) if err != nil { return nil, fmt.Errorf("%w: invalid swap size: %s: %w", ErrFileParse, swapFields[2], err) } swap.Used, err = strconv.Atoi(swapFields[3]) if err != nil { return nil, fmt.Errorf("%w: invalid swap used: %s: %w", ErrFileParse, swapFields[3], err) } swap.Priority, err = strconv.Atoi(swapFields[4]) if err != nil { return nil, fmt.Errorf("%w: invalid swap priority: %s: %w", ErrFileParse, swapFields[4], err) } return swap, nil }	2.26 KB	2025-05-25 12:27
📄 swaps_test.go // Copyright 2019 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "reflect" "testing" ) func TestSwaps(t testing.T) { fs, err := NewFS(procTestFixtures) if err != nil { t.Fatalf("failed to open procfs: %v", err) } swaps, err := fs.Swaps() if err != nil { t.Fatalf("failed to get swaps: %v", err) } if len(swaps) != 1 { t.Fatalf("expected 1 swap entry, got %d", len(swaps)) } swap := swaps[0] if swap.Filename != "/dev/dm-2" { t.Errorf("expected swap.Filename /dev/dm-2, got %s", swap.Filename) } if swap.Type != "partition" { t.Errorf("expected swap.Type partition, got %s", swap.Type) } if swap.Size != 131068 { t.Errorf("expected swap.Size 131068, got %d", swap.Size) } if swap.Used != 176 { t.Errorf("expected swap.Used 176, got %d", swap.Used) } if swap.Priority != -2 { t.Errorf("expected swap.Priority -2, got %d", swap.Priority) } } func TestParseSwapString(t testing.T) { tests := []struct { name string s string swap Swap invalid bool }{ { name: "device-mapper volume", s: "/dev/dm-2 partition 131068 1024 -2", invalid: false, swap: &Swap{ Filename: "/dev/dm-2", Type: "partition", Size: 131068, Used: 1024, Priority: -2, }, }, { name: "Swap file", s: "/foo file 1048572 0 -3", invalid: false, swap: &Swap{ Filename: "/foo", Type: "file", Size: 1048572, Used: 0, Priority: -3, }, }, { name: "Invalid number", s: "/dev/sda2 partition hello world -2", invalid: true, }, { name: "Not enough fields", s: "/dev/dm-2 partition 131068 1024", invalid: true, }, } for _, tt := range tests { t.Run(tt.name, func(t testing.T) { swap, err := parseSwapString(tt.s) if tt.invalid && err == nil { t.Error("unexpected success") } if !tt.invalid && err != nil { t.Errorf("unexpected error: %v", err) } if !reflect.DeepEqual(tt.swap, swap) { t.Errorf("swap:\nwant:\n%+v\nhave:\n%+v", tt.swap, swap) } }) } }	2.73 KB	2025-05-25 12:27
📁 sysfs	-	2025-05-25 12:27
📁 testdata	-	2025-05-25 12:27
📄 thread.go // Copyright 2022 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "fmt" "os" "strconv" fsi "github.com/prometheus/procfs/internal/fs" ) // Provide access to /proc/PID/task/TID files, for thread specific values. Since // such files have the same structure as /proc/PID/ ones, the data structures // and the parsers for the latter may be reused. // AllThreads returns a list of all currently available threads under /proc/PID. func AllThreads(pid int) (Procs, error) { fs, err := NewFS(DefaultMountPoint) if err != nil { return Procs{}, err } return fs.AllThreads(pid) } // AllThreads returns a list of all currently available threads for PID. func (fs FS) AllThreads(pid int) (Procs, error) { taskPath := fs.proc.Path(strconv.Itoa(pid), "task") d, err := os.Open(taskPath) if err != nil { return Procs{}, err } defer d.Close() names, err := d.Readdirnames(-1) if err != nil { return Procs{}, fmt.Errorf("%w: could not read %q: %w", ErrFileRead, d.Name(), err) } t := Procs{} for _, n := range names { tid, err := strconv.ParseInt(n, 10, 64) if err != nil { continue } t = append(t, Proc{PID: int(tid), fs: FS{fsi.FS(taskPath), fs.isReal}}) } return t, nil } // Thread returns a process for a given PID, TID. func (fs FS) Thread(pid, tid int) (Proc, error) { taskPath := fs.proc.Path(strconv.Itoa(pid), "task") if _, err := os.Stat(taskPath); err != nil { return Proc{}, err } return Proc{PID: tid, fs: FS{fsi.FS(taskPath), fs.isReal}}, nil } // Thread returns a process for a given TID of Proc. func (proc Proc) Thread(tid int) (Proc, error) { tfs := FS{fsi.FS(proc.path("task")), proc.fs.isReal} if _, err := os.Stat(tfs.proc.Path(strconv.Itoa(tid))); err != nil { return Proc{}, err } return Proc{PID: tid, fs: tfs}, nil }	2.28 KB	2025-05-25 12:27
📄 thread_test.go // Copyright 2022 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package procfs import ( "reflect" "sort" "strconv" "testing" ) var ( testPID = int(27079) testTIDS = [...]int{27079, 27080, 27081, 27082, 27083} ) func TestAllThreads(t testing.T) { fixFS := getProcFixtures(t) threads, err := fixFS.AllThreads(testPID) if err != nil { t.Fatal(err) } sort.Sort(threads) for i, tid := range testTIDS { if wantTID, haveTID := tid, threads[i].PID; wantTID != haveTID { t.Errorf("want TID %d, have %d", wantTID, haveTID) } wantFS := fixFS.proc.Path(strconv.Itoa(testPID), "task") haveFS := string(threads[i].fs.proc) if wantFS != haveFS { t.Errorf("want fs %q, have %q", wantFS, haveFS) } } } func TestThreadStat(t testing.T) { // Pull process and thread stats. proc, err := getProcFixtures(t).Proc(testPID) if err != nil { t.Fatal(err) } procStat, err := proc.Stat() if err != nil { t.Fatal(err) } threads, err := getProcFixtures(t).AllThreads(testPID) if err != nil { t.Fatal(err) } sort.Sort(threads) threadStats := make([]*ProcStat, len(threads)) for i, thread := range threads { threadStat, err := thread.Stat() if err != nil { t.Fatal(err) } threadStats[i] = &threadStat } // The following fields should be shared between the process and its thread: procStatValue := reflect.ValueOf(procStat) sharedFields := [...]string{ "PPID", "PGRP", "Session", "TTY", "TPGID", "VSize", "RSS", } for i, thread := range threads { threadStatValue := reflect.ValueOf(threadStats[i]).Elem() for _, f := range sharedFields { if want, have := procStatValue.FieldByName(f), threadStatValue.FieldByName(f); want.Interface() != have.Interface() { t.Errorf("TID %d, want %s %#v, have %#v", thread.PID, f, want, have) } } } // Thread specific fields: for i, thread := range threads { if want, have := thread.PID, threadStats[i].PID; want != have { t.Errorf("TID %d, want PID %d, have %d", thread.PID, want, have) } } // Finally exemplify the relationship between process and constituent // threads CPU times: each the former ~ the sum of the corresponding // latter. Require -v flag. totalUTime, totalSTime := uint(0), uint(0) for _, thread := range threads { threadStat, err := thread.Stat() if err != nil { t.Fatal(err) } t.Logf("TID %d, UTime %d, STime %d", thread.PID, threadStat.UTime, threadStat.STime) totalUTime += threadStat.UTime totalSTime += threadStat.STime } t.Logf("PID %d, UTime %d, STime %d, total threads UTime %d, STime %d", proc.PID, procStat.UTime, procStat.STime, totalUTime, totalSTime) }	3.09 KB	2025-05-25 12:27
📄 ttar #!/usr/bin/env bash # Purpose: plain text tar format # Limitations: - only suitable for text files, directories, and symlinks # - stores only filename, content, and mode # - not designed for untrusted input # # Note: must work with bash version 3.2 (macOS) # Copyright 2017 Roger Luethi # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. set -o errexit -o nounset # Sanitize environment (for instance, standard sorting of glob matches) export LC_ALL=C path="" CMD="" ARG_STRING="$" #------------------------------------------------------------------------------ # Not all sed implementations can work on null bytes. In order to make ttar # work out of the box on macOS, use Python as a stream editor. USE_PYTHON=0 PYTHON_CREATE_FILTER=$(cat << 'PCF' #!/usr/bin/env python import re import sys for line in sys.stdin: line = re.sub(r'EOF', r'\EOF', line) line = re.sub(r'NULLBYTE', r'\NULLBYTE', line) line = re.sub('\x00', r'NULLBYTE', line) sys.stdout.write(line) PCF ) PYTHON_EXTRACT_FILTER=$(cat << 'PEF' #!/usr/bin/env python import re import sys for line in sys.stdin: line = re.sub(r'(?<!\\)NULLBYTE', '\x00', line) line = re.sub(r'\\NULLBYTE', 'NULLBYTE', line) line = re.sub(r'([^\\])EOF', r'\1', line) line = re.sub(r'\\EOF', 'EOF', line) sys.stdout.write(line) PEF ) function test_environment { if [[ "$(echo "a" \| sed 's/a/\x0/' \| wc -c)" -ne 2 ]]; then echo "WARNING sed unable to handle null bytes, using Python (slow)." if ! which python >/dev/null; then echo "ERROR Python not found. Aborting." exit 2 fi USE_PYTHON=1 fi } #------------------------------------------------------------------------------ function usage { bname=$(basename "$0") cat << USAGE Usage: $bname [-C <DIR>] -c -f <ARCHIVE> <FILE...> (create archive) $bname -t -f <ARCHIVE> (list archive contents) $bname [-C <DIR>] -x -f <ARCHIVE> (extract archive) Options: -C <DIR> (change directory) -v (verbose) --recursive-unlink (recursively delete existing directory if path collides with file or directory to extract) Example: Change to sysfs directory, create ttar file from fixtures directory $bname -C sysfs -c -f sysfs/fixtures.ttar fixtures/ USAGE exit "$1" } function vecho { if [ "${VERBOSE:-}" == "yes" ]; then echo >&7 "$@" fi } function set_cmd { if [ -n "$CMD" ]; then echo "ERROR: more than one command given" echo usage 2 fi CMD=$1 } unset VERBOSE unset RECURSIVE_UNLINK while getopts :cf:-:htxvC: opt; do case $opt in c) set_cmd "create" ;; f) ARCHIVE=$OPTARG ;; h) usage 0 ;; t) set_cmd "list" ;; x) set_cmd "extract" ;; v) VERBOSE=yes exec 7>&1 ;; C) CDIR=$OPTARG ;; -) case $OPTARG in recursive-unlink) RECURSIVE_UNLINK="yes" ;; ) echo -e "Error: invalid option -$OPTARG" echo usage 1 ;; esac ;; ) echo >&2 "ERROR: invalid option -$OPTARG" echo usage 1 ;; esac done # Remove processed options from arguments shift $(( OPTIND - 1 )); if [ "${CMD:-}" == "" ]; then echo >&2 "ERROR: no command given" echo usage 1 elif [ "${ARCHIVE:-}" == "" ]; then echo >&2 "ERROR: no archive name given" echo usage 1 fi function list { local path="" local size=0 local line_no=0 local ttar_file=$1 if [ -n "${2:-}" ]; then echo >&2 "ERROR: too many arguments." echo usage 1 fi if [ ! -e "$ttar_file" ]; then echo >&2 "ERROR: file not found ($ttar_file)" echo usage 1 fi while read -r line; do line_no=$(( line_no + 1 )) if [ $size -gt 0 ]; then size=$(( size - 1 )) continue fi if [[ $line =~ ^Path:\ (.)$ ]]; then path=${BASH_REMATCH[1]} elif [[ $line =~ ^Lines:\ (.)$ ]]; then size=${BASH_REMATCH[1]} echo "$path" elif [[ $line =~ ^Directory:\ (.)$ ]]; then path=${BASH_REMATCH[1]} echo "$path/" elif [[ $line =~ ^SymlinkTo:\ (.)$ ]]; then echo "$path -> ${BASH_REMATCH[1]}" fi done < "$ttar_file" } function extract { local path="" local size=0 local line_no=0 local ttar_file=$1 if [ -n "${2:-}" ]; then echo >&2 "ERROR: too many arguments." echo usage 1 fi if [ ! -e "$ttar_file" ]; then echo >&2 "ERROR: file not found ($ttar_file)" echo usage 1 fi while IFS= read -r line; do line_no=$(( line_no + 1 )) local eof_without_newline if [ "$size" -gt 0 ]; then if [[ "$line" =~ [^\\]EOF ]]; then # An EOF not preceded by a backslash indicates that the line # does not end with a newline eof_without_newline=1 else eof_without_newline=0 fi # Replace NULLBYTE with null byte if at beginning of line # Replace NULLBYTE with null byte unless preceded by backslash # Remove one backslash in front of NULLBYTE (if any) # Remove EOF unless preceded by backslash # Remove one backslash in front of EOF if [ $USE_PYTHON -eq 1 ]; then echo -n "$line" \| python -c "$PYTHON_EXTRACT_FILTER" >> "$path" else # The repeated pattern makes up for sed's lack of negative # lookbehind assertions (for consecutive null bytes). echo -n "$line" \| \ sed -e 's/^NULLBYTE/\x0/g; s/$[^\\]$NULLBYTE/\1\x0/g; s/$[^\\]$NULLBYTE/\1\x0/g; s/\\NULLBYTE/NULLBYTE/g; s/$[^\\]$EOF/\1/g; s/\\EOF/EOF/g; ' >> "$path" fi if [[ "$eof_without_newline" -eq 0 ]]; then echo >> "$path" fi size=$(( size - 1 )) continue fi if [[ $line =~ ^Path:\ (.)$ ]]; then path=${BASH_REMATCH[1]} if [ -L "$path" ]; then rm "$path" elif [ -d "$path" ]; then if [ "${RECURSIVE_UNLINK:-}" == "yes" ]; then rm -r "$path" else # Safe because symlinks to directories are dealt with above rmdir "$path" fi elif [ -e "$path" ]; then rm "$path" fi elif [[ $line =~ ^Lines:\ (.)$ ]]; then size=${BASH_REMATCH[1]} # Create file even if it is zero-length. touch "$path" vecho " $path" elif [[ $line =~ ^Mode:\ (.)$ ]]; then mode=${BASH_REMATCH[1]} chmod "$mode" "$path" vecho "$mode" elif [[ $line =~ ^Directory:\ (.)$ ]]; then path=${BASH_REMATCH[1]} mkdir -p "$path" vecho " $path/" elif [[ $line =~ ^SymlinkTo:\ (.)$ ]]; then ln -s "${BASH_REMATCH[1]}" "$path" vecho " $path -> ${BASH_REMATCH[1]}" elif [[ $line =~ ^# ]]; then # Ignore comments between files continue else echo >&2 "ERROR: Unknown keyword on line $line_no: $line" exit 1 fi done < "$ttar_file" } function div { echo "# ttar - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -" \ "- - - - - -" } function get_mode { local mfile=$1 if [ -z "${STAT_OPTION:-}" ]; then if stat -c '%a' "$mfile" >/dev/null 2>&1; then # GNU stat STAT_OPTION='-c' STAT_FORMAT='%a' else # BSD stat STAT_OPTION='-f' # Octal output, user/group/other (omit file type, sticky bit) STAT_FORMAT='%OLp' fi fi stat "${STAT_OPTION}" "${STAT_FORMAT}" "$mfile" } function _create { shopt -s nullglob local mode local eof_without_newline while (( "$#" )); do file=$1 if [ -L "$file" ]; then echo "Path: $file" symlinkTo=$(readlink "$file") echo "SymlinkTo: $symlinkTo" vecho " $file -> $symlinkTo" div elif [ -d "$file" ]; then # Strip trailing slash (if there is one) file=${file%/} echo "Directory: $file" mode=$(get_mode "$file") echo "Mode: $mode" vecho "$mode $file/" div # Find all files and dirs, including hidden/dot files for x in "$file/"{,.[^.]}; do _create "$x" done elif [ -f "$file" ]; then echo "Path: $file" lines=$(wc -l "$file"\|awk '{print $1}') eof_without_newline=0 if [[ "$(wc -c "$file"\|awk '{print $1}')" -gt 0 ]] && \ [[ "$(tail -c 1 "$file" \| wc -l)" -eq 0 ]]; then eof_without_newline=1 lines=$((lines+1)) fi echo "Lines: $lines" # Add backslash in front of EOF # Add backslash in front of NULLBYTE # Replace null byte with NULLBYTE if [ $USE_PYTHON -eq 1 ]; then < "$file" python -c "$PYTHON_CREATE_FILTER" else < "$file" \ sed 's/EOF/\\EOF/g; s/NULLBYTE/\\NULLBYTE/g; s/\x0/NULLBYTE/g; ' fi if [[ "$eof_without_newline" -eq 1 ]]; then # Finish line with EOF to indicate that the original line did # not end with a linefeed echo "EOF" fi mode=$(get_mode "$file") echo "Mode: $mode" vecho "$mode $file" div else echo >&2 "ERROR: file not found ($file in $(pwd))" exit 2 fi shift done } function create { ttar_file=$1 shift if [ -z "${1:-}" ]; then echo >&2 "ERROR: missing arguments." echo usage 1 fi if [ -e "$ttar_file" ]; then rm "$ttar_file" fi exec > "$ttar_file" echo "# Archive created by ttar $ARG_STRING" _create "$@" } test_environment if [ -n "${CDIR:-}" ]; then if [[ "$ARCHIVE" != /* ]]; then # Relative path: preserve the archive's location before changing # directory ARCHIVE="$(pwd)/$ARCHIVE" fi cd "$CDIR" fi "$CMD" "$ARCHIVE" "$@"	11.57 KB	2025-05-25 12:27
📄 vm.go // Copyright 2019 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. //go:build !windows // +build !windows package procfs import ( "fmt" "os" "path/filepath" "strings" "github.com/prometheus/procfs/internal/util" ) // The VM interface is described at // // https://www.kernel.org/doc/Documentation/sysctl/vm.txt // // Each setting is exposed as a single file. // Each file contains one line with a single numerical value, except lowmem_reserve_ratio which holds an array // and numa_zonelist_order (deprecated) which is a string. type VM struct { AdminReserveKbytes int64 // /proc/sys/vm/admin_reserve_kbytes BlockDump int64 // /proc/sys/vm/block_dump CompactUnevictableAllowed int64 // /proc/sys/vm/compact_unevictable_allowed DirtyBackgroundBytes int64 // /proc/sys/vm/dirty_background_bytes DirtyBackgroundRatio int64 // /proc/sys/vm/dirty_background_ratio DirtyBytes int64 // /proc/sys/vm/dirty_bytes DirtyExpireCentisecs int64 // /proc/sys/vm/dirty_expire_centisecs DirtyRatio int64 // /proc/sys/vm/dirty_ratio DirtytimeExpireSeconds int64 // /proc/sys/vm/dirtytime_expire_seconds DirtyWritebackCentisecs int64 // /proc/sys/vm/dirty_writeback_centisecs DropCaches int64 // /proc/sys/vm/drop_caches ExtfragThreshold int64 // /proc/sys/vm/extfrag_threshold HugetlbShmGroup int64 // /proc/sys/vm/hugetlb_shm_group LaptopMode int64 // /proc/sys/vm/laptop_mode LegacyVaLayout int64 // /proc/sys/vm/legacy_va_layout LowmemReserveRatio []int64 // /proc/sys/vm/lowmem_reserve_ratio MaxMapCount int64 // /proc/sys/vm/max_map_count MemoryFailureEarlyKill int64 // /proc/sys/vm/memory_failure_early_kill MemoryFailureRecovery int64 // /proc/sys/vm/memory_failure_recovery MinFreeKbytes int64 // /proc/sys/vm/min_free_kbytes MinSlabRatio int64 // /proc/sys/vm/min_slab_ratio MinUnmappedRatio int64 // /proc/sys/vm/min_unmapped_ratio MmapMinAddr int64 // /proc/sys/vm/mmap_min_addr NrHugepages int64 // /proc/sys/vm/nr_hugepages NrHugepagesMempolicy int64 // /proc/sys/vm/nr_hugepages_mempolicy NrOvercommitHugepages int64 // /proc/sys/vm/nr_overcommit_hugepages NumaStat int64 // /proc/sys/vm/numa_stat NumaZonelistOrder string // /proc/sys/vm/numa_zonelist_order OomDumpTasks int64 // /proc/sys/vm/oom_dump_tasks OomKillAllocatingTask int64 // /proc/sys/vm/oom_kill_allocating_task OvercommitKbytes int64 // /proc/sys/vm/overcommit_kbytes OvercommitMemory int64 // /proc/sys/vm/overcommit_memory OvercommitRatio int64 // /proc/sys/vm/overcommit_ratio PageCluster int64 // /proc/sys/vm/page-cluster PanicOnOom int64 // /proc/sys/vm/panic_on_oom PercpuPagelistFraction int64 // /proc/sys/vm/percpu_pagelist_fraction StatInterval int64 // /proc/sys/vm/stat_interval Swappiness int64 // /proc/sys/vm/swappiness UserReserveKbytes int64 // /proc/sys/vm/user_reserve_kbytes VfsCachePressure int64 // /proc/sys/vm/vfs_cache_pressure WatermarkBoostFactor int64 // /proc/sys/vm/watermark_boost_factor WatermarkScaleFactor int64 // /proc/sys/vm/watermark_scale_factor ZoneReclaimMode int64 // /proc/sys/vm/zone_reclaim_mode } // VM reads the VM statistics from the specified `proc` filesystem. func (fs FS) VM() (VM, error) { path := fs.proc.Path("sys/vm") file, err := os.Stat(path) if err != nil { return nil, err } if !file.Mode().IsDir() { return nil, fmt.Errorf("%w: %s is not a directory", ErrFileRead, path) } files, err := os.ReadDir(path) if err != nil { return nil, err } var vm VM for _, f := range files { if f.IsDir() { continue } name := filepath.Join(path, f.Name()) // ignore errors on read, as there are some write only // in /proc/sys/vm value, err := util.SysReadFile(name) if err != nil { continue } vp := util.NewValueParser(value) switch f.Name() { case "admin_reserve_kbytes": vm.AdminReserveKbytes = vp.PInt64() case "block_dump": vm.BlockDump = vp.PInt64() case "compact_unevictable_allowed": vm.CompactUnevictableAllowed = vp.PInt64() case "dirty_background_bytes": vm.DirtyBackgroundBytes = vp.PInt64() case "dirty_background_ratio": vm.DirtyBackgroundRatio = vp.PInt64() case "dirty_bytes": vm.DirtyBytes = vp.PInt64() case "dirty_expire_centisecs": vm.DirtyExpireCentisecs = vp.PInt64() case "dirty_ratio": vm.DirtyRatio = vp.PInt64() case "dirtytime_expire_seconds": vm.DirtytimeExpireSeconds = vp.PInt64() case "dirty_writeback_centisecs": vm.DirtyWritebackCentisecs = vp.PInt64() case "drop_caches": vm.DropCaches = vp.PInt64() case "extfrag_threshold": vm.ExtfragThreshold = vp.PInt64() case "hugetlb_shm_group": vm.HugetlbShmGroup = vp.PInt64() case "laptop_mode": vm.LaptopMode = vp.PInt64() case "legacy_va_layout": vm.LegacyVaLayout = vp.PInt64() case "lowmem_reserve_ratio": stringSlice := strings.Fields(value) pint64Slice := make([]int64, 0, len(stringSlice)) for _, value := range stringSlice { vp := util.NewValueParser(value) pint64Slice = append(pint64Slice, vp.PInt64()) } vm.LowmemReserveRatio = pint64Slice case "max_map_count": vm.MaxMapCount = vp.PInt64() case "memory_failure_early_kill": vm.MemoryFailureEarlyKill = vp.PInt64() case "memory_failure_recovery": vm.MemoryFailureRecovery = vp.PInt64() case "min_free_kbytes": vm.MinFreeKbytes = vp.PInt64() case "min_slab_ratio": vm.MinSlabRatio = vp.PInt64() case "min_unmapped_ratio": vm.MinUnmappedRatio = vp.PInt64() case "mmap_min_addr": vm.MmapMinAddr = vp.PInt64() case "nr_hugepages": vm.NrHugepages = vp.PInt64() case "nr_hugepages_mempolicy": vm.NrHugepagesMempolicy = vp.PInt64() case "nr_overcommit_hugepages": vm.NrOvercommitHugepages = vp.PInt64() case "numa_stat": vm.NumaStat = vp.PInt64() case "numa_zonelist_order": vm.NumaZonelistOrder = value case "oom_dump_tasks": vm.OomDumpTasks = vp.PInt64() case "oom_kill_allocating_task": vm.OomKillAllocatingTask = vp.PInt64() case "overcommit_kbytes": vm.OvercommitKbytes = vp.PInt64() case "overcommit_memory": vm.OvercommitMemory = vp.PInt64() case "overcommit_ratio": vm.OvercommitRatio = vp.PInt64() case "page-cluster": vm.PageCluster = vp.PInt64() case "panic_on_oom": vm.PanicOnOom = vp.PInt64() case "percpu_pagelist_fraction": vm.PercpuPagelistFraction = vp.PInt64() case "stat_interval": vm.StatInterval = vp.PInt64() case "swappiness": vm.Swappiness = vp.PInt64() case "user_reserve_kbytes": vm.UserReserveKbytes = vp.PInt64() case "vfs_cache_pressure": vm.VfsCachePressure = vp.PInt64() case "watermark_boost_factor": vm.WatermarkBoostFactor = vp.PInt64() case "watermark_scale_factor": vm.WatermarkScaleFactor = vp.PInt64() case "zone_reclaim_mode": vm.ZoneReclaimMode = vp.PInt64() } if err := vp.Err(); err != nil { return nil, err } } return &vm, nil }	7.73 KB	2025-05-25 12:27
📄 vm_test.go // Copyright 2019 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. //go:build !windows // +build !windows package procfs import ( "testing" "github.com/google/go-cmp/cmp" ) func newPInt64(i int64) int64 { return &i } func TestVM(t testing.T) { fs, err := NewFS(procTestFixtures) if err != nil { t.Fatal(err) } got, err := fs.VM() if err != nil { t.Fatal(err) } zeroPointer := newPInt64(0) lowmemreserveratio := []*int64{newPInt64(256), newPInt64(256), newPInt64(32), zeroPointer, zeroPointer} want := &VM{ AdminReserveKbytes: newPInt64(8192), BlockDump: zeroPointer, CompactUnevictableAllowed: newPInt64(1), DirtyBackgroundBytes: zeroPointer, DirtyBackgroundRatio: newPInt64(10), DirtyBytes: zeroPointer, DirtyExpireCentisecs: newPInt64(3000), DirtyRatio: newPInt64(20), DirtytimeExpireSeconds: newPInt64(43200), DirtyWritebackCentisecs: newPInt64(500), DropCaches: zeroPointer, ExtfragThreshold: newPInt64(500), HugetlbShmGroup: zeroPointer, LaptopMode: newPInt64(5), LegacyVaLayout: zeroPointer, LowmemReserveRatio: lowmemreserveratio, MaxMapCount: newPInt64(65530), MemoryFailureEarlyKill: zeroPointer, MemoryFailureRecovery: newPInt64(1), MinFreeKbytes: newPInt64(67584), MinSlabRatio: newPInt64(5), MinUnmappedRatio: newPInt64(1), MmapMinAddr: newPInt64(65536), NumaStat: newPInt64(1), NumaZonelistOrder: "Node", NrHugepages: zeroPointer, NrHugepagesMempolicy: zeroPointer, NrOvercommitHugepages: zeroPointer, OomDumpTasks: newPInt64(1), OomKillAllocatingTask: zeroPointer, OvercommitKbytes: zeroPointer, OvercommitMemory: zeroPointer, OvercommitRatio: newPInt64(50), PageCluster: newPInt64(3), PanicOnOom: zeroPointer, PercpuPagelistFraction: zeroPointer, StatInterval: newPInt64(1), Swappiness: newPInt64(60), UserReserveKbytes: newPInt64(131072), VfsCachePressure: newPInt64(100), WatermarkBoostFactor: newPInt64(15000), WatermarkScaleFactor: newPInt64(10), ZoneReclaimMode: zeroPointer, } if diff := cmp.Diff(want, got); diff != "" { t.Fatalf("unexpected power supply class (-want +got):\n%s", diff) } }	2.98 KB	2025-05-25 12:27
📁 xfs	-	2025-05-25 12:27
📄 zoneinfo.go // Copyright 2019 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. //go:build !windows // +build !windows package procfs import ( "bytes" "fmt" "os" "regexp" "strings" "github.com/prometheus/procfs/internal/util" ) // Zoneinfo holds info parsed from /proc/zoneinfo. type Zoneinfo struct { Node string Zone string NrFreePages int64 Min int64 Low int64 High int64 Scanned int64 Spanned int64 Present int64 Managed int64 NrActiveAnon int64 NrInactiveAnon int64 NrIsolatedAnon int64 NrAnonPages int64 NrAnonTransparentHugepages int64 NrActiveFile int64 NrInactiveFile int64 NrIsolatedFile int64 NrFilePages int64 NrSlabReclaimable int64 NrSlabUnreclaimable int64 NrMlockStack int64 NrKernelStack int64 NrMapped int64 NrDirty int64 NrWriteback int64 NrUnevictable int64 NrShmem int64 NrDirtied int64 NrWritten int64 NumaHit int64 NumaMiss int64 NumaForeign int64 NumaInterleave int64 NumaLocal int64 NumaOther int64 Protection []*int64 } var nodeZoneRE = regexp.MustCompile(`(\d+), zone\s+(\w+)`) // Zoneinfo parses an zoneinfo-file (/proc/zoneinfo) and returns a slice of // structs containing the relevant info. More information available here: // https://www.kernel.org/doc/Documentation/sysctl/vm.txt func (fs FS) Zoneinfo() ([]Zoneinfo, error) { data, err := os.ReadFile(fs.proc.Path("zoneinfo")) if err != nil { return nil, fmt.Errorf("%w: error reading zoneinfo %q: %w", ErrFileRead, fs.proc.Path("zoneinfo"), err) } zoneinfo, err := parseZoneinfo(data) if err != nil { return nil, fmt.Errorf("%w: error parsing zoneinfo %q: %w", ErrFileParse, fs.proc.Path("zoneinfo"), err) } return zoneinfo, nil } func parseZoneinfo(zoneinfoData []byte) ([]Zoneinfo, error) { zoneinfo := []Zoneinfo{} zoneinfoBlocks := bytes.Split(zoneinfoData, []byte("\nNode")) for _, block := range zoneinfoBlocks { var zoneinfoElement Zoneinfo lines := strings.Split(string(block), "\n") for _, line := range lines { if nodeZone := nodeZoneRE.FindStringSubmatch(line); nodeZone != nil { zoneinfoElement.Node = nodeZone[1] zoneinfoElement.Zone = nodeZone[2] continue } if strings.HasPrefix(strings.TrimSpace(line), "per-node stats") { continue } parts := strings.Fields(strings.TrimSpace(line)) if len(parts) < 2 { continue } vp := util.NewValueParser(parts[1]) switch parts[0] { case "nr_free_pages": zoneinfoElement.NrFreePages = vp.PInt64() case "min": zoneinfoElement.Min = vp.PInt64() case "low": zoneinfoElement.Low = vp.PInt64() case "high": zoneinfoElement.High = vp.PInt64() case "scanned": zoneinfoElement.Scanned = vp.PInt64() case "spanned": zoneinfoElement.Spanned = vp.PInt64() case "present": zoneinfoElement.Present = vp.PInt64() case "managed": zoneinfoElement.Managed = vp.PInt64() case "nr_active_anon": zoneinfoElement.NrActiveAnon = vp.PInt64() case "nr_inactive_anon": zoneinfoElement.NrInactiveAnon = vp.PInt64() case "nr_isolated_anon": zoneinfoElement.NrIsolatedAnon = vp.PInt64() case "nr_anon_pages": zoneinfoElement.NrAnonPages = vp.PInt64() case "nr_anon_transparent_hugepages": zoneinfoElement.NrAnonTransparentHugepages = vp.PInt64() case "nr_active_file": zoneinfoElement.NrActiveFile = vp.PInt64() case "nr_inactive_file": zoneinfoElement.NrInactiveFile = vp.PInt64() case "nr_isolated_file": zoneinfoElement.NrIsolatedFile = vp.PInt64() case "nr_file_pages": zoneinfoElement.NrFilePages = vp.PInt64() case "nr_slab_reclaimable": zoneinfoElement.NrSlabReclaimable = vp.PInt64() case "nr_slab_unreclaimable": zoneinfoElement.NrSlabUnreclaimable = vp.PInt64() case "nr_mlock_stack": zoneinfoElement.NrMlockStack = vp.PInt64() case "nr_kernel_stack": zoneinfoElement.NrKernelStack = vp.PInt64() case "nr_mapped": zoneinfoElement.NrMapped = vp.PInt64() case "nr_dirty": zoneinfoElement.NrDirty = vp.PInt64() case "nr_writeback": zoneinfoElement.NrWriteback = vp.PInt64() case "nr_unevictable": zoneinfoElement.NrUnevictable = vp.PInt64() case "nr_shmem": zoneinfoElement.NrShmem = vp.PInt64() case "nr_dirtied": zoneinfoElement.NrDirtied = vp.PInt64() case "nr_written": zoneinfoElement.NrWritten = vp.PInt64() case "numa_hit": zoneinfoElement.NumaHit = vp.PInt64() case "numa_miss": zoneinfoElement.NumaMiss = vp.PInt64() case "numa_foreign": zoneinfoElement.NumaForeign = vp.PInt64() case "numa_interleave": zoneinfoElement.NumaInterleave = vp.PInt64() case "numa_local": zoneinfoElement.NumaLocal = vp.PInt64() case "numa_other": zoneinfoElement.NumaOther = vp.PInt64() case "protection:": protectionParts := strings.Split(line, ":") protectionValues := strings.Replace(protectionParts[1], "(", "", 1) protectionValues = strings.Replace(protectionValues, ")", "", 1) protectionValues = strings.TrimSpace(protectionValues) protectionStringMap := strings.Split(protectionValues, ", ") val, err := util.ParsePInt64s(protectionStringMap) if err == nil { zoneinfoElement.Protection = val } } } zoneinfo = append(zoneinfo, zoneinfoElement) } return zoneinfo, nil }	6.27 KB	2025-05-25 12:27
📄 zoneinfo_test.go // Copyright 2019 The Prometheus Authors // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. //go:build !windows // +build !windows package procfs import ( "testing" "github.com/google/go-cmp/cmp" ) func TestZoneinfo(t testing.T) { fs := getProcFixtures(t) protectionDMA := []int64{newPInt64(0), newPInt64(2877), newPInt64(7826), newPInt64(7826), newPInt64(7826)} protectionDMA32 := []int64{newPInt64(0), newPInt64(0), newPInt64(4949), newPInt64(4949), newPInt64(4949)} protectionNormal := []int64{newPInt64(0), newPInt64(0), newPInt64(0), newPInt64(0), newPInt64(0)} protectionMovable := []int64{newPInt64(0), newPInt64(0), newPInt64(0), newPInt64(0), newPInt64(0)} protectionDevice := []int64{newPInt64(0), newPInt64(0), newPInt64(0), newPInt64(0), newPInt64(0)} refs := []Zoneinfo{ {Node: "0", Zone: "DMA", NrFreePages: newPInt64(3952), Min: newPInt64(33), Low: newPInt64(41), High: newPInt64(49), Spanned: newPInt64(4095), Present: newPInt64(3975), Managed: newPInt64(3956), NrActiveAnon: newPInt64(547580), NrInactiveAnon: newPInt64(230981), NrIsolatedAnon: newPInt64(0), NrAnonPages: newPInt64(795576), NrAnonTransparentHugepages: newPInt64(0), NrActiveFile: newPInt64(346282), NrInactiveFile: newPInt64(316904), NrIsolatedFile: newPInt64(0), NrFilePages: newPInt64(761874), NrSlabReclaimable: newPInt64(131220), NrSlabUnreclaimable: newPInt64(47320), NrKernelStack: newPInt64(0), NrMapped: newPInt64(215483), NrDirty: newPInt64(908), NrWriteback: newPInt64(0), NrUnevictable: newPInt64(115467), NrShmem: newPInt64(224925), NrDirtied: newPInt64(8007423), NrWritten: newPInt64(7752121), NumaHit: newPInt64(1), NumaMiss: newPInt64(0), NumaForeign: newPInt64(0), NumaInterleave: newPInt64(0), NumaLocal: newPInt64(1), NumaOther: newPInt64(0), Protection: protectionDMA}, {Node: "0", Zone: "DMA32", NrFreePages: newPInt64(204252), Min: newPInt64(19510), Low: newPInt64(21059), High: newPInt64(22608), Spanned: newPInt64(1044480), Present: newPInt64(759231), Managed: newPInt64(742806), NrKernelStack: newPInt64(2208), NumaHit: newPInt64(113952967), NumaMiss: newPInt64(0), NumaForeign: newPInt64(0), NumaInterleave: newPInt64(0), NumaLocal: newPInt64(113952967), NumaOther: newPInt64(0), Protection: protectionDMA32}, {Node: "0", Zone: "Normal", NrFreePages: newPInt64(18553), Min: newPInt64(11176), Low: newPInt64(13842), High: newPInt64(16508), Spanned: newPInt64(1308160), Present: newPInt64(1308160), Managed: newPInt64(1268711), NrKernelStack: newPInt64(15136), NumaHit: newPInt64(162718019), NumaMiss: newPInt64(0), NumaForeign: newPInt64(0), NumaInterleave: newPInt64(26812), NumaLocal: newPInt64(162718019), NumaOther: newPInt64(0), Protection: protectionNormal}, {Node: "0", Zone: "Movable", Min: newPInt64(0), Low: newPInt64(0), High: newPInt64(0), Spanned: newPInt64(0), Present: newPInt64(0), Managed: newPInt64(0), Protection: protectionMovable}, {Node: "0", Zone: "Device", Min: newPInt64(0), Low: newPInt64(0), High: newPInt64(0), Spanned: newPInt64(0), Present: newPInt64(0), Managed: newPInt64(0), Protection: protectionDevice}, } data, err := fs.Zoneinfo() if err != nil { t.Fatalf("failed to parse zoneinfo: %v", err) } if len(data) != 5 { t.Fatal("failed to get all all node info") } for index, ref := range refs { want, got := ref, data[index] if diff := cmp.Diff(want, got); diff != "" { t.Fatalf("unexpected crypto entry (-want +got):\n%s", diff) } } }	3.84 KB	2025-05-25 12:27

Edit File:

Terminal