Skip to main content

Object History (Audit Logs)

Every change made to Device42 Configuration Items (CIs), via the user interface, autodiscovery jobs, RESTful API calls, or imports, is recorded as history.

This section discusses how to view and filter audit logs and exclude object categories (models) from being logged.

The Audit Log List Page

Go to Analytics > Audit Logs > History to view the audit history. Use the search bar on the right to find changes made by a specific user or source.

History (audit log) list pageHistory (audit log) list page

Click the gear icon to customize the columns displayed in the table. By default, the following columns are included:

  • Type: Indicates the category of the object that was changed (for example, Device, Global Settings, Application Group, Contract, and so on).
  • Object: Displays the specific object that was changed. Click an object to filter the table by that object.
  • Changed: Shows what was added and what was changed. For database objects, the database ID of the object is shown.
  • Action: Displays the type of action that was logged (for example, Insert, Delete, Update, View, Login, API).
  • Origin: Shows the source of the change (for example, UI, API, Task, and Internal).

Apply filters to narrow down the results displayed in the table. Use the Action Date/Time dropdown to limit the results to a specific duration or date range.

The User, Type, Action, and Origin dropdown menus are included in the UI by default. To add additional filters, click the More Filters button.

Use the Advanced button to query the audit logs by properties such as object_id and action_id.

Click on the gear icon to save the filters you've applied for quick access later or to save the view as the default view.

Dropdown filtersDropdown filters

Export as CSV

Select the columns you want to export, and use the Export Selected Columns as CSV action or the ellipsis icon to the right of each record to export the selected records in CSV format.

Action dropdownAction dropdown

View History for Individual Objects

In addition to this centralized audit log, you can access the history of an individual object from its view or edit pages.

  • For discovery job objects, use the ellipsis icon to access the history log for each object.

    Object history buttonObject history button

    The default view for history logs is Direct Only. To see the changes made to related data, such as the IPs of a device, change the filter option to All or Related Only.

    Object history filterObject history filter
  • Objects like devices and IP addresses have the Audit Logs tab on their view pages and also include the Related dropdown filter option mentioned above.

    Object history filterObject history filter

Audit Log Exclusions

You can turn off history tracking for object categories. Navigate to Tools > Settings > History (Audit Log) Exclusions and click Edit.

Select one or more object categories from the Available Models and use the arrow button to add them to the Excluded Models box.

Select exclusions interfaceSelect exclusions interface