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

Summary

When running processes within ArcGIS Enterprise, 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.

For more information on how the SDEINTERCEPT log file works, refer to the Esri knowledge base article, How To: Diagnose ArcGIS application database connection and performance issues using intercept log files.

Procedure

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

1. Ensure the application is not running.
   • ArcGIS Enterprise (Windows) - On the machine where ArcGIS Server is installed, stop ArcGIS Server.
     1. Right-click the Windows button > Run > type services.msc.
     2. Open the Services app.
     3. Locate ArcGIS Server and right-click > Stop, to stop the service.
   • ArcGIS Enterprise (Linux) - On the machine where ArcGIS Server is installed, stop the ArcGIS Server. Execute the stopserver script on the default installation location using the following command:

${HOME}/arcgis/server/stopserver.sh

• ArcGIS Pro and ArcMap - On the machine having either ArcGIS Pro or ArcMap installed, close the application if it is running.

2. Set up the variables for SDEINTERCEPT logging:

Note:
Ensure the target directory and folder exists with write access prior to creating the variable.

• For Windows operating system:
  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 2(iv) to create a new variable:

For Variable Name, type SDEINTERCEPTLOC. 
For Variable Value, type C:\temp\intercept_log.

7. Click OK and close the System Properties and Advanced System Settings windows.

• For Linux operating system, set up the following environment variables with either option i or ii:
  1. To create temporary environment variable (automatically deleted after the machine is logged out), use the following command in the shell terminal:

$ export SDEINTERCEPT=cwrTf
$ export SDEINTERCEPTLOC="<path to directory where the intercept files will be stored>"

2. To create a permanent environment variable, edit the configuration Environment file in /etc folder location and add the following parameters:

SDEINTERCEPT=cwrTf
SDEINTERCEPTLOC="<path to directory where the intercept files will be stored>"

3. Launch the application:
   • ArcGIS Enterprise (Windows) - On the machine where ArcGIS Server is installed, start ArcGIS Server.
     1. Right-click the Windows button > Run > type services.msc.
     2. Open the Services app.
     3. Locate ArcGIS Server and right-click > Start, to start the service.
   • ArcGIS Enterprise (Linux) - On the machine where ArcGIS Server is installed, stop the ArcGIS Server. Execute the startserver script on the default installation location using the following command:

${HOME}/arcgis/server/startserver.sh

• ArcGIS Pro and ArcMap - Launch the desired application.

4. 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.
5. 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 process.
   • For Windows operating system:
     1. Repeat Steps 1 through 2(iii).
     2. Delete the variables created in Step 2(iv) from the System Variable list.
   • For Linux operating system:
     1. For the permanent environment variable, edit the configuration Environment file in /etc folder location.
     2. Delete the variable created from the System Variable list.