$now-unixtimestamp¶

Exposes the current time as a monotonically increasing Unix timestamp.

This property belongs to the Time-Related System Properties group.

Name:: $now-unixtimestamp
Category:: Time-Related System Properties
Type:: integer

Description¶

The current time as a unix timestamp (seconds since epoch). This actually is a monotonically increasing counter and as such can also be used for any other use cases that require such counters.

Usage¶

template(name="example" type="list") {
    property(name="$now-unixtimestamp")
}

Additional example:

# Get Unix timestamp of current message
set $.tnow = $$now-unixtimestamp

# Rate limit info to 5 every 60 seconds
if ($!severity == 6 and $!facility == 17) then {
  if (($.tnow - $/trate) > 60) then {
    # 5 seconds window expired, allow more messages
    set $/trate = $.tnow;
    set $/ratecount = 0;
  }
  if ($/ratecount > 5) then {
    # discard message
    stop
  } else {
    set $/ratecount = $/ratecount + 1;
  }
}

Notes¶

Note

By definition, there is no “UTC equivalent” of the $now-unixtimestamp property.

Properties that include hyphens require the double dollar form ($$) when used in expressions so the parser does not treat the hyphen as subtraction.

$now-unixtimestamp¶

Description¶

Usage¶

Notes¶

See also¶