Skip to main content
Feedback

Viewing the audit log

Updated 
note

Knowledge Hub is an Early Access release. Refer to the Early Access disclaimer for details.

Knowledge Hub records each significant change to its repositories, Knowledge Bases, sources, and source mappings in the Boomi platform audit log. Knowledge Hub does not store the audit history or provide an audit screen of its own. It publishes each change to Boomi Bus, and the platform records it. You read your Knowledge Hub change history on the platform audit page or through the AtomSphere Audit Log API.

What gets recorded

Recording is automatic. There is nothing to configure. Each event includes the actor, the action, the entity, the account, and the timestamp.

EntityRecorded events
RepositoryCreated, Updated, Enabled or Disabled, Deleted
Knowledge BaseCreated, Updated, Enabled or Disabled, Deleted
SourceCreated, Updated, Enabled or Disabled, Deleted
Source mappingCreated, Updated, Enabled or Disabled, Deleted

Recording does not slow down your change. If publishing an event to the platform fails, Knowledge Hub retries until it succeeds.

Actions that record more than one event

A single action can change more than one entity. Knowledge Hub records an event for each affected entity. The events share the actor and timestamp, but the platform does not link them. Only two actions do this:

User actionEvents recorded
Creates a knowledge base schema from the source mapping flowKnowledge Base Updated, Source Mapping Created
Deletes a knowledge base schemaKnowledge Base Updated, Source Mapping Disabled, Source Disabled

When you save and publish in one sequence, Knowledge Hub records the events for the resulting changes. It does not record an event for each intermediate save or draft state.

What is not recorded

The audit log records configuration changes only. Ingestion runs, job execution, and job failures are not recorded. Read and retrieval access to a Knowledge Base is also not recorded. These events appear in activity logs instead. For ingestion history, refer to Viewing Knowledge Base activity. The audit log does not record whether a change came from the UI or the API.

Reading the audit log

During Early Access, only users with the Administrator role can view the audit log. Refer to Access and permissions overview.

You can read Knowledge Hub audit entries in two ways:

  • Platform audit page: Review entries interactively in the Boomi platform.
  • AtomSphere Audit Log API: Read change history programmatically with the Audit Log object. Filter results with the Audit Log query. For the Platform API reference, refer to AuditLog.

The platform audit log is shared across Boomi products. Use the Audit Log query to return only Knowledge Hub entries. For the Knowledge Hub filter values, refer to Audit log query types.

Retention and export

Audit entries follow the Boomi platform retention policy, which keeps them for one year. To keep history longer, export it from the platform for long-term storage.

On this Page