# Escuta SISC em alta carga

A escuta foi ajustada para rajadas acima de 10.000 mensagens no espaço nativo.

Configuração recomendada para produção:

```bash
pp --ligar-escuta --lote=20000 --paralelo=512 --lote-ator=100 --intervalo=1 --intervalo-limpeza=300 --log-compacto
```

Notas operacionais:

- `--lote` controla quantas mensagens são avaliadas por ciclo. O padrão agora é `20000`.
- `--paralelo` controla quantos atores podem ficar ativos ao mesmo tempo. O padrão agora é `512`; o máximo configurável é `10000`, limitado também por `ulimit -u` do usuário.
- `--lote-ator` controla quantas mensagens entram em um acionamento em lote quando o manifesto do ator declara `comandoLote`/`executavelLote`/`handlerLerMensagens`. O padrão é `100` e o teto é `1000`.
- Para usar lote por ator, declare no manifesto algo como:

```json
{
  "controlador": {
    "executavelLote": "./atores/meu-handler-lote",
    "loteMaximo": 100
  }
}
```

  A escuta chama agentes com `--ler-mensagens-arquivo <arquivo-lista>` e conectores com `ler-mensagens-arquivo <arquivo-lista>`. O arquivo-lista contém um caminho de mensagem por linha. Os runtimes nativos (`./escuta/runtime-agente` e `./escuta/runtime-conector`) aceitam esse modo e percorrem a lista; para ganho máximo, implemente um handler de lote real que consuma a lista em uma única inicialização.
- `--log-compacto` é o padrão e reduz I/O em massa, mantendo eventos de ciclo, erros, quarentena, duplicidade e estado terminal em `espaco/estado/`.
- Use `--log-detalhado` apenas em diagnóstico, pois ele registra cada entrega/início/conclusão.
- Por padrão, a validação do marcador `espaco/api-publicadas` é rápida: exige a existência do marcador e evita uma leitura extra por mensagem. Use `--validar-marcador-api` se precisar conferir o conteúdo de cada marcador em auditoria estrita.
- A limpeza pesada de marcadores roda por padrão a cada 300s para não competir com a ingestão.
- Para cargas muito altas, verifique `ulimit -u`, `ulimit -n`, CPU, disco e o custo real dos handlers dos agentes/conectores.