---
title: Configure the audit service
description: Configure the PingIDM audit service by editing `audit.json` or using the admin UI to set up audit event handlers, event logging, and query options
component: pingidm
version: 8.1
page_id: pingidm:audit-guide:configure-audit-service
canonical_url: https://docs.pingidentity.com/pingidm/8.1/audit-guide/configure-audit-service.html
keywords: ["Audit", "Logs", "Configuration", "Handlers", "Options"]
---

# Configure the audit service

You access the audit logging configuration over REST at the `openidm/config/audit` context path and in the `conf/audit.json` file. To configure the audit service, edit the `audit.json` file or use the admin UI. Select Configure > System Preferences, and click the Audit tab. The fields on that form correspond to the configuration parameters described in this section.

You can configure the following major options for the audit service:

* Which audit handlers are used

  [Audit event handlers](configuring-topic-handlers.html) are responsible for handling audit events. They are listed in the `availableAuditEventHandlers` property in your `conf/audit.json` file.

* Which handler is used for queries

  You *must* configure one audit event handler to manage [queries](audit-queries.html) on the audit logs.

* What events are logged

  The [events](audit-log-topics.html) that are logged are configured in the `events` list for each audit event handler.

* Track transactions across products

  If you use more than one Ping product, you can specify that a common `transactionId` be used to track audit data across products. Edit your `conf/system.properties` file and set:

  ```
  org.forgerock.http.TrustTransactionHeader=true
  ```