Audit Logs (Preview)

Audit logs are created in m3ter whenever an entity in your Organization is created, updated, or deleted. The new Audit logs service makes available a full historical audit trail for entities in your Organization.

On the Audit logs page in the m3ter Console you can quickly set up and perform queries and retrieve logs:

• Time Period:
  • Select from predefined time period options or specify a custom time period.
  • The maximum time period for a query is 31 days.
  • The query returns audit logs for the selected period.
  • The default time period when the Audit logs page opens is the current month.
• Query Filters:
  • Entity type. The type of entity you want to return audit logs for.
  • Entity ID. The specific entity you want to return audit logs for.
  • Modified by. Who or what you want to return audit logs for: User, Service User, or System.
  • Event type. The type of audit event you want to return audit logs for: created, updated, or deleted. If left blank, logs for all audit event types are returned.

When you perform a query, any logs satisfying the query are loaded into the Audit logs page and you can:

• Expand logs and review their details.
• View the entity JSON for logs and compare the current with the previous version.

You can also access audit logs for specific entities using a text link provided on Console entity details pages This opens the Audit logs page directly and automatically performs a query to return the entity’s most recent audit logs.

This topic explains how to work with the Audit logs feature to configure and perform queries and review details of logs returned:

• Building and Performing Audit Logs Queries
• Reviewing Audit Logs Details
• Viewing Audit Logs JSON
• Opening Audit Logs from Entity Details

Notes and warnings:

• Audit Logs Processing Delay! The Audit logs loading process takes approximately 5 minutes before logs becomes available for querying.
• Audit Logs in Preview Release. Please note that the Audit logs feature is currently a Preview feature. See Feature Release Stages for Preview feature guidance.

​

Building and Performing Audit Logs Queries

You can quickly set up and perform queries to return audit logs for your Organization’s entities.

To build and perform an audit logs query:

1. In the Console main top navigation bar, select Audit logs:

The Audit logs page opens.

2. Select the calendar icon for Modified at (inclusive):

3. Define the time period for your query:

• Six pre-defined time period options are available and the default period is This month.
• If you want to use a custom period, use the calendars to select inclusive start and end dates.

Maximum Time Period! The maximum time period you can use for querying audit logs is 31 days.

4. Use the query filters to return the audit logs you want to review and then select Perform query:

• For example, you can return all logs for a specific Entity type:

In this example, logs for every Account and all audit Event types are returned.

Note that text hotlinks are provided for each audit log under Entity ID and Modified by, which allow you to open either the Entity details or User details page directly.

• Alternatively, you can use the Modified by to return logs for all audit Event types linked to a specific Organization user:

Important! In addition to a time period, your must select either an Entity type or Modified by filter. If you try to perform a query with only a time period selected, you’ll receive an error.

• You can use the Event type filter to show only logs of a specific type:

In this example, only the logs for the CREATED Event type linked to the selected user are returned.

• If you want to filter your query by Entity ID, you must also select the relevant Entity type:

In this example, a single audit log is returned for a specific Account.

Caution! If you enter mismatched Entity ID and Entity type - for example a Meter ID but select Account for type - then this mismatch will not be caught and no error will show.

​

Reviewing Audit Logs Details

When you have built and performed a query that returns the audit logs, you can expand logs to review details.

To review audit logs details:

1. In the Console main top navigation bar, select Audit logs. The Audit logs page opens.
2. Build and perform a query that returns the audit logs you want to review.
3. Use the arrow on the left side of an audit log record to expand it:

In this example, a CREATED audit log is expanded:

• The entity type is shown together with Total fields created on the entity.
• You can then expand individual fields to reveal their values.

The details given depend on the audit log type.

4. If you expand an UPDATED audit log, a breakdown of the updates is given:

• Total changes
• Fields created
• Fields updated
• Fields deleted

You can then expand an individual change to reveal details:

5. If you expand a DELETED audit log, you can use a view JSON link to show the last version of the entity prior to its deletion:

​

Viewing Audit Logs JSON

In addition to reviewing log details in the Audit logs page, you can also quickly open a modal screen to view a log’s JSON.

To view audit logs JSON:

1. In the Console main top navigation bar, select Audit logs. The Audit logs page opens.
2. Build and perform a query that returns the audit logs whose JSON you want to view.
3. Select the view JSON icon at the right side of an audit log:

Alternatively, if you’ve expanded an audit log to review its details, select View JSON:

A modal opens:

In this example, the JSON for a CREATED audit log shows the Current version of the entity.

4. If you view JSON for an UPDATED audit log, the Current version and Previous version are shown for comparison and changes highlighted:

In this example, a Meter was updated to add a new Data Field and this change is highlighted in green. Any fields changed for the update are identified and highlighted in blue.

5. If you view JSON for a DELETED audit log, the Previous version of the entity is shown:

​

Opening Audit Logs from Entity Details

You can access audit logs for specific entities using a text link provided on entity details pages. This opens the Audit logs page directly and automatically performs a query to return the entity’s most recent audit log.

To open audit logs from entity details pages:

1. In the Console, open the details page of the entity you want to open audit logs for.
2. Select View audit logs:

The Audit logs page opens:

In this example, the Audit logs page for a Meter was opened from its details page. Note that when the Audit logs page opens for an entity, a query is performed automatically to return the most recent audit log together with any other logs falling in the 30 day period prior to the date of the most recent log.