Por que usar o Systemplane
Em um deploy tradicional, alterar um valor de configuração significa atualizar variáveis de ambiente e reiniciar o serviço. O Systemplane elimina esse downtime para muitas configurações:
- Ajustar rate limits durante picos de tráfego sem redeploy — evitando interrupções do serviço em momentos de alto volume de transações
- Ajustar intervalos de workers com base na carga de trabalho observada — otimizando o throughput de reconciliação sem mexer na infraestrutura
- Atualizar tamanhos de connection pool conforme os padrões de tráfego mudam
- Inspecionar valores atuais em tempo de execução para diagnosticar problemas em produção sem mergulhar nos logs
Como funciona
O Systemplane fornece uma API de gerenciamento de chave-valor flat. Todas as chaves de configuração estão em um único namespace sob
/system/matcher.
Endpoints
Esses endpoints são servidos diretamente pela instância do Matcher em execução. Eles não são versionados sob
/v1 — use os caminhos acima exatamente como mostrado.Permissões
Os endpoints do Systemplane são protegidos pela mesma autenticação usada por todas as rotas da API do Matcher. Quando a autenticação está habilitada, todos os endpoints
/system requerem a permissão RBAC system-runtime-config:admin (recurso system-runtime-config, ação admin).
Quando a autenticação está desabilitada, todos os endpoints são acessíveis sem restrição.
Comportamentos de aplicação
Nem todo valor de configuração pode ser alterado em tempo de execução. Cada chave tem um comportamento de aplicação que indica quando as mudanças entram em vigor:
Chaves que são somente bootstrap NÃO estão registradas na API do systemplane — elas são gerenciadas exclusivamente por variáveis de ambiente. Isso evita uma armadilha onde um PUT de admin pareceria ter sucesso mas o processo em execução continuaria silenciosamente usando o valor do momento de inicialização.
Chaves de configuração comuns
Abaixo estão as chaves mais comumente ajustadas, organizadas por categoria. Para uma lista completa, chame
GET /system/matcher.
Chaves ajustáveis em tempo de execução
Essas chaves podem ser alteradas sem reiniciar o Matcher:Chaves multi-tenant (ajustáveis em tempo de execução)
Essas chaves controlam o comportamento multi-tenant e podem ser ajustadas sem reinício. Consulte Modo Multi-Tenant para mais detalhes.Habilitar o modo multi-tenant em si (
tenancy.multi_tenant_enabled / MULTI_TENANT_ENABLED) é somente bootstrap — é lido uma vez na inicialização e requer um reinício. Não está registrado na API do Systemplane e não pode ser alternado em tempo de execução. Consulte a tabela de somente bootstrap mais abaixo.Chaves somente bootstrap (requerem reinício)
Essas chaves não estão registradas na API do systemplane. Altere-as por variáveis de ambiente e reinicie:Boas práticas
Inspecione os valores atuais antes de alterar
Inspecione os valores atuais antes de alterar
Chame
GET /system/matcher para ver todos os valores atuais em tempo de execução antes de fazer qualquer alteração. Isso confirma o que o processo está realmente usando, que pode diferir das variáveis de ambiente se chamadas PUT anteriores foram feitas.Teste mudanças em staging primeiro
Teste mudanças em staging primeiro
Mesmo que as alterações em tempo de execução não requeiram reinício, elas entram em vigor imediatamente. Teste em um ambiente de staging antes de aplicar em produção.
Reinicie para chaves somente bootstrap
Reinicie para chaves somente bootstrap
Se uma chave não estiver visível em
GET /system/matcher, ela é somente bootstrap. Atualize a variável de ambiente e reinicie o serviço — não há caminho em tempo de execução para esses valores.Próximos passos
Modo multi-tenant
Habilitar e configurar o isolamento de tenant.
Roteamento de exceções
Configurar como as exceções são despachadas para sistemas externos.
Regras de match
Configurar regras de correspondência de transações.
Segurança
Autenticação, autorização e proteção de dados.