---
title: Configure the audit service
description: 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.
component: pingidm
version: 7.3
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"]
superseded_by: https://docs.pingidentity.com/pingidm/8.1/audit-guide/configure-audit-service.html
---

# 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 ForgeRock 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
  ```