稽核記錄

Admin and indexing operations are recorded in an audit log that can be queried via an Admin endpoint.

Only users who have the role admin.role.author can read the audit logs, see Project Configuration for more information.

Admin operations

The audit log stores information about the following successful Admin operations:

Name
Description
preview
When a page is previewed or removed from preview..
live
When a page is published or unpublished.
index
When a page is indexed or removed from the index..
cache
When a page is manually purged from the cache.
code
When code is synchronized from GitHub
sitemap
When a sitemap is rebuilt manually
form
When a sheet is prepared for data ingestion.

The following information about those operations is stored:

Name
Description
timestamp
Epoch when the operation took place.
duration
Time in milliseconds the operation took.
method
HTTP method used (POST or DELETE)
route
The operation that took place (see above).
path
The target path of the operation.
contentBusId
The internal content bus ID of the project.
owner
The GitHub owner of the repository.
repo
The GitHub repository name.
ref
The GitHub branch or tag affected.
user
User that made the change, missing if the request was not authenticated.
search
Query string of the URL requested

Indexing operations

The audit log stores information about the outcome of background indexing operations, namely:

Name
Description
timestamp
Epoch when the operation took place.
contentBusId
The internal content bus ID of the project.
changes
An array of strings describing what changed in the index.
errors
An array of strings containing errors that occurred while indexing.
unmodified
The number of index changes that did not change a row in the index.

Examples

Here are some examples of how common operations triggered via Sidekick will be reflected in the audit log:

Operation
Sidekick
Audit log
Preview
Preview button in editor
Reload button in preview environment
code language-none
method: POST, route: /preview
Publish
Publish button in preview, live or production environment
code language-none
method: POST, route: /live
Unpublish
Unpublish button in preview, live or production environment
code language-none
method: DELETE, route: /live
Delete
Delete button in preview, live or production environment
code language-none
method: DELETE, route: /preview
method: DELETE, route: /live
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab