Universal Logging System

Different basic data types can be sent to the ULS-server and stored as values.

• numbers, as quantity of (a finite subset of) rational numbers
• strings with up to 32000 characters
• files up to 1GB of size

Derived data types are identified and interpreted by the used unit and its contents:

• integer numbers, as quantity of the subset of natural numbers and non-zero natural numbers, 10 digits max
• floating point numbers, as an approximation to real numbers, 20 significant digits
• numbers in combination with si-related units (e.g. km, m, mm; or °C, °F, K), 200 characters max
• timing tuples, as tuples of start- and stop-timing events, bound together with the same time stamp, 200 characters max
• timestamps in ISO notation (yyyy-mm-dd HH:MM:SS) (use unit {DT}) or seconds since unix epoch (use unit {TT}).
• strings rendered in monospaced font in the web browser, can e.g. be used for tabular data, 32000 characters max
• images (.jpg, .png, .gif, …) are shown as images in the web browser, other files are represented as web links for download

Units have to be managed by an ULS administrator. The are a lot of units already defined in ULS, but your specific ones may not be present and you can add your own units.

Each value must have a unit, a blank (space) as unit is used for text values.

This list of units is available by default. Some special units are described further in [[uls:structure#Special Units]] below.

Here is a table of all special units. These have a special meaning and should not be changed or removed from the unit list.

The ULS administrator manages the units. Log in as ULS administrator and move to 'system →> edit units'.

The list of units looks like (just an example):

Units (name) can be defined as a simple function to base units (si-unit) by using factors (si-factor).

how about a dynamically evaluateable equation where x is replaced by the <value>

<value> [<name>] * <si-factor> = <value2> [<si-unit>]

If you are creating a new unit and its si-unit does not exist yet, then leave “si-unit” blank and change it after the si-unit has been created initially.

(new in version 1.7.0)

Units (name) can be defined as a simple function to base units (si-unit) by using factors (si-factor) and offsets (si-offset).

<value> [<name>] * <si-factor> + <si-offset> = <value2> [<si-unit>]

SI-Units can be used for manual scaling of different base units in graphs or in definitions of derived or calculated details.

Each value in the ULS corresponds to a combination of the attributes:

The domain is derived from the source, it is a constant, manually defined relation. A domain is a collection of one to many (value-) sources which belong somehow together. User access and privileges are bound to the domain.

The logical data structure is similar to the representation in the ULS user interface (interactive webbrowser-based analysis):

<domain>
  │
  └──►<source>
      │
      └──►<section>
            │
            └──►<teststep>  | time stamp           |  detail  |  detail  |
                            |                      |  unit    |  unit    |
                            | ---------------------|----------|----------|
                            | yyyy-mm-dd hh:mi:ss  |  value   |  value   |
                            | yyyy-mm-dd hh:mi:ss  |  value   |  value   |
                            | yyyy-mm-dd hh:mi:ss  |  value   |  value   |

The relation between domains and sources must be kept manually, all other relations are automatically determined by the values that are transferred to the ULS and do not need any administrative activities.