/  Yamcs CLI  /  yamcs events

yamcs events

Synopsis

yamcs events create [-m <MESSAGE>, --message <MESSAGE>] [--date <DATE>]
[--sequence-number <SEQNO>] [--severity <LEVEL>] [--source <SOURCE>]
[--type <TYPE>] [--extra <KEY=VALUE> [<KEY=VALUE> ...]]
yamcs events log [-n <LINES>, --lines <LINES>]
[-s <DATE>, --since <DATE>] [-u <DATE>, --until <DATE>]

Description

Add events to the Yamcs event log.

Commands

create

Create an event. This command shows an editor where you can enter the event message. Alternatively you can specify the message using the --message option.

log [-n <LINES>, --lines <LINES>] [-s <DATE>, --since <DATE>] [-u <DATE>, --until <DATE>]

Read event log

Options

-m <MESSAGE>, --message <MESSAGE>

Event message.

--date <DATE>

Event time. If unspecified, defaults to mission time.

The date should be specified in ISO format or as detailed under Timestamps.

--sequence-number <SEQNO>

Sequence number of this event. This is used to determine unicity of events at the same time and coming from the same source. If not set Yamcs will automatically assign a sequential number as if every submitted event is unique.

--severity <LEVEL>

The severity level of the event. One of info, watch, warning, distress, critical or severe. Default is info.

--source <SOURCE>

Source of the event. Defaults to User if unset.

--type <TYPE>

Type of the event.

--extra <KEY=VALUE> [KEY=VALUE ...]

Set additional event properties.

-n <LINES>, --lines <LINES>

With log, specify the number of events to show, or all to show all.

Default: 10, but only when --since and --until are unset.

-s <DATE>, --since <DATE>

With log, include events not older than the specified date.

The date should be specified in ISO format or as detailed under Timestamps.

-u <DATE>, --until <DATE>

With log, include events not newer than the specified date.

The date should be specified in ISO format or as detailed under Timestamps.

Timestamps

When parsing timestamps, yamcs-cli accepts a specification in ISO format. The following special patterns are also recognised:

  • now: current time

  • now UTC: current UTC time

  • today: 00:00:00 of the current day

  • today UTC: 00:00:00 UTC of the current day

  • yesterday: 00:00:00 of the day before

  • yesterday UTC: 00:00:00 UTC of the day before

  • tomorrow: 00:00:00 of the next day

  • tomorrow UTC: 00:00:00 UTC of the next day