Operación, auditoría y planificación#

La configuración de lo que Empowerment Center vigila y conserva por sí mismo: las alertas operativas de la consola, el mantenimiento, la actividad, la auditoría, el planificador y las copias que se guardan de los libros, las plantillas del portal y el metadata. Cómo se usan la consola y la auditoría está en Operación y Auditoría.

Las alertas operativas#

La consola de operación comprueba el servidor cada minuto y abre alertas que se resuelven solas cuando el problema desaparece.

Propiedad	Por defecto	Qué es
`ecenter.operations.enabled`	`true`	Comprobar las alertas y hacer el mantenimiento solos.
`ecenter.operations.instance-name`	`ECENTER_INSTANCE_NAME` o el nombre del equipo	La instancia en las alertas.
`ecenter.operations.alerts.interval`	`1m`	Cada cuánto se comprueba el servidor.
`ecenter.operations.alerts.connection-interval`	`5m`	Cada cuánto se comprueban las BD de los clientes.
`ecenter.operations.alerts.connection-timeout`	`10s`	Lo que se espera a una BD de cliente.
`ecenter.operations.alerts.memory-percent`	`90`	La memoria ocupada tras la última recolección, en % del máximo, a partir de la que se avisa (de 1 a 100).
`ecenter.operations.alerts.disk-path`	El directorio temporal	El disco que se vigila.
`ecenter.operations.alerts.disk-free-min`	`1GB`	El espacio libre por debajo del que se avisa.
`ecenter.operations.alerts.queue-wait`	`10m`	La espera en cola a partir de la que se avisa.
`ecenter.operations.alerts.running-max`	`1h`	La duración de un trabajo a partir de la que se avisa.
`ecenter.operations.alerts.failures`	`5`	Trabajos fallidos…
`ecenter.operations.alerts.failures-window`	`15m`	…en este periodo, a partir de los que se avisa.
`ecenter.operations.alerts.delivery-failures`	`3`	Envíos de suscripciones y evaluaciones de alertas de datos fallidos…
`ecenter.operations.alerts.delivery-failures-window`	`1h`	…en este periodo.
`ecenter.operations.alerts.credential-expiry`	`30d`	La antelación con que se avisa de una credencial de SCIM, de incrustación o de intercambio del metadata que caduca.
`ecenter.operations.alerts.mail-timeout`	`10s`	Lo que se espera al servidor de correo al comprobarlo.
`ecenter.operations.alerts.render-timeout`	`10s`	Lo que se espera al navegador sin interfaz al comprobarlo.
`ecenter.operations.alerts.provisioning-rejection-age`	`1h`	Lo que puede esperar un alta rechazada del proveedor de identidad antes de avisar.
`ecenter.operations.alerts.stuck-events`	`15m`	Lo que puede quedar sin procesar un evento interno antes de avisar.
`ecenter.operations.alerts.scheduled-failures`	`3`	Ejecuciones seguidas que tiene que fallar una tarea programada para avisar.
`ecenter.operations.alerts.embed-replay-window`	`1h`	Cuánto sigue abierta la alerta de los tokens de incrustación reutilizados tras el último (como mucho 1 día).
`ecenter.operations.alerts.absent-instance`	`30m`	Con varias instancias, lo que puede pasar una alerta de una instancia que ya no existe antes de darla por resuelta. Al menos cinco veces `interval`.
`ecenter.operations.alerts.check-wait`	`10s`	Lo que Comprobar ahora espera a la ronda antes de dejarla en segundo plano.
`ecenter.operations.events.resubmit-wait`	`10s`	Lo que Volver a entregar… espera antes de dejarlo en segundo plano.

Los avisos por correo de estas alertas se configuran en ecenter.operations.notifications.* (véase Correo y avisos).

Cuándo cambiarlas. Si una alerta salta a menudo sin que haya un problema real en su instalación (por ejemplo, trabajos que siempre tardan más de una hora porque procesan mucho), ajuste su umbral en lugar de acostumbrarse a ignorarla.

El mantenimiento#

