Differences

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

--- uls:agents:value_file_format [2015-11-12 10:53]
uls [PD: Pause Delete]
+++ uls:agents:value_file_format [2026-02-03 16:29] (current)
uls [Start/Stop Time Tuple]
@@ Line 110: / Line 110: @@
  double quotes (") contained in text expressions
  must be quoted with back slash (\\").
+|-
+| <defdays>
+|
+| set the storetime in days for the column. Only the first value of a new
+ column has an effect.
 |}
@@ Line 137: / Line 142: @@
 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 167: @@
 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 171: / Line 176: @@
 increment or decrement it:
-  C;<datetime>;<source>;<section>;<teststep>;<detail>;[<cmode>];[<value>][;<access>]
+  C;<datetime>;<source>;<section>;<teststep>;<detail>;[<cmode>];[<value>][;;[<access>][;<storedays>]]
-  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 200: @@
   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 204: / Line 209: @@
 the time <elapsed> has elapsed:
-  E<elapsed>;<datetime>;<source>;<section>;<teststep>;<detail>;<value>;<unit>[;<access>]
+  E<elapsed>;<datetime>;<source>;<section>;<teststep>;<detail>;<value>;<unit>[;[<access>][;<storedays>]]
-  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 221: / Line 226: @@
 Transfer a whole file as a value to the ULS-server:
-  F;<datetime>;<source>;<section>;<teststep>;<detail>;<local filename>;<uls filename>[;<access>]
+  F;<datetime>;<source>;<section>;<teststep>;<detail>;<local filename>;<uls filename>[;[<access>][;<storedays>]]
   F;;;mysection;myteststep;perl script;datetime.pl;datetime.pl
@@ Line 233: / Line 238: @@
 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 247: @@
 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 253: / Line 258: @@
 each file chunk:
-  FA;<datetime>;<source>;<section>;<teststep>;<detail>;<local filename>[;;<access>]
+  FA;<datetime>;<source>;<section>;<teststep>;<detail>;<local filename>[;;[<access>][;<storedays>]]
 -----
@@ Line 265: / Line 270: @@
   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 299: / Line 304: @@
 (it will only be saved if the value has changed):
-  N;<datetime>;<source>;<section>;<teststep>;<detail>;<value>;<unit>[;<access>]
+  N;<datetime>;<source>;<section>;<teststep>;<detail>;<value>;<unit>[;[<access>][;<storedays>]]
   N;;lxtest1;OneLine Format;NoDups;IP-Adresse;10.10.10.5;
@@ Line 315: / Line 320: @@
 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;<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 (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;<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 351: / Line 356: @@
 -----
+=== 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 385: @@
   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:
@@ Line 366: / Line 391: @@
   PD;<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
+  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 390: / Line 415: @@
   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 432: / Line 457: @@
 with this <unit> does not exist in the ULS database for the (exactly) specified <datetime>:
-  U;<datetime>;<source>;<section>;<teststep>;<detail>;<value>;<unit>[;<access>]
+  U;<datetime>;<source>;<section>;<teststep>;<detail>;<value>;<unit>[;[<access>][;<storedays>]]
-  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 442: / Line 467: @@
 Line for a normal value, numeric or text::
-  V;<datetime>;<source>;<section>;<teststep>;<detail>;<value>;<unit>[;<access>]
+  V;<datetime>;<source>;<section>;<teststep>;<detail>;<value>;<unit>[;[<access>][;<storedays>]]
-  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 474: / Line 499: @@
 they are processed particularly:
-  V;<datetime>;<source>;<section>;<teststep>;<detail>;Start YYYY-MM-DD hh:mm:ss;{T}[;<access>]
+  V;<datetime>;<source>;<section>;<teststep>;<detail>;Start YYYY-MM-DD hh:mm:ss;{T}[;[<access>][;<storedays>]]
-  V;<datetime>;<source>;<section>;<teststep>;<detail>;Stop YYYY-MM-DD hh:mm:ss;{T}[;<access>]
+  V;<datetime>;<source>;<section>;<teststep>;<detail>;Stop YYYY-MM-DD hh:mm:ss;{T}[;[<access>][;<storedays>]]
-  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 529: / Line 554: @@
 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 536: / Line 561: @@
 # V;<datetime>;<source>;<section>;<teststep>;<detail>;<value>;<unit>[;<access>]
-# Get any value
+# Get some value
 V=`ls /tmp/ | wc -l`
@@ Line 546: / Line 571: @@
 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 560: / Line 585: @@
 # 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 570: / Line 595: @@
 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 587: / Line 613: @@
 <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