Por qué usar Systemplane
En un despliegue tradicional, cambiar un valor de configuración significa actualizar variables de entorno y reiniciar el servicio. Systemplane elimina ese tiempo de inactividad para muchas configuraciones:
- Ajustar límites de tasa durante picos de tráfico sin redeploy — evitando interrupciones del servicio en momentos de alto volumen de transacciones
- Ajustar intervalos de workers según la carga de trabajo observada — optimizando el rendimiento de conciliación sin modificar la infraestructura
- Actualizar tamaños de connection pool a medida que cambian los patrones de tráfico
- Inspeccionar valores actuales en tiempo de ejecución para diagnosticar problemas en producción sin bucear en logs
Cómo funciona
Systemplane proporciona una API de gestión de clave-valor plana. Todas las claves de configuración están en un único namespace bajo
/system/matcher.
Endpoints
Estos endpoints son servidos directamente por la instancia de Matcher en ejecución. No están versionados bajo
/v1 — usa las rutas anteriores exactamente como se muestran.Permisos
Los endpoints de Systemplane están protegidos por la misma autenticación utilizada por todas las rutas de la API de Matcher. Cuando la autenticación está habilitada, todos los endpoints
/system requieren el permiso RBAC system-runtime-config:admin (recurso system-runtime-config, acción admin).
Cuando la autenticación está deshabilitada, todos los endpoints son accesibles sin restricciones.
Comportamientos de aplicación
No todos los valores de configuración pueden cambiarse en tiempo de ejecución. Cada clave tiene un comportamiento de aplicación que indica cuándo surten efecto los cambios:
Las claves que son solo bootstrap NO están registradas en la API de systemplane — se gestionan exclusivamente a través de variables de entorno. Esto evita que un PUT de administrador parezca exitoso mientras el proceso en ejecución continúa silenciosamente usando el valor del momento de arranque.
Claves de configuración comunes
A continuación se muestran las claves más comúnmente ajustadas, organizadas por categoría. Para una lista completa, llama a
GET /system/matcher.
Claves ajustables en tiempo de ejecución
Estas claves pueden cambiarse sin reiniciar Matcher:Claves multi-tenant (ajustables en tiempo de ejecución)
Estas claves controlan el comportamiento multi-tenant y pueden ajustarse sin reinicio. Consulta Modo Multi-Tenant para más detalles.Habilitar el modo multi-tenant en sí (
tenancy.multi_tenant_enabled / MULTI_TENANT_ENABLED) es solo bootstrap — se lee una vez al inicio y requiere un reinicio. No está registrado en la API de Systemplane y no puede alternarse en tiempo de ejecución. Consulta la tabla de solo bootstrap más abajo.Claves solo bootstrap (requieren reinicio)
Estas claves no están registradas en la API de systemplane. Cámbialas mediante variables de entorno y reinicia:Mejores prácticas
Inspecciona los valores actuales antes de cambiar
Inspecciona los valores actuales antes de cambiar
Llama a
GET /system/matcher para ver todos los valores actuales en tiempo de ejecución antes de realizar cualquier cambio. Esto confirma lo que el proceso está usando realmente, que puede diferir de las variables de entorno si se realizaron llamadas PUT anteriores.Prueba los cambios en staging primero
Prueba los cambios en staging primero
Aunque los cambios en tiempo de ejecución no requieren reinicio, surten efecto de inmediato. Prueba en un entorno de staging antes de aplicar a producción.
Reinicia para claves solo bootstrap
Reinicia para claves solo bootstrap
Si una clave no es visible en
GET /system/matcher, es solo bootstrap. Actualiza la variable de entorno y reinicia el servicio — no hay ruta en tiempo de ejecución para esos valores.Próximos pasos
Modo multi-tenant
Habilitar y configurar el aislamiento de tenant.
Enrutamiento de excepciones
Configurar cómo se despachan las excepciones a sistemas externos.
Reglas de coincidencia
Configurar reglas de coincidencia de transacciones.
Seguridad
Autenticación, autorización y protección de datos.