Activity tracking events for catalog management
IBM Cloud services, such as catalog management, generate activity tracking events.
Activity tracking events report on activities that change the state of a service in IBM Cloud. You can use the events to investigate abnormal activity and critical actions and to comply with regulatory audit requirements.
You can use IBM Cloud Activity Tracker Event Routing, a platform service, to route auditing events in your account to destinations of your choice by configuring targets and routes that define where activity tracking events are sent. For more information, see About IBM Cloud Activity Tracker Event Routing.
You can use IBM Cloud Logs to visualize and alert on events that are generated in your account and routed by IBM Cloud Activity Tracker Event Routing to an IBM Cloud Logs instance.
Locations where activity tracking events are sent by IBM Cloud Activity Tracker Event Routing
Catalog management sends activity tracking events by IBM Cloud Activity Tracker Event Routing in the regions that are indicated in the following table.
Dallas (us-south) |
Washington (us-east) |
Toronto (ca-tor) |
Sao Paulo (br-sao) |
|---|---|---|---|
| No | No | No | No |
Tokyo (jp-tok) |
Sydney (au-syd) |
Osaka (jp-osa) |
Chennai (in-che) |
|---|---|---|---|
| No | No | No | No |
Frankfurt (eu-de) |
London (eu-gb) |
Madrid (eu-es) |
|---|---|---|
| Yes | No | No |
Viewing activity tracking events for catalog management
You can use IBM Cloud Logs to visualize and alert on events that are generated in your account and routed by IBM Cloud Activity Tracker Event Routing to an IBM Cloud Logs instance.
Launching IBM Cloud Logs from the Observability page
For information on launching the IBM Cloud Logs UI, see Launching the UI in the IBM Cloud Logs documentation.
Events for managing private catalogs
The following table lists the actions that generate private catalog management events:
| Action | Description |
|---|---|
globalcatalog-collection.instance.read |
An event is generated when you view a catalog. |
globalcatalog-collection.instance.update |
An event is generated when you update a catalog. |
globalcatalog-collection.instances.list |
An event is generated when you get a list of the catalogs in an account. |
Events for managing products in a private catalog
The following table lists the actions that generate events for managing products in a private catalog:
| Action | Description |
|---|---|
globalcatalog-collection.offerings.list |
An event is generated when you get a list of the products in a catalog. |
globalcatalog-collection.offering.read |
An event is generated when you view a product in a catalog. |
globalcatalog-collection.offering.create |
An event is generated when you create a product. |
globalcatalog-collection.offering.update |
An event is generated when you update a product. |
globalcatalog-collection.offering.delete |
An event is generated when you delete a product. |
Events for managing catalog settings at the account level
The following table lists the actions that generate events for managing catalog settings at the account level:
| Action | Description |
|---|---|
globalcatalog-collection.account-settings.read |
An event is generated when you view the account settings. |
globalcatalog-collection.account-settings.update |
An event is generated when you update the account settings. |
Events for managing catalog settings in enterprise accounts
The following table lists the actions that generate events for managing catalog settings in enterprise accounts:
| Action | Description |
|---|---|
globalcatalog-collection.enterprise-settings.read |
An event is generated when you view the enterprise settings. |
globalcatalog-collection.enterprise-settings.update |
An event is generated when you update the enterprise settings. |
globalcatalog-collection.enterprise-settings.list |
An event is generated when you get a list of the enterprises in an account and their corresponding settings. |
Events for managing software licenses and entitlements
The following table lists the actions that generate events for managing software licenses and entitlements:
| Action | Description |
|---|---|
entitlement.entitlement.create |
An event is generated when an initiator binds a license to an account. |
entitlement.entitlement.delete |
An event is generated when an initiator deletes an entitlement. |
entitlement.entitlement.delete_purge |
An event is generated when an initiator purges an entitlement. |
entitlement.entitlement.update |
An event is generated when an initiator updates an entitlement. |
entitlement.entitlement.check |
An event is generated when an initiator uses an entitlement to pull an image from the governed IBM Container Registry. |
entitlement.entitlement.invalidate |
An event is generated when an entitlement's license is not valid anymore. |
Events for managing software instances
The following table lists the actions that generate an event for software instances:
| Action | Description |
|---|---|
globalcatalog-instance.offering-instance.create |
An event is generated when you create a software instance. |
globalcatalog-instance.offering-instance.delete |
An event is generated when you delete a software instance. |
globalcatalog-instance.offering-instance.list |
An event is generated when you list all software instances in an account. |
globalcatalog-instance.offering-instance.read |
An event is generated when you retrieve a software instance. |
globalcatalog-instance.offering-instance.retrieve_history |
An event is generated when you access the audit logs for a software instance. |
globalcatalog-instance.offering-instance.update |
An event is generated when you install updates to a software instance. |
globalcatalog-instance.dashboard.view |
An event is generated when you access the software instance details page. |
Analyzing catalog management activity tracking events
You can find the value unavailable in catalog events. This value indicates when an update is made, but specific details about the update aren't included.