This page describes how to view the status, activity logs, and sync activity of a third-party data store, and how to configure alerts for the data store.
View data store details and status
After connecting your third-party data source to Agentspace by creating a data store, you can view the status of the data store by going to the Data stores page and clicking the data store name.
View data store states
The Connector state field shows the status of the data store. See the following table for information about possible data store states.
| State | Description |
|---|---|
| Creating | The data store is being created. |
| Creating (with errors) | The data store is being created, but some errors have occurred. |
| Initialization failed | The data store failed to be created. |
| [Action required] | User actions that must be completed before the data store can start syncing data. |
| Updating | The data store is being updated. |
| Failed during setup | The data store encountered some errors during setup. |
| Failed during sync | The data store encountered some errors during sync. |
| Authorization issues | The data store failed with authorization related errors. |
| Quota issues | The data store failed with quota related errors. |
| Failed | The data sync run failed. |
| Running | The data sync run is in progress. |
| Running (with errors) | The data sync run is in progress, but some errors have occurred (possibly including fatal errors). |
| Warning | The data store's latest sync run encountered fatal errors. |
| Active | The data store was successfully created and is awaiting the next sync run. The last sync run encountered no fatal errors. |
| Paused | The data sync run is paused. |
| Paused (with errors) | The data sync run is paused, and some errors have occurred. |
View data store sync activity
In the Data Ingestion Activity tab, you can see the data store's latest sync activity. Each sync run is listed, with the following fields:
Connector run: the date and time of the sync run.
Status: the status of the sync run.
Last update time: the date and time of the last change in the sync run.
Sync type: the type of sync (Full or Incremental).
Items succeeded (%): the percentage of entities that were successfully synced.
Items failed: the number of entities that failed to sync.
Details: More information about the sync run. If there are more details available, you can click to expand the field and view them.
For information about the possible values of the Status field for a sync run, see the following table.
| Status | Description |
|---|---|
| Running | The data sync is ongoing. At least one entity is still being synced. |
| Running with errors | The data sync is ongoing. At least one entity is still being synced. Sync for some entities failed, or encountered nonfatal errors. |
| Succeeded | The data sync has completed successfully. All of the entities were successfully synced. |
| Succeeded with errors | The data sync has completed, but some entity sync runs failed or encountered nonfatal errors. |
| Failed | All entities failed to sync. |
| Cancelled | The data sync was scheduled, but syncs for all entities have been cancelled. |
| Overrun | The data sync is ongoing, but has taken longer than expected and continues to run at the time that the next run is scheduled. |
For each sync run in the table, you can expand the row by clicking the date and time under Connector run. This shows you the details of each specific entity type included in the sync run. For more information, see the following table.
| Field | Description |
|---|---|
| Status |
|
| Last update time | The date and time of the last change in the sync run for this entity. |
| Sync type | The type of sync (Full or Incremental). |
| Items Succeeded (%) | The percentage of items (documents) successfully indexed. This percentage may change over time as the sync run progresses. |
| Items Failed | The number of items (documents) that failed to index. |
| Details / View Details | This button opens up a side-panel that shows a link to view logs for this entity sync run, as well as more details about the error. |
View data store activity logs
To view activity logs for the data store, click View logs in the data store details page.
This shows you all logs related to this data store, across all sync runs, including all entity sync runs.
Set up alerts for sync events
After connecting your third-party data source to Agentspace by creating a data store, you can enable alerts for predefined tasks. Alert notifications can be emailed to selected recipients.
Before you begin
To enable alerts for a data store, you need to have the following permissions or role assigned to you:
| Permissions |
|
| Predefined role | Discovery Engine User |
Enable alerts for a data source
To enable alerts for a specific data source:
In the Google Cloud console, go to the Agentspace page.
In the navigation menu, click Data stores.
Click the name of the data store that you want the alerts configured.
On the data store details page, ensure that you have enabled the Full sync frequency and the Incremental sync frequency.
Click the Alerts tab and then click Edit.
In the Configure alerts section, click the alert toggle to the on position. The following alerts are supported:
Alert Type Description Status: Failed/Cancelled The data store failed to connect or retrieve data from your data source, or the sync run was cancelled. Status: Succeeded The data store successfully connected and retrieved data from your data source. In the Configure recipients section, add the email addresses that must receive notifications for the enabled alerts.