GridGain Developers Hub
GitHub logo GridGain iso GridGain.com
GridGain Software Documentation

Auditing and Events

Every user action is tracked in GridGain. This tracking is recorded in the form of Events. You can use events to audit user activity on the cluster.

How to Use Events

To use an event to audit actions:

  1. Enable the event type (here we’re enabling EVT_MANAGEMENT_TASK_STARTED):

    <property name="includeEventTypes">
    <list>
        <util:constant static-field="org.apache.ignite.events.EventType.EVT_MANAGEMENT_TASK_STARTED"/>
    </list>
</property>

  2. Implement EventStorageSpi. The implementation will receive all events in its record() method. After that you can log or store the events however you prefer.

  3. Specify your EventStorageSpi in your configuration:

    <property name="eventStorageSpi">
    <!-- Insert the name of your implementation here. -->
    <bean class="org.gridgain.examples.events.MgmtAuditEventStorageSpi"/>
</property>

For a complete example of configuring an event for auditing, including a sample EventStorageSPI implementation, see Monitoring and Auditing Web Console Activity.

Events

You can always find the most complete and up to date list of events in the javadocs: Ignite events and GridGain events.

Events are grouped into the following categories:

Event Category Event Name

Checkpoint

EVT_CHECKPOINT_SAVED
EVT_CHECKPOINT_LOADED
EVT_CHECKPOINT_REMOVED

Deployment

EVT_CLASS_DEPLOYED
EVT_CLASS_UNDEPLOYED
EVT_CLASS_DEPLOY_FAILED
EVT_TASK_DEPLOYED
EVT_TASK_UNDEPLOYED
EVT_TASK_DEPLOY_FAILED

Error

EVT_JOB_TIMEDOUT
EVT_JOB_FAILED
EVT_JOB_FAILED_OVER
EVT_JOB_REJECTED
EVT_JOB_CANCELLED
EVT_TASK_TIMEDOUT
EVT_TASK_FAILED
EVT_CLASS_DEPLOY_FAILED
EVT_TASK_DEPLOY_FAILED
EVT_TASK_DEPLOYED
EVT_TASK_UNDEPLOYED
EVT_CACHE_REBALANCE_STARTED
EVT_CACHE_REBALANCE_STOPPED

Discovery

EVT_NODE_JOINED
EVT_NODE_LEFT
EVT_NODE_FAILED
EVT_NODE_SEGMENTED
EVT_CLIENT_NODE_DISCONNECTED
EVT_CLIENT_NODE_RECONNECTED

Discovery (all)

EVT_NODE_JOINED
EVT_NODE_LEFT
EVT_NODE_FAILED
EVT_NODE_SEGMENTED
EVT_NODE_METRICS_UPDATED
EVT_CLIENT_NODE_DISCONNECTED
EVT_CLIENT_NODE_RECONNECTED

Job Execution

EVT_JOB_MAPPED
EVT_JOB_RESULTED
EVT_JOB_FAILED_OVER
EVT_JOB_STARTED
EVT_JOB_FINISHED
EVT_JOB_TIMEDOUT
EVT_JOB_REJECTED
EVT_JOB_FAILED
EVT_JOB_QUEUED
EVT_JOB_CANCELLED

Task Execution

EVT_TASK_STARTED
EVT_TASK_FINISHED
EVT_TASK_FAILED
EVT_TASK_TIMEDOUT
EVT_TASK_SESSION_ATTR_SET
EVT_TASK_REDUCED

Cache

EVT_CACHE_ENTRY_CREATED
EVT_CACHE_ENTRY_DESTROYED
EVT_CACHE_OBJECT_PUT
EVT_CACHE_OBJECT_READ
EVT_CACHE_OBJECT_REMOVED
EVT_CACHE_OBJECT_LOCKED
EVT_CACHE_OBJECT_UNLOCKED
EVT_CACHE_OBJECT_EXPIRED

Cache Rebalance

EVT_CACHE_REBALANCE_STARTED
EVT_CACHE_REBALANCE_STOPPED
EVT_CACHE_REBALANCE_PART_LOADED
EVT_CACHE_REBALANCE_PART_UNLOADED
EVT_CACHE_REBALANCE_OBJECT_LOADED
EVT_CACHE_REBALANCE_OBJECT_UNLOADED
EVT_CACHE_REBALANCE_PART_DATA_LOST
EVT_CACHE_REBALANCE_PART_SUPPLIED
EVT_CACHE_REBALANCE_PART_MISSED

Cache Lifecycle

EVT_CACHE_STARTED
EVT_CACHE_STOPPED
EVT_CACHE_NODES_LEFT

Cache Query

EVT_CACHE_QUERY_EXECUTED
EVT_CACHE_QUERY_OBJECT_READ

Transactions

EVT_TX_STARTED
EVT_TX_COMMITTED
EVT_TX_ROLLED_BACK
EVT_TX_SUSPENDED
EVT_TX_RESUMED

Cluster Activation

EVT_CLUSTER_ACTIVATED
EVT_CLUSTER_DEACTIVATED

License

EVT_LIC_CLEARED
EVT_LIC_VIOLATION
EVT_LIC_GRACE_EXPIRED

Authentication

EVT_AUTHENTICATION_SUCCEEDED
EVT_AUTHENTICATION_FAILED

Authorization

EVT_AUTHORIZATION_SUCCEEDED
EVT_AUTHORIZATION_FAILED