Cómo funcionan los archivos de registro

ArcGIS Server escribe eventos que ocurren en el servidor y los errores asociados con esos eventos en los archivos de registro. Los eventos como por ejemplo el inicio de servicios, el uso de servicios (creación de contexto del servidor) y la adición de equipos al servidor se escriben en los registros. Los mensajes de bajo nivel, como los tiempos de dibujo de capa en un servicio de mapa, también se pueden escribir en los registros.

El monitor SOC de ArcGIS Server (ArcSOCMon.exe) es el lector/escritor de registros centralizado para ArcGIS Server. Una de las funciones de ArcSOCMon es registrar todos los eventos que se generan en el administrador de objetos de servidor (SOM), los contenedores de objetos de servidor (SOC) y los servicios que contienen.

Los registros son en general un conjunto de archivos: archivos XML y .dat coincidentes que residen en cada equipo en el sistema de ArcGIS Server. Los archivos XML contienen las etiquetas <log>, y los archivos .dat contienen los mensajes que se incorporan constantemente. El archivo XML se puede abrir en cualquier herramienta que admita XML para ver los mensajes en el archivo .dat.

Dado que los archivos de registro ahora se distribuyen entre todos los equipos de ArcGIS Server, puede resultar difícil leer y correlacionar manualmente los archivos de registro. Los archivos de registro se leen mejor con las aplicaciones del Administrador, pero también se puede obtener acceso a estos mediante la API de servidor (ArcObjects). Ambos métodos organizan los mensajes de registro cronológicamente sin importar qué equipos aportaron los archivos.

Por defecto, los archivos de registro se escriben en <ubicación_instalación>\server\user\log en cada equipo (en Windows), y en <directorio de instalación de ArcGIS Server>/user/log (en Linux/Solaris). Cada vez que se reinicia ArcGIS Server se crean nuevos archivos de registro y el servidor continúa escribiendo mensajes en esos archivos de registro hasta que alcanzan el tamaño de registro máximo.

Una vez que el archivo de registro supera el tamaño máximo, se retira y se crea un nuevo archivo de registro. Por defecto, el tamaño de registro máximo es 10 MB. Puede modificar este valor y también puede especificar la cantidad global de archivos de registro permitidos en el directorio de registros. Estas opciones de configuración están disponibles en la ficha General del cuadro de diálogo Propiedades de servidor en Administrador o ArcCatalog.

Los mensajes de registro pueden variar en cuanto al nivel de severidad desde Error (que indica un problema que requiere de atención inmediata) a Info: detallado (que es un mensaje común generado mediante el uso regular del servidor). El nivel de registro determina la cantidad y los tipos de mensajes que se escriben en el archivo. A continuación, se presentan los niveles de registro de ArcGIS Server:

Ninguno—Sin inicio de sesión.

Error—Problemas graves que requieren de atención inmediata.

Normal—Advertencias acerca de problemas que requieren atención y errores.

Info: simple—Mensajes administrativos comunes del servidor, incluidos los mensajes acerca de la creación de servicio. Este nivel también incluye advertencias y errores.

Info: estándar—Mensajes comunes del uso del servidor que se registran como máximo una vez por solicitud. Este nivel también incluye todos los mensajes, advertencias y errores de Info: simple.

Info: detallado—Mensajes frecuentes del servidor que se pudieron registrar varias veces por solicitud, como la notificación de que cada capa en un servicio de mapa se dibujó correctamente. Este nivel incluye todos los mensajes de Info: estándar e Info: simple, así como también advertencias y errores.

Detallado—Los desarrolladores de ArcGIS Server pueden utilizar este nivel para colocar mensajes de depuración al probar los objetos de servidor y las extensiones de objetos de servidor que desarrollaron. Incluye todos los mensajes, advertencias y errores de nivel de información.

Por defecto, el nivel de registro del servidor se establece en Info: simple, lo que significa que se registran los mensajes cuya severidad es Error, Normal o Info: simple. No se registran todos los mensajes cuyo nivel es Info: estándar o Info: detallado.

Puede cambiar la ubicación de registro, el tamaño de registro máximo y el nivel de registro cuando lo desee mediante el Administrador, ArcCatalog o la API de servidor. Cualquier cambio que realiza se refleja inmediatamente en el servidor.

Si configura una instalación distribuida de ArcGIS Server (donde los componentes del servidor se ejecutan en más de un equipo), puede elegir compartir el directorio de registro y hacer referencia a este mediante una ruta UNC (por ejemplo, \\myServer\log) o puede utilizar una ruta local al mismo directorio de registro en cada equipo. También debe asegurarse de que la cuenta SOC tenga permisos de Lectura y Escritura en el directorio de registro.

Explore:

Para eliminar manualmente un archivo de registro, debe detener el proceso de ArcSOCMon.exe en el equipo que está escribiendo el archivo de registro. Esto se aplica incluso cuando escribe archivos de registro en una ubicación compartida. El nombre del archivo de registro contiene el nombre del equipo SOC que escribió el archivo (precedido por el nombre del equipo SOM).

Utilizar archivos de registro como herramienta administrativa

Los archivos de registro son una herramienta importante para controlar y solucionar problemas con el servidor SIG. Los administradores de servidor SIG controlan las estadísticas del servidor y utilizan las estadísticas para ayudar a determinar cuándo necesitan consultar los archivos de registro. Las estadísticas del servidor SIG brindan información general del estado del servidor SIG y de si se producen errores. Las estadísticas están disponibles para los administradores de servidor a través de ArcCatalog.

A través de los informes y las estadísticas del servidor SIG de los usuarios del sistema, los administradores enfrentan errores y otros problemas que surgen en el sistema. Los archivos de registro brindan la información para identificar cuáles son los errores y, a través de la información en el registro, sugieren qué se debe investigar para solucionar el problema.

Por ejemplo, un administrador puede ver las estadísticas de servidor y detectar que hubo errores asociados con la creación de nuevos servicios en el servidor. Al examinar más las estadísticas, el área del problema se puede limitar a un equipo de contenedor de objetos de servidor en particular. La información en el archivo de registro se puede utilizar para determinar qué errores se registraron y para descubrir, por ejemplo, que el equipo contenedor de objetos de servidor en donde se produjeron los errores no obtuvo acceso al directorio de salida. Con esta información, el administrador puede rectificar el problema de acceso al directorio, utilizar las estadísticas y los archivos de registro para determinar si se produce el error nuevamente.

Los archivos de registro consisten en un historial de las estadísticas y los eventos que se produjeron en el servidor con el paso del tiempo. Las estadísticas del servidor están en la memoria y son resúmenes acumulados de intervalos de tiempo desde que se inició el servidor SIG. La granularidad de estos intervalos de tiempo es más gruesa a medida que retrocede en el tiempo. Las estadísticas también se eliminan cuando se detiene el servidor. Los registros del servidor SIG mantienen un registro de todos los eventos en el servidor y no se eliminan cuando el servidor se detiene.

Archivos de registro en flujos de trabajo de seguridad

Si habilitó la seguridad en el servidor SIG, verá una etiqueta adicional en los mensajes de registro que informa qué usuario presenta la solicitud. Esto puede ayudar a rastrear la actividad de usuario individual en el servidor SIG.