Differences

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

--- uls:agents:value_file_format [2015-11-12 10:22]
uls [P: Pause]
+++ uls:agents:value_file_format [2024-11-27 13:50] (current)
uls [A: Detail Documentation]
@@ Line 137: / 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 162: / 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 173: / 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 195: / 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 206: / 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 233: / 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 242: / 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 265: / 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 317: / Line 317: @@
   P;<datetime>;<source>;<section>;<teststep>;<detail>;<end_datetime>;<unit>[;<access>[;<remark>]]
-  P;2015-01-18 07:00:00;host010;System;;;2015-01-19 07:59:59;;;automated sunday patching
+  P;2018-01-18 07:00:00;host010;System;;;2018-01-19 07:59:59;;;automated sunday patching
-alternatively you can use a time interval as
+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;2015-11-11 11:11:11;host012;System;;;+4h;;;planned outage of system for carnival
+  P;2018-11-11 11:11:11;host012;System;;;+4h;;;planned outage of system for carnival
@@ Line 343: / Line 343: @@
 |-
 | <time interval>
-| +<n>[mhd], use the time interval given in number of minutes, hours or days for the monitoring pause
+| +<n>[mhd], use the time interval given in number of minutes, hours or days for the monitoring pause. **The '+' is mandatory!**
 |-
 | <source>
@@ Line 351: / 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 360: / 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 384: / 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 428: / 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 438: / 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"
-  V;2015-05-13 13:17:00;herkules;"Infoboard";"Introduction";"Text";"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
   dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo
@@ Line 471: / 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 523: / 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 530: / Line 556: @@
 # V;<datetime>;<source>;<section>;<teststep>;<detail>;<value>;<unit>[;<access>]
-# Get any value
+# Get some value
 V=`ls /tmp/ | wc -l`
@@ Line 540: / 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 554: / 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 564: / 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 581: / 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