Troubleshooting
Common situations met while using Monitoring, with the likely cause and the recommended resolution. Sections follow the order of the Monitoring guides.
Five Checks to Make First
Most Monitoring questions are answered by one of these five checks.
- Does the role have the permission? The Monitoring pages depend on the System Configuration group of the role.
- Is the page showing the right range? Search boxes, filters and time windows narrow what a page shows.
- Have you refreshed? Several pages have a Refresh button, and Logs has Auto-Refresh.
- Does the license include the feature? License Details lists the enabled modules and plugins.
- Is the scope Own, Group or All? Audit Logs and Active Sessions show only the people in scope.
Getting Started
| Symptom | Likely Cause | Resolution |
|---|---|---|
| A Monitoring page is missing from the side menu. | The role does not have the matching permission, or the license does not include the feature. | Check the System Configuration group of the role. For CRM Imports, Automations and Campaign Execution, also check the role's access to CRM, Automations and Campaign, and the Edition Capabilities on License Details. |
System Health
| Symptom | Likely Cause | Resolution |
|---|---|---|
| The cards or tabs show old values. | The page has not been refreshed. | Reload the page, and on the Database tab click Refresh Diagnostics. |
| A service group shows DEGRADED. | Only some of the services in the group are running. | Expand the group on the Services tab to see which services are not running, and contact support with the group name. |
Health Tabs
| Symptom | Likely Cause | Resolution |
|---|---|---|
| The Network tab shows few days left on a certificate. | The certificate is close to its expiry date. | Renew the certificate before the date shown in Days Left. |
License Details
| Symptom | Likely Cause | Resolution |
|---|---|---|
| A new user cannot be created. | Every user seat in the license is in use. | Check Active Users on License Details and free a seat or ask for more seats. |
| License Details is missing from the side menu. | The role does not have the Manage License permission. | Switch Manage License on for the role. |
Viewing Logs
| Symptom | Likely Cause | Resolution |
|---|---|---|
| The viewer shows no entries. | A keyword or level filter is too narrow, or no entries were written in the time window. | Clear the filters, widen the time window and click Fetch. |
| The core directory shows nothing until you act. | A directory loads only when you click Fetch. | Set a Start Time and a time window, then click Fetch. |
Edge Log Submission
| Symptom | Likely Cause | Resolution |
|---|---|---|
| No new Edge entries appear. | Auto-Refresh is off, or the filter excludes them. | Turn on Auto-Refresh (30s), clear the filter, and check that the Edge group is ONLINE on the Services tab. |
Audit Logs
| Symptom | Likely Cause | Resolution |
|---|---|---|
| A change you expect is not in the list. | The page shows the first page of a very long list, or the person is outside your scope. | Search by the name of the record or the user, and check the scope of the Audit Logs permission. |
| The Purge button is missing. | The role does not have the Log Purge permission. | Switch Log Purge on for the role, if purging is part of the person's duties. |
Active Sessions
| Symptom | Likely Cause | Resolution |
|---|---|---|
| A connected person is not listed. | The person is outside your scope, or has no open connection. | Check the scope of the Active Session permission and ask the person to sign in again. |
Task Queues
| Symptom | Likely Cause | Resolution |
|---|---|---|
| A queue shows pending jobs that do not move. | The queue is paused. | Open the queue and resume it. Check the Paused count. |
| Task Queues is missing from the side menu. | The role does not have the Logs/Task Queues permission. | Switch Logs/Task Queues on for the role. |
Automation Monitor
| Symptom | Likely Cause | Resolution |
|---|---|---|
| A workflow never appears in Execution History. | It has not been triggered yet, or the search box holds another name. | Clear the search, and check the workflow's trigger. |
The Registry Health Check shows ERROR for a module. | An action endpoint or a referenced ID that a workflow uses no longer exists. | Open the workflows that use the module and correct the action, then run the check again. |
CRM Imports
| Symptom | Likely Cause | Resolution |
|---|---|---|
| An import is not listed. | Only active and recent imports appear, or the import was purged. | Start the import again, or look for the records in Audit Logs. |
Campaign Execution
| Symptom | Likely Cause | Resolution |
|---|---|---|
| The campaign is not in the table. | It has not run yet. | Start the campaign, wait for its first execution and click Refresh. |
| Skipped is higher than expected. | Contacts were skipped, for example because they were excluded from the campaign. | Review the campaign's list and filters before the next run. |
Permissions
| Symptom | Likely Cause | Resolution |
|---|---|---|
| A supervisor sees fewer rows than an administrator. | The Audit Logs or Active Session permission has Group scope. | This is expected. Change the scope to All only if the supervisor needs it. |