---
title: Creating File-Based Debug Log Publishers
description: PingAuthorize Server provides a File-Based Debug Log Publisher that can be configured when troubleshooting a problem that could occur during server processing.
component: pingauthorize
version: 11.1
page_id: pingauthorize:pingauthorize_server_administration_guide:paz_create_file_based_debug_log_pubs
canonical_url: https://docs.pingidentity.com/pingauthorize/11.1/pingauthorize_server_administration_guide/paz_create_file_based_debug_log_pubs.html
llms_txt: https://docs.pingidentity.com/pingauthorize/llms.txt
docs_for_agents: https://developer.pingidentity.com/build-with-ai/docs-for-agents.md
revdate: August 4, 2023
section_ids:
  creating-a-file-based-debug-log-publisher: Creating a File-Based Debug Log Publisher
  steps: Steps
  example: Example:
  deleting-a-file-based-debug-log-publisher: Deleting a File-Based Debug Log Publisher
  steps-2: Steps
  example-2: Example:
---

# Creating File-Based Debug Log Publishers

PingAuthorize Server provides a File-Based Debug Log Publisher that can be configured when troubleshooting a problem that could occur during server processing.

Because the debug data might be too large to maintain during normal operations, the Debug Log Publisher must be specifically configured and enabled. The Debug Log reports the following types of information:

* Exception data thrown by the server.

* Data read or written to network clients.

* Data read or written to the database.

* Access control or password policy data made within the server.

Use the `dsconfig` tool to create a debug log publisher.

|   |                                                                                                                                       |
| - | ------------------------------------------------------------------------------------------------------------------------------------- |
|   | You should only create a debug logger when troubleshooting a problem because of the voluminous output PingAuthorize Server generates. |

## Creating a File-Based Debug Log Publisher

### Steps

* To create the debug log publisher, use `dsconfig`.

  The `log-file` property (required) sets the debug log path. You must also specify the rotation and retention policy for the debug log.

  #### Example:

  ```shell
  $ bin/dsconfig create-log-publisher \
    --publisher-name "File-Based Debug Logger" \
    --type file-based-debug \
    --set enabled:true \
    --set log-file:/logs/debug \
    --set "rotation-policy:24 Hours Time Limit Rotation Policy" \
    --set "rotation-policy:Size Limit Rotation Policy" \
    --set "retention-policy:File Count Retention Policy"
  ```

## Deleting a File-Based Debug Log Publisher

### Steps

* To create the debug log publisher, use `dsconfig`.

  #### Example:

  ```shell
  $ bin/dsconfig delete-log-publisher \
    --publisher-name "File-Based Debug Logger"
  ```