HOW TO

Set up intercept log files on a machine running ArcGIS Pro or ArcMap

Last Published: June 23, 2025

Summary

When running processes within ArcGIS Pro or ArcMap against an enterprise geodatabase, errors or performance issues may arise that require troubleshooting. Setting up the intercept logs allows for logging the communication between the client application and the enterprise geodatabase. The generated log files contain detailed information about the performed operation along with any associated errors.

Note:
After troubleshooting the issue, remember to disable the trace by removing or altering the SDETRACELOC variable, this can consume considerable disk space and significantly affect geodatabase performance.

Procedure

The instructions provided below describe how to set up and generate SDEINTERCEPT log files on a machine running either ArcGIS Pro or ArcMap. 

  1. Ensure the application is not running. On the machine having either ArcGIS Pro or ArcMap installed, close the application.
  2. Set up the variables for SDEINTERCEPT logging.
    Note: Ensure the target directory and folder exists with write access before creating the variable.
    1. Open a Windows Explorer folder > right-click This PC on the left pane and click Properties.
    2. Scroll down and click Advanced System Settings.
    3. On the System Properties window, click the Advanced tab, and click Environment Variables.
    4. Under System variables, click New and type the following in the respective fields.
      Note: The values are case sensitive.
      • For Variable name, type SDEINTERCEPT
      • For Variable value, type crwTf
    5. Click OK.
    6. Repeat Step 2d to create a new variable:
      • For Variable name, type SDEINTERCEPTLOC
      • For Variable value, type the desired folder location to store the log file. For example: C:\temp\intercept_log
    7. Click OK to close the Environment Variables window, and close the System Properties and Advanced System Settings windows.
  3. Restart the machine.
  4. Launch the application, either ArcGIS Pro or ArcMap,
  5. Run through the workflow to reproduce the issue. Navigate to the specified target directory and folder of the intercept log file to verify and review the generated log file.
  6. Upon completing these diagnostics, repeat Steps 1 and 2 and delete the variables created in Step 2 from the System Variable list to stop all logging processes:
    1. Repeat Steps 1 through 2c.
    2. Delete the variables created in Step 2d from the System Variable list.

Article ID: 000032858

Software:
  • ArcGIS Pro 3 1
  • ArcGIS Pro 3 3
  • ArcGIS Pro 3 0
  • ArcMap 10 6
  • ArcGIS Pro 3 2
  • ArcGIS Pro 2 9x
  • ArcMap 10 7
  • ArcMap 10 8

Receive notifications and find solutions for new or common issues

Get summarized answers and video solutions from our new AI chatbot.

Download the Esri Support App

Related Information

Discover more on this topic

Get help from ArcGIS experts

Contact technical support

Download the Esri Support App

Go to download options