Move resource monitoring from notes to docs
This commit is contained in:
parent
1272d4e7e3
commit
96356ed545
|
|
@ -19,3 +19,4 @@ Items marked ```REQUIRED``` are assumed to be setup and working. You've been war
|
||||||
* [Additional Networking Setup (REQUIRED)](cockpit.md)
|
* [Additional Networking Setup (REQUIRED)](cockpit.md)
|
||||||
* [Web Dashboard / Landing Page](landing_page.md)
|
* [Web Dashboard / Landing Page](landing_page.md)
|
||||||
* [System Monitoring (REQUIRED)](monit.md)
|
* [System Monitoring (REQUIRED)](monit.md)
|
||||||
|
* [Resource Monitoring](munin.md)
|
||||||
|
|
|
||||||
94
docs/munin.md
Normal file
94
docs/munin.md
Normal file
|
|
@ -0,0 +1,94 @@
|
||||||
|
# Resource Monitoring
|
||||||
|
|
||||||
|
The below commands will setup ```munin``` for monitoring resource utilization on your PiFrame. This is wholly optional but can provide insights if your PiFrame is exhibiting odd behavior.
|
||||||
|
|
||||||
|
## Important Notes
|
||||||
|
|
||||||
|
* This setup will deploy a *dedicated instance* of ```lighttpd``` to handle access to the ```munin``` data. Given how lean ```lighttpd``` is on resources, this saves many hassles with virtual hosts and the like.
|
||||||
|
* This setup uses cgi to generate ```munin``` graphs. The Raspberry Pi cpu can take awhile to generate graphs. Please be patient. This approach was chosen to keep ```munin``` from consuming resource generating graphs every time it collects statistics. This also helps prevent excessive disk writes to the micro sd card extending its life.
|
||||||
|
|
||||||
|
## Setup
|
||||||
|
|
||||||
|
``` sh
|
||||||
|
|
||||||
|
pacman -S munin perl-cgi-fast
|
||||||
|
nano -w /etc/munin/munin.conf
|
||||||
|
graph_strategy cgi
|
||||||
|
html_strategy cron
|
||||||
|
[piframe]
|
||||||
|
address 127.0.0.1
|
||||||
|
use_node_name yes
|
||||||
|
chown munin: /var/lib/munin/cgi-tmp
|
||||||
|
chown munin: -R /usr/share/munin/www
|
||||||
|
munin-node-configure --shell # activate useful plugins
|
||||||
|
sudo -sHu munin munin-cron # prime munin data
|
||||||
|
systemctl enable --now munin-node
|
||||||
|
crontab /etc/munin/munin-cron-entry -u munin
|
||||||
|
cat > /etc/lighttpd/lighttpd-munin.conf <<EOF
|
||||||
|
# Apply the following tweaks to the /etc/munin/munin.conf file ahead of running lighttpd for munin
|
||||||
|
## Use cgi rendering for graph and html
|
||||||
|
#graph_strategy cgi
|
||||||
|
#html_strategy cron
|
||||||
|
|
||||||
|
server.username = "munin"
|
||||||
|
server.groupname = "munin"
|
||||||
|
|
||||||
|
server.document-root = "/srv/http"
|
||||||
|
server.port = 2813
|
||||||
|
|
||||||
|
server.errorlog = "/var/log/munin/lighttpd-error.log"
|
||||||
|
dir-listing.activate = "disable"
|
||||||
|
server.modules = (
|
||||||
|
"mod_access",
|
||||||
|
"mod_accesslog",
|
||||||
|
"mod_alias",
|
||||||
|
"mod_rewrite",
|
||||||
|
"mod_redirect",
|
||||||
|
"mod_cgi",
|
||||||
|
"mod_fastcgi",
|
||||||
|
)
|
||||||
|
server.follow-symlink = "enable"
|
||||||
|
index-file.names = ( "index.html", "index.htm" )
|
||||||
|
|
||||||
|
url.redirect += ( "^/*$" => "/munin/" )
|
||||||
|
|
||||||
|
\$HTTP["url"] =~ "/munin-cgi/munin-cgi-graph" {
|
||||||
|
alias.url += ( "/munin-cgi/munin-cgi-graph" => "/usr/share/munin/cgi/munin-cgi-graph" )
|
||||||
|
cgi.assign = ( "" => "" )
|
||||||
|
}
|
||||||
|
|
||||||
|
#alias.url += ( "/munin/static" => "/etc/munin/static" )
|
||||||
|
alias.url += ( "/munin" => "/usr/share/munin/www" )
|
||||||
|
|
||||||
|
mimetype.assign = (
|
||||||
|
".html" => "text/html",
|
||||||
|
".txt" => "text/plain",
|
||||||
|
".css" => "text/css",
|
||||||
|
".js" => "application/x-javascript",
|
||||||
|
".jpg" => "image/jpeg",
|
||||||
|
".jpeg" => "image/jpeg",
|
||||||
|
".gif" => "image/gif",
|
||||||
|
".png" => "image/png",
|
||||||
|
"" => "application/octet-stream"
|
||||||
|
)
|
||||||
|
EOF
|
||||||
|
cat > /etc/systemd/system/lighttpd-munin.service <<EOF
|
||||||
|
[Unit]
|
||||||
|
Description=Lighttpd Web Server (munin)
|
||||||
|
After=syslog.target network.target
|
||||||
|
|
||||||
|
[Service]
|
||||||
|
PrivateTmp=true
|
||||||
|
ExecStart=/usr/bin/lighttpd-angel -D -f /etc/lighttpd/lighttpd-munin.conf
|
||||||
|
ExecReload=/bin/kill -HUP $MAINPID
|
||||||
|
KillSignal=SIGINT
|
||||||
|
|
||||||
|
[Install]
|
||||||
|
WantedBy=multi-user.target
|
||||||
|
EOF
|
||||||
|
systemctl daemon-reload
|
||||||
|
systemctl enable --now lighttpd-munin
|
||||||
|
firewall-cmd --zone=public --permanent --add-port=2813/tcp
|
||||||
|
firewall-cmd --reload
|
||||||
|
|
||||||
|
```
|
||||||
84
notes.txt
84
notes.txt
|
|
@ -1,87 +1,3 @@
|
||||||
########################################
|
|
||||||
# system _resource_ monitoring
|
|
||||||
########################################
|
|
||||||
|
|
||||||
pacman -S munin perl-cgi-fast
|
|
||||||
nano -w /etc/munin/munin.conf
|
|
||||||
graph_strategy cgi
|
|
||||||
html_strategy cron
|
|
||||||
[piframe]
|
|
||||||
address 127.0.0.1
|
|
||||||
use_node_name yes
|
|
||||||
chown munin: /var/lib/munin/cgi-tmp
|
|
||||||
chown munin: -R /usr/share/munin/www
|
|
||||||
munin-node-configure --shell # activate useful plugins
|
|
||||||
sudo -sHu munin munin-cron # prime munin data
|
|
||||||
systemctl enable --now munin-node
|
|
||||||
crontab /etc/munin/munin-cron-entry -u munin
|
|
||||||
cat > /etc/lighttpd/lighttpd-munin.conf <<EOF
|
|
||||||
# Apply the following tweaks to the /etc/munin/munin.conf file ahead of running lighttpd for munin
|
|
||||||
## Use cgi rendering for graph and html
|
|
||||||
#graph_strategy cgi
|
|
||||||
#html_strategy cron
|
|
||||||
|
|
||||||
server.username = "munin"
|
|
||||||
server.groupname = "munin"
|
|
||||||
|
|
||||||
server.document-root = "/srv/http"
|
|
||||||
server.port = 2813
|
|
||||||
|
|
||||||
server.errorlog = "/var/log/munin/lighttpd-error.log"
|
|
||||||
dir-listing.activate = "disable"
|
|
||||||
server.modules = (
|
|
||||||
"mod_access",
|
|
||||||
"mod_accesslog",
|
|
||||||
"mod_alias",
|
|
||||||
"mod_rewrite",
|
|
||||||
"mod_redirect",
|
|
||||||
"mod_cgi",
|
|
||||||
"mod_fastcgi",
|
|
||||||
)
|
|
||||||
server.follow-symlink = "enable"
|
|
||||||
index-file.names = ( "index.html", "index.htm" )
|
|
||||||
|
|
||||||
url.redirect += ( "^/*$" => "/munin/" )
|
|
||||||
|
|
||||||
\$HTTP["url"] =~ "/munin-cgi/munin-cgi-graph" {
|
|
||||||
alias.url += ( "/munin-cgi/munin-cgi-graph" => "/usr/share/munin/cgi/munin-cgi-graph" )
|
|
||||||
cgi.assign = ( "" => "" )
|
|
||||||
}
|
|
||||||
|
|
||||||
#alias.url += ( "/munin/static" => "/etc/munin/static" )
|
|
||||||
alias.url += ( "/munin" => "/usr/share/munin/www" )
|
|
||||||
|
|
||||||
mimetype.assign = (
|
|
||||||
".html" => "text/html",
|
|
||||||
".txt" => "text/plain",
|
|
||||||
".css" => "text/css",
|
|
||||||
".js" => "application/x-javascript",
|
|
||||||
".jpg" => "image/jpeg",
|
|
||||||
".jpeg" => "image/jpeg",
|
|
||||||
".gif" => "image/gif",
|
|
||||||
".png" => "image/png",
|
|
||||||
"" => "application/octet-stream"
|
|
||||||
)
|
|
||||||
EOF
|
|
||||||
cat > /etc/systemd/system/lighttpd-munin.service <<EOF
|
|
||||||
[Unit]
|
|
||||||
Description=Lighttpd Web Server (munin)
|
|
||||||
After=syslog.target network.target
|
|
||||||
|
|
||||||
[Service]
|
|
||||||
PrivateTmp=true
|
|
||||||
ExecStart=/usr/bin/lighttpd-angel -D -f /etc/lighttpd/lighttpd-munin.conf
|
|
||||||
ExecReload=/bin/kill -HUP $MAINPID
|
|
||||||
KillSignal=SIGINT
|
|
||||||
|
|
||||||
[Install]
|
|
||||||
WantedBy=multi-user.target
|
|
||||||
EOF
|
|
||||||
systemctl daemon-reload
|
|
||||||
systemctl enable --now lighttpd-munin
|
|
||||||
firewall-cmd --zone=public --permanent --add-port=2813/tcp
|
|
||||||
firewall-cmd --reload
|
|
||||||
|
|
||||||
########################################
|
########################################
|
||||||
# syncthing / rclone / web based file browser
|
# syncthing / rclone / web based file browser
|
||||||
########################################
|
########################################
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue