Administration Guide

System Log and Alerts

On this page

The System Log records the errors that Alloy Navigator's components report. It stores each distinct message once: when the same text is recorded again, the existing record counts one more occurrence and moves its last occurrence, instead of adding a record. The category, the source, and the account play no part in this, so two components that report the same text share one record.

Every record has a category and a source, both from fixed lists that cannot be changed:

  • Categories: failure to execute a job, to send a notification, to reach the mail server, to load audit snapshots, an audit conflict, failure to synchronize with Active Directory, to execute a workflow item, to import data, to archive data, to run a report, to run a scheduled task, and General.
  • Sources include Active Directory Import, Mail Connector, Automation Server, Alloy Discovery Connector, Import, Web App, Self Service Portal, Data Archiver, Reporting Service, Mobile App Service, API, Scheduled Tasks, and AlloyScan.

An alert sends an e-mail to a person or an address when a record of its category is written. How often it sends for the same record is set by one notification interval for all alerts.

You can read the System Log and manage its alerts in the Settings App and in the Admin Center.

For where each log can be read, and how long the System Log keeps its records, see Logs.

The System Log in the Settings App

In the Settings App, the System Log sits under Logs > All Errors and has two nodes: Error Log, which lists the log records, and Alerts, which lists the alerts. For its place in the tree, see Find a log.

What you can see and change

An account that can see the System Log but does not have the administrative right to manage logs sees its records read-only and cannot delete a record: Delete and Clear All are not offered. Alerts is shown only with that right. For the rights, see Permissions Reference.

A configuration export of the System Log carries the alerts, never the log records. On Alerts, Export Log... opens the Settings App's export wizard and exports the alerts to the file you name there, only the selected ones while the list has the focus. To export log records, use the export on the Error Log's right-click menu; see Work with a log.

Read a System Log record

In the Error Log, double-click a record, or select it and click View Details or press Enter. The Error Log Record window opens with these read-only fields:

Field Shows
First Occurrence: When the message was first recorded.
Last Occurrence: When it was last recorded.
Occurrences: How many times it was recorded.
Record ID: The record's ID.
Category: The category.
Account: The account.
Source: The component that reported it.
Details: The message text.

< and > move to the previous and next record of the list behind the window, each available only while there is such a record, and Close closes it.

For the Error Log's other commands, such as Delete, Clear All, and Refresh, and for how many records it loads, see Work with a log.

Set up an alert

Alerts shows the columns Category and Recipient, sorted by category. The page has the commands New, Edit, Delete, and Refresh.

  1. In the Settings App, open Logs > All Errors > Alerts.
  2. Click New, or press Insert. The Error Log Alert window opens.
  3. In Category:, choose the category the alert is for. The list is sorted by name, and a new alert starts on General.
  4. Choose the recipient. A new alert starts with E-mail: chosen.
    • Person: opens the Select Person picker and shows the chosen person in a read-only box.
    • E-mail: takes a typed address. While the box has the focus, its ellipsis button inserts an object field.
  5. Edit Subject: and Message:. A new alert starts with the subject %[Event Category]% (%[Occurrences Total]%) and a ready-made message that begins "Alloy Navigator reported an error that requires your attention." and quotes the source, the category, the details, both occurrence dates, the last notification, and both counters.
  6. Click OK. OK is available only when the recipient, the subject, and the message are all filled in.

The alert is saved as soon as you click OK.

Insert Placeholder... always inserts into Message:. To insert a placeholder into Subject:, use the ellipsis button in the Subject: box, which opens the same menu. The menu has these placeholders:

Menu item Inserts
Initiator Account %[Initiator Account]%
Event Category %[Event Category]%
Event Details %[Event Details]%
First Occurrence %[First Occurrence]%
Last Occurrence %[Last Occurrence]%
Last Notification %[Last Notification]%
Occurrences Total %[Occurrences Total]%
Occurrences Since Last Notification %[Occurrences Since Last Notification]%
Event Source %[Event Source]%

%[Occurrences Total]% and %[Occurrences Since Last Notification]% quote the record's two counters, which also count the occurrences for which no alert was sent. The count since the last notification goes back to zero with each occurrence that sends an alert.

Edit or delete an alert

  • To edit an alert, double-click it, or select it and click Edit or press Enter.
  • To delete alerts, select them and click Delete or press the Delete key, then confirm "Are you sure you want to delete selected notifications?". Every selected alert is removed.

Set the notification interval

The Notification Interval: list below the alerts holds Once, Every hour, Every day, and Every week. It is one value for all alerts, not a setting of the selected alert. The default is Every hour.

