---
title: Enabling debug logging
description: To help with troubleshooting or monitoring, you can turn on activity logging for PingFederate, the Microsoft EAM IdP Adapter, or both.
component: microsoft-eam
page_id: microsoft-eam:troubleshooting:pf_ms_eam_enabling_debug_logging
canonical_url: https://docs.pingidentity.com/integrations/microsoft-eam/troubleshooting/pf_ms_eam_enabling_debug_logging.html
revdate: October 25, 2024
section_ids:
  about-this-task: About this task
  steps: Steps
  choose-from: Choose from:
---

# Enabling debug logging

To help with troubleshooting or monitoring, you can turn on activity logging for PingFederate, the Microsoft EAM IdP Adapter, or both.

## About this task

You can use logging for troubleshooting and analytics.

Learn more about logging in [Enabling debug messages and console logging](https://docs.pingidentity.com/pingfederate/latest/administrators_reference_guide/pf_enabling_debug_message_and_console_logging.html) in the PingFederate documentation.

## Steps

1. Open the `<pf_install>/pingfederate/server/default/conf/log4j2.xml` file for editing.

2. To log activity for PingFederate and all adapters:

   1. Find the following section:

      ```html
      <AsyncRoot level="INFO" includeLocation="false">
      	<!-- <AppenderRef ref="CONSOLE" /> -->
      	<AppenderRef ref="FILE" />
      </AsyncRoot>
      ```

   2. Change `INFO` to `DEBUG`:

      ```html
      <AsyncRoot level="DEBUG" includeLocation="false">
      	<!-- <AppenderRef ref="CONSOLE" /> -->
      	<AppenderRef ref="FILE" />
      </AsyncRoot>
      ```

   3. **Optional:** To see the adapter activity in the console, remove the comment tags that surround the `CONSOLE` line:

      ```html
      <AsyncRoot level="INFO" includeLocation="false">
      	<AppenderRef ref="CONSOLE" />
      	<AppenderRef ref="FILE" />
      </AsyncRoot>
      ```

3. To log activity relating to the Microsoft EAM IdP Adapter:

   ### Choose from:

   * To log activity for the Microsoft EAM IdP Adapter as well as its HTTPS and component activity, add the following line:

     ```html
     <Logger name="com.pingidentity.adapters.microsoft.eam" level="DEBUG"/>
     ```

   * To log activity for the adapter's HTTPS activity and other components but not for the adapter itself, add the following line:

     ```html
     <Logger name="com.pingidentity.adapters.microsoft.eam.shade" level="DEBUG"/>
     ```

   * To log activity for the Microsoft EAM IdP Adapter but not its HTTPS or component activity, add the following lines:

     ```html
     <Logger name="com.pingidentity.adapters.microsoft.eam" level="DEBUG"/>
     <Logger name="com.pingidentity.adapters.microsoft.eam.shade" level="INFO"/>
     ```

4. Save the file.