Events API

On This Page

Events are emitted by the Iguazio backend for internal (services) and external (users) visibility of user actions, security actions and system state. The user can emit (manual) events as long as he has system admin role.

Events are displayed in the Iguazio Events Dashboard.

Before you start, make sure that the igz_mgmt package is installed and that you are logged in to the system with the igz_mgmt.Client API. If not, see Control plane API.

import igz_mgmt
client = igz_mgmt.Client(username="someone", access_key="some-access-id")

List Events, Audit Events, Communication Events

Events, Audit Events, Communication Events can be filtered by tenant, source, kind, classification, severity, etc.

The following example lists all info-level events for the current tenant.

events = igz_mgmt.Event.list(
    client, filter_by={"severity":}

The following example lists all security audit events for login failures

audit_events = igz_mgmt.AuditEvent.list(
    filter_by={"kind": "Security.User.Login.Failed"},

The following example lists all communication events for the current tenant.

communication_events = igz_mgmt.CommunicationEvent.list(client)

Manual events

Manual events are events that are emitted by the user. If Iguazio-system has predefined “kind” for the events, the parameters text must be accordingly to the event definition. Ask Support team to learn more.

Create a manual audit event

import igz_mgmt.resources

event = igz_mgmt.resources.AuditEvent(
    description="Created a secret",,
    parameters_text=["secret_keys", value="a,b,c"),"secret_name", value="my-secret"),"project", value="my-project"),