---
title: Logging, reporting, and troubleshooting
description: This section provides an overview of the available logging, reporting, and troubleshooting features for PingFederate.
component: pingfederate
version: 13.1
page_id: pingfederate:pingfederate_monitoring_guide:pf_logging_reporting_troubleshooting
canonical_url: https://docs.pingidentity.com/pingfederate/13.1/pingfederate_monitoring_guide/pf_logging_reporting_troubleshooting.html
llms_txt: https://docs.pingidentity.com/pingfederate/llms.txt
docs_for_agents: https://developer.pingidentity.com/build-with-ai/docs-for-agents.md
revdate: December 11, 2023
section_ids:
  pingfederate-logs: PingFederate Logs
---

# Logging, reporting, and troubleshooting

This section provides an overview of the available logging, reporting, and troubleshooting features for PingFederate.

## PingFederate Logs

The `server.log` file represents the primary troubleshooting log. Along with an HTTP trace from the browser, which can be generated from a debugging application like Fiddler, this file is helpful for identifying issues that must be resolved. The following table identifies the available PingFederate logs and summarizes their purposes.

| Name                              | Purpose                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `admin.log`                       | Records the actions that users of the Administrative Console and the Administrative API perform.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `admin-event-detail.log`          | If detailed event logging is enabled, this log records detailed information about each applicable administrative event that users perform using the Administrative Console and the Administrative API.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `admin-api.log`                   | Records the actions that users of the administrative API perform.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `runtime-api.log`                 | Records the actions that API users perform by using the OAuth Client Management Service, the OAuth Access Grant Management Service, and the Session Revocation API.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `transaction.log`                 | Records individual identity-federation runtime transactions at specified levels of detail.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| `audit.log`                       | Records a selected, configurable subset of transaction log information plus additional details. Intended for security-audit and regulatory-compliance purposes.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `provisioner-audit.log`           | Records outbound provisioning events intended for security-audit purposes.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| `provisioner.log`                 | Records provisioning activity only. Useful when troubleshooting issues that relate to provisioning.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `server.log`                      | Records PingFederate runtime and administrative server activities. For more information about the primary troubleshooting log, see [Creating an error-only server log](pf_create_error_only_server_log.html).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `init.log`                        | Records only Jetty messages that are generated prior to starting PingFederate.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `thread-pool-exhaustion-dump.log` | Contains log messages and stack traces of all threads in PingFederate's Java Virtual Machine (JVM) *(tooltip: \<div class="paragraph">&#xA;\<p>A virtual machine that allows a computer to run Java programs and programs that are compiled to Java bytecode.\</p>&#xA;\</div>)*, including Java threads and VM internal threads. This information can help with troubleshooting the root cause of potential thread exhaustion events. The format of the thread dumps can be consumed by utilities such as jstack that is included with a Java Development Kit (JDK) *(tooltip: \<div class="paragraph">&#xA;\<p>A development environment for building applications and components using Java.\</p>&#xA;\</div>)*.This log is written only if you enable the runtime notification for thread pool exhaustion events. For more information, see [Configuring runtime notifications](../administrators_reference_guide/pf_configuring_runtime_notifications.html). |
