The geoprocessing tools you run are logged and saved with your project. You can view detailed information about each tool that was run and reopen the tool with the same settings you previously used. Geoprocessing history will help you be more productive and allow you to better understand the processes that created the data and layers in your project.
When you run any geoprocessing tool, an entry is added under the Geoprocessing tab in the History pane. To access history for geoprocessing tools, on the Analysis ribbon, in the Geoprocessing group, click the History button .
Each history entry maintains detailed information about the tool, including the following:
- The tool input, output, and other parameter settings.
- Any custom geoprocessing environment settings.
- When the tool was run, when tool execution finished, and how long it took to execute.
- Whether the tool completed successfully or failed.
- Any information, warning, or error messages.
- Links to output reports or files, such as PDF or HTML documents. When clicked, these files will open in your default system application for the file type.
If you open the project at a later time to continue your work, all of the geoprocessing tools you previously ran in the project will be available to review in geoprocessing history. You can reopen and run any of the tools in the history by double-clicking the entry, or right-click and select Open.
You can remove any history entries that you do not want to keep in your project. Select any entries you want to remove, then right-click and select Remove. Single or multiple selected history entries can also be removed using the Remove button located at the top of the history entries list.
Tools in your project geoprocessing history can be marked as a favorite, which pins the tool to the top of the geoprocessing history Favorites section. Right-click a tool and select Add To History Favorites to add it to the Favorites section. Tools marked as a favorite will be listed in the Favorites section and will also continue to appear in the main geoprocessing history view according to the selected sorting method.
To remove a tool marked as a favorite, right-click the tool in the Favorites section and select Remove From History Favorites .
You can apply the following filters to geoprocessing history using the Filter pull-down menu :
- Type—Local, Portal
- Status—In Progress, Completed, Failed
- Input Layer—A list of the layers used as input by all tools in history
To filter history, follow these steps:
- Open the History pane and select the Geoprocessing tab .
- Click the Filter pull-down menu .
- Expand the filter type you want to specify.
- Check or uncheck boxes to display or hide tools in the geoprocessing history using the filter.
You can use the Select All check box at the top of the Filter menu to check or uncheck all filters. After unchecking all filters, check a type, status, or input layer to see the geoprocessing history entries that match that filter.
Automate geoprocessing using history
You can use the geoprocessing tools run from the Geoprocessing pane as a starting point to automate your work with ModelBuilder or Python.
Geoprocessing history entries can be dragged onto a ModelBuilder view. The tools and all parameter settings will be added and connected in the model. You can also right-click history entries and select Add To Model, and the tools and all data required to run the tools will be added to an open model. If no model is open, a model will be created in the project toolbox. You can select multiple history entries and add them to a model to build a connected chain of processes in the model, where the output of one tool may feed into another tool as input.
Geoprocessing history items can also be converted to Python. Right-click any history entry and select Copy Python command to copy the geoprocessing tool command as Python code. You can also send Python code to the Python window using the Send To Python window command or by dragging and dropping the history item. History items can also be saved as a Python script (.py) that contains all of the selected tools in History using the Save As Python Script command.
If any geoprocessing environments were in use when the tool was executed, the environment will be included in the Python code using the arcpy.EnvManager class.Learn more about running geoprocessing tools in Python
Share your analysis
Geoprocessing history plays a key role when sharing your analysis as either a geoprocessing package or a web tool. Any analysis you want to share must first have been run successfully and logged in your geoprocessing history.
Geoprocessing logging options
The following geoprocessing options control how the geoprocessing tools you run are logged in geoprocessing history, external XML logs, and dataset metadata.
Write geoprocessing operations to Geoprocessing History
This option controls whether the tools you run are added to the current project's geoprocessing history.
- Checked—Every tool run is logged in the project's geoprocessing history. This is the default.
- Unchecked—Tools are not logged to geoprocessing history.
Write geoprocessing operations to an XML log file
This option controls whether information about all the geoprocessing tools you run is written to an external log file.
- Checked—XML log files are created in the directory %AppData%\Esri\ArcGISPro\ArcToolbox\History.
- Unchecked—XML log files are not created. This is the default.
Write geoprocessing operations to dataset metadata
This option controls whether geoprocessing tool input and output datasets' metadata is updated to include the tool name, parameters, when the tool was run, and other information.
- Checked—The dataset metadata contains a Geoprocessing history section with logging of the tools used with that dataset. This is the default.
- Unchecked—Dataset metadata is not updated.
You can view the Geoprocessing history section of dataset metadata in the FGDC metadata style.
Your software administrator may provide a default value for the option to write geoprocessing operations to dataset metadata; the administrator may also lock this value. If the setting is locked, a message appears on the Options dialog box. Learn more about geoprocessing history and metadata.