Differences

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

--- uls:agents:value_file_format [2015-05-13 13:24]
uls [Place Holders]
+++ 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 309: / 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 334: / 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 341: / 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 350: / 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 374: / 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 418: / 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 428: / 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 461: / 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 513: / 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 520: / Line 556: @@
 # V;<datetime>;<source>;<section>;<teststep>;<detail>;<value>;<unit>[;<access>]
-# Get any value
+# Get some value
 V=`ls /tmp/ | wc -l`
@@ Line 530: / 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 544: / 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 554: / 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 571: / 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