euserv-describe-events

Shows information about service-affecting events.

Note: The euserv-describe-events command is intended to replace the -E option in the euca-describe-services command and is currently under Technical Preview and is subject to change without notice.

Syntax

euserv-describe-events [-s] [-f FORMAT]

Description

Events come in the form of a list, where each event contains one or more of the following tags:

Tag	Description
`id`	A unique ID for the event.
`message`	A free-form text description of the event.
`severity`	The message's severity (FATAL, URGENT, ERROR, WARNING, INFO, DEBUG, TRACE).
`stack-trace`	The stack trace, if any, corresponding to the event. The -s option is required to make this appear.
`subject-arn`	The Eucalyptus ARN of the service affected by the event.
`subject-name`	The name of the service affected by the event.
`subject-type`	The type of service affected by the event.
`timestamp`	The date and time of the event's creation.

Environment

Note: The euserv-describe-events command requires access keys and knowledge of where to locate the web services it needs to contact. It can obtain these from several locations.

Environment	Description
`AWS_ACCESS_KEY_ID`	The access key ID to use when authenticating web service requests. This takes precedence over and euca2ools.ini, but not `-I`.
`AWS_SECRET_ACCESS_KEY`	The secret key to use when authenticating web service requests. This takes precedence over --region and euca2ools.ini(5), but not `-S`.
`EUCA_BOOTSTRAP_URL`	The URL of the service to contact. This takes precedence over `--region` and euca2ools.ini, but not `-U`.

Options

Option	Description	Required
`-f, --format format`	Print events in a given format, where format can be: `yaml` or `oneline`, and `format`:string. See Output for details about each format. When omitted, the format defaults to `yaml`.	No
`-s, --show-stack-traces`	Include the stack-trace tag in events' data. This is omitted by default due to its length.	No

Common Options

Option	Description
`--show-empty-fields`	Show empty fields as "(nil)".
`--region user@region`	Region and/or user name to search when looking up config file data. Only valid for EC2 endpoints.
`-U,--url url`	URL of the cloud service to connect to. For administrative commands, this should be `<ip_address>:8773/services/Empyrean`.
`-I,--access-key-id key_id`	User's access key ID.
`-S,--secret-key secret_key`	User's secret key.
`--security-token token`	User's security token.
`--debug`	Prints what the command sends to the server and what it receives from the server. Use when you're trying to debug Euca2ools.
`--debugger`	Enable interactive debugger on error.
`-h,--help`	Display the manual page for the command.
`--version`	Display the version of this tool.

Output

There are several built-in formats, and you can define additional formats using a format: string, as described below. Here are the details of the built-in formats:

yaml

This outputs block-style YAML designed to be easily readable. Tags that are empty or not defined do not appear in this output at all.

events:
            - timestamp: {timestamp}
            severity: {severity}
            id: {id}
            subject-type: {subject-type}
            subject-name: {subject-name}
            subject-host: {subject-host}
            subject-arn: {subject-arn}
            message: |-
            {message}
            stack-trace: |-
            {stack-trace}

oneline

This output is designed to be as compact as possible.

{timestamp} {severity} {subject-type} {subject-name} {message}

format:string

The format:string format allows you to specify which information you want to show using placeholders enclosed in curly braces to indicate where to show the tags for each event. For example:

euserv-describe-events -f "format:{timestamp} {subject-name} {message}"

Example

To output a list of service-affecting events in the oneline format:

euserv-describe-events --format oneline
2016-06-20 16:16:08 INFO node 10.111.1.15 the node is operating normally\nFound service status for 10.111.1.15: ENABLED
2016-06-27 17:37:57 ERROR node 10.111.5.50 Error occurred in transport
2016-06-28 07:00:17 ERROR node 10.111.5.50