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