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)
|
||||
* [Web Dashboard / Landing Page](landing_page.md)
|
||||
* [System Monitoring (REQUIRED)](monit.md)
|
||||
* [Resource Monitoring](munin.md)
|
||||
|
|
|
|||
|
|
@ -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
|
||||
########################################
|
||||
|
|
|
|||
Loading…
Reference in New Issue