---
title: Configure the audit service
description: Configure the PingIDM audit service by editing `audit.json` or using the legacy 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
llms_txt: https://docs.pingidentity.com/pingidm/llms.txt
docs_for_agents: https://developer.pingidentity.com/build-with-ai/docs-for-agents.md
keywords: ["Audit", "Logs", "Configuration", "Handlers", "Options"]
---

# Configure the audit service

|   |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| - | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|   | Configure audit settings in any of these ways:- Edit your project's `conf/audit.json` file.

- Use the [REST interface](../rest-api-reference/endpoints/rest-server-config.html), at the `openidm/config/audit` context path.

- Use the [legacy admin UI](../setup-guide/legacy-admin-ui.html).To view audit events, export your data using the [JSON audit event handler](configuring-topic-handlers.html#audit-json-handler) to a third-party audit framework, such as [Elastic Stack](https://www.elastic.co/elastic-stack). |

In the legacy 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
  ```
