Trabajar con registros del sistema
ArcGIS Enterprise on Kubernetes registra los eventos que se producen en su organización, y cualquier error asociado a esos eventos se registra en los registros. Los registros se pueden consultar desde ArcGIS Enterprise Manager o capturar mediante una solución de observabilidad de terceros.
Puede utilizar los registros para monitorizar y solucionar los problemas de su organización. La información de los registros puede ayudarle a identificar los errores y a proporcionar contexto sobre cómo resolver los problemas. Los registros también compilan un historial de eventos y patrones en el tiempo.
Utilizar Enterprise Manager
Al producirse un evento en el sitio, este se captura y graba en los registros. Para ver mensajes asociados al evento, consulte los registros. Para consultar y ver los mensajes actuales en su sitio, siga estos pasos:
Inicie sesión en ArcGIS Enterprise Manager como administrador.
Haga clic en el botón Registros en la barra lateral para revisar los registros actuales.
Algunos mensajes se devuelven junto con información adicional.
Todos los registros incluyen varios elementos de información sobre el evento. Puede ver y cambiar las columnas que muestran lo siguiente:
Fecha y hora del evento del registro
Nivel de registro del evento
Mensaje de registro
Origen del evento del registro
Id. de solicitud del evento de registro
Nombre de usuario asociado con el evento
Tipo de servicio en el que ocurrió el evento
Nodo en el que ocurrió el evento registrado
Códigos de registro relacionado con el evento
Seguimiento de pila del evento
También puede filtrar registros en función del tiempo, nivel de registro, origen, Id. de solicitud, nombre de usuario, tipo de servicio y código de registro.
Nota:
Si su organización no consigue recuperar los registros, compruebe el estado de salud del almacenamiento del sistema. Su organización no podrá acceder a los registros cuando el almacén espaciotemporal y de índices no esté en buen estado. Utilice Lens u otro IDE de Kubernetes para ver eventos de Kubernetes, comprobar los registros de sus pods administrativos y reiniciar los pods si es necesario.
Actualizar la duración de retención del registro
Puede establecer una política de retención de registros para los registros de su sistema. De forma predeterminada, los registros del sistema se conservarán durante 60 días antes de eliminarlos.
Para actualizar la duración del periodo de retención, realice lo siguiente:
Haga clic en Configuración en la página de Registros.
En la página Ajustes de registro, actualice la duración de retención del registro.
Haga clic en Guardar.
Eliminar mensajes de registro
Para eliminar mensajes de registro, realice lo siguiente:
En la página Registros, haga clic en el botón Eliminar
.En la página Eliminar mensajes de registro, tiene las opciones siguientes:
Seleccionar niveles de registro: seleccione uno o varios niveles de registro que desee eliminar.
Seleccionar periodo de tiempo: seleccione un periodo de tiempo a partir del cual desee eliminar los mensajes de registro.
Seleccionar periodo de tiempo personalizado: si está activado, seleccione un periodo de tiempo personalizado a partir del cual desee eliminar los mensajes de registro.
Haga clic en Eliminar.
Utilizar herramientas de terceros
Además de ser almacenados por ArcGIS Enterprise, los registros del sistema se transmiten a stdout (salida estándar). Esto le permite trabajar con los registros utilizando soluciones de observabilidad de terceros como Datadog o Splunk. Cada entrada de registro de stdout se emite como un objeto JSON estructurado independiente escrito en su propia línea utilizando JSON delimitado por nuevas líneas.
La siguiente entrada de registro de ejemplo ilustra el esquema utilizado por los registros de la aplicación, que tienen "eventType":"arcgis-logs". Los registros de auditoría de eventos relacionados con la seguridad se transmiten por separado a stdout con un esquema diferente.
{"date":1777073486.102182,"msgTimestamp":"2026-04-24T23:31:25,968","logLevel":"DEBUG","source":"Workflow Manager","logCode":"46300","processID":"1","threadID":"1","className":"WorkflowManager","msg":"Creating ArcGIS Client request for https://arcgis-rest-portal-api.arcgis.svc.cluster.local:8443/arcgis/sharing/rest/generateToken ","stackTraces":"\n","input":{"type":"log"},"log":{"file":{"path":"/arcgisusr/logs/arcgis_logfile.log"}},"fields":{"serviceTypes":"","deploymentID":""},"pod":"arcgis-workflow-manager-gkruq-6cff58b755-pnpq9","eventType":"arcgis-logs"}
Nota:
El campo date registra la marca de tiempo en la que se emitió el evento a stdout, mientras que el campo msgTimestamp registra el tiempo del evento de registro original.
Se puede acceder a los registros de stdout mediante el comando kubectl logs para recuperar los registros del contenedor fluent-bit dentro del pod de destino. Para obtener más información, consulte la documentación de Kubernetes sobre registros kubectl
Solución de problemas mediante registros
Si sospecha que experimenta un problema con un servicio o nodo, o un usuario informa de un problema, puede reproducir el evento, capturar el evento con los registros y consultar los registros para obtener información sobre el evento. A continuación, use la información en el registro para resolver el problema que ha causado el evento.
Si se sospecha o se informa de un problema, trate de reproducirlo. Si puede reproducirlo, consulte los registros pertinentes y revise los mensajes para obtener información que pueda resultar útil. Por ejemplo, si un usuario informa de un problema de rendimiento con un servicio web, reproduzca sus acciones y supervise los registros para comprobar qué está ocurriendo. Puede que encuentre un mensaje de error que indique la causa.
Si no hay información, aumente el nivel de registro. Esto amplía el rango de registros capturados y puede proporcionarle información útil.
Niveles de registro
Los eventos registrados pueden variar su detalle del nivel Severo, que indica un problema que requiere una atención inmediata, al nivel Detallado, que es un mensaje informativo detallado generado mediante el uso regular del servidor.
En la siguiente tabla se describen los niveles de registro:
|
Nivel de registro |
Descripción |
Mensaje de muestra |
|---|---|---|
|
Severe |
Han ocurrido problemas graves que requieren de atención inmediata. Este nivel solo incluye mensajes graves. |
No se pudo procesar la demanda. Servicio X no encontrado. |
|
Advertencia |
Han ocurrido problemas moderados que requieren atención. Este nivel también incluye mensajes graves. |
Error al iniciar sesión. Nombre de usuario o contraseña de administrador especificados no válidos. |
|
Información |
Mensajes administrativos comunes, incluida la información acerca de la creación e inicio del servicio. Este nivel también incluye mensajes de advertencia y graves. |
Acceso a la configuración de la cuenta de organización. |
|
Bien |
Los mensajes comunes incluyen información como los nombres de las solicitudes de operaciones recibidas. Este nivel también incluye mensajes graves, de advertencia y de información. |
Verificación de elementos vencidos. |
|
Detallado |
Los mensajes proporcionan más detalles sobre cómo la implementación cumplimenta una operación, como registrar que cada capa en un servicio de mapas se ha dibujado correctamente, con qué rapidez se dibujó la capa o el tiempo empleado para acceder a los datos de origen de la capa. Este nivel también incluye mensajes graves, de advertencia, de información y minuciosos. |
Inicio del dibujo de la capa: condados. |
|
Depurar |
Los mensajes se han diseñado para los desarrolladores y técnicos de soporte que busquen una mejor comprensión de la situación del problema durante la solución de problemas. Se recomienda no utilizar este nivel en un entorno de producción; ya puede causar una disminución en el rendimiento. Si no soluciona un problema, use el nivel Advertencia en su lugar. |
Limpieza de directorios. |
Actualizar el nivel de registro
Al trabajar con los registros del sistema en ArcGIS Enterprise Manager, es posible que tenga que aumentar el nivel de registro para capturar y revisar los eventos.
Puede ampliar la gama de registros que se registran. También puede examinar los registros relacionados con la creación y el inicio del servicio, en cuyo caso puede cambiar el nivel de registro del valor predeterminado Advertencia a Información.
Para actualizar el nivel de registro en ArcGIS Enterprise Manager, realice lo siguiente:
Haga clic en Configuración en la página de Registros.
En el panel Ajustes de registro, defina el nivel de registro predeterminado.
Haga clic en Guardar.
Actualizar el índice de registro
Puede actualizar el índice de registros para solucionar problemas relacionados con el acceso a los registros, por ejemplo, si no se generan nuevos registros o si los registros existentes dejan de estar disponibles.
Para actualizar el índice de registro en ArcGIS Enterprise Manager, realice lo siguiente:
Haga clic en Configuración en la página de Registros.
En la página Ajustes de registro, haga clic en Actualizar índice de registro.