Datos de auditoría en línea y fuera de línea (persistencia directa)
Los servicios y sus parámetros en la implementación de persistencia directa difieren de los de la implementación de tabla de datos. En este tema se explican los datos de auditoría en línea y fuera de línea, los servicios que se pueden utilizar para extraerlos y los parámetros que se utilizan en la implementación de persistencia directa.
Datos de auditoría en línea
Cuando la implementación de persistencia directa está activa, las entradas de auditoría en línea se mantienen en línea en función de los valores especificados para el parámetro DaysOnline del subsistema de auditoría. Se proporcionan servicios para gestionar la cantidad de datos en el almacén de datos de auditoría en línea:
Las operaciones de archivo y depuración las activan las cosas del programador relacionadas en ThingWorx Platform. Estas cosas del programador son responsables de invocar estos servicios periódicamente. Es posible configurar los programadores para que se ajusten a las necesidades de la organización. Por defecto, estos servicios se ejecutan diariamente. También se pueden invocar manualmente cuando sea necesario. Los mensajes de auditoría en línea persisten en ficheros que se almacenan en el directorio AuditArchiveDirectPersistence de AuditArchiveFileRepository del subsistema de auditoría. No se puede configurar este almacén.
 |
Fuera de línea en el contexto del subsistema de auditoría significa que los mensajes de auditoría ya no se pueden filtrar ni buscar, y que ya no se almacenan en la base de datos en línea.
|
El criterio de retención para los datos de auditoría en línea es el parámetro de configuración del número de días que se conservarán los datos de auditoría en línea para el subsistema de auditoría. El servicio ArchiveAuditHistoryDirectPersistence no borra los datos que cumplen con este criterio de retención. En su lugar, se puede ejecutar el servicio independiente PurgeAuditData con una programación o manualmente para borrar los datos de auditoría en línea si se cumple el criterio.
Para buscar datos de auditoría en línea mediante el servicio QueryAuditHistoryWithQueryCriteria, consulte
Datos de auditoría fuera de línea
Los datos de auditoría fuera de línea proporcionan una ubicación de almacenamiento para los datos de auditoría a los que el usuario no necesita acceder a menudo, pero que desea conservar para fines administrativos. El servicio ArchiveAuditHistoryDirectPersistence permite copiar los datos de auditoría en línea en el almacenamiento fuera de línea. Los siguientes servicios permiten a los administradores gestionar los datos fuera de línea:
El servicio ExportAuditData llama al servicio ArchiveAuditHistoryDirectPersistence, que copia los datos de auditoría en línea solicitados desde AuditArchiveFileRepository al fichero de exportación especificado. La operación de exportación procesa y traduce los datos archivados y los almacena en el fichero de exportación especificado.
El servicio CleanUpOfflineAudit se suele ejecutar en función de un programador. También se puede ejecutar manualmente. Se pasa un elemento olderThanDate al servicio para especificar los ficheros archivados que se borrarán de AuditArchiveFileRepository.
Los ficheros fuera de línea se archivan sin localización. Un servicio lector fuera de línea, denominado ExportAuditData, está disponible para recuperarlos en función de la configuración regional especificada. Consulte Exportación de datos de auditoría para obtener más información.
En el siguiente diagrama se muestra la jerarquía de los ficheros de archivo sin conexión. En el párrafo que sigue al diagrama, se explica el nodo justo debajo de FileRepository, "Carpeta OfflineAudit para la implementación activa".
Jerarquía del archivo fuera de línea
En el diagrama anterior, el nodo "Carpeta OfflineAudit para la implementación activa" representa el directorio principal del almacén para la implementación activa, la persistencia directa y/o la tabla de datos. Si se empezó con la implementación de tabla de datos y, posteriormente, se cambió a la implementación de persistencia directa, habrá dos directorios, AuditArchive para la implementación de tabla de datos y AuditArchiveDirectPersistence para la implementación de persistencia directa. Ambos directorios tienen la misma estructura de subdirectorios que se muestra arriba. Los datos de auditoría archivados se conservan cuando se cambia de una implementación a otra.
 | Si el usuario decide cambiar de una implementación a otra, debe asegurarse de haber archivado los datos de auditoría que necesite conservar antes de realizar el cambio. |
Las carpetas con fecha son con la fecha de los mensajes de auditoría que contienen, no la fecha de ejecución del archivo. Tal como se muestra en el diagrama anterior, el formato del nombre de la carpeta con fecha es el formato AAAA-MM-DD (ISO 8601), con una nueva carpeta para cada día de mensajes de auditoría. Los "fragmentos de auditoría fuera de línea" están en un fichero JSON comprimido en el que se incluyen los mensajes de auditoría de esa fecha. El tamaño del fragmento por defecto es 50.000 filas. Se debe tener en cuenta que el tamaño mínimo es 10.000 filas. Un administrador del sistema puede cambiar el tamaño por defecto de los fragmentos en la configuración del subsistema de auditoría. Por ejemplo, el administrador del sistema puede especificar un tamaño de fichero de fragmentos de 70.000 filas. Habría un fichero de fragmentos comprimido para esa cantidad de filas de mensajes en la carpeta con fecha. Si todas las entradas de auditoría fueran de aproximadamente un 1 KB, el tamaño de un fichero de fragmentos sería de en torno a 70 MB descomprimidos o en la memoria.
Rendimiento y conservación de datos
Para maximizar el rendimiento, se requiere un equilibrio entre los datos de auditoría en línea y el almacén de datos fuera de línea. El subsistema de auditoría proporciona operaciones de archivado y depuración para ayudar a conseguir el equilibrio óptimo para el sistema. Aunque la operación de archivo no verifica el parámetro DaysOnline del subsistema, el servicio PurgeAuditData sí que lo verifica.
Cuando el programador llama al servicio ArchiveAuditHistoryDirectPersistence, la fecha actual se transfiere como olderThanDate. Se archivan todos los mensajes de auditoría en línea anteriores a esta fecha. Este servicio no verifica el parámetro DaysOnline del subsistema de auditoría.
El servicio PurgeAuditData verifica el valor del parámetro DaysOnline del subsistema de auditoría para determinar qué mensajes de auditoría en línea se deben depurar y cuáles deben permanecer disponibles en línea. Antes de borrar los mensajes de auditoría, este servicio verifica si hay mensajes de auditoría en línea marcados para borrarse y que no se hayan archivado. Si es así, este servicio llama al servicio ArchiveAuditHistoryDirectPersistence. Estas acciones garantizan que se archivan todos los datos antes de que se borren.
| | Si el valor de DaysOnline es 0 y se llama al servicio de depuración, todos los datos se mueven al almacén fuera de línea y, a continuación, se borran del almacén en línea. |
Exportación de datos de auditoría en línea y fuera de línea
A partir de ThingWorx Platform v.9.0.0, el subsistema de auditoría tiene dos servicios de exportación, uno para los datos de auditoría en línea y otro para los datos de auditoría en línea y fuera de línea. Consulte Exportación de datos de auditoría en línea y Exportación de datos de auditoría para obtener información sobre el uso de estos servicios para exportar datos de auditoría.