HOW TO

Enable the debug mode for Utility Network Package Tools in ArcGIS Pro

Last Published: July 19, 2023

Summary

In ArcGIS Pro, it is possible to enable the debug mode when troubleshooting Utility Network Package Tools errors by setting the logging level to ‘DEBUG’. When running a tool from Utility Network Package Tools, and it fails to execute, a pop-up is generated, with detailed information in the Messages section if the debug mode is enabled. This is helpful in identifying the causes for tool failure.

The following image shows the messages from the pop-up window before setting the logging level to 'DEBUG' when a tool fails to execute.

Image of the example of the messages from a pop-up window of a failed tool before setting the logging level

Procedure

Follow the instructions below to set the logging level to debug mode when troubleshooting a Utility Network Package Tools error in ArcGIS Pro.

  1. In ArcGIS Pro, click the Analysis tab on the top ribbon. Click the drop-down menu next to Python, and select Python Window.
Image of the selected Python Window
  1. In the Python window, insert the following commands:
import untools
untools.logger.setLevel('DEBUG')
Image of the commands in the Python window in ArcGIS Pro
  1. Press Enter.
  2. In the Geoprocessing pane, run the desired tool from Utility Network Package Tools. If the tool fails, click View Details on the progress bar to view the tool's execution details.

The following image shows the messages from the pop-up window after setting the logging level to 'DEBUG' when the tool fails to execute.

Image of the example of the messages from a pop-up window of a failed tool after setting the logging level

Article ID: 000024444

Software:
  • ArcGIS Solutions
  • ArcGIS Pro 2 x

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