El mantenimiento de la base de datos es una tarea que todo administrador de Automic sabe que debería realizar con regularidad, pero que va posponiendo sin darse cuenta, hasta que los datos de ejecución, los informes antiguos y los mensajes del sistema han saturado la base de datos AE. Durante años, el mantenimiento de la base de datos de Automic implicaba recurrir a las utilidades locales de la base de datos AE o acceder directamente a la base de datos, que es precisamente la razón por la que acababa relegado al final de la lista de tareas pendientes. En Automic V26, esa fricción ha desaparecido: puede archivar, reorganizar, eliminar y limpiar datos operativos directamente desde la perspectiva de administración de AWI y la API REST de AE. Este artículo forma parte de nuestra serie de capacitación sobre Automic V26 y se centra en la ruta de la API REST; el vídeo tutorial que aparece a continuación muestra las mismas operaciones de principio a fin.
¿Qué ha cambiado en el mantenimiento de la base de datos Automic en la versión 26?
En versiones anteriores, el archivado, la reorganización y la descarga de la base de datos de AE se gestionaban mediante las utilidades independientes de AE DB o trabajando directamente con la base de datos. Automic V26 somete estas actividades a un control regulado y basado en API: las mismas tareas de mantenimiento están ahora disponibles a través de la API REST de AE y la perspectiva de administración de AWI, por lo que ya no se necesitan binarios de utilidades locales ni credenciales directas de la base de datos para ejecutarlas.
En general, los datos que se gestionan son lo que Automic denomina «datos operativos»: mensajes del sistema, datos de ejecución (antes denominados «estadísticas»), informes y comentarios. En conjunto, la API REST de AE abarca cinco operaciones: archivar datos operativos, crear informes de revisión, reorganizar datos operativos, eliminar datos operativos y vaciar la papelera de reciclaje.
La ventaja práctica es la gobernanza. Canalizar el mantenimiento a través de la API REST de AE significa que cada archivo, reorganización y eliminación es una llamada auditable y repetible, en lugar de una ejecución ad hoc de una utilidad en el ordenador de un usuario; además, se puede conceder mediante un único privilegio, en lugar de un acceso a nivel de base de datos. Para los entornos Automic regulados, esa trazabilidad es tan importante como el espacio liberado en la base de datos.
Privilegios y configuración para configurar primero
Antes de ejecutar cualquier tarea de mantenimiento de la base de datos Automic a través de la API REST, es necesario cumplir dos requisitos: disponer de los privilegios de usuario adecuados y definir las variables que controlan cada operación.
- Privilegios. El
DB_MAINTENANCEprivilegio inicia los procesos de archivado, reorganización y eliminación. Para descargar paquetes de archivo e informes de revisión, también necesitasACCESS_METRICS_ENDPOINT, y para leer o vaciar la Papelera de reciclaje necesitasRECYCLE_BIN. - Variables de configuración en el Cliente 0. Los parámetros de archivo se encuentran en
UC_UTILITY_ARCHIVE, los parámetros de reorganización enUC_UTILITY_REORG, y los parámetros de borrado enUC_UTILITY_DB_UNLOAD. Para los informes de revisión, debe activarse el registro de objetos (OBJECT_AUDIT) debe estar habilitado enUC_CLIENT_SETTINGS. - Ubicación de salida. El archivo o el paquete de informes se guarda automáticamente en el directorio que se defina en el archivo INI de Automation Engine para sistemas locales, o en el
values.yamlarchivo para entornos AAKE (contenedorizados). Desde allí, lo transfieres a donde lo necesites.
Con los privilegios concedidos y las variables configuradas una vez, cada ejecución posterior es una única llamada a la API. El recorrido a continuación muestra estas operaciones en AWI y a través de la API REST de AE; síguelo y luego utiliza las llamadas de referencia en la segunda mitad de esta guía.
Las operaciones de mantenimiento a través de la API AE REST
Cada operación se activa en el Cliente 0 y puede dirigirse a un único cliente (target_client=100) o a todos los clientes (target_client=ALL); no se puede seleccionar un subconjunto arbitrario. La mayoría de los procesos devuelven un run_id que se utiliza para recuperar el paquete resultante.
Archivar datos operativos
El archivo recopila mensajes del sistema, datos de ejecución, informes y comentarios en un archivo ZIP descargable. Lo activas con una solicitud POST y luego descargas el paquete con el ID de ejecución devuelto:
POST /ae/api/v1/0/system/clients/archive?target_client=100
→ { "run_id": 1007001 }
GET /ae/api/v1/0/system/clients/archive/1007001
→ (descarga el paquete de archivo)Con un cliente REST como Postman, utiliza la opción «Enviar y descargar»; con cURL, añade -o para guardar el archivo en el disco. Si se llama al mismo punto final con el método «reset», se desactiva el indicador de archivo.
Creación de informes de revisión
Los informes de revisiones le proporcionan un registro cronológico y listo para auditorías de los cambios en un cliente —objetos creados, eliminaciones, transportes, inicios de sesión de usuarios y más—, lo que mantiene un entorno regulado en cumplimiento. Puede acotar un informe por rango de fechas y por tipo de cambio:
POST /ae/api/v1/0/system/clients/revisionreport?target_client=ALL
{
"from": "2026-01-01T00:00:00Z",
"to": "2026-03-31T00:00:00Z",
"types": ["CREATE", "DELETE", "OBJ_MOD", "USER", "TRNSPRT"]
}Si types se omite, se incluyen todas las categorías de cambio. El informe se descarga con su run_id, exactamente igual que un paquete de archivo.
Reorganizar datos operativos
La reorganización de los datos operativos marca los registros antiguos para su eliminación, sin borrarlos todavía. La lógica de retención combina dos ajustes: un umbral de días para la reorganización y un recuento de registros que se conservan. Por ejemplo, si el umbral de reorganización se establece en 30 y el recuento de registros que se conservan en 5, el proceso conserva todo lo de los últimos 30 días más los cinco registros más antiguos por objeto.
POST /ae/api/v1/0/system/clients/reorg?target_client=ALLEliminando datos operativos
Una vez que los registros están marcados, la eliminación de datos operativos los elimina permanentemente de la base de datos de AE. Es un único disparador por cliente o para todos los clientes:
POST /ae/api/v1/0/system/clients/deletedata?target_client=ALLVaciar la papelera de reciclaje
Los objetos eliminados se mueven a la Papelera de reciclaje en lugar de desaparecer inmediatamente. Desde el Cliente 0, puede enumerar los contenidos de la papelera de un cliente y luego vaciarla:
GET /ae/api/v1/0/recyclebin?target_client=100
DELETE /ae/api/v1/0/recyclebin?target_client=ALLLos objetos que aún contienen datos operativos no archivados no se eliminan; se devuelven en la respuesta en failedObjects. La regla general es sencilla: primero archivar, luego vaciar.
Restableciendo marcas de archivo y reorganización
Si necesita volver a ejecutar un ciclo —por ejemplo, para archivar registros que ya estaban marcados—, los puntos finales de archivo y reorganización aceptan un método de reinicio que borra la marca correspondiente. Esto le permite corregir una ejecución mal programada sin tocar la base de datos, manteniendo todo el ciclo de mantenimiento dentro de la API REST de AE.
Convierte el mantenimiento de la base de datos Automic en una tarea programada, no en una carga
Dado que ahora cada operación es una simple llamada REST, el siguiente paso lógico es dejar de ejecutarlas manualmente. Incorpora la secuencia "archivar → reorganizar → eliminar" en un flujo de trabajo programado de Automic para que la base de datos de AE se mantenga con una periodicidad predecible, e incluye el Cliente 0, que acumula los registros del servidor y del agente y que es fácil pasar por alto. Si prefiere llamar a los puntos finales desde un script, la nueva integración de Automic V26 con Python le permite invocarlos desde un trabajo nativo de Python junto con su lógica de automatización existente. El mantenimiento fiable de la base de datos de Automic es una de las partes menos glamurosas, pero más importantes, para que V26 funcione correctamente.
Un patrón sensato es reorganizar con regularidad, archivar antes de eliminar y vaciar la Papelera de reciclaje una vez que el archivo haya confirmado que no queda nada sin archivar. Ajustar los umbrales de retención al volumen de sus datos es donde reside la mayor parte del valor: lo suficientemente agresivo como para mantener la base de datos reducida, lo suficientemente conservador como para cumplir su ventana de auditoría.
Esta guía forma parte de nuestra serie de formación sobre Automic V26. Si SAP es un elemento central de su entorno, el documento complementario sobre la compatibilidad de SAP Agent con múltiples sistemas aborda otro cambio de la versión V26 que conviene revisar antes de actualizar. Para consultar las especificaciones oficiales, véase la descripción general de la versión Automic V26 de Broadcom y la documentación sobre el mantenimiento de la base de datos de la API REST 26.0 AE.
Preguntas frecuentes
¿Qué privilegios necesito para realizar tareas de mantenimiento de la base de datos Automic a través de la API REST?
Necesitas el privilegio DB_MAINTENANCE para iniciar el archivado, la reorganización y la eliminación. Para descargar paquetes de archivo e informes de revisión, también necesitas ACCESS_METRICS_ENDPOINT, y para leer o vaciar la Papelera de reciclaje, necesitas el privilegio RECYCLE_BIN.
¿Esto funciona localmente (on-premises) así como en entornos contenerizados AAKE?
Sí. Las operaciones son idénticas; solo difiere la ubicación de salida. En las instalaciones locales, establece el directorio del paquete en el archivo INI del Automation Engine, y en los entornos AAKE (contenedores) lo establece en el archivo values.yaml.
¿Qué se considera datos operativos en Automic?
Los datos operativos significan mensajes del sistema, datos de ejecución (anteriormente llamados estadísticas), informes y comentarios. Estos son los registros que se acumulan durante la operación diaria y que el mantenimiento está diseñado para archivar, reorganizar y eliminar.
¿Puedo ejecutar el mantenimiento para todos los clientes a la vez?
Sí. Desde el Cliente 0 puede dirigirse a un solo cliente con target_client=100 o a todos los clientes con target_client=ALL. No puede seleccionar un subconjunto arbitrario de clientes en una sola llamada.
¿Cómo descargo un paquete de archivo o un informe de revisión?
Utilice el run_id devuelto cuando active el proceso en una solicitud GET de seguimiento. En Postman, utilice la opción Enviar y descargar; con cURL, agregue el indicador -o para escribir el archivo en el disco.
¿Cuál es la diferencia entre reorganizar y eliminar?
Reorganizar marca los datos operativos que han caducado para su eliminación según su configuración de retención, pero los deja en la base de datos. Luego, la eliminación elimina permanentemente los registros marcados. Ejecutar primero reorganizar y luego eliminar le permite controlar lo que realmente sale de la base de datos.
¿Dónde se almacena el paquete de archivo o informe?
Cuando se activa el proceso, un trabajo en segundo plano recopila los datos en un archivo ZIP y lo escribe en el directorio definido en el archivo INI del Automation Engine (en las instalaciones) o en el archivo values.yaml (AAKE). Luego, lo descarga o transfiere desde allí.
Planifica la configuración de tu mantenimiento V26
Trasladar el mantenimiento de la base de datos a la API REST supone un pequeño cambio con enormes beneficios en cuanto a la preparación para auditorías y el buen estado de la base de datos; sin embargo, vale la pena ajustar correctamente los privilegios, los umbrales de retención y la programación para tu entorno específico. Si desea que revisemos su configuración de V26, reserve una consulta gratuita con el equipo de Tricise Automic.
