Differences

This shows you the differences between two versions of the page.

--- uls:agents:value_file_format [2015-05-13 13:12]
uls [V: Normal Value]
+++ uls:agents:value_file_format [2024-11-27 13:50] (current)
uls [A: Detail Documentation]
@@ Line 54: / Line 54: @@
 | <datetime>
 | 19
-| date and time in the format "YYYY-MM-DD HH:MM:SS"
+| date and time in the format: YYYY-MM-DD HH:MM:SS.
+ It may NOT be enclosed in quotes!
 |-
 | <detail>
@@ Line 136: / Line 137: @@
 See the [[value_file_format#Example]] for how to generate similar contents:
-  V;2013-08-15 15:04:30;SourceA3;My Section;My Teststep;start-stop;Start 2013-08-15 15:04:30;{T}
+  V;2018-08-15 15:04:30;SourceA3;My Section;My Teststep;start-stop;Start 2018-08-15 15:04:30;{T}
-  V;2013-08-15 15:04:30;SourceA3;My Section;My Teststep;file count;66;#
+  V;2018-08-15 15:04:30;SourceA3;My Section;My Teststep;file count;66;#
-  V;2013-08-15 15:04:30;SourceA3;My Section;My Teststep;listener;"Lorem ipsum dolor sit amet";
+  V;2018-08-15 15:04:30;SourceA3;My Section;My Teststep;listener;"Lorem ipsum dolor sit amet";
-  E4:00;2013-08-15 15:04:30;SourceA3;My Section;My Teststep;kernel release;3.0.80-0.7-default;
+  E4:00;2018-08-15 15:04:30;SourceA3;My Section;My Teststep;kernel release;4.9.0-8-amd64;
-  V;2013-08-15 15:04:30;SourceA3;My Section;My Teststep;start-stop;Stop 2013-08-15 15:04:36;{T}
+  V;2018-08-15 15:04:30;SourceA3;My Section;My Teststep;start-stop;Stop 2018-08-15 15:04:36;{T}
 -----
@@ Line 161: / Line 162: @@
 A text that is saved as a documentation to a detail:
-  A;<ignored>;<source>;<section>;<teststep>;<detail>;"<text>"
+  A;<ignored>;<source>;<section>;<teststep>;<detail>;"<text>";<unit>
 -----
@@ Line 172: / Line 173: @@
   C;<datetime>;<source>;<section>;<teststep>;<detail>;[<cmode>];[<value>][;<access>]
-  C;2013-11-11 11:11:11;myhost;section;event entries;serious;inc
+  C;2018-11-11 11:11:11;myhost;section;event entries;serious;inc
 <cmode> := { add | inc | sub | dec | set | reset }
@@ Line 194: / Line 195: @@
   D;<datetime>;<source>;<section>;<teststep>;<detail>;<ignored>;<ignored>[;<access>]
-  D;2013-04-19 11:13:31;myhost;my_section;my_teststep;my_detail;;;CHEF_ONLY
+  D;2018-04-19 11:13:31;myhost;my_section;my_teststep;my_detail;;;CHEF_ONLY
 -----
@@ Line 205: / Line 206: @@
   E<elapsed>;<datetime>;<source>;<section>;<teststep>;<detail>;<value>;<unit>[;<access>]
-  E3:45;2013-08-13 14:14:00;host032;system;information;kernel release;3.0.80-0.7-default;
+  E3:45;2018-08-13 14:14:00;host032;system;information;kernel release;4.9.0-8-amd64;
 Assuming that you run a monitoring script every 10 minutes
@@ Line 232: / Line 233: @@
 In your script you generate the ULS value file:
-  F;2013-08-13 00:42:13;WINBOX5;nightly jobs;output tool;script result;OUTPUT.txt;OUTPUT.txt
+  F;2018-08-13 00:42:13;WINBOX5;nightly jobs;output tool;script result;OUTPUT.txt;OUTPUT.txt
 and copy "OUTPUT.txt" to the same directory as the ULS value file.
@@ Line 241: / Line 242: @@
 Better use e.g. a timestamp (or pid) in the filename "OUTPUT_2013-08-13.txt"::
-  F;2013-08-13 00:42:13;WINBOX5;nightly jobs;output tool;script result;OUTPUT_2013-08-13.txt;OUTPUT.txt
+  F;2018-08-13 00:42:13;WINBOX5;nightly jobs;output tool;script result;OUTPUT_2018-08-13.txt;OUTPUT.txt
 but use always the same <uls filename>.
@@ Line 264: / Line 265: @@
   I;<datetime>;<source>;<section>;<teststep>;<detail>;<local filename>;<uls filename>[;<access>]
-  I;2013-09-03 11:51:37;PNGHOST;paleontologists;Germany;Georg August Goldfuss;"C:\TMP\Georg_August_Goldfuss.jpg";"GAG.jpg"
+  I;2018-09-03 11:51:37;PNGHOST;paleontologists;Germany;Georg August Goldfuss;"C:\TMP\Georg_August_Goldfuss.jpg";"GAG.jpg"
 You must copy the file <local filename> to the same transfer directory as the ULS value file.
@@ Line 308: / Line 309: @@
 Set a monitoring pause in ULS to prevent the generation of notifications,
 directly from the monitored system, without the need to manually set the monitoring pause
-in ULS. It can, e.g. be integrated in maintenance scripts.
+in the ULS web interface. It can, e.g. be integrated in maintenance scripts.
 This is useful to avoid notifications for **planned** outages.
-To be able to use this, the monitored system must be enabled in ULS to do so.
+To be able to use this, the monitored system must be enabled in ULS (administration - client suspension) to do so.
   P;<datetime>;<source>;<section>;<teststep>;<detail>;<end_datetime>;<unit>[;<access>[;<remark>]]
-  P;2015-01-18 07:00:00;host010;System;;;2015-01-18 23:59:59;;;automated sunday patching
+  P;2018-01-18 07:00:00;host010;System;;;2018-01-19 07:59:59;;;automated sunday patching
+alternatively (new in version 1.8.1), you can use a time interval as
+  P;<datetime>;<source>;<section>;<teststep>;<detail>;<time interval>;<unit>[;<access>[;<remark>]]
+  P;2018-11-11 11:11:11;host012;System;;;+4h;;;planned outage of system for carnival
 All expressions except <source> may contain wildcard pattern.
@@ Line 333: / Line 341: @@
 | <end_datetime>
 | sets the end of the monitoring pause. Should obviously lie in the future.
+|-
+| <time interval>
+| +<n>[mhd], use the time interval given in number of minutes, hours or days for the monitoring pause. **The '+' is mandatory!**
 |-
 | <source>
@@ Line 340: / Line 351: @@
 -----
+=== PC: Pause Change ===
+Change a monitoring pause. **All** placeholders must **exactly** match the ones
+used when setting the monitoring pause! Only the <end_datetime> ist the <new_end_datetime>.
+The monitoring pause must have been created by the same <source>.
+  PC;<datetime>;<source>;<section>;<teststep>;<detail>;<new_end_datetime>;<unit>[;<access>[;<remark>]]
+  PC;2018-01-18 07:00:00;host010;System;;;2018-01-18 12:59:59;;;automated sunday patching
+alternatively (new in version 1.8.1), if a time interval was used when setting the pause:
+  PC;<datetime>;<source>;<section>;<teststep>;<detail>;<time interval>;<unit>[;<access>[;<remark>]]
+  PC;2018-11-11 11:11:11;host012;System;;;+10m;;;planned outage of system for carnival
+See the [[value_file_format#P: Pause]] for the explanation of expressions.
+-----
 === PD: Pause Delete ===
@@ Line 349: / Line 380: @@
   PD;<datetime>;<source>;<section>;<teststep>;<detail>;<end_datetime>;<unit>[;<access>[;<remark>]]
-  PD;2015-01-18 07:00:00;host010;System;;;2015-01-18 23:59:59;;;automated sunday patching
+  PD;2018-01-18 07:00:00;host010;System;;;2018-01-18 23:59:59;;;automated sunday patching
+alternatively (new in version 1.8.1), if a time interval was used when setting the pause:
+  PD;<datetime>;<source>;<section>;<teststep>;<detail>;<time interval>;<unit>[;<access>[;<remark>]]
+  PD;2018-11-11 11:11:11;host012;System;;;+4h;;;planned outage of system for carnival
 See the [[value_file_format#P: Pause]] for the explanation of expressions.
@@ Line 373: / Line 410: @@
   S;<datetime>;<source>;<name>;<description>;<ignored>;<local filename>;[<download>]
-  S;2013-01-17 12:01:02;lxtest1;Name;"ULS-client for Linux configuration file";;/etc/uls/uls.conf;uls.conf
+  S;2018-01-17 12:01:02;lxtest1;Name;"ULS-client for Linux configuration file";;/etc/uls/uls.conf;uls.conf
 Use <download> to specify a text expression that is shown
@@ Line 417: / Line 454: @@
   U;<datetime>;<source>;<section>;<teststep>;<detail>;<value>;<unit>[;<access>]
-  U;2013-04-18 12:00:00;lxtest1;OneLine Format;Einmalig;Unique;47;#
+  U;2018-04-18 12:00:00;lxtest1;OneLine Format;Einmalig;Unique;47;#
 -----
@@ Line 427: / Line 464: @@
   V;<datetime>;<source>;<section>;<teststep>;<detail>;<value>;<unit>[;<access>]
-  V;2013-03-26 15:47:00;"lxhost";"Oracle DB";"tablespace:TS3";"size";"28842.5";"MB";dba
+  V;2018-03-26 15:47:00;lxhost;"Oracle DB";"tablespace:TS3";"size";"28842.5";"MB";dba
-  V;2013-11-10 10:10:00;moorea;"Oracle DB";"tablespace:TS4";"size";"25.6";"MB"
+  V;2018-11-10 10:10:00;moorea;"Oracle DB";"tablespace:TS4";"size";"25.6";"MB"
-<!-- "Lorem ipsum dolor sit amet,
+  V;2018-05-13 13:17:00;herkules;"Infoboard";"Introduction";"Text";"Lorem ipsum dolor sit amet,
-consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et
+  consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et
-dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo
+  dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo
-dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem
+  dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem
-ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr,
+  ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr,
-sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat,
+  sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat,
-sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum.
+  sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum.
-Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet."  -->
+  Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet.";
 -----
@@ Line 460: / Line 497: @@
   V;<datetime>;<source>;<section>;<teststep>;<detail>;Stop YYYY-MM-DD hh:mm:ss;{T}[;<access>]
-  V;2013-09-08 08:32:47;myhost;section;"backup";"start-stop";Start 2013-09-08 08:32:47;{T}
+  V;2018-09-08 08:32:47;myhost;section;"backup";"start-stop";Start 2018-09-08 08:32:47;{T}
-  V;2013-09-08 08:32:47;myhost;section;"backup";"start-stop";Stop 2013-09-08 10:13:28;{T}
+  V;2018-09-08 08:32:47;myhost;section;"backup";"start-stop";Stop 2018-09-08 10:13:28;{T}
 Important: the start/stop time tuple **MUST** have the **SAME** <datetime>.
@@ Line 512: / Line 549: @@
 T1=`date +"%Y-%m-%d %H:%M:%S"`
-# V;<datetime>;<source>;<section>;<teststep>;<detail>;Start 2007-06-13 13:45:04;{T}
+# V;<datetime>;<source>;<section>;<teststep>;<detail>;Start 2018-08-13 13:45:04;{T}
 echo "V;$DT;$HOST;$SECTION;$TESTSTEP;start-stop;Start $T1;{T}" >> $VFILE
@@ Line 519: / Line 556: @@
 # V;<datetime>;<source>;<section>;<teststep>;<detail>;<value>;<unit>[;<access>]
-# Get any value
+# Get some value
 V=`ls /tmp/ | wc -l`
@@ Line 529: / Line 566: @@
 echo "E4:00;$DT;$HOST;$SECTION;$TESTSTEP;kernel release;$K; " >> $VFILE
-# Send it every time, but only saved to ULS-server if
+# SEND it every time, but SAVE it at the ULS-server only if
-# kernel release has changed or the last kernel release entry
+# kernel release has changed or the last kernel release value
 # is older than 4 hours (E4:00;...).
@@ Line 543: / Line 580: @@
 # It may span several lines, so enclose it in double quotes.
-T=`ps -ef | fgrep LIST`
+T=`ps -ef | fgrep sbin/init | grep -v grep`
-echo "V;$DT;$HOST;$SECTION;$TESTSTEP;listener;\"$T\"; " >> $VFILE
+echo "V;$DT;$HOST;$SECTION;$TESTSTEP;init process;\"$T\"; " >> $VFILE
-# ' ' is the unit for normal text expressions
+# ' ' (blank) is the unit for normal text expressions
 # -----
@@ Line 553: / Line 590: @@
 T2=`date +"%Y-%m-%d %H:%M:%S"`
-# V;<datetime>;<source>;<section>;<teststep>;<detail>;Stop 2007-06-13 13:45:04;{T}
+# V;<datetime>;<source>;<section>;<teststep>;<detail>;Stop 2018-08-13 13:45:04;{T}
 echo "V;$DT;$HOST;$SECTION;$TESTSTEP;start-stop;Stop $T2;{T}" >> $VFILE
 # -----
-# flush_test_values is found in the ULS-Client for Unix
+# flush_test_values is found in the ULS-Client for Unix.
+# Must be added to PATH.
 echo "Transfer to ULS-server"
-/usr/local/bin/flush_test_values $VDIR
+flush_test_values $VDIR
 # The directory is completely removed after the successful transfer
@@ Line 570: / Line 608: @@
 <file>
-  V;2013-08-15 15:04:30;SourceA3;My Section;first values;start-stop;Start 2013-08-15 15:04:30;{T}
+  V;2018-08-15 15:04:30;SourceA3;My Section;first values;start-stop;Start 2018-08-15 15:04:30;{T}
-  V;2013-08-15 15:04:30;SourceA3;My Section;first values;file count;66;#
+  V;2018-08-15 15:04:30;SourceA3;My Section;first values;file count;66;#
-  V;2013-08-15 15:04:30;SourceA3;My Section;first values;listener;"uls      11110 11108  0 15:04 pts/3    00:00:00 /bin/grep -F LIST";
+  V;2018-08-15 15:04:30;SourceA3;My Section;first values;init process;"root         1     0  0 10:09 ?        00:00:00 /sbin/init";
-  E4:00;2013-08-15 15:04:30;SourceA3;My Section;first values;kernel release;3.0.80-0.7-default;
+  E4:00;2018-08-15 15:04:30;SourceA3;My Section;first values;kernel release;4.9.0-8-amd64;
-  V;2013-08-15 15:04:30;SourceA3;My Section;first values;start-stop;Stop 2013-08-15 15:04:36;{T}
+  V;2018-08-15 15:04:30;SourceA3;My Section;first values;start-stop;Stop 2018-08-15 15:04:36;{T}
 </file>

Universal Logging System

User Tools

Site Tools

Differences

Page Tools