ArcGIS Server Configuration

You can configure default settings that affect all your ArcGIS Servers, including remote servers. You can also edit settings for a particular ArcGIS Server instance, whether it is an agent server or a remote server. You can also add or remove a remote ArcGIS Server.

Intelligent Probing

Intelligent probing of services on an ArcGIS Server makes a distinction between active and inactive services. An active service is an ArcGIS service that is currently busy, and has at least one instance running. In the case of a service being active already, the collection interval for an ArcGIS service is always respected because the service is already in use. On the other hand, an inactive service, is an ArcGIS service that is not being used and has not received any traffic for some time. To prevent Analytics from adversely affecting this server’s performance, inactive services are only guaranteed to be checked every 24 hours - starting from the time that Analytics started. Depending on the total number of services and the number of clusters and sites in any given ArcGIS environment, services may be checked more frequently than every 24 hours.

The need to know which services are active or inactive has made it necessary to supply Analytics with administrator access credentials to each ArcGIS Server.

Multiple Log Directories and Time Zones

Analytics has the ability collect log files from multiple log directories by supplying a path that includes the domain name and server name. If the remote server that the directory is on is in a time zone that is not the same as the Analytics Hub server, you can specify the time zone that the server is in.

When ArcGIS Server is within a Cluster

Analytics recognizes when ArcGIS Servers are in an ArcGIS cluster and displays them under the cluster name in the Sidebar of the application. Analytics only needs access to one of the servers within an ArcGIS cluster to ascertain the name of the cluster and display it and the other clustered servers correctly in the Sidebar.

The second level in the Resource Panel represents the ArcGIS Server Cluster that the ArcGIS Server belongs to. The third level represents all the ArcGIS Server instances within that ArcGIS Server cluster. The second level of ArcGIS Servers is always the ArcGIS Server Cluster, even if it is a cluster with only one instance.

If Analytics is unable to detect the name of an ArcGIS Server Cluster, it uses the name of the server instead.

Add an ArcGIS Cluster

You can set up an ArcGIS Cluster for Analytics to monitor in the following ways:

Interactions between Analytics and Servers within a Cluster

When it comes to alarms or data collection, Analytics interacts with each individual server. For example, if a server triggers an alarm, it is reported as from that server without affecting any other servers in the cluster.

Collection of ArcGIS Server Log Data

In order for Analytics to collect log files from an ArcGIS Server, you must have logging turned on and the log level must be set to Verbose in ArcGIS Server Manager. For information on how to set logging levels, see Set ArcGIS Server Logging to Verbose.

It is possible to collect ArcGIS Server Log Data in the following ways:

If you are collecting logs from an ArcGIS Server that carries a heavy load, consider shortening the collection interval from the default in order to avoid falling behind on the collection of log data.

Default ArcGIS Server Settings

Collection Interval Settings

To change default collection interval settings, in Configuration, click ArcGIS Servers and edit the following:

If you have an ArcGIS Server that carries a heavy load, you can consider shortening the collection interval from the default to ensure that log data collection does not fall behind.

Alarms

You can override the default settings for the alarms that affect all ArcGIS Server instances and configure them to suite your own system.

On the Alarms tab:

Service Settings

Analytics is able to detect if an ArcGIS Server is in a cluster and take this into account in determining the load that the server can carry. Analytics assumes that a clustered ArcGIS Server has a greater capacity because the load can be distributed over the cluster.

You can change the Collection Interval for all the supported services that are found in ArcGIS Servers, Geocortex Essentials instances, ArcGIS Online, or Portals for ArcGIS. You can change these settings in Analytics under Portals, ArcGIS Servers, and Essentials. When you change the settings in any of these locations, it changes the settings for all the services in all the locations.

On the Service Settings tab:

Specific ArcGIS Server Settings

The degree that you can add or edit the settings for a specific ArcGIS Server depends on whether the server is a Hub server, an Agent server, or a remote server:

Enable or Disable Monitoring

You can enable or disable monitoring of an ArcGIS Server with the following procedure. When monitoring is disabled, Analytics will stop collecting information and stop checking alarms for this ArcGIS Server. This will also disable monitoring of this ArcGIS Server's services. Previously collected information can still be viewed in Analytics when monitoring is disabled.

To enable or disable monitoring an ArcGIS Server:

  1. In Configuration, click ArcGIS Servers.

  2. Click the name of the ArcGIS Server for which you want to enable or disable monitoring.

  3. Click at the top right.