Propiedad	Por defecto	Qué es
`ecenter.operations.maintenance.interval`	`1h`	Cada cuánto se purga.
`ecenter.operations.maintenance.job-history`	`90d`	Lo que se conserva el historial de trabajos.
`ecenter.operations.maintenance.resolved-alerts`	`365d`	Lo que se conserva una alerta resuelta.

La actividad de la consola#

La pestaña Actividad guarda muestras de cada instancia cada minuto y las resume en horas y días.

Propiedad	Por defecto	Qué es
`ecenter.operations.activity.enabled`	`true`	Muestrear.
`ecenter.operations.activity.gauge-interval`	`15s`	Cada cuánto se leen los medidores (de 1 s a 1 min).
`ecenter.operations.activity.retention.minutes`	`3d`	Lo que se conservan las muestras por minuto.
`ecenter.operations.activity.retention.hours`	`92d`	Las resumidas por hora.
`ecenter.operations.activity.retention.days`	`400d`	Las resumidas por día.
`ecenter.operations.activity.zone`	`TZ` o la del servidor	La zona de los días. Variable: `ECENTER_OPERATIONS_ACTIVITY_ZONE`.
`ecenter.operations.activity.max-points`	`200`	Los puntos como mucho de un tramo elegido al acercar (al menos 10).

La auditoría#

Propiedad	Por defecto	Qué es
`ecenter.audit.record-queries`	`true`	Anotar cada consulta a una BD de cliente con su SQL y los valores de sus parámetros.
`ecenter.audit.retention.others`	`365d`	Lo que se conserva una categoría que no tiene plazo propio.
`ecenter.audit.retention.categories.<categoría>`	`query: 90d`, `job: 90d`	El plazo de una categoría. Al menos un día.
`ecenter.audit.purge-interval`	`1h`	Cada cuánto se purga lo caducado.
`ecenter.audit.purge-enabled`	`true`	Purgar solo.
`ecenter.audit.export-max-rows`	`100000`	Las entradas de una exportación.
`ecenter.audit.export-timeout`	`30m`	Lo que puede durar la descarga de una exportación.

Las categorías son access (entradas, salidas e intentos fallidos), query (consultas a las BD de los clientes), data (cambios de datos de los formularios y los datos externos), workbook (libros), job (trabajos terminados), scheduling (tareas programadas), administration (usuarios y licencia), distribution (suscripciones, entregas y alertas de datos) y metadata (cambios del metadata).

ecenter:
  audit:
    retention:
      others: 730d
      categories:
        query: 180d
        job: 90d
        access: 730d

Cuándo cambiarla. La auditoría es lo que más hace crecer la BD propia: cada consulta deja una entrada con su SQL. Ajuste los plazos a lo que exija la política de la organización. Con record-queries: false no se anotan las consultas, lo que ahorra disco pero deja sin rastro qué datos se leyeron.

Las líneas de registro de la auditoría#

Cada entrada de la auditoría sale también como una línea del registro del backend, en ecenter.audit.<categoría>, para mandarla a un syslog o a un SIEM. Por defecto salen todas salvo las de las consultas y los trabajos, que son una por cada una:

logging:
  level:
    ecenter.audit: info
    ecenter.audit.query: warn   # info para tener también cada consulta
    ecenter.audit.job: warn     # info para tener también cada trabajo

El planificador#

Propiedad	Por defecto	Qué es
`ecenter.scheduling.enabled`	`true`	Lanzar las tareas a su hora. Con `false`, solo se ejecutan a mano y tampoco se purga su historial.
`ecenter.scheduling.tick`	`15s`	Cada cuánto se miran las tareas que tocan.
`ecenter.scheduling.zone`	La del servidor (`TZ`)	La zona de las programaciones.
`ecenter.scheduling.max-running`	`4`	Las tareas que se ejecutan a la vez. Las demás esperan a la vuelta siguiente. Ejecutar ahora no espera turno.
`ecenter.scheduling.recalc-timeout`	`2h`	El tiempo máximo de cada intento de recalcular un libro.
`ecenter.scheduling.procedure-timeout`	`2h`	El de un procedimiento programado.
`ecenter.scheduling.step-timeout`	`30m`	El del procedimiento previo o posterior de un grupo.
`ecenter.scheduling.history`	`90d`	Lo que se conservan las ejecuciones. Se purgan en cada vuelta, con licencia válida.
`ecenter.scheduling.job-poll`	`1s`	Cada cuánto se mira si han terminado los trabajos de un recálculo.
`ecenter.scheduling.instance-name`	`ECENTER_INSTANCE_NAME` o el nombre del equipo	La instancia en las ejecuciones.

