scqc¶
Derives quality control (QC) parameters from waveforms.
Description¶
scqc determines waveform quality control (QC) parameters of data streams. The
output parameters are time averaged in terms of waveform quality messages.
In regular intervals report messages are sent containing the short term average
representation of the specific QC parameter for a given time span. Alarm messages
are generated if the short term average (e.g. 90 s) of a QC parameter differs from
the long term average (e.g. 3600 s) by more than a defined threshold.
To avoid an excessive load, QC messages are sent distributed over time. Storing
QC parameters into the database should be avoided by configuring, e.g.,
plugins.default.archive.interval
as otherwise the database grows
quickly.
The QC parameters can be interactively observed using scqcv or scmm.
Technology¶
scqc uses plugins to compute the waveform quality control (QC) parameters. The plugins can be found in @DATADIR@/plugins/qc. They are loaded by default or selected by configuration setup.
QC parameters¶
The following QC parameters are determined when the corresponding plugin is loaded:
- availability [%]
Plugin: qcplugin_availability
Description: Availability of data in the configured time span.
- delay [s]
Plugin: qcplugin_delay
Description: Time difference between current time, , and time of the last record in the SeisComP system (see Figure):
Note
Current time is measured during reception of a record and updated in the report intervals configured for delay.
- gaps (count [counts], interval [s], length [s])
Plugin: qcplugin_gap
Description: In case of a data gap between two consecutive records this parameter delivers the gap interval time (interval), the mean length of the gaps (length) and the number of the gaps (count) over the configured time interval.
Hint
gaps interval = 0 for gaps count = 1 but gaps interval > 0 for gaps count > 1. This may be important when evaluating the intervals.
- latency [s]
Plugin: qcplugin_latency
Description: Time difference between current time, , and arrival time of the last record (see Figure):
Note
Current time is measured during reception of a record and updated in the report intervals configured for latency.
- offset [counts]
Plugin: qcplugin_offset
Description: Average value of all samples of a record.
- outage [time string]
Plugin: qcplugin_outage
Description: Delivers the start and the end time of a data outage (gap).
- overlaps (count [counts], interval [s], length [s])
Plugin: qcplugin_overlap
Description: In case of overlaps between two consecutive records this parameter delivers the overlaps interval time (interval), the mean length (length) of the overlaps and the number of the overlaps (count) over the configured time interval.
Hint
overlaps interval = 0 for overlaps count = 1 but overlaps interval > 0 for overlaps count > 1. This may be important when evaluating the intervals.
- rms [counts]
Plugin: qcplugin_rms
Description: Offset corrected root mean square (RMS) value of a record.
- spikes (count [counts], interval [s], amplitude [counts])
Plugin: qcplugin_spike
Description: In case of the occurrence of a spike in a record this parameter delivers the time interval between consecutive spikes (interval), the mean amplitude of the spike (amplitude) and the number of the spikes (count) over the configured time interval. Internally a list of spikes is stored (spike time, spike amplitude); the spike finder algorithm is still preliminary.
Hint
spikes interval = 0 for spikes count = 1 but spikes interval > 0 for spikes count > 1. This may be important when evaluating the intervals.
- timing [%]
Plugin: qcplugin_timing
Description: miniSEED record timing quality (0 - 100 %) as written into the miniSEED records by the digitizer.
Setup¶
The configuration can be adjusted in the module configuration (scqc.cfg
).
Select the streams for which to compute the QC parameters. Be default, only streams defined global bindings are considered:
use3Components
: Select to consider the 3 components related to the stream defined by global bingings. Reguires to selectuseConfiguredStreams
.streamMask
: Freely choose any available stream to compute the QC parameters for. This requires to unselectuseConfiguredStreams
. Regular expressions may be used, e.g.:Consider BHZ streams from all networks, stations and locations:
streamMask = ""(.+)\.(.+)\.(.*)\.(BHZ)$"
Consider any component from BH, LH and HH streams:
streamMask = "(.+)\.(.+)\.(.*)\.((BH)|(LH)|(HH))?$"
Load the QC and other plugins, e.g. for data acquisition. The QC plugins loaded by default are
qcplugin_availability
,qcplugin_delay
,qcplugin_gap
,qcplugin_latency
,qcplugin_offset
,qcplugin_outage
,qcplugin_overlap
,qcplugin_rms
,qcplugin_spike
andqcplugin_timing
.Adjust
plugins
for setting plugins explicitly and to exclude the other ones, e.g.plugins = qcplugin_availability, qcplugin_spike
Further RecordStream plugins for reading data may be considered.
Configure the plugin parameters: Each plugin considers specific parameters which can be configured separately or the default section.
Configuration¶
etc/defaults/global.cfg
etc/defaults/scqc.cfg
etc/global.cfg
etc/scqc.cfg
~/.seiscomp/global.cfg
~/.seiscomp/scqc.cfg
scqc inherits global options.
-
CreatorId
¶ Type: string
ID of QC message creator Default is
smi://de.gfz-potsdam/QcTool_0.3.1
.
-
useConfiguredStreams
¶ Type: boolean
Limit QC determination to processed data streams which are defined in global bindings with detecLocid and detecStream. Default is
true
.
-
use3Components
¶ Type: boolean
If useConfiguredStreams is true then this parameter decides whether to use only the vertical component (default) or all three components. The 3 components are collected from the inventory according to channel orientation. If that is not possible then the fixed components N and E will be used. Default is
false
.
-
streamMask
¶ Type: string
If useConfiguredStreams is false, then load (from inventory) only those streams, matching the streamMask
RegEx e.g. “^(NET1|NET2).(STA1|STA2|STA3).(LOC).((BH)|(LH)|(HH))Z$”
RegEx e.g. “^(.+).(.+).(.*).(.+)Z$”
streamMask = “^(.+).(.+).(.*).(BHZ)$”
-
dbLookBack
¶ Type: int
Unit: days
Database look up for past entries not older than x days (to determine the last QC parameter calculated). Default is
7
.
Note
plugins.* Control parameters for individual QC plugins.
Note
plugins.default.* Default configuration parameters for the plugins. Can be overwritten by the individual plugin configurations.
-
plugins.default.realTimeOnly
¶ Type: boolean
Enable to use this plugin only for realtime processing.
Default [disable]: plugin is able to process archived data AND realtime data streams. Default is
false
.
-
plugins.default.filter
¶ Type: string
Filter string used to filter waveforms before processing.
-
plugins.default.buffer
¶ Type: int
Unit: s
Qc-Buffer Length [s] (aka LTA-Buffer). Must be >= plugins.*.bufferLength. Default is
4000
.
Note
plugins.default.report.* Control interactions with the messaging system.
-
plugins.default.report.interval
¶ Type: int
Unit: s
Interval for sending report messages which e.g. will be may be displayed by scqcv. Default is
60
.
-
plugins.default.report.buffer
¶ Type: int
Unit: s
Time window for calculating QC reports. Default is
600
.
-
plugins.default.report.timeout
¶ Type: int
Unit: s
Report messages are generated in case no data is received since timeout. Only in real-time processing. Default is
0
.
Note
plugins.default.archive.* Control sending QC reports as notifier to the messaging where scmaster will write them to the database.
-
plugins.default.archive.interval
¶ Type: int
Unit: s
Interval to send the QC reports.
Default [-1]: Do not send any QC report. This will prevent writing QC reports into the database. Default is
-1
.
-
plugins.default.archive.buffer
¶ Type: int
Unit: s
Time window for calculating QC reports. Default is
3600
.
Note
plugins.default.alert.* Control for sending alerts based on QC reports.
-
plugins.default.alert.interval
¶ Type: int
Unit: s
Interval for checking and sending alert thresholds. -1 disables threshold checking. Default is
-1
.
-
plugins.default.alert.buffer
¶ Type: int
Unit: s
Time window for calculating QC reports. Default is
1800
.
-
plugins.default.alert.thresholds
¶ Type: int
List of thresholds for sending QC reports. Use comma to separate values. Default is
150
.
Note
plugins.QcLatency.* Configuration parameters for the plugin qcplugin_latency. Overwrites the parameters from the default section.
-
plugins.QcLatency.realTimeOnly
¶ Type: boolean
Enable to use this plugin only for realtime processing.
Default [disable]: plugin is able to process archived data AND realtime data streams. Default is
true
.
-
plugins.QcLatency.filter
¶ Type: string
Filter string used to filter waveforms before processing.
-
plugins.QcLatency.buffer
¶ Type: int
Unit: s
Qc-Buffer Length [s] (aka LTA-Buffer). Must be >= plugins.*.bufferLength. Default is
4000
.
Note
plugins.QcLatency.report.* Control interactions with the messaging system.
-
plugins.QcLatency.report.interval
¶ Type: int
Unit: s
Interval for sending report messages which, e.g., can be displayed by scqcv. Default is
60
.
-
plugins.QcLatency.report.buffer
¶ Type: int
Unit: s
Time window for calculating QC reports. Default is
600
.
-
plugins.QcLatency.report.timeout
¶ Type: int
Unit: s
Report messages are generated in case no data is received since timeout. Only in real-time processing. Default is
0
.
Note
plugins.QcLatency.archive.* Control sending QC reports as notifier to the messaging where scmaster will write them to the database.
-
plugins.QcLatency.archive.interval
¶ Type: int
Unit: s
Interval to send the QC reports.
Default [-1]: Do not send any QC report. This will prevent writing QC reports into the database. Default is
-1
.
-
plugins.QcLatency.archive.buffer
¶ Type: int
Unit: s
Time window for calculating QC reports. Default is
3600
.
Note
plugins.QcLatency.alert.* Control for sending alerts based on QC reports.
-
plugins.QcLatency.alert.interval
¶ Type: int
Unit: s
Interval for checking and sending alert thresholds. -1 disables threshold checking. Default is
-1
.
-
plugins.QcLatency.alert.buffer
¶ Type: int
Unit: s
Time window for calculating QC reports. Default is
1800
.
-
plugins.QcLatency.alert.thresholds
¶ Type: int
List of thresholds for sending QC reports. Use comma to separate values. Default is
150
.
Note
plugins.QcDelay.* Configuration parameters for the plugin qcplugin_delay. Overwrites the parameters from the default section.
-
plugins.QcDelay.realTimeOnly
¶ Type: boolean
Enable to use this plugin only for realtime processing.
Default [disable]: plugin is able to processd data AND realtime data streams. Default is
true
.
-
plugins.QcDelay.filter
¶ Type: string
Filter string used to filter waveforms before processing.
-
plugins.QcDelay.buffer
¶ Type: int
Unit: s
Qc-Buffer Length [s] (aka LTA-Buffer). Must be >= plugins.*.bufferLength. Default is
4000
.
Note
plugins.QcDelay.report.* Control interactions with the messaging system.
-
plugins.QcDelay.report.interval
¶ Type: int
Unit: s
Interval for sending report messages which e.g. will be may be displayed by scqcv. Default is
60
.
-
plugins.QcDelay.report.buffer
¶ Type: int
Unit: s
Time window for calculating QC reports. Default is
600
.
-
plugins.QcDelay.report.timeout
¶ Type: int
Unit: s
Report messages are generated in case no data is received since timeout. Only in real-time processing. Default is
0
.
Note
plugins.QcDelay.archive.* Control sending QC reports as notifier to the messaging where scmaster will write them to the database.
-
plugins.QcDelay.archive.interval
¶ Type: int
Unit: s
Interval to send the QC reports.
Default [-1]: Do not send any QC report. This will prevent writing QC reports into the database. Default is
-1
.
-
plugins.QcDelay.archive.buffer
¶ Type: int
Unit: s
Time window for calculating QC reports. Default is
3600
.
Note
plugins.QcDelay.alert.* Control for sending alerts based on QC reports.
-
plugins.QcDelay.alert.interval
¶ Type: int
Unit: s
Interval for checking and sending alert thresholds. -1 disables threshold checking. Default is
-1
.
-
plugins.QcDelay.alert.buffer
¶ Type: int
Unit: s
Time window for calculating QC reports. Default is
1800
.
-
plugins.QcDelay.alert.thresholds
¶ Type: int
List of thresholds for sending QC reports. Use comma to separate values. Default is
150
.
Note
plugins.QcGap.* Configuration parameters for the plugin qcplugin_gap. Overwrites the parameters from the default section.
-
plugins.QcGap.realTimeOnly
¶ Type: boolean
Enable to use this plugin only for realtime processing.
Default [disable]: plugin is able to process archived data AND realtime data streams. Default is
false
.
-
plugins.QcGap.filter
¶ Type: string
Filter string used to filter waveforms before processing.
-
plugins.QcGap.buffer
¶ Type: int
Unit: s
Qc-Buffer Length [s] (aka LTA-Buffer). Must be >= plugins.*.bufferLength. Default is
4000
.
Note
plugins.QcGap.report.* Control interactions with the messaging system.
-
plugins.QcGap.report.interval
¶ Type: int
Unit: s
Interval for sending report messages which e.g. will be may be displayed by scqcv. Default is
60
.
-
plugins.QcGap.report.buffer
¶ Type: int
Unit: s
Time window for calculating QC reports. Default is
600
.
-
plugins.QcGap.report.timeout
¶ Type: int
Unit: s
Report messages are generated in case no data is received since timeout. Only in real-time processing. Default is
0
.
Note
plugins.QcGap.archive.* Control sending QC reports as notifier to the messaging where scmaster will write them to the database.
-
plugins.QcGap.archive.interval
¶ Type: int
Unit: s
Interval to send the QC reports.
Default [-1]: Do not send any QC report. This will prevent writing QC reports into the database. Default is
-1
.
-
plugins.QcGap.archive.buffer
¶ Type: int
Unit: s
Time window for calculating QC reports. Default is
3600
.
Note
plugins.QcGap.alert.* Control for sending alerts based on QC reports.
-
plugins.QcGap.alert.interval
¶ Type: int
Unit: s
Interval for checking and sending alert thresholds. -1 disables threshold checking. Default is
-1
.
-
plugins.QcGap.alert.buffer
¶ Type: int
Unit: s
Time window for calculating QC reports. Default is
1800
.
-
plugins.QcGap.alert.thresholds
¶ Type: int
List of thresholds for sending QC reports. Use comma to separate values. Default is
150
.
Note
plugins.QcOffset.* Configuration parameters for the plugin qcplugin_offset. Overwrites the parameters from the default section.
-
plugins.QcOffset.realTimeOnly
¶ Type: boolean
Enable to use this plugin only for realtime processing.
Default [disable]: plugin is able to process archived data AND realtime data streams. Default is
false
.
-
plugins.QcOffset.filter
¶ Type: string
Filter string used to filter waveforms before processing.
-
plugins.QcOffset.buffer
¶ Type: int
Unit: s
Qc-Buffer Length [s] (aka LTA-Buffer). Must be >= plugins.*.bufferLength. Default is
4000
.
Note
plugins.QcOffset.report.* Control interactions with the messaging system.
-
plugins.QcOffset.report.interval
¶ Type: int
Unit: s
Interval for sending report messages which e.g. will be may be displayed by scqcv. Default is
60
.
-
plugins.QcOffset.report.buffer
¶ Type: int
Unit: s
Time window for calculating QC reports. Default is
600
.
-
plugins.QcOffset.report.timeout
¶ Type: int
Unit: s
Report messages are generated in case no data is received since timeout. Only in real-time processing. Default is
0
.
Note
plugins.QcOffset.archive.* Control sending QC reports as notifier to the messaging where scmaster will write them to the database.
-
plugins.QcOffset.archive.interval
¶ Type: int
Unit: s
Interval to send the QC reports.
Default [-1]: Do not send any QC report. This will prevent writing QC reports into the database. Default is
-1
.
-
plugins.QcOffset.archive.buffer
¶ Type: int
Unit: s
Time window for calculating QC reports. Default is
3600
.
Note
plugins.QcOffset.alert.* Control for sending alerts based on QC reports.
-
plugins.QcOffset.alert.interval
¶ Type: int
Unit: s
Interval for checking and sending alert thresholds. -1 disables threshold checking. Default is
-1
.
-
plugins.QcOffset.alert.buffer
¶ Type: int
Unit: s
Time window for calculating QC reports. Default is
1800
.
-
plugins.QcOffset.alert.thresholds
¶ Type: int
List of thresholds for sending QC reports. Use comma to separate values. Default is
150
.
Note
plugins.QcOverlap.* Configuration parameters for the plugin qcplugin_overlap. Overwrites the parameters from the default section.
-
plugins.QcOverlap.realTimeOnly
¶ Type: boolean
Enable to use this plugin only for realtime processing.
Default [disable]: plugin is able to process archived data AND realtime data streams. Default is
false
.
-
plugins.QcOverlap.filter
¶ Type: string
Filter string used to filter waveforms before processing.
-
plugins.QcOverlap.buffer
¶ Type: int
Unit: s
Qc-Buffer Length [s] (aka LTA-Buffer). Must be >= plugins.*.bufferLength. Default is
4000
.
Note
plugins.QcOverlap.report.* Control interactions with the messaging system.
-
plugins.QcOverlap.report.interval
¶ Type: int
Unit: s
Interval for sending report messages which e.g. will be may be displayed by scqcv. Default is
60
.
-
plugins.QcOverlap.report.buffer
¶ Type: int
Unit: s
Time window for calculating QC reports. Default is
600
.
-
plugins.QcOverlap.report.timeout
¶ Type: int
Unit: s
Report messages are generated in case no data is received since timeout. Only in real-time processing. Default is
0
.
Note
plugins.QcOverlap.archive.* Control sending QC reports as notifier to the messaging where scmaster will write them to the database.
-
plugins.QcOverlap.archive.interval
¶ Type: int
Unit: s
Interval to send the QC reports.
Default [-1]: Do not send any QC report. This will prevent writing QC reports into the database. Default is
-1
.
-
plugins.QcOverlap.archive.buffer
¶ Type: int
Unit: s
Time window for calculating QC reports. Default is
3600
.
Note
plugins.QcOverlap.alert.* Control for sending alerts based on QC reports.
-
plugins.QcOverlap.alert.interval
¶ Type: int
Unit: s
Interval for checking and sending alert thresholds. -1 disables threshold checking. Default is
-1
.
-
plugins.QcOverlap.alert.buffer
¶ Type: int
Unit: s
Time window for calculating QC reports. Default is
1800
.
-
plugins.QcOverlap.alert.thresholds
¶ Type: int
List of thresholds for sending QC reports. Use comma to separate values. Default is
150
.
Note
plugins.QcRms.* Configuration parameters for the plugin qcplugin_rms. Overwrites the parameters from the default section.
-
plugins.QcRms.realTimeOnly
¶ Type: boolean
Enable to use this plugin only for realtime processing.
Default [disable]: plugin is able to process archived data AND realtime data streams. Default is
false
.
-
plugins.QcRms.filter
¶ Type: string
Filter string used to filter waveforms before processing.
-
plugins.QcRms.buffer
¶ Type: int
Unit: s
Qc-Buffer Length [s] (aka LTA-Buffer). Must be >= plugins.*.bufferLength. Default is
4000
.
Note
plugins.QcRms.report.* Control interactions with the messaging system.
-
plugins.QcRms.report.interval
¶ Type: int
Unit: s
Interval for sending report messages which e.g. will be may be displayed by scqcv. Default is
60
.
-
plugins.QcRms.report.buffer
¶ Type: int
Unit: s
Time window for calculating QC reports. Default is
600
.
-
plugins.QcRms.report.timeout
¶ Type: int
Unit: s
Report messages are generated in case no data is received since timeout. Only in real-time processing. Default is
0
.
Note
plugins.QcRms.archive.* Control sending QC reports as notifier to the messaging where scmaster will write them to the database.
-
plugins.QcRms.archive.interval
¶ Type: int
Unit: s
Interval to send the QC reports.
Default [-1]: Do not send any QC report. This will prevent writing QC reports into the database. Default is
-1
.
-
plugins.QcRms.archive.buffer
¶ Type: int
Unit: s
Time window for calculating QC reports. Default is
3600
.
Note
plugins.QcRms.alert.* Control for sending alerts based on QC reports.
-
plugins.QcRms.alert.interval
¶ Type: int
Unit: s
Interval for checking and sending alert thresholds. -1 disables threshold checking. Default is
-1
.
-
plugins.QcRms.alert.buffer
¶ Type: int
Unit: s
Time window for calculating QC reports. Default is
1800
.
-
plugins.QcRms.alert.thresholds
¶ Type: int
List of thresholds for sending QC reports. Use comma to separate values. Default is
150
.
Note
plugins.QcSpike.* Configuration parameters for the plugin qcplugin_spike. Overwrites the parameters from the default section.
-
plugins.QcSpike.realTimeOnly
¶ Type: boolean
Enable to use this plugin only for realtime processing.
Default [disable]: plugin is able to process archived data AND realtime data streams. Default is
false
.
-
plugins.QcSpike.filter
¶ Type: string
Filter string used to filter waveforms before processing.
-
plugins.QcSpike.buffer
¶ Type: int
Unit: s
Qc-Buffer Length [s] (aka LTA-Buffer). Must be >= plugins.*.bufferLength. Default is
4000
.
Note
plugins.QcSpike.report.* Control interactions with the messaging system.
-
plugins.QcSpike.report.interval
¶ Type: int
Unit: s
Interval for sending report messages which e.g. will be may be displayed by scqcv. Default is
60
.
-
plugins.QcSpike.report.buffer
¶ Type: int
Unit: s
Time window for calculating QC reports. Default is
600
.
-
plugins.QcSpike.report.timeout
¶ Type: int
Unit: s
Report messages are generated in case no data is received since timeout. Only in real-time processing. Default is
0
.
Note
plugins.QcSpike.archive.* Control sending QC reports as notifier to the messaging where scmaster will write them to the database.
-
plugins.QcSpike.archive.interval
¶ Type: int
Unit: s
Interval to send the QC reports.
Default [-1]: Do not send any QC report. This will prevent writing QC reports into the database. Default is
-1
.
-
plugins.QcSpike.archive.buffer
¶ Type: int
Unit: s
Time window for calculating QC reports. Default is
3600
.
Note
plugins.QcSpike.alert.* Control for sending alerts based on QC reports.
-
plugins.QcSpike.alert.interval
¶ Type: int
Unit: s
Interval for checking and sending alert thresholds. -1 disables threshold checking. Default is
-1
.
-
plugins.QcSpike.alert.buffer
¶ Type: int
Unit: s
Time window for calculating QC reports. Default is
1800
.
-
plugins.QcSpike.alert.thresholds
¶ Type: int
List of thresholds for sending QC reports. Use comma to separate values. Default is
150
.
Note
plugins.QcTiming.* Configuration parameters for the plugin qcplugin_timing. Overwrites the parameters from the default section.
-
plugins.QcTiming.realTimeOnly
¶ Type: boolean
Enable to use this plugin only for realtime processing.
Default [disable]: plugin is able to process archived data AND realtime data streams. Default is
false
.
-
plugins.QcTiming.filter
¶ Type: string
Filter string used to filter waveforms before processing.
-
plugins.QcTiming.buffer
¶ Type: int
Unit: s
Qc-Buffer Length [s] (aka LTA-Buffer). Must be >= plugins.*.bufferLength. Default is
4000
.
Note
plugins.QcTiming.report.* Control interactions with the messaging system.
-
plugins.QcTiming.report.interval
¶ Type: int
Unit: s
Interval for sending report messages which e.g. will be may be displayed by scqcv. Default is
60
.
-
plugins.QcTiming.report.buffer
¶ Type: int
Unit: s
Time window for calculating QC reports. Default is
600
.
-
plugins.QcTiming.report.timeout
¶ Type: int
Unit: s
Report messages are generated in case no data is received since timeout. Only in real-time processing. Default is
0
.
Note
plugins.QcTiming.archive.* Control sending QC reports as notifier to the messaging where scmaster will write them to the database.
-
plugins.QcTiming.archive.interval
¶ Type: int
Unit: s
Interval to send the QC reports.
Default [-1]: Do not send any QC report. This will prevent writing QC reports into the database. Default is
-1
.
-
plugins.QcTiming.archive.buffer
¶ Type: int
Unit: s
Time window for calculating QC reports. Default is
3600
.
Note
plugins.QcTiming.alert.* Control for sending alerts based on QC reports.
-
plugins.QcTiming.alert.interval
¶ Type: int
Unit: s
Interval for checking and sending alert thresholds. -1 disables threshold checking. Default is
-1
.
-
plugins.QcTiming.alert.buffer
¶ Type: int
Unit: s
Time window for calculating QC reports. Default is
1800
.
-
plugins.QcTiming.alert.thresholds
¶ Type: int
List of thresholds for sending QC reports. Use comma to separate values. Default is
150
.
Note
plugins.QcAvailability.* Configuration parameters for the plugin qcplugin_availability. Overwrites the parameters from the default section.
-
plugins.QcAvailability.realTimeOnly
¶ Type: boolean
Enable to use this plugin only for realtime processing.
Default [disable]: plugin is able to process archived data AND realtime data streams. Default is
false
.
-
plugins.QcAvailability.filter
¶ Type: string
Filter string used to filter waveforms before processing.
-
plugins.QcAvailability.buffer
¶ Type: int
Unit: s
Qc-Buffer Length [s] (aka LTA-Buffer). Must be >= plugins.*.bufferLength. Default is
4000
.
Note
plugins.QcAvailability.report.* Control interactions with the messaging system.
-
plugins.QcAvailability.report.interval
¶ Type: int
Unit: s
Interval for sending report messages which e.g. will be may be displayed by scqcv. Default is
60
.
-
plugins.QcAvailability.report.buffer
¶ Type: int
Unit: s
Time window for calculating QC reports. Default is
600
.
-
plugins.QcAvailability.report.timeout
¶ Type: int
Unit: s
Report messages are generated in case no data is received since timeout. Only in real-time processing. Default is
0
.
Note
plugins.QcAvailability.archive.* Control sending QC reports as notifier to the messaging where scmaster will write them to the database.
-
plugins.QcAvailability.archive.interval
¶ Type: int
Unit: s
Interval to send the QC reports.
Default [-1]: Do not send any QC report. This will prevent writing QC reports into the database. Default is
-1
.
-
plugins.QcAvailability.archive.buffer
¶ Type: int
Unit: s
Time window for calculating QC reports. Default is
3600
.
Note
plugins.QcAvailability.alert.* Control for sending alerts based on QC reports.
-
plugins.QcAvailability.alert.interval
¶ Type: int
Unit: s
Interval for checking and sending alert thresholds. -1 disables threshold checking. Default is
-1
.
-
plugins.QcAvailability.alert.buffer
¶ Type: int
Unit: s
Time window for calculating QC reports. Default is
1800
.
-
plugins.QcAvailability.alert.thresholds
¶ Type: int
List of thresholds for sending QC reports. Use comma to separate values. Default is
150
.
Note
plugins.QcOutage.* Configuration parameters for the plugin qcplugin_outage. Overwrites the parameters from the default section.
-
plugins.QcOutage.realTimeOnly
¶ Type: boolean
Enable to use this plugin only for realtime processing.
Default [disable]: plugin is able to process archived data AND realtime data streams. Default is
false
.
-
plugins.QcOutage.filter
¶ Type: string
Filter string used to filter waveforms before processing.
-
plugins.QcOutage.buffer
¶ Type: int
Unit: s
Qc-Buffer Length [s] (aka LTA-Buffer). Must be >= plugins.*.bufferLength. Default is
4000
.
-
plugins.QcOutage.notifyDB
¶ Type: int
Unit: s
If there is a gap of more than notifyDB [s], write an OUTAGE entry into the database. Default is
1800
.
Note
plugins.QcOutage.report.* Control interactions with the messaging system.
-
plugins.QcOutage.report.interval
¶ Type: int
Unit: s
Interval for sending report messages which e.g. will be may be displayed by scqcv. Default is
60
.
-
plugins.QcOutage.report.buffer
¶ Type: int
Unit: s
Time window for calculating QC reports. Default is
600
.
-
plugins.QcOutage.report.timeout
¶ Type: int
Unit: s
Report messages are generated in case no data is received since timeout. Only in real-time processing. Default is
0
.
Note
plugins.QcOutage.archive.* Control sending QC reports as notifier to the messaging where scmaster will write them to the database.
-
plugins.QcOutage.archive.interval
¶ Type: int
Unit: s
Interval to send the QC reports.
Default [-1]: Do not send any QC report. This will prevent writing QC reports into the database. Default is
-1
.
-
plugins.QcOutage.archive.buffer
¶ Type: int
Unit: s
Time window for calculating QC reports. Default is
3600
.
Note
plugins.QcOutage.alert.* Control for sending alerts based on QC reports.
-
plugins.QcOutage.alert.interval
¶ Type: int
Unit: s
Interval for checking and sending alert thresholds. -1 disables threshold checking. Default is
-1
.
-
plugins.QcOutage.alert.buffer
¶ Type: int
Unit: s
Time window for calculating QC reports. Default is
1800
.
-
plugins.QcOutage.alert.thresholds
¶ Type: int
List of thresholds for sending QC reports. Use comma to separate values. Default is
150
.
Command-line¶
Generic¶
-
-h
,
--help
¶
show help message.
-
-V
,
--version
¶
show version information
-
--config-file
arg
¶ Use alternative configuration file. When this option is used the loading of all stages is disabled. Only the given configuration file is parsed and used. To use another name for the configuration create a symbolic link of the application or copy it, eg scautopick -> scautopick2.
-
--plugins
arg
¶ Load given plugins.
-
-D
,
--daemon
¶
Run as daemon. This means the application will fork itself and doesn’t need to be started with &.
-
--auto-shutdown
arg
¶ Enable/disable self-shutdown because a master module shutdown. This only works when messaging is enabled and the master module sends a shutdown message (enabled with –start-stop-msg for the master module).
-
--shutdown-master-module
arg
¶ Sets the name of the master-module used for auto-shutdown. This is the application name of the module actually started. If symlinks are used then it is the name of the symlinked application.
-
--shutdown-master-username
arg
¶ Sets the name of the master-username of the messaging used for auto-shutdown. If “shutdown-master-module” is given as well this parameter is ignored.
Verbosity¶
-
--verbosity
arg
¶ Verbosity level [0..4]. 0:quiet, 1:error, 2:warning, 3:info, 4:debug
-
-v
,
--v
¶
Increase verbosity level (may be repeated, eg. -vv)
-
-q
,
--quiet
¶
Quiet mode: no logging output
-
--component
arg
¶ Limits the logging to a certain component. This option can be given more than once.
-
-s
,
--syslog
¶
Use syslog logging back end. The output usually goes to /var/lib/messages.
-
-l
,
--lockfile
arg
¶ Path to lock file.
-
--console
arg
¶ Send log output to stdout.
-
--debug
¶
Debug mode: –verbosity=4 –console=1
-
--log-file
arg
¶ Use alternative log file.
Messaging¶
-
-u
,
--user
arg
¶ Overrides configuration parameter
connection.username
.
-
-H
,
--host
arg
¶ Overrides configuration parameter
connection.server
.
-
-t
,
--timeout
arg
¶ Overrides configuration parameter
connection.timeout
.
-
-g
,
--primary-group
arg
¶ Overrides configuration parameter
connection.primaryGroup
.
-
-S
,
--subscribe-group
arg
¶ A group to subscribe to. This option can be given more than once.
-
--content-type
arg
¶ Overrides configuration parameter
connection.contentType
.
-
--start-stop-msg
arg
¶ Sets sending of a start- and a stop message.
Database¶
-
--db-driver-list
¶
List all supported database drivers.
-
-d
,
--database
arg
¶ The database connection string, format: service://user:pwd@host/database. “service” is the name of the database driver which can be queried with “–db-driver-list”.
-
--config-module
arg
¶ The configmodule to use.
-
--inventory-db
arg
¶ Load the inventory from the given database or file, format: [service://]location
-
--db-disable
¶
Do not use the database at all
Records¶
-
--record-driver-list
¶
List all supported record stream drivers
-
-I
,
--record-url
arg
¶ The recordstream source URL, format: [service://]location[#type]. “service” is the name of the recordstream driver which can be queried with “–record-driver-list”. If “service” is not given “file://” is used.
-
--record-file
arg
¶ Specify a file as record source.
-
--record-type
arg
¶ Specify a type for the records being read.