Log activity

📘

Note

The Activity API supersedes the deprecated ChangeLog API.

For example, changes to pages, blocks, and media items are logged as an Activity.

Activities are needed to support the project activity feed, mirroring, and other platform features, as well as providing a general short term auditing mechanism.

Activities are stored at least one month unless another platform feature has a dependency to certain activities, in which case they may remain for an additional period. Activities without remaining dependencies are archived or deleted by a scheduled job.

Archived activities are persisted for 12 months by default, but you can modify this by configuring the ArchiveRetentionPeriod property on ActivityOptions. (For CMS 10.9-11, add an activityArchiveRetentionPeriod attribute to the applicationSettings element in the web.config instead). The property value represents the number of months for which to retain activities in the archive.

• To disable archiving completely, set the value to 0.
• To disable the cleanup of the archive and let activities remain indefinitely, set the value to -1. You should not use this setting unless you put external safeguards in place.

You can retrieve archived activities only by using the IActivityQueryService.ListActivitiesAsync method, providing a query with the IncludeArchived flag set.

Administrators change log

The Change Log is an interface for administrators to list recent activities in Optimizely. See Change Log.

Programming interfaces

The classes and interfaces for the Activities API are in the EPiServer.DataAbstraction.Activities namespace in the EPiServer assembly.

Related blog post: Activity log with custom content security activity