IBM Cloud Docs
Activity tracking events watsonx Assistant

Activity tracking events watsonx Assistant

IBM Cloud Enterprise Premium

IBM Cloud services, such as watsonx Assistant, generate activity tracking events. This applies to both the classic and new experiences of watsonx Assistant.

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.

As of 28 March 2024, the IBM Cloud Activity Tracker service is deprecated and will no longer be supported as of 30 March 2025. Customers will need to migrate to IBM Cloud Logs before 30 March 2025. During the migration period, customers can use IBM Cloud Activity Tracker along with IBM Cloud Logs. Activity tracking events are the same for both services. For information about migrating from IBM Cloud Activity Tracker to IBM Cloud Logs and running the services in parallel, see migration planning.

Locations where activity tracking events are generated

Locations where activity tracking events are sent to IBM Cloud Logs hosted event search

watsonx Assistant sends activity tracking events to IBM Cloud Logs hosted event search in the regions that are indicated in the following table.

Regions where activity tracking events are sent in Americas locations
Dallas (us-south) Washington (us-east) Toronto (ca-tor) Sao Paulo (br-sao)
Yes Yes No No
Regions where activity tracking events are sent in Asia Pacific locations
Tokyo (jp-tok) Sydney (au-syd) Osaka (jp-osa) Chennai (in-che)
Yes Yes No No
Regions where activity tracking events are sent in Europe locations
Frankfurt (eu-de) London (eu-gb) Madrid (eu-es)
Yes Yes No

Locations where activity tracking events are sent by IBM Cloud Activity Tracker Event Routing

watsonx Assistant sends activity tracking events by IBM Cloud Activity Tracker Event Routing in the regions that are indicated in the following table.

Regions where activity tracking events are sent in Americas locations
Dallas (us-south) Washington (us-east) Toronto (ca-tor) Sao Paulo (br-sao)
Yes Yes No No
Regions where activity tracking events are sent in Asia Pacific locations
Tokyo (jp-tok) Sydney (au-syd) Osaka (jp-osa) Chennai (in-che)
Yes Yes No No
Regions where activity tracking events are sent in Europe locations
Frankfurt (eu-de) London (eu-gb) Madrid (eu-es)
Yes Yes No

Viewing activity tracking events for watsonx Assistant

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.

Events that are generated by an instance of the watsonx Assistant service are automatically forwarded to the IBM Cloud Logs service instance that is available in the same location. However, if your service instance is hosted in the Washington DC location, create the IBM Cloud Logs service instance in the Dallas region.

IBM Cloud Logs can have only one instance per location. To view events, you must access the web UI of the IBM Cloud Logs service in the same location where your service instance is available. For more information, see Navigating to the UI.

watsonx Assistant events in IBM Cloud Logs

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.

List of events

Actions that generates events
Action Description
conversation.action.create creates an action
conversation.action.delete deletes an action
conversation.action.update updates an action
conversation.action_handler.create creates an action handler
conversation.action_handler.delete deletes an action handler
conversation.action_handler.update updates an action handler
conversation.action_variable.create creates an action variable
conversation.action_variable.delete deletes an action variable
conversation.action_variable.update updates an action variable
conversation.actions.copy copies an action from one assistant to another
conversation.assistant.create creates an assistant
conversation.assistant.delete deletes an assistant
conversation.assistant.update updates an assistant, for example, updates the settings
conversation.catalog_integration.create creates a custom extension
conversation.catalog_integration.delete deletes a custom extension
conversation.catalog_integration.update updates a custom extension
conversation.counterexample.create marks test user input in "Try it out" as being irrelevant or corrects the categorization of a user input that was incorrectly assigned to an intent by marking it as irrelevant
conversation.counterexample.delete deletes a counterexample
conversation.counterexample.update edits a counterexample
conversation.data.delete deletes multiple training data items, such as multiple entities or intents
conversation.data.update does a bulk action, such as importing a CSV file of intents or entities to the skill
conversation.data_type.create creates a saved response
conversation.data_type.delete deletes a saved response
conversation.data_type.update updates a saved response
conversation.entity.create creates an entity
conversation.entity.delete deletes an entity
conversation.entity.update edits an entity
conversation.environment.create adds an environment
conversation.environment.delete deletes an environment
conversation.environment.updates updates an environment
conversation.example.create adds a user input example to an intent
conversation.example.delete deletes a user example from an intent
conversation.example.update edits a user example that is associated with an intent
conversation.integration_defintion.create creates an integration
conversation.integration_defintion.delete deletes an integration
conversation.integration_defintion.update updates an integration
conversation.intent.create creates an intent
conversation.intent.delete deletes an intent
conversation.intent.update edits an intent
conversation.log.create corrects an intent that was inaccurately categorized by the skill from the Analytics>User conversations page
conversation.node.create creates a dialog node
conversation.node.delete deletes a dialog node
conversation.node.update edits a dialog node
conversation.notifier.create creates a notifier
conversation.notifier.delete deletes a notifier
conversation.notifier.update updates a notifier
conversation.processor.create creates a processor
conversation.processor.delete deletes a processor
conversation.processor.update updates a processor
conversation.release.create create a version from content in the draft environment
conversation.release.delete delete a version
conversation.release.deploy publish a version to an environment
conversation.skill.create creates a skill
conversation.skill.delete deletes a skill
conversation.skill.update updates a skill
conversation.skill_reference.create adds a specific skill to an assistant
conversation.skill_reference.delete removes a specific skill from an assistant
conversation.skill_reference.update updates a specific skill that is associated with an assistant
conversation.skill_variable.create create a skill variable
conversation.skill_variable.delete delete a skill variable
conversation.skill_variable.update update a skill variable
conversation.skills.export export a skill
conversation.skills.import import a skill
conversation.snapshot.create creates a version of a dialog skill
conversation.snapshot.delete deletes a version of a dialog skill
conversation.snapshot.update updates a version of a dialog skill
conversation.step.create adds a step to an action
conversation.step.delete deletes a step from an action
conversation.step.update updates a step in an action
conversation.step_handler.create create a step handler
conversation.step_handler.delete delete a step handler
conversation.step_handler.update update a step handler
conversation.synonym.create creates a synonym for an entity value
conversation.synonym.delete deletes a synonym that is associated with an entity value
conversation.synonym.update edits a synonym that is associated with an entity value
conversation.userdata.delete deletes data that was created by a specified customer
conversation.value.create creates an entity value
conversation.value.delete deletes an entity value
conversation.value.update edits an entity value
conversation.workspace.create creates a workspace
conversation.workspace.delete deletes a workspace
conversation.workspace.update edits a workspace

Additional information for update events

Any of the update events include this additional information in a requestData.update object:

  • Name changed
  • Title changed
  • Metadata changed
  • Training data changed

This example from an assistant.update event shows a name change:

"update":[{"updateType":"Name changed","nameAttribute":"name","newValue”:”Banking Bot 2},{“updateType":"Metadata changed","attributesUpdated":["description","language"]}],{"environment":"draft"},