Monitor Alerts | Moveworks

What are Moveworks Alerts?

Moveworks Alerts inform administrators of critical events within the customer instance that may impact skill functionality. These notifications enable rapid detection and response to potential issues, helping you maintain system health and resolve problems efficiently.

Alerts are by default available in Moveworks Setup Alerts module. To enable in-bot alert notifications (Beta), please reach out to your Customer Success Manager or support team.

How to navigate in Moveworks Setup?

Open Moveworks Setup.
Navigate to Organization Details > Alerts

Columns in Alerts home screen

Module: The segment of the system where the alert originates.
Alert ID: A unique identifier assigned to each alert.
Alert Name: The title that describes the essence of the alert.
Alert Description: A brief explanation providing context to the alert.
Alert Type: The category that the alert falls into
- System Alert: Integration specific alerts
- Configuration Alert: Alerts generating from configuration changes
- External Alert: Alerts originating from external chat system
Last Fired at: The most recent time and date when the alert was last triggered.
Total Times fired: Count of times the same alert was fired.
Active Since: Time from which a specific alert is active.
Acknowledged By: User who is acknowledging an active alert in the UI.

There are 2 states a alert can be present in

Active - Active alerts signifying that the issue is possibly still persisting
Archived - Historical alerts that were triggered and resolved.
1. An Alert gets moved to the Archived section if alert expression criteria is resolved internally.
2. The archived alerts section contains a history of the last 2 months of alerts.

Supported Alert Types

Moveworks Alerts infrastructure is evolving. Currently Moveworks support a limited number of alerts covering few scenarios that impacts a skill functioning.

Module	Alert Name	Alert Type	Alert Description	Downstream Alert Impact	Troubleshooting Docs or Recommended Steps
Connector	Integration Failure - {System}	System Alert	System is failing to connect with {System}. Please check credentials and the authentication system used	Import Users, Account Access, Group Access, Employee Comms	Ensure the Connector has been setup Following the Steps here
Identity	User validation failed	Configuration Alert	User identity validation failed.	If not fixed over time this will impact : Import Users, Ticketing, Knowledge Search, File Search, Account Access, Group Access, Employee Comms	The issue is commonly due to the Integrations not having the same Joining Key, Please ensure the step here has been followed when configuring Identity.
Ticketing	Ticketing - Tickets are not passing the Universal ticket filter	Ticketing Filter Alert	No tickets have passed universal filter. Check ticket filters (particularly Universal ticket fetching filter)	Ticketing, Ticket Actions, Ticket Polling, Ticket Interception	Learn more about how Ticket Filters are setup here.
Internal Knowledge	Knowledge Ingestion - Large drop in articles	Configuration Alert	A significant (>50%) decrease in the number of ingested articles has been detected.	Internal Knowledge would have a gap in content.	If this drop is expected, contact Moveworks Support and request: “Mark ingestion of knowledge articles as healthy despite large data drop”. Check for intentional config changes Verify source system health Check connector permissions
Agent	Agent disconnected	External Alert	There are no Moveworks on-prem agents connected.	Import Users, Account Access, Group Access, Employee Comms	Please follow this Troubleshooting Document for steps to Resolution
Connector	Chat credentials expired	System Alert	Chat system responded with “401 - Unauthorized”. This means that the existing credentials are no longer valid and the bot is unable to send messages to the users.	Bot Unresponsive to user/users in the Chat Interaction Platform.	Credentials Rotation Guide for : Microsoft Teams Slack
Chat	Bot has been disabled by admin	External Alert	The bot has been disabled and is unable to send messages to users and/or users may be unable to locate the bot in their chat client. Please reach out to your Microsoft Teams admin to get the bot re-enabled in your Teams admin console. This may also require modifying the app’s Permission Policy.	Bot Unavailable to user/users in the Chat Interaction Platform.	Please reach out to your Microsoft Teams admin to get the bot re-enabled in your Teams admin console. This may also require modifying the app’s Permission Policy.
Connector	ServiceNow Service Account Timezone Mismatch	System Alert	The timezone of the ServiceNow service account configured as a Moveworks connector does not match one of the expected timezones (‘GMT’, ‘GMT0’, ‘UTC’, ‘America/Danmarkshavn’).	In Ticketing > Ticket Polling would be unable to poll tickets due to the invalid timezone.	Here are the steps to setup the Time Zone.
Connector	Microsoft Teams - Message Authentication Failure	System Alert	Failure to authenticate Microsoft Teams inbound messages	Bot Unresponsive to user/users in the Chat Interaction Platform.	Reach out to the Moveworks Support Team
Connector	Microsoft Teams Installation Forbidden	System Alert	Failure to install bot in Microsoft Teams to subset of users.	Microsoft Teams - Bot installation blocked for some users	Have your Microsoft Teams Admin confirm the bot is assigned and authorized for the necessary permissions (User.Read.All & TeamsAppInstallation.ReadWriteSelfForUser.All) Review the app permission policy settings for the bot. Verify that the bot has not been blocked or restricted by organizational policies.
Permissions	ServiceNow Permissions Data Stale	System Alert	Moveworks ServiceNow User Criteria Ingestion is failing	ServiceNow Knowledge may not serve to users	Verify connector is properly Configured Verify Moveworks acl Update set is properly installed Confirm that the moveworks_user role in ServiceNow must be granted to the Moveworks service account After confirming above, file a Moveworks Support ticket.
Access Groups	Group ingestion Failure	System Alert	Issues importing Groups into Moveworks	Groups leveraged in the Access DL skill may not be able to discover new Groups	Verify connector has the right scopes Check with your IDAM team if there is issues with the system.
Internal Knowledge	Knowledge Ingestion Failure	System Alert	Knowledge data is stale due to a downstream error or other restriction such as Large Data Change Protection being triggered.	Moveworks AI Assistant will not be able to answer questions related to new	Verify the connector has the right scopes and the credentials are correct. Check with your Knowledge team if there is issues with the specific system. Navigate to Core Platform > Customer Data Ingestion, to view the knowledge ingestion, Click `View Logs`for further info, ensure to review the Error Summary. Email Moveworks Support to mark the Ingestion as approved if it is due to a Large Data Change Protection alert.
Group Identity Stale	Group Ingestion Failure	System Alert	Group Ingestion data is stale due to a downstream error or other restriction such as Large Data Change Protection being triggered.	Groups leveraged in the Access DL skill may not be able to discover new Groups	Verify connector has the right scopes and the credentials are correct Check with your IDAM team if there is issues with the system. Email Moveworks Support to mark the Ingestion as approved if it is due to a Large Data Change Protection alert.
User Identity Stale	User Ingestion Failure	System Alert	User Identity data is stale due to a downstream error or other restriction	New employees may not be able to use the Moveworks Assistant.	Navigate to Core Platform > Customer Data Ingestion, see which connector is failing Verify connector has the right scopes and the credentials are correct. Click `View Logs`for further info, ensure to review the Error Summary.
Form Data Stale	Form Ingestion Failure	System Alert	Forms are stale due to a downstream error or other restriction	New forms may not surface from within the Moveworks Assistant.	If this drop is expected, please contact Moveworks Support and request: “Mark ingestion of Forms as healthy despite large data drop” Ensure the external data source that forms are being imported from is online and accessible. Confirm that the Moveworks service account or equivalent API credential has the correct permissions and access scopes to import forms.