Los avisos por correo de las ejecuciones, en Correo y avisos. Sin licencia válida no se lanza ninguna tarea.

Libros, plantillas y metadata#

ECenter guarda copias al guardar un libro, una plantilla del portal y, antes de cada importación o restauración, el metadata de una conexión. De cada uno conserva las últimas de hoy y la última de cada día anterior.

Propiedad	Por defecto	Qué es
`ecenter.workbooks.backups-today`	`10`	Copias de hoy de cada libro.
`ecenter.workbooks.backups-previous-days`	`7`	Días anteriores de los que se conserva la última copia de cada libro.
`ecenter.workbooks.lock-timeout`	`8h`	Un libro abierto para editar más tiempo se da por abandonado y otro lo puede tomar.
`ecenter.portal.layouts.backups-today`	`10`	Copias de hoy de cada plantilla. `0` y `0`, ninguna.
`ecenter.portal.layouts.backups-previous-days`	`7`	Días anteriores de cada plantilla.
`ecenter.metadata.backups-today`	`10`	Copias de hoy del metadata de cada conexión.
`ecenter.metadata.backups-previous-days`	`7`	Días anteriores del metadata de cada conexión.

Estas copias sirven para deshacer un cambio, no para recuperar la instalación: eso es la copia de la BD propia (véase Copias de seguridad y restauración).

Favoritos y marcadores#

Propiedad	Por defecto	Qué es
`ecenter.workbooks.favorites.max-per-user`	`500`	Favoritos de cada usuario (libros, documentos y marcadores).
`ecenter.workbooks.bookmarks.max-private-per-document`	`50`	Marcadores privados de cada usuario en un documento.
`ecenter.workbooks.bookmarks.max-public-per-document`	`100`	Marcadores públicos de un documento.
`ecenter.workbooks.bookmarks.max-state-size`	`256KB`	El tamaño del estado guardado de un marcador.
`ecenter.portal.favorites.max-per-user`	`500`	Favoritos del portal de cada usuario.
`ecenter.portal.bookmarks.max-private-per-page`	`50`	Marcadores privados de cada usuario en una página del portal.
`ecenter.portal.bookmarks.max-public-per-page`	`100`	Marcadores públicos de una página.
`ecenter.portal.bookmarks.max-state-size`	`256KB`	El tamaño del estado guardado.

El metadata#

Propiedad	Por defecto	Qué es
`ecenter.metadata.exchange.max-package-size`	`64MB`	El paquete de metadata que se importa, descomprimido. Por encima, 413 `PACKAGE_TOO_LARGE`.
`ecenter.metadata.exchange.max-entries`	`5000`	Los ficheros del paquete.
`ecenter.metadata.exchange.max-entry-size`	`16MB`	Cada fichero descomprimido.
`ecenter.metadata.impact.max-revalidated`	`2000`	Los objetos que se vuelven a comprobar al guardar un cambio del metadata. Del resto se dice que no se han comprobado.
`ecenter.metadata.impact.max-listed`	`200`	Los objetos que se listan en el informe de impacto (los recuentos son siempre completos).
`ecenter.metadata.impact.max-users-listed`	`50`	Los logins que se listan por audiencia.
`ecenter.workbooks.usage-index.reindex-on-startup`	`true`	Al arrancar tras una actualización, volver a indexar lo que usan los libros.
`ecenter.portal.usage-index.reindex-on-startup`	`true`	Lo mismo con las publicaciones del portal.