User Tools
uls:agents:value_file_format
Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
uls:agents:value_file_format [2018-09-15 10:56] uls [Start/Stop Time Tuple] |
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 | double quotes (") contained in text expressions | ||
| must be quoted with back slash (\\"). | 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: | 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 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: | 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 } | <cmode> := { add | inc | sub | dec | set | reset } | ||
| Line 195: | Line 200: | ||
| D;<datetime>;<source>;<section>;<teststep>;<detail>;<ignored>;<ignored>[;<access>] | 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: | 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 | 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: | 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 | F;;;mysection;myteststep;perl script;datetime.pl;datetime.pl | ||
| Line 233: | Line 238: | ||
| In your script you generate the ULS value file: | 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. | 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":: | 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>. | but use always the same <uls filename>. | ||
| Line 253: | Line 258: | ||
| each file chunk: | 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;<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. | 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): | (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; | 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. | 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 | 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 === | === PD: Pause Delete === | ||
| Line 360: | Line 385: | ||
| PD;<datetime>;<source>;<section>;<teststep>;<detail>;<end_datetime>;<unit>[;<access>[;<remark>]] | 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: | 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>]] | 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. | 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;<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 | 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>: | 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:: | 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 | 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 | ||
| Line 474: | Line 499: | ||
| they are processed particularly: | 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} | V;2018-09-08 08:32:47;myhost;section;"backup";"start-stop";Start 2018-09-08 08:32:47;{T} | ||
uls/agents/value_file_format.1537001762.txt.gz · Last modified: 2018-09-15 10:56 by uls
Page Tools
Except where otherwise noted, content on this wiki is licensed under the following license: GNU Free Documentation License 1.3