Remove an ArcGIS Server

When you remove an ArcGIS Server, it no longer appears in Analytics and its collected information is no longer accessible.

If the ArcGIS Server has an Analytics Agent installed, uninstalling the Agent removes the ArcGIS Server from Analytics and all other resources found on that server; this is the preferred method to remove an ArcGIS Server found via an Agent. If the server is already decommissioned, you can remove the ArcGIS Server using the following method.

If the ArcGIS Server has an Analytics Agent installed and the ArcGIS Server is removed using the following method without the Agent being uninstalled, the ArcGIS Server will reappear in Analytics.

To remove an ArcGIS Server:

  1. In Configuration, click ArcGIS Servers.

  2. Click the name of the ArcGIS Server you want to remove.

  3. Click at the top right.

  4. Click OK.

Add a Remote ArcGIS Server

To add a remote ArcGIS Server:

  1. Open Analytics, and then click Configuration.

  2. At the bottom of the sidebar, click Add Resource, and then select ArcGIS Server.

  3. On the Setup tab, enter the following information:

    • Services URL: Type in the services URL to the remote ArcGIS Server, for example, https://YourHostName/arcgis/rest/services.

    • Authentication Type: Select the type of authentication you want to use. Different fields appear depending on your selection.

      • None: Select if the remote ArcGIS Server is not secured. You can also select None and return later and enter the correct authentication details.

        If you configure a valid services URL but do not select an authentication method, Analytics may collect information about the server but will not have access to all the information, including any secured services.
      • Token: Select if you use Token security.

        • Username: Enter the name of an account that has full access to the ArcGIS Server.

        • Password: Enter the password that belongs to the Username.

        • Token Provider URL:  In some cases, services use a token provider service for authentication. In these cases, you need to add the URL to the Token Provider service.

      • Windows Authentication: Select if you use Windows Authentication for security.

        • Username: Enter the name of an account that has access to the server.

        • Password: Enter the password that belongs to the Username.

        • Domain: Enter the domain that the user belongs to.

      • Portal: It is possible to federate ArcGIS Server with Portal for ArcGIS and in this case, all the authorization goes through the Portal. If you have federated, then you can select the Portal credentials to use for the ArcGIS Server.

        • Select Portal: Select the name of the federated portal whose security credentials you wish to use.

        • Add ArcGIS Portal: Select if you wish to add an ArcGIS Portal and use its credentials. Save the settings you have already added as you will see the following warning:

      • WinAuth + Token: Select if the remote ArcGIS Server uses two layers of security made up of Windows Authentication and Token security. You then need to enter the credentials for both a Windows-authenticated user and a Token-secured user. The fields are the same as those for Windows Authentication and Token above.

      • WinAuth + Portal: Select if the remote ArcGIS Server uses two layers of security made up of Windows Authentication and Portal security. If you select this option, you need to enter the Windows Authentication credentials and the name of the federated Portal whose credentials you wish to use.

        If the Portal is using Windows Authentication credentials, then ArcGIS Server’s Windows credentials must match the Portal’s Windows credentials.

        • Add ArcGIS Portal: Click to open a page where you can add an ArcGIS Portal in order to use its credentials.

      • Server Installed on: Specify the server that this ArcGIS Server is installed on. When you specify a server, Analytics can do the following:

        • Access the CPU and Memory process information for this ArcGIS Server in order to monitor its performance.
        • Use the access credentials of the specified server to access the configured ArcGIS Server logs.

        If you manually set the credentials for a Network Share, IIS or Tomcat log directory, those credentials will be used instead of the credentials of the server.

      • Administrative Settings: Use this option to enter credentials to access this ArcGIS Server Administrator Directory.

        To monitor services intelligently, Analytics needs administrator access credentials so that it can determine whether services are active or inactive at any given time.
        • Admin URL: Select either http or https and then paste in the URL to the ArcGIS Server Administrator Directory.

        • Username: Type in the Username of an account that has access to the ArcGIS Server Administrator Directory.

          This field does not appear if Authentication Type is set to Portal, as Analytics will use the Portal user credentials instead.

        • Password: Type in the password that belongs to the Username that has access to the ArcGIS Server Administrator Directory

          This field does not appear if Authentication Type is set to Portal, as Analytics will use the Portal user credentials instead.

    • ArcGIS Server Log Settings:

    • Network Share: You can use the Network Share option if you have already set up a remote server or if the log folder is on a remote server.

      • Add: To add multiple log directories, click Add.

      • Log Directory: To add each log directory, enter the path to the folder where the logs are kept. The path should contain the server name and the domain name.

        If you need to add specific administrator access credentials for this log directory, or it is in a different time zone, click the down arrow.

      • Credentials: If a remotely monitored server is linked to this ArcGIS Server via the Server Installed On option, the log directory is accessed using the credentials associated with the remote server.

        If there is no associated host server being monitored or you wish to use different credentials to access the log directory, fill in the following authentication fields:

        • Username: Type in the name of a user who has access to the specified log folder.

        • Password: Type in the password of the user.

        • Domain: Type in the domain that the user belongs to.

        • Timezone (Optional): Select the timezone where the remote server is located.

    • Admin URL: You can retrieve log files from the administrative REST endpoint of the ArcGIS Server but this method is slow and is not recommended. You need to provide the credentials to access the REST endpoint, which you enter under Administrative Credentials.
      .
    • Web Server Log Settings:

      You can configure Analytics to collect either IIS or Tomcat web server log data remotely and send it to the Analytics Hub Server without installing Analytics on the remote machine. You achieve this by providing access to the specific folder containing the IIS or Tomcat web server logs. To access the log folder remotely via a network share, you need to specify the user credentials.

      If ArcGIS Server is installed on the same machine as an Analytics Hub or Agent, Analytics attempts to automatically detect the web server log directory. You can change the location of the log directory if you want to.

      If you are collecting logs in an environment using a web adaptor, the logs need to come from the server that the web adaptor is installed on.

      If you are not using a web adaptor, you cannot collect web server logs. This also means that you will not be able to collect data about tile requests.

    • IIS: Use this option if you want to collect IIS logs. Type in the path to the IIS log folder where the log files are kept. The path should contain the server name and the domain name.

      Analytics only supports the collection of WC3 format for logs.
      • IIS Log Directory: Type in the path, including the server and domain name, to the folder that contains the IIS logs on the remote server.

      • Add: To add multiple log directories, click Add and enter the path to each directory.

        If you need to add specific administrator access credentials for a log directory, or it is in a different time zone, click the down arrow beside that log directory.

      • Credentials: If a remotely monitored server is linked to this IIS server via the Server Installed On option, the log directory is accessed using the credentials associated with the remote server.

        If there is no associated host server being monitored or you wish to use different credentials to access the log directory, fill in the following authentication fields:

        • Username: Type in the name of a user who has access to the specified log folder.

        • Password: Type in the password of the user.

        • Domain: Type in the domain that the user belongs to.

        • Timezone (Optional): Select the timezone where the remote server is located.

    • Tomcat: Use this option if you want to collect Tomcat logs. Type in the path to the Tomcat log folder where the log files are kept. The path should contain the server name and the domain name.
      • Tomcat Log Directory: Type in the path to the folder that contains the Tomcat logs on the remote server. You must include the server name and the domain name in the path.

      • Add: To add multiple log directories, click Add and enter the path to each directory.

        If you need to add specific administrator access credentials for a log directory, or it is in a different time zone, click the down arrow beside that log directory.

      • Credentials: If a remotely monitored server is linked to this Tomcat server via the Server Installed On option, the log directory is accessed using the credentials associated with the remote server.

        If there is no associated host server being monitored or you wish to use different credentials to access the log directory, fill in the following authentication fields:

        • Username: Type in the name of a user who has access to the specified log folder.

        • Password: Type in the password of the user.

        • Domain: Type in the domain that the user belongs to.

        • Timezone (Optional): Select the timezone where the remote server is located.

  4. Click Save.

    A message indicates that the ArcGIS Server is being added. When the process is complete, the ArcGIS Server name appears in the sidebar under ArcGIS Servers and you can set more configuration options.

Specific ArcGIS Server Alarms

You can configure the default settings in the alarms for a specific ArcGIS Server as well as enable an ArcGIS service not currently monitored and configure alarms for the service.

For more information on how to set up and edit alarms, see Alarms , Alarm Types and Alarm Notifications.

For more information about enabling an ArcGIS Service alarm, see ArcGIS Services Alarm

ArcGIS, Reverse Proxies, and URL Substitution

If your ArcGIS Server is accessed using a Reverse proxy, or the URL to a particular server is not the same as the one that is configured in Analytics, you can add a Reverse proxy URL or alternate URLs on the URL Substitution tab for a specific ArcGIS Server.

On the URL Substitution tab, change the following: