mirror of
https://github.com/karl0ss/homepage.git
synced 2025-04-29 12:03:41 +01:00
74 lines
3.0 KiB
Markdown
74 lines
3.0 KiB
Markdown
---
|
||
title: Glances
|
||
description: Glances Widget Configuration
|
||
---
|
||
|
||
<img width="1614" alt="glances" src="https://github-production-user-asset-6210df.s3.amazonaws.com/82196/257382012-25648c97-2c1b-4db0-b5a5-f1509806079c.png">
|
||
|
||
_(Find the Glances information widget [here](../info/glances.md))_
|
||
|
||
The Glances widget allows you to monitor the resources (cpu, memory, diskio, sensors & processes) of host or another machine. You can have multiple instances by adding another service block.
|
||
|
||
```yaml
|
||
widget:
|
||
type: glances
|
||
url: http://glances.host.or.ip:port
|
||
username: user # optional if auth enabled in Glances
|
||
password: pass # optional if auth enabled in Glances
|
||
metric: cpu
|
||
```
|
||
|
||
_Please note, this widget does not need an `href`, `icon` or `description` on its parent service. To achieve the same effect as the examples above, see as an example:_
|
||
|
||
```yaml
|
||
- CPU Usage:
|
||
widget:
|
||
type: glances
|
||
url: http://glances.host.or.ip:port
|
||
metric: cpu
|
||
- Network Usage:
|
||
widget:
|
||
type: glances
|
||
url: http://glances.host.or.ip:port
|
||
metric: network:enp0s25
|
||
```
|
||
|
||
## Metrics
|
||
|
||
The metric field in the configuration determines the type of system monitoring data to be displayed. Here are the supported metrics:
|
||
|
||
`info`: System information. Shows the system's hostname, OS, kernel version, CPU type, CPU usage, RAM usage and SWAP usage.
|
||
|
||
`cpu`: CPU usage. Shows how much of the system's computational resources are currently being used.
|
||
|
||
`memory`: Memory usage. Shows how much of the system's RAM is currently being used.
|
||
|
||
`process`: Top 5 processes based on CPU usage. Gives an overview of which processes are consuming the most resources.
|
||
|
||
`network:<interface_name>`: Network data usage for the specified interface. Replace `<interface_name>` with the name of your network interface, e.g., `network:enp0s25`, as specified in glances.
|
||
|
||
`sensor:<sensor_id>`: Temperature of the specified sensor, typically used to monitor CPU temperature. Replace `<sensor_id>` with the name of your sensor, e.g., `sensor:Package id 0` as specified in glances.
|
||
|
||
`disk:<disk_id>`: Disk I/O data for the specified disk. Replace `<disk_id>` with the id of your disk, e.g., `disk:sdb`, as specified in glances.
|
||
|
||
`gpu:<gpu_id>`: GPU usage for the specified GPU. Replace `<gpu_id>` with the id of your GPU, e.g., `gpu:0`, as specified in glances.
|
||
|
||
`fs:<mnt_point>`: Disk usage for the specified mount point. Replace `<mnt_point>` with the path of your disk, e.g., `/mnt/storage`, as specified in glances.
|
||
|
||
## Views
|
||
|
||
All widgets offer an alternative to the full or "graph" view, which is the compact, or "graphless" view.
|
||
|
||
<img width="970" alt="Screenshot 2023-09-06 at 1 51 48 PM" src="https://github-production-user-asset-6210df.s3.amazonaws.com/82196/265985295-cc6b9adc-4218-4274-96ca-36c3e64de5d0.png">
|
||
|
||
To switch to the alternative "graphless" view, simply pass `chart: false` as an option to the widget, like so:
|
||
|
||
```yaml
|
||
- Network Usage:
|
||
widget:
|
||
type: glances
|
||
url: http://glances.host.or.ip:port
|
||
metric: network:enp0s25
|
||
chart: false
|
||
```
|