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.
Dallas (us-south ) |
Washington (us-east ) |
Toronto (ca-tor ) |
Sao Paulo (br-sao ) |
---|---|---|---|
Yes | Yes | No | No |
Tokyo (jp-tok ) |
Sydney (au-syd ) |
Osaka (jp-osa ) |
Chennai (in-che ) |
---|---|---|---|
Yes | Yes | No | No |
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.
Dallas (us-south ) |
Washington (us-east ) |
Toronto (ca-tor ) |
Sao Paulo (br-sao ) |
---|---|---|---|
Yes | Yes | No | No |
Tokyo (jp-tok ) |
Sydney (au-syd ) |
Osaka (jp-osa ) |
Chennai (in-che ) |
---|---|---|---|
Yes | Yes | No | No |
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.
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
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"},