A.112 getEventListByQuery

Lists the events for an object using a query to narrow results.

Syntax

getEventListByQuery [ [ objType=value ] [ objIds=value ] ] [ severity= { UNKNOWN | CRITICAL | WARNING | INFORMATIONAL } ] severityEqualityType= { LT | LTE | GT | GTE | EQ | NE } [ eventTypes= value ] eventEqualityType= { LIKE | NOT_LIKE } [ acknowledged= { Yes | No } ] [ userAckable= { Yes | No } ] [ startTime=value ] [ endTime=value ] [ maxResults=value ]

Description

This command lists the events for an object using a query to narrow results. To acknowledge an event, use the ackEvent command.

Options

The following table shows the available options for this command.

Option	Description
`objType=value`	The object type for which to list the events. The `value` of `objType` is an object such as `FileServer`, `Repository`, or `Server`. To get a list of all object types, use the showobjtypes. The value for `objType` is case insensitive. This is an optional parameter and must be used with the `objIds` option.
`objIds=value`	The ID of the objects for which events should be listed. To enter one or more objects, use a comma separated list. This is an optional parameter and must be used with the `objType` option.
`severity=` { `UNKNOWN` \| `CRITICAL` \| `WARNING` \| `INFORMATIONAL` }	The severity of the event to list. Use this in combination with the `equalityType` option. The events are ranked in the order from low to high: UNKNOWN: The event does not have a specific severity. INFORMATIONAL: An event which is used to convey information about the system. WARNING: An event which is only likely to have a minor impact to system functionality. CRITICAL: An event which could cause a critical loss of functionality which requires immediate attention. When you use this in conjunction with the `severityEqualityType` option, the comparison is performed using this ranking. For example, if you use: `severity=WARNING severityEqualityType=GTE` All events greater than or equal to WARNING are returned. This means all WARNING and all CRITICAL events are returned. This is an optional parameter.
`severityEqualityType=` { `LT` \| `LTE` \| `GT` \| `GTE` \| `EQ` \| `NE` }	The equality type for the severity comparison. Use this in combination with the `severity` option. The parameters are: LT: Less than (<). LTE: Less than or equal to (<=). GT: Greater than (>). GTE: Greater than or equal to (>=). EQ: Equal to (=). NE: Not equal to (<>, or !=).
`eventTypes=value`	The event type. Use this to filter the results to a specific event or events. For example: `eventTypes=server.maintenance.mode.` Note the period (.) at the end of the event type. This is important. You cannot truncate the event type; it must be in full. No wild cards are allowed. For a list of the available options, see Table A.1, “eventTypes Values”. For the most up-to-date list of event types, see the Oracle VM Manager Web Services API 3.4 documentation at: `http://hostname/WSAPI/doc/api/webservices_s/com/oracle/ovm/mgr/ws/model/Event.html` This documentation is available on the Oracle VM Manager ISO/CD. You should deploy it to a web server to access the content.
`eventEqualityType=` { `LIKE` \| `NOT_LIKE` }	The event equality type for the event types comparison. Use this in combination with the `eventTypes` option. The parameters are: LIKE: Is like the value of `eventTypes`. NOT_LIKE: Is not like the value of `eventTypes`.
`acknowledged=` { `Yes` \| `No` }	Whether to include acknowledged events in the listing. The default is `No`, so all events that have been acknowledged are not displayed. This is an optional parameter.
`userAckable=` { `Yes` \| `No` }	Whether to include events that can be acknowledged by a user in the listing. The default is `No`, so all events that cannot be acknowledged by a user are removed from the results. This is an optional parameter.
`startTime=value`	The start date and time from which to list events. The format to use is `"MM-dd-yyyy HH:mm:ss"`. This is an optional parameter.
`endTime=value`	The end date and time from which to list events. The format to use is `"MM-dd-yyyy HH:mm:ss"`. This is an optional parameter.
`maxResults=value`	The maximum number of events to list. This is an optional parameter.

eventTypes Values

This table shows the available options for the eventTypes option of this command.

Table A.1 eventTypes Values

