event (evt)
Manage events.
gi eventSubcommands
| Command | Description |
|---|---|
gi event create | Create a new event |
gi event get <event-id> | Get an event by its id |
gi event list | List all events |
Flags
list flags
| Flag | Alias | Description |
|---|---|---|
--filter | -f | Filter events (e.g. level=ERROR, tenant=my-tenant) |
create flags
| Flag | Alias | Description |
|---|---|---|
--name | -n | Event name (env: EVENT_NAME) |
--description | -d | Event description (env: EVENT_DESCRIPTION) |
--time | -t | Timestamp (RFC 3339, e.g. 2024-01-15T10:30:00Z) (env: EVENT_TIME) |
--user | -u | User associated with the event (env: EVENT_USER) |
--source-ip | — | Source IP address (env: EVENT_SOURCE_IP) |
--datacenter | — | Datacenter identifier (env: EVENT_DATACENTER) |
--region | -r | Region identifier (env: EVENT_REGION) |
--platform | -p | Platform identifier (env: EVENT_PLATFORM) |
--tenant | — | Tenant identifier (env: EVENT_TENANT) |
--service | -s | Service identifier (env: EVENT_SERVICE) |
--action | -a | Action performed (e.g. create, delete, update, login) (env: EVENT_ACTION) |
--asset-type | — | Type of asset involved (env: EVENT_ASSET_TYPE) |
--asset-uid | — | Asset unique identifier (env: EVENT_ASSET_UID) |
--application | — | Application identifier (env: EVENT_APPLICATION) |
--url | — | Related URL (env: EVENT_URL) |
--level | -l | Severity: DEBUG, INFO, WARNING, ERROR, CRITICAL (env: EVENT_LEVEL) |
--metadata | -m | Key-value metadata (repeatable: --metadata key1=value1 --metadata key2=value2) (env: EVENT_METADATA) |
--details | — | JSON string for details field (env: EVENT_DETAILS) |
Examples
# Create an event
gi event create \
--name "Deployment" \
--level INFO \
--action create \
--platform prod-emea \
--tenant acme-prod \
--description "Deployed v1.5.0 to production" \
--metadata version=1.5.0 \
--metadata deployer=alice
# List events with filter
gi evt list -f level=ERROR
gi evt list -f tenant=acme-prod
# Get a specific event
gi evt get evt-abc123