Event commands control the way InfiniBox events are displayed.
Viewing event codes
List all of the InfiniBox event codes.
Filter the list by code, level or reporter. State the code to list only the event codes without their details. State the level and select among critical, error, warning and info. State the reporter and select among block, custom, file, management, platform and REPLICATION.
- Run the command without parameters to get a full list of all of the event codes:
event.codes
Run the command specifying a code to see its details:
eventcodes code=VOLUME_CREATED
CODE VISIBILITY LEVEL REPORTER DESCRIPTION VOLUME_CREATED CUSTOMER INFO MGMT Created {prov_type} volume '{volume_name}' in pool {pool_name} of size: {size_in}{size_format}
Querying for events
List the events that the InfiniBox emitted.
Filter the query by time stamp, event ID, code, level and reporter.
From a specific point-in-time forward:
event.query from='2015-06-10 10:00:00'
- Between two points in time:
event.query from='2015-06-10 10:00:00' to='2015-06-10 20:00:00'
- Between two event IDs:
event.query from_seq=201 to_seq=220
The events are listed on screen with the following information:
- Timestamp
- Level
- Code
- Description
You can run the event in detailed mode, adding the following fields:
- Seq – the sequential number of the event
- Reporter
- User name
Viewing the event details
Display a detailed view of a single event: event.details id=100
Affected Entity Id 416 Code HOST_ADD_PORT Description Added port '000000000000003c' to 'host-04' Seq 100 Level INFO Reporter MGMT Seq Num 85 Source Node Id 1 System Version 1.5.0.11 Timestamp 2014-06-09 14:36:57 Username admin Data: Host Id 416 Data: Host Name host-04 Data: Initiator Address 000000000000003c
Viewing event levels
- Run this command to see the available event levels:
event.levels
Viewing event reporters
- List InfiniBox areas that report events:
event.reporters
Watching events
- See a live display of events on the InfiniShell screen. Click Ctrl+C to get back to the command prompt:
event.watch
Creating an event
Create a new custom event. Set the level and text of the event you create. Then, run the event.query
command to see the event.
- Example:
event.create level=INFO description='custom event'
Output:
TIMESTAMP LEVEL CODE DESCRIPTION 2015-06-01 10:00:00 INFO CUSTOM_INFO_EVENT custom event
Controlling event retention
By default, InfiniBox retains events for a long time.
If there is need to control how long events are retained, administrators can periodically delete old events.
- Example:
event.delete retention="2020-04-27 10:00:00"
- This command deletes any event that occurred prior to 10 AM on April 27th 2020
Events must be retained for at least one year.
Comments