Archiving and restoring services¶
Who can do this: organization administrators.
Deleting a service in Pulse archives it. The service disappears from every live view, but its readings, alarm history and audit trail are kept, and it can be restored. There is no permanent delete for services.
Archive a service¶
- Open Admin, then Services.
- Click Delete in the service's row.
- Confirm Delete service "
<name>"? This will remove all its channel mappings and free those channels for assignment elsewhere.
The page shows Service deleted (its channel mappings have been freed). The action is recorded in the audit log as service.delete.
What happens when a service is archived:
| Effect | Detail |
|---|---|
| Mappings removed | All channel mappings are deleted and the channels become free to map to other services. |
| Monitoring stops | The current alarm state is removed: an active alarm disappears from Active Alarms and from the API immediately. |
| Acknowledgements and mutes end | Active acknowledgements expire and mutes are switched off. |
| Hidden everywhere | The service no longer appears on the dashboard, in the Services list, in Active Alarms, or in the API. Its service page shows Service not found or not authorized and its CSV export returns Not Found (404). On the Assets page the asset's Linked Service column shows —. |
| Detached later | If the linked asset or the notification group is deleted while the service is archived, the archived service is detached from it automatically; it does not block the deletion. |
| History kept | Alarm events, notification records, downtimes and past limit versions are retained. The alarm history remains visible on the Alarm History page; see Alarm history and audit log. |
Archived services do not count towards anything that blocks other deletions: an asset can be deleted while only archived services link to it, and a user group can be deleted while only archived services use it as their notification group.
The archived services list¶
Click Archived services → at the top of the Services page.
| Column | Meaning |
|---|---|
| Service | Name. |
| Organization | Organization. |
| Deleted | When it was archived, in UTC. |
| Deleted by | The administrator who archived it. |
| Actions | Alarm history opens the Alarm History page filtered to this service's name; Restore restores the service (see below). |
The list shows No archived services. when there are none.
The Archived Services page lists archived services with their Alarm history and Restore actions.
Restore a service¶
- On the archived services list, click Restore in the service's row.
- Confirm Restore
<name>? It will come back unmapped and you must remap its channels.
The archived services list reloads with Service restored. Remap its channels on the Services page to resume monitoring. at the top. The action is recorded in the audit log as service.restore.
A restored service:
- is enabled again and back in the Services list;
- has no channel mappings. Map its channels again before it reports anything or appears on the dashboard; see Map a channel to a service;
- keeps its name, service type, alarm limits and notification settings;
- keeps its asset link and notification group unless they were deleted while it was archived.
Restoring does not restore acknowledgements or mutes that ended when the service was archived.
Rules for archived services¶
- An archived service cannot be edited, cannot receive channel mappings (Service is archived. Restore it before adding channel mappings.) and cannot be exported.
- Its alarm limits and notification settings cannot be changed, its bands cannot be removed, and it cannot be muted, including through the API; each of these is refused as Service not found. Restore the service first.
- An archived service's page shows Service not found or not authorized for every role.
- Its channels may already have been mapped to another service. Restoring does not take them back; if you remap them, remove them from the other service first.
- Only organization administrators of the service's organization can archive or restore it.