96 lines
2.3 KiB
Groff
96 lines
2.3 KiB
Groff
.\" Man page generated from reStructuredText.
|
|
.
|
|
.
|
|
.nr rst2man-indent-level 0
|
|
.
|
|
.de1 rstReportMargin
|
|
\\$1 \\n[an-margin]
|
|
level \\n[rst2man-indent-level]
|
|
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
-
|
|
\\n[rst2man-indent0]
|
|
\\n[rst2man-indent1]
|
|
\\n[rst2man-indent2]
|
|
..
|
|
.de1 INDENT
|
|
.\" .rstReportMargin pre:
|
|
. RS \\$1
|
|
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
|
|
. nr rst2man-indent-level +1
|
|
.\" .rstReportMargin post:
|
|
..
|
|
.de UNINDENT
|
|
. RE
|
|
.\" indent \\n[an-margin]
|
|
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
.nr rst2man-indent-level -1
|
|
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
|
..
|
|
.TH "DISKMON" "1" "Sep 22, 2025" "6.9.0" "SeisComP"
|
|
.SH NAME
|
|
diskmon \- SeisComP Documentation
|
|
.sp
|
|
\fBMonitors a disk and sends notifications.\fP
|
|
.SH DESCRIPTION
|
|
.sp
|
|
Diskmon is a SeisComP init script that checks on each call to \fBseiscomp check\fP
|
|
the filesystem by running the following command:
|
|
.INDENT 0.0
|
|
.INDENT 3.5
|
|
.sp
|
|
.nf
|
|
.ft C
|
|
df | awk \-v max=\(dq%d\(dq \e\(aq{ if ( $5 > max ) print $0 }\e\(aq
|
|
.ft P
|
|
.fi
|
|
.UNINDENT
|
|
.UNINDENT
|
|
.sp
|
|
where \(dq%d\(dq is replaced by the configured threshold. If there are lines in the
|
|
output (which means some filesystem exceed the usage threshold) it sends
|
|
the output along with a description line to all configured receipients using
|
|
the \fBmail\fP command.
|
|
.sp
|
|
To make diskmon work it is important that \fBmail\fP is working on the shell.
|
|
.SH MODULE CONFIGURATION
|
|
.sp
|
|
\fBNOTE:\fP
|
|
.INDENT 0.0
|
|
.INDENT 3.5
|
|
diskmon is a \fI\%standalone module\fP and does not inherit \fI\%global options\fP\&.
|
|
.UNINDENT
|
|
.UNINDENT
|
|
.nf
|
|
\fBetc/defaults/diskmon.cfg\fP
|
|
\fBetc/diskmon.cfg\fP
|
|
\fB~/.seiscomp/diskmon.cfg\fP
|
|
.fi
|
|
.sp
|
|
.INDENT 0.0
|
|
.TP
|
|
.B threshold
|
|
Default: \fB95\fP
|
|
.sp
|
|
Type: \fIint\fP
|
|
.sp
|
|
Disk usage threshold in percent. Each time when the disk usage exceeds this level,
|
|
an alert e\-mail is send to the user. Note that disk usage is only checked when a
|
|
cron job of seiscomp check is installed or seiscomp check is called
|
|
regularly by other means.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B emails
|
|
Type: \fIlist:string\fP
|
|
.sp
|
|
Comma\-separated list of e\-mail addresses to notify when disk usage
|
|
threshold is exceeded.
|
|
.UNINDENT
|
|
.SH AUTHOR
|
|
gempa GmbH, GFZ Potsdam
|
|
.SH COPYRIGHT
|
|
gempa GmbH, GFZ Potsdam
|
|
.\" Generated by docutils manpage writer.
|
|
.
|