PingDirectory

Creating new log publishers

The server provides customization options to help you create your own log publishers with the dsconfig command.

When you create a new log publisher, you must also configure the log retention and rotation policies for each new publisher.

For more information, see Configuring Log Rotation and Configuring Log Retention.

Creating a new log publisher

Steps

  1. Use the dsconfig command in non-interactive mode to create and configure the new log publisher.

    Example:

    This example shows how to create a logger that only logs disconnect operations.

    $ bin/dsconfig create-log-publisher \
      --type file-based-access --publisher-name "Disconnect Logger" \
      --set enabled:true \
      --set "rotation-policy:24 Hours Time Limit Rotation Policy" \
      --set "rotation-policy:Size Limit Rotation Policy" \
      --set "retention-policy:File Count Retention Policy" \
      --set log-connects:false \
      --set log-requests:false --set log-results:false \
      --set log-file:logs/disconnect.log

    To configure compression on the logger, add the --set compression-mechanism: gzip option to the previous command.

    Because compression cannot be disabled or turned off after configured for the logger, plan carefully to determine your logging requirements, including log rotation and retention with regards to compressed logs.

  2. View log publishers with the following command.

    $ bin/dsconfig list-log-publishers

Creating a log publisher using dsconfig interactive command-line mode

Steps

  1. In the command line, enter bin/dsconfig.

  2. Authenticate to the server by following the prompts.

  3. In the main menu, select the option to configure the log publisher.

  4. In the Log Publisher menu, select the option to create a new log publisher.

  5. Select the Log Publisher type.

    For this example, select File-Based Access Log Publisher.

  6. Enter a name for the log publisher.

  7. Enable it.

  8. Enter the path to the log file relative to the PingDirectory server root.

    For this example, logs/disconnect.log.

  9. Select the rotation policy to use for this log publisher.

  10. Select the retention policy to use for this log publisher.

  11. In the Log Publisher Properties menu, select the option for log-connects:false, log-disconnects:true, log-requests:false, and log-results:false.

  12. Enter f to apply the changes.