File indexing completed on 2024-04-06 12:12:43
0001 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
0002 <BODY bgcolor="FFFFFF">
0003 <title>
0004 CMS MessageLogger: Establishing Limits and Timespans
0005 </title>
0006
0007 <center>
0008 <h1> <img src="header-public.gif" align="center"> </h1>
0009
0010 <font color=red>
0011 <h1>
0012 Establishing Limits and Timespans </h1>
0013 </font>
0014 </center>
0015
0016 <pre>
0017 process TEST = {
0018
0019 service = MessageLogger {
0020 vstring destinations = { "detailedInfo.txt"
0021 , "critical.txt"
0022 , "jobdebug.txt"
0023 , "anotherfile.txt"
0024 , "cout"
0025 , "cerr"
0026 }
0027 vstring categories = { "unimportant"
0028 , "trkwarning"
0029 , "serious_matter"
0030 }
0031 PSet critical.txt = { string threshold = "ERROR"
0032 PSet default = { <font color=red>int32 limit = 10</font>
0033 <font color=red>int32 timespan = 180</font>
0034 }
0035 PSet serious_matter = { int32 limit = 100000 }
0036 }
0037 PSet detailedInfo.txt = { string threshold = "INFO"
0038 PSet default = { <font color=red>int32 limit = 10
0039 int32 timespan = 60</font>
0040 }
0041 PSet WARNING = { <font color=red>int32 limit = 100
0042 int32 timespan = 60</font>
0043 }
0044 PSet ERROR = { <font color=red>int32 limit = 100
0045 int32 timespan = 60</font>
0046 }
0047 PSet trkwarning = { <font color=red>int32 limit = 20
0048 int32 timespan = 1200</font>
0049 }
0050 PSet unimportant = { <font color=red>int32 limit = 5</font> }
0051 PSet serious_matter = { <font color=red>int32 limit = 1000000</font> }
0052 }
0053 PSet cerr = { string threshold = "WARNING" }
0054
0055 PSet jobdebug.txt = { PSet default = { <font color=red>int32 limit = 1000000</font> }
0056 }
0057 PSet anotherfile.txt = { PSet serious_matter = { <font color=red>int32 limit = 1000</font> }
0058 }
0059 PSet default = { <font color=red>int32 limit = 10
0060 int32 timespan = 60</font>
0061 }
0062 }
0063 untracked PSet maxEvents = {untracked int32 input = 10}
0064 path p = { myAnalysisModule }
0065 module myAnalysisModule = ModuleThatIssuesMessages { }
0066 source = EmptySource { }
0067 }
0068 </pre>
0069
0070 The Pset entries <font color=red>int32 limit = ...</font> and
0071 <font color=red>int32 timespan = ...</font> establish that this
0072 destination should report only so many messages of a specified
0073 specified messageID or severity level. For example, detailedInfo.txt
0074 will report only the first twenty trkwarning messages, before
0075 ignoring most of the rest (with an exponential backoff).
0076 <p>
0077 The timespan, if supplied, directs the destination to reset its count of
0078 how many times a message of this type has been encountered if no messages
0079 of this type occur within that many seconds. For example, if this job issues
0080 25 trkwarning messages at the start, then 25 additional messages more than
0081 20 minutes (1200 seconds) later, the first twenty of each group would be reported.
0082 A limit can be supplied without a timespan. Supplying a timespan without a
0083 limit is meaningless.
0084 <p>
0085 These are optional. Each destination can supply limit and timespan for all,
0086 some, or none of severity levels, listed message IDs, and default
0087 (all message IDs without explicit specification). Note that if both the limit
0088 and the timespan are specified, they are not comma-separated (since they are
0089 two distinct elements in a PSet).
0090
0091 <p><center>
0092 <img src="bar.gif"></center>
0093
0094 <p><center>
0095 <a href="http://www.uscms.org/SoftwareComputing/index.html">
0096 USCMS Software and Computing Home Page </a> -
0097 <a href="MessageLogger.html"> CMS MessageLogger Service Page </a> -
0098 <a href="parameters.html#complete"> Configuration File </a>
0099 </center>
0100
0101 <p>
0102 <hr>
0103 <address><a href="mailto:mf@fnal.gov">Mark Fischler</a></address>
0104
0105 Last modified: Dec 1, 2005
0106
0107 </body>
0108
0109
0110
0111
0112
0113
0114
0115