eventType Value	Event Severity	Description
Lifecycle Events
lifecycle.	INFORMATIONAL	This eventType is not used directly. However, you can use this when retrieving Events by type to retrieve all lifecycle eventTypes.
lifecycle.create.	INFORMATIONAL	Object has been created.
lifecycle.modify.	INFORMATIONAL	Object has been modified.
lifecycle.delete.	INFORMATIONAL	Object has been deleted.
Runstate Events
runstate.	INFORMATIONAL	This eventType is not used directly. However, you can use this when retrieving Events by type to retrieve all runstate eventTypes.
runstate.starting.	INFORMATIONAL	Object is in the process of starting.
runstate.running.	INFORMATIONAL	Object is running.
runstate.stopping.	INFORMATIONAL	Object is in the process of stopping.
runstate.stopped.	INFORMATIONAL	Object is stopped.
runstate.suspended.	INFORMATIONAL	Object is suspended.
Discover Events
discover.failure.	INFORMATIONAL	There was a failure during server discovery.
Virtual machine Events
vm.api.incomming.	INFORMATIONAL	Virtual machine incoming message.
vm.api.outgoing.	INFORMATIONAL	Virtual machine outgoing message.
vm.error.	CRITICAL	This eventType is not used directly. However, you can use this when retrieving Events by type to retrieve all vm.error eventTypes.
vm.error.disconnected.	CRITICAL	Virtual machine has disconnected.
vm.error.migration.	CRITICAL	Virtual machine migration failed.
vm.warn.migration.	WARNING	This eventType is not used directly. However, you can use this when retrieving Events by type to retrieve all vm.warn.migration eventTypes.
vm.warn.migration.src.	WARNING	Virtual machine migration warning from the server that holds the source (from) the virtual machine.
vm.warn.migration.tgt.	WARNING	Virtual machine migration warning from the server that is the target (to) for the virtual machine.
vm.domain.mismatch.	INFORMATIONAL	Virtual machine domain type mismatch.
vm.migrating.	INFORMATIONAL	Virtual machine is migrating.
vm.misplaced.	INFORMATIONAL	Virtual machine has been found on an incompatible server.
vm.os.mismatch.	INFORMATIONAL	Virtual machine operating system type mismatch.
vm.disk.missing.	CRITICAL	Virtual machine is missing a virtual disk.
vm.error.offline.	CRITICAL	Virtual machine is offline.
Server Events
server.failure.	CRITICAL	Server has experienced a failure.
server.discovery.failed.	CRITICAL	Server discovery has failed.
server.discovery.started.	INFORMATIONAL	Server discovery is in progress.
server.repository.error.	CRITICAL	The server repository has experienced an error.
server.cluster.failure.	CRITICAL	The server cluster has experienced a failure.
server.cluster.state.	INFORMATIONAL	This eventType is not used directly. However, you can use this when retrieving Events by type to retrieve all server.cluster.state eventTypes.
server.cluster.state.down	INFORMATIONAL	The server's cluster is down.
server.cluster.state.up	INFORMATIONAL	The server's cluster is up.
server.disconnected.	CRITICAL	The server has disconnected.
server.authentication.error.	CRITICAL	There was a server authentication error.
server.disk.reserved.	INFORMATIONAL	The server disk is reserved.
server.disk.unreserved.	INFORMATIONAL	The server disk is unreserved.
server.kernel.invalid.	CRITICAL	The server kernel is invalid.
server.maintenance.mode.	INFORMATIONAL	The server is in maintenance mode.
server.out.of.date.	INFORMATIONAL	The server software is out of date with regards to that found in the update repository.
server.pool.	INFORMATIONAL	This eventType is not used directly. However, you can use this when retrieving Events by type to retrieve all server.pool eventTypes.
server.pool.failure.	CRITICAL	There has been a failure with the server pool.
server.pool.file.system.missing.	CRITICAL	The server pool file system is missing.
server.pool.master.missing.	CRITICAL	Server pool is missing the master.
server.pool.vip.unavailable.	WARNING	Server pool virtual IP address is unavailable.
server.evacuate.failed.	WARNING	Server failed to evacuate.
server.mount.missing.	WARNING	Server mount is missing.
server.network.operation.failed.	WARNING	Server network operation failed.
server.offline.	CRITICAL	Server is offline.
server.ownership.mismatch.	WARNING	Server is owned by another Oracle VM Manager.
server.version.mismatch.	WARNING	There is an API version mismatch with the server.
server.update.repository.mismatch.	INFORMATIONAL	The repository information on the server is not the same as configured in Oracle VM Manager. This will trigger an update process so the information on the server is reconfigured.
server.update.repository.check.	INFORMATIONAL	Server is being checked if its software update repository is up to date.
server.update.repository.check.failed.	INFORMATIONAL	There was a failure during the update repository configuration.
server.update.repository.config.failed.	INFORMATIONAL	There was a failure during the repository configuration update check.
server.duplicate.storage.initiator.	WARNING	Server has a duplicate storage initiator.
server.network.mismatch.	WARNING	A networking device was found during discovery on this server with a network definition that includes the Virtual Machine role. This network already exists in Oracle VM Manager without the Virtual Machine role. This role will not be automatically added to the network and the server's view of the network is out of sync with Oracle VM Manager. If the Virtual Machine role is needed on this network, it will need to be added manually.
server.upgrade.in.progress.	INFORMATIONAL	Server upgrade in progress.
server.upgrade.config.in.progress.	INFORMATIONAL	A configuration of the server upgrade repositories is in progress.
File Server Events
fileserver.error.	CRITICAL	A critical fileserver error.
fileserver.invalid.exports.	CRITICAL	Invalid exports exist.
File System Events
filesystem.missing.	WARNING	File system is missing.
filesystem.size.mismatch.	CRITICAL	File system is larger than its underlying storage device.
Repository Events
repository.empty.	CRITICAL	Repository is empty.
repository.error.	CRITICAL	There is a repository error.
repository.missing.	WARNING	Repository is missing.
repository.unmounted.	CRITICAL	Repository is unmounted
Storage Device Events
storage.device.	INFORMATIONAL
storage.device.offline.	WARNING	Storage device is offline.
storage.device.online.	INFORMATIONAL	Storage device is online.
storage.device.off.path.	WARNING	At least one path is missing for storage element
Manager Events
mgr.db.scan.error.	CRITICAL	Database scan error.
mgr.db.scan.ok.	INFORMATIONAL	Database scan succeeded.
mgr.db.backup.fail.	WARNING	Database backup failed.
mgr.db.timeshift.	WARNING	System time has gone backwards.
Port Events
port.status.	INFORMATIONAL	This eventType is not used directly. However, you can use this when retrieving Events by type to retrieve all port.status eventTypes.
port.status.down.	INFORMATIONAL	Ethernet port is down.
port.status.up.	INFORMATIONAL	Ethernet port is up.
Path Events
path.status.	INFORMATIONAL	This eventType is not used directly. However, you can use this when retrieving Events by type to retrieve all path.status eventTypes.
path.status.down.	INFORMATIONAL	Storage path status is down.
path.status.up.	INFORMATIONAL	Storage path status is up.
path.missing.storage.device.	WARNING	Storage path is missing a storage device.
Volume Events
volume.group.missing.	CRITICAL	A volume group is missing.
Object Events
object.needs.refresh.	INFORMATIONAL	Object needs to be refreshed to obtain valid object information.

Examples

Example A.140 Listing all events

OVM> getEventListByQuery

Example A.141 Listing all events for specified Oracle VM Servers

OVM> getEventListByQuery objType=Server objIds=00:e0:81:4d:41:05:00:e0:81:4d:40:de:00:e0:81:4d, \
  00:e0:81:4d:41:59:00:e0:81:4d:41:2c:00:e0:81:4d

Example A.142 Listing events types for Oracle VM Servers

OVM> getEventListByQuery eventEqualityType=LIKE eventTypes=server.disconnected.

Example A.143 Listing high priority events for Oracle VM Servers

OVM> getEventListByQuery severity=WARNING severityEqualityType=GTE \
  eventTypes=server.disconnected. eventEqualityType=LIKE