Skip To Content

Understand organization logs

ArcGIS Enterprise records events that occur, and any errors associated with those events, to logs. Logs are an important tool for monitoring and troubleshooting problems with your organization. Information in the logs will help you identify errors and provide context on how to address problems. The logs also comprise a history of the events that occur over time.

For example, the following events are recorded in the logs:

  • Installation and upgrade events, such as authorizing the software and creating the portal
  • Publishing of services and items, such as hosted services, web maps, and data items
  • Content management events, such as sharing items, changing item ownership, and adding, updating, moving, and deleting items
  • Security events, such as users signing in to the organization; creating, deleting, and disabling users; creating and changing user roles; updating HTTP and HTTPS settings; importing and exporting security certificates; and updating the portal's identity store
  • Organization management events, such as adding and configuring groups; adding or removing users from a group; configuring the gallery, basemaps, utility services, and federated servers; and configuring log settings and deleting logs
  • General events, such as updating the portal's search index and restarting the portal

The following events are not recorded in the logs:

  • Users logging out of the organization
  • Federating and unfederating an ArcGIS Server site with your portal
  • REST requests to edit and query items

While you can query logs across ArcGIS Enterprise components from the Portal Administrator Directory, all event filters are not available to sever logs. For more filtering options, query server logs from ArcGIS Server Manager.

Install and upgrade logging behavior

When you install or upgrade ArcGIS Enterprise, each component's log level is set to Verbose. This means that very detailed messages are logged during the installation or upgrade process.

If you encounter a failure when installing or upgrading Portal for ArcGIS and want to review the logs to help you troubleshoot, determine whether you can access the Portal Administrator Directory. If you can, query the logs and review the messages. If not, review the log messages on disk. To access the logs on disk, browse to the logs directory and open the most recent log file (for example, <Portal for ArcGIS installation directory>/arcgisportal/logs/<machine name>/portal/portal-20150101.095803-8596-0.0.log). If necessary, you can share this information with Esri Support.

After the installation or upgrade process completes, the log level for each component is set to Warning by default. This means that only moderate to serious problems are logged. If a user reports a problem, you may need to change the log level to capture more fine-grained messages for that specific issue. To learn how to modify the level of logging, see Specify portal log settings and Specify server log settings.

Understand logs

All events record specific information, such as the log level type, the time at which the event occurred, the source component that logged it, the machine on which the event occurred, the user associated with the event, the log code, and process ID. All of this information can help you troubleshoot more effectively. The following sections explain this information in detail.

Log type

Logged events can vary in their level of detail from Severe, which indicates a problem that requires immediate attention, to Verbose, which is a detailed, informative message generated through regular use of the organization.

The following are the log level types:

LevelDescriptionSample message

Severe

Serious problems that require immediate attention. This level only includes severe messages.

The 'System/GPServer/PublishingTools' service is stopped or ArcGIS Server is not started. Verify these components are started and try again.

Warning

Moderate problems that require attention. This level also includes severe messages.

Organization updated: HTTP access disabled. The portal can only be accessed through HTTPS.

Info

Common administrative messages, including messages about organization settings being updated. This level also includes severe and warning messages.

User 'asmith' signed in to the portal.

Fine

Common messages from use of the organization, such as names of operations and requests received. This level includes severe, warning, and info messages.

Account settings updated.

Verbose

Messages providing more detail about how the organization fulfills operations and requests. This level includes severe, warning, info, and fine messages.

Setting log level to VERBOSE before creating new site.

Debug

Highly verbose messages designed for developers and support technicians who want to obtain a better understanding of the organization's state when troubleshooting. Don't use this level in a production environment; it may cause a decrease in performance. If you're not troubleshooting an issue, use the Warning level instead.

Failed to update index for item '44b37137e1f64de2bec832ab82043b86'.

Off

Logging is turned off. Events are not logged with the organization.

N/A

Message

This is the message associated with the logged event. Messages vary in their level of detail based on the log level type.

Time

The time at which the logged event occurred. Events are organized chronologically, with the most recent event displayed first. The time format is yyyy-mm-ddThh:mm:ss.

Source

The events logged in the portal are of one of the following sources:

  • Sharing—Events related to publishing and users.
  • Portal Admin—Events related to security and indexing.
  • Portal—Events related to installing the software.

The source of events logged in a server can be a service or the server. Events associated with services display the name and service type as the source property. Events associated with the server display the framework component name that logged the message as the source property.

The following are examples:

  • An event related to the SampleWorldCities map service appears as SampleWorldCities.MapServer.
  • After successfully creating a server cluster in your site, Admin displays as the component that logged the message.

Machine

The machine on which the event occurred.

User

The name of the user who submitted the request resulting in the log message. This property is useful to help you track individual user activity when security is enabled.

Code

The log code associated with the message. The codes are organized into several categories with specific ranges and content.

The following table contains portal log codes. To review server log codes, see Log codes.

CategoryRangeMessage content

Publishing

200000–201999

Publishing and deleting hosted services.

Content management

202000–203999

Adding, removing, updating, and moving items.

Changing item ownership.

Sharing items with everyone, the organization, and groups.

Security

204000–205999

Built-in or organization-specific user log in.

Portal token generation and configuration.

Disabling and enabling account sign up.

Disabling and enabling the ArcGIS Portal Directory.

Importing or exporting a security certificate.

Creating, deleting, and disabling users.

Changing user role privileges.

Creating and deleting custom roles.

Disabling and enabling HTTPS and anonymous access.

Updating the identity store.

Organization management

206000–207999

Customizing the organization home page.

Configuration of the gallery, basemaps, display units, utility services, and federated servers.

Creating and deleting groups.

Adding users to a group and removing users from a group.

Invite users to a group or accepting an invitation to a group.

Configuration of ArcGIS Pro licenses.

ArcGIS Web Adaptor configuration.

Modifying the location of the portal content directory.

Configuring forward and reverse proxy servers.

Exceeding the number of named users authorized for the portal.

Editing log setting and deleting logs.

Installation and upgrade

208000–209999

Installing and upgrading the software, creating the portal website, and authorizing the software.

Search index

210000–211999

Generating the portal's item search index.

General

212000–219999

Restarting the portal.

Configuring a highly available portal.

Other general messages generated through regular use of the portal.

Process

The machine process ID that logged the event.

Request ID

The unique ID string attached to every request upon submission, which is carried throughout the request's life cycle in the system.