Differences

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

--- uls:agents:value_file_format [2018-09-15 10:56]
uls [U: Unique Value]
+++ 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;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;2018-03-26 15:47:00;lxhost;"Oracle DB";"tablespace:TS3";"size";"28842.5";"MB";dba
@@ 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;2018-09-08 08:32:47;myhost;section;"backup";"start-stop";Start 2018-09-08 08:32:47;{T}

Universal Logging System

User Tools

Site Tools

Differences

Page Tools