{ "componentChunkName": "component---src-templates-issues-tsx", "path": "/issues/627", "result": {"data":{"issuesJson":{"id":"76c2277e-f98e-5489-ba65-59e6c9a82513","title":"bvaisvil/zenith: 类似 top 或 htop，还具有可缩放图表、CPU、GPU、网络和磁盘使用情况的能力","number":627,"bodyHTML":"

\n

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Repos	bvaisvil/zenith
Views	$\"views\"$
Stars	$\"stars\"$
Forks	$\"forks\"$
License	$\"license\"$
UpdatedAt	$\"last-commit\"$
CreatedAt	$\"create-at\"$

\n\n

\n

\n

\n

Zenith

\n

In terminal graphical metrics for your *nix system written in Rust

\n

\n

Features

\n

Optional CPU, Memory, Network, and Disk usage charts
Quick glances at Disk free space, NIC IP addresses, CPU frequency
Highlight top users of CPU, Memory, & Disk
Battery percentage, time to charge or discharge, power used
A top-like filterable process table that includes per process disk usage
Change process priority
Zoomable chart views (with support to scroll back in time)
Managing processes with signals
Performance data saved between runs
GPU Utilization Metrics for NVIDIA GPUs (with --features nvidia), including per-process GPU usage
Disk free space charts
Delay accounting (on Linux when running zenith with root permissions)

\n

\n

Planned Features

\n

CPU steal percentage and general virtualization awareness
Sensor Temperature charts
Per process network usage (Linux)
Messaging about adverse system events, like errors in kernel ring buffer (Linux)
Docker support
ZFS (pool status)
GPU utilization metrics for AMD GPUS
Disk metrics like IO ops / latency
Support Memory pressure

\n

Current Platforms

\n

Linux
MacOS

\n

Planned Platforms

\n

BSD (OpenBSD/FreeBSD)
Perhaps Redox OS.

\n

Installation

\n

\n

Binary

\n

Download one of the compiled releases.

\n

Debian/Ubuntu based Linux distributions (64-bit)

\n

The latest 64-bit deb packages are available here and require distributions based on Debian >= 9 or Ubuntu >= 16.04

\n

You can also install and update the .deb packages we publish in our GitHub releases page using deb-get.
\nFirst install deb-get using these commands in a terminal:

\n

sudo apt install curl\ncurl -sL https://raw.githubusercontent.com/wimpysworld/deb-get/main/deb-get | sudo -E bash -s install deb-get

\n

Then install zenith using the following command in terminal:

\n

deb-get install zenith

\n

Once zenith is installed it can be kept upto date using:

\n

deb-get update\ndeb-get upgrade

\n

Arch Linux

\n

zenith is available in the extra repository and can be installed with pacman:

\n

pacman -S zenith

\n

There are also packages available in the AUR: zenith-git and zenith-bin

\n

The zenith-bin package uses the deb package mentioned in previous section and can be used to avoid building the package from source. The first two depend on rust/cargo and it is recommended to install the rustup package from AUR instead of the rust package from official repositories. This allows for easy installation of rust components as per what rust officially documents. You will need to install a toolchain separately with rustup so use something like:

\n

yay -S rustup\nrustup toolchain install stable\nrustup default stable

\n

Change the 'stable' toolchain above to beta/nightly/... if you have some specific preference. After this install the preferred AUR package: yay -S zenith-git (will track the latest git revision)

\n

Homebrew

\n

brew install zenith

\n

Cargo

\n

cargo install --git https://github.com/bvaisvil/zenith.git\n

\n

For NVIDIA GPU support, install with feature nvidia:

\n

cargo install --features nvidia --git https://github.com/bvaisvil/zenith.git\n

\n

Building

\n

Prerequisites

\n

Building requires rust version >= 1.40 and libclang development packages.

\n

Rust:

\n

Install from your preferred package manager or preferrably use rustup.rs

\n

Clang development packages:

\n

Ubuntu/Debian:
\nsudo apt-get install libclang-dev
CentOS/RHL/Fedora
\nsudo [yum/dnf] install clang

\n

Zenith builds under rustc version >= 1.40.0.

\n

cd zenith\ncargo build --release\n

\n

For NVIDIA GPU support, build with feature nvidia:

\n

cargo build --release --features nvidia

\n

The minimum supported NVIDIA driver version is 418.56

\n

There is also a Makefile that detects the presence of NVIDIA driver on the
\ncurrent system and builds the appropriate flavor on Linux.

\n

make && sudo make install

\n

If for some reason the Makefile incorrectly detects NVIDIA driver installation
\nor in case of a broken installation (e.g. libnvidia-ml.so.1 present but no
\nlibnvidia-ml.so) then explicitly skip it using the base target:

\n

make base && sudo make install

\n

The default installation path is /usr/local so make install requires root
\nprivileges above. To install in a custom location use PREFIX like below:

\n

make && make install PREFIX=$HOME/zenith

\n

There is also an 'all' target in the Makefile that will build both the flavors on Linux,
\nif NVIDIA driver is detected, and 'make install' will then copy a wrapper 'zenith' script
\nthat chooses the appropriate binary at runtime.

\n

Static build

\n

The make file provides for building fully static versions on Linux against the musl C library.
\nIt requires musl-gcc to be installed on the system. Install \"musl-tools\" package on debian/ubuntu
\nderivatives, \"musl-gcc\" on fedora and equivalent on other distributions from their standard repos.

\n

Use the target \"linux-static\" to build it. This will create a tarball containing the executable
\naccompanied with file containing sha256 sum.

\n

NVIDIA drivers normally do not ship with static versions of the libraries, so the static
\nbuild skips that configuration. However, if you somehow get hold of static NVIDIA
\nlibraries or are okay for dynamic linking for that executable, then you can explicitly
\nset the BUILD_NVIDIA flag to true:

\n

make linux-static BUILD_NVIDIA=true

\n

Building with NVIDIA support in a virtual environment

\n

If one needs to build with NVIDIA support in a virtual environment, then it requires some more
\nsetup since typically the VM software is unable to directly expose NVIDIA GPU.
\nUnlike the runtime zenith script, the Makefile has been setup to detect only the presence of
\nrequired NVIDIA libraries, so it is possible to build with NVIDIA support even when without
\nNVIDIA GPU.

\n

Install the nvidia driver package as per the distribution recommended way. For example
\nin Ubuntu < 18.04 add the NVIDIA PPA (https://launchpad.net/~graphics-drivers/+archive/ubuntu/ppa)
\nand install the nvidia-430 package. For newer versions install nvidia-driver-440/450 package.

\n

After that disable the actual use of the driver using \"sudo prime-select intel\". Then while
\nbuilding with Makefile you will need to explicitly add the NVIDIA library path to LD_LIBRARY_PATH.
\nFor instance on Ubuntu and derivatives, something like:

\n

  export LD_LIBRARY_PATH=/usr/lib/nvidia-430\n  make && sudo make install\n

\n

Building deb package

\n

Debian package support is present in the source tree. Install devscripts package and use standard
\noptions like \"debuild -b -uc -us\" to build an unsigned deb package in the directory above.
\nIn a virtual environment build, LD_LIBRARY_PATH can be explicitly set like:

\n

debuild -eLD_LIBRARY_PATH=/usr/lib/nvidia-430 -b -uc -us

\n

Cargo can be installed from the repositories or the standard rustup way. Latter would be normally
\nrecommended if one needs to do anything more than just building in a virtual environment. For
\nthat case $HOME/.cargo/bin should be in PATH and mark PATH so that debuild does not sanitize it:

\n

debuild -ePATH -eLD_LIBRARY_PATH=/usr/lib/nvidia-430 -b -uc -us

\n

Clean up using \"./debian/rules clean\" rather than \"make clean\" to clear debian build files too.

\n

Usage

\n

Running with no arguments starts zenith with the default visualizations for CPU, Disk, and Network and a refresh rate of 2000 ms (2 seconds). These can be changed with command line parameters:

\n

    zenith [FLAGS] [OPTIONS]\n\nFLAGS:\n        --disable-history    Disables history when flag is present\n    -h, --help               Prints help information\n    -V, --version            Prints version information\n\nOPTIONS:\n    -c, --cpu-height <INT>        Min Percent Height of CPU/Memory visualization. [default: 17]\n        --db <STRING>             Database to use, if any. [default: ~/.zenith]\n    -d, --disk-height <INT>       Min Percent Height of Disk visualization. [default: 17]\n    -n, --net-height <INT>        Min Percent Height of Network visualization. [default: 17]\n    -p, --process-height <INT>    Min Percent Height of Process Table. [default: 32]\n    -r, --refresh-rate <INT>      Refresh rate in milliseconds. [default: 2000]\n    -g, --graphics-height <INT>   Min Percent Height of Graphics Card visualization. [default: 17]\n

\n

The graphics-height option only applies when NVIDIA GPU support has been enabled.

\n

Don't want a section? Remove it by setting the height to 0.

\n

For example: zenith -c 0 removes the CPU chart.

\n

Up/down arrow keys move around the process table. Return (enter) will focus on a process.
\nTab switches the active section. Active sections can be expanded (e) and minimized (m).
\n+/- (or =/-) will zoom in / out all of the charts. Arrow keys (←/→) move forward/backward in time.
\nBack tick (`) resets the chart to current time and max zoom.
\nUsing these options you can create the layout you want.

\n

In zenith 'h' key will show this help:

\n

\n

Built using these great crates

\n

","updatedAt":"2025-05-22T01:54:13Z","upvoteCount":null,"author":{"login":"eryajf","avatarUrl":"https://avatars.githubusercontent.com/u/33259379?u=e4a4090a38ac2473aaed4ef9945233636776c6c3&v=4","url":"https://github.com/eryajf"},"category":null,"labels":{"edges":[{"node":{"name":"更多","color":"25B472"}},{"node":{"name":"命令行工具","color":"e05879"}},{"node":{"name":"bvaisvil","color":"61c116"}}]},"comments":{"edges":[]}}},"pageContext":{"number":627,"previous":{"title":"tryzealot/zealot: 开源自部署持续集成一切跟应用有关事情，接入任意 CI 系统一切自动化处理，企业多年实战经验，独立部署提供企业打包分发流程、上传应用全套流程方案","number":626},"next":{"title":"easysoft/zentaopms: 禅道是第一款国产的开源项目管理软件。它集产品管理、项目管理、质量管理、文档管理、组织管理和事务管理于一体，是一款专业的研发项目管理软件，完整地覆盖了项目管理的核心流程。","number":628}}}, "staticQueryHashes": ["151096407","2861350382"]}