Home > User Interface > Auditing > Admin API Audit Logs

Admin API Audit Logs

This page provides a display of the logs related to A3 administrative tasks, invoked by an application programming interface (API). Most of the fields are for use by support personnel.

The general format and usage of this page is discussed in General GUI Usage.

The elements of the page are:

Admin API Audit Logs
Advanced Search

Admin API Audit Logs

The view offers selectable columns (with the select columns icon symbol); the initial default columns are:

Created At
User Name
Action
Object Id
Status

Admin API log entries can be searched with a Simple Search or Advanced Search, based on the position of the select advanced slider. Simple searches consist of a search by user name, action, or object id, whereas advanced searches use multiple search conditions.

Clicking on any entry displays information about that log entry, as discussed in DNS Log Entry.

Admin API Log Entry

The DNS log entry columns that can be selected with the select columns icon icon are shown below. Selecting an individual log entry will display the data for that entry in three tabs:


Label	Usage
Created At	The date and time at which the log entry was made.
ID	A unique identification number, incrementing with each API usage
User Name	The name of the administrator logged in during the API request.
Action	The internal action performed. For example, api.v1.Config.Bases.resource.update is used to indicate a saved configuration parameter update.
Object Id	The ID of the item being updated.
URL	The specific file modified.
Method	The method used to modify the resource. For example, PATCH indicates a change within the file.
Status	The returned status of the API call. For example, 200 indicates success.

Simple Search

The simple search choice offers a straightforward means of searching user entries:

Type any text into the Search by user name, action or object id box and press the button. Any client entry whose user name, action or object id contains the text will be displayed in the list.
The search box and the listing are reset back to the complete list via the button.
Export to CSV - the results of the current search are saved to a file named adminlogs.csv. Previous output is not overwritten; new versions are labeled admin_api_audit_logs(1).csv, admin_api_audit_logs(2).csv, etc.

Advanced Search

Select the select advanced slider to access the advanced searches page. Multiple or conditions are joined together with and conjunctions. Each element of an or set can be deleted with the delete icon symbol or reordered by selecting the item's grid icon symbol. Reordering can occur across or sets.

Several facilities exist for saving and using saved searches:

In the drop-down:
- Use the Save Search choice to name and save the current search conditions.
- Previously saved searches are available in the list as well.
- Saved searches will be listed along the left-hand edge of the screen.
- The search terms can also be exported or imported in JSON format.
- the results of the current search are saved to a file named admin_api_audit_logs.csv. Previous output is not overwritten; new versions are labeled admin_api_audit_logs(1).csv, admin_api_audit_logs(2).csv, etc.

Each condition has three parts:

Log entry property - one of the characteristics of the log entry. Choose from the full list of elements in the drop-down list.
Compare operation - one of:
- is - matches the comparison string
- is not - does not match the comparison string
- starts with - starts with the comparison string
- ends with - ends with the comparison string
- matches - the user element is matched against a regular expression (regexp). Regexp is a powerful language for expressing string matches. An introduction to regexps is found here. A simple search is the equivalent of using the matches operation with the equivalent text.

Comparison string or choice - the string or choice to match against or use as a regular expression.