The interval limits how often alerts are sent for the same record: an alert is sent when the time since that record's last notification reaches the interval. Occurrences in between are still counted. With Once, an alert is in effect not repeated.

Choosing Once, or Every week while the Error Log keeps its records for fewer than 7 days, shows at once: "The specified notification interval is longer than the System Log keep interval. The actual notification interval will be at least not shorter than the System Log keep interval."

The interval is the one value on the page that waits for Apply. Alerts themselves are saved when you click OK in their window or delete them.

What a saved change notifies

Each change on the page, whether you add, edit, or delete an alert or apply the interval, is passed on at once:

  • The settings change time is stamped.
  • The running Automation Server is told to reload its settings.
  • The change is reported to the Administrative Dashboard.

The System Log in the Admin Center

In the Admin Center, the System Log is the All Errors tile of the Logs page, which is shown to an account that holds a logs right or Administrative access. The tile opens the error log. The alerts are listed on a second page of the same tile, which opens only for an account that holds the right to manage logs or Administrative access. For the rights, see Permissions Reference.

Read the error log

To open a record, select exactly one record and click View log, or double-click the record.

Clear all, Delete, and the Settings link of a log page are shown only to an account that holds the right to manage logs or Administrative access.

Clear all asks a single Yes/No question before it deletes the log's records. Delete asks for confirmation, for one record or for several, and shows no result message after the records are deleted.

Set up an alert in the Admin Center

  1. On the Logs page, open All Errors, and then the page that lists the alerts.
  2. Click New. The Error Log Alert drawer opens.
  3. In Category, choose the category the alert is for.
  4. Choose Person or E-mail, and fill in the recipient. Only the chosen one is available, and it is required. A new alert starts with E-mail chosen.
  5. Edit the subject and the message. A new alert starts with the subject %[Event Category]% (%[Occurrences Total]%) and a ready-made message that names the event source, the category, the details, the first and last occurrence, the last notification time, and both occurrence counts.
  6. Save the alert.

The Category list names the categories "Audit conflict detected", "Failure to archive data", "Failure to connect to the mail server", "Failure to execute job", "Failure to execute workflow item", "Failure to import data", "Failure to load audit snapshots", "Failure to run report", "Failure to run scheduled task", "Failure to send notification", "Failure to synchronize with Active Directory", and "General".

The subject and the message both offer nine placeholders, with the same names as in the Settings App, from Initiator Account to Event Source; see Set up an alert. A subject or an e-mail address longer than 256 characters is refused when you save.

Edit or delete an alert in the Admin Center

The page that lists the alerts has New, Edit, Delete, and a search box, and no Clear all.

  • To edit an alert, select exactly one and click Edit, or double-click it.
  • To delete alerts, select one or more, click Delete, and confirm.

The page that lists the alerts also shows Notification interval: with Once, Every hour, Every day, and Every week. It shows Every hour until the stored interval has loaded, and then the stored interval, but a change made there is not saved and is lost when you leave the page. The interval is set in the Settings App; see Set the notification interval.

How alerts are sent

When a System Log record is written and the interval allows a notification, every alert of that record's category is sent:

  • For a person, the alert goes to the person's primary e-mail address. A person whose status is inactive is skipped.
  • For a typed address, the macros in it are expanded first.
  • An alert whose recipient comes out as an empty address is skipped without a record.

An alert is queued as a system message. When it cannot be sent, no new System Log record is written about it, so an unreachable mail server does not turn each undelivered alert into a new error to alert about. The failure still appears in the run log of the Automation Server's notification sending.

Alerts, administrators, and views in the supplied configuration

A new 2026.1 database created with the Default Workflow contains the following; see Default Workflow Configuration. An upgraded database need not contain it, and an administrator may have changed it.

  • Alerts. The supplied configuration includes a set of alerts, which appear in the Settings App under Logs > All Errors > Alerts.
  • Administrator parameters. The workflow parameters System Administrator, Backup System Administrator, and Alternate System Administrator, in the Personnel category under Administration, each take a technician. Each is described as the person "used for communication regarding administrative functionality such as alerts, warnings and errors"; the second is a backup and the third an alternate. All three are empty in the supplied configuration, so a new database starts with no administrator set.
  • Error Log views. In the Settings App, the Error Log has the views All Time, Last 7 days, and by Category. Each shows the source, the category, the last occurrence, and the number of occurrences. Last 7 days lists the records last recorded in the last seven days, and by Category groups the records by category and totals their occurrences for each group.