Definições da plataforma
O painel de administração da instalação — trabalho de fundo, email dos avisos, limiares, limites, actualizações e a app móvel.
As Definições são o painel de controlo da instalação inteira. Não são as definições de uma app — essas vivem dentro de cada app e viajam com ela. Aqui decide-se o que a plataforma faz sozinha, para onde manda os avisos, a partir de que valores se preocupa, e quanto tempo dura uma sessão.
Abre-se pelo item Definições, no fundo da barra lateral. Só contas com perfil de administrador lá entram.
Nota
Todas as definições desta página se gravam com o botão Gravar, no fundo do ecrã. Sair sem gravar não guarda nada.
Trabalho de fundo
A primeira secção liga e desliga o que corre sozinho enquanto ninguém está a olhar. São quatro interruptores independentes:
| Interruptor | O que acontece quando está ligado | O que perde quando o desliga |
|---|---|---|
| Agendador | Corre os agendamentos, os relatórios agendados e os temporizadores dos workflows. | Nada se apaga: as horas marcadas simplesmente não correm até voltar a ligar. |
| Índice de observabilidade | Leva o que as apps registam para o índice central e aplica os prazos de retenção de cada app. | Os ecrãs do Radar mostram dados velhos e os registos ficam guardados para sempre. |
| Notificações em tempo real | As notificações chegam ao ecrã de quem está a trabalhar, no momento. | As notificações continuam a ser criadas e entregues — mas só aparecem na visita seguinte. |
| Avisos por email | Avisa quando algo passa dos limites definidos mais abaixo. | Ninguém é avisado; os problemas só se descobrem ao abrir o Radar. |
Atenção
Desligar o Agendador é a causa número um de "os meus scripts deixaram de correr". Se um agendamento parece morto, confirma este interruptor antes de investigar o script. Vale o mesmo para relatórios agendados e para passos de espera em workflows — dependem todos do mesmo motor.
Email dos avisos
É por aqui que a plataforma manda os alarmes dela — não confundir com o email que cada app manda aos utilizadores dela, que se configura nos canais de notificação da app.
Preenche:
- Servidor e Porta do serviço de email.
- TLS implícito — liga para SMTPS (porto 465); desliga para STARTTLS (porto 587).
- Utilizador e Palavra-passe da conta de envio. A palavra-passe escreve-se uma vez e nunca volta ao ecrã: o campo passa a dizer que está definida, e deixá-lo vazio significa "não mexer", nunca "apagar".
- Remetente — o endereço que aparece a quem recebe.
- Destinatários — quem recebe os alarmes, separados por vírgulas.
A partir de quando avisar
Os limiares dizem à plataforma o que é normal e o que merece um email. Todos são avaliados dentro da janela definida no fim da secção.
| Valor | O que significa |
|---|---|
| Erros de API (%) | Percentagem de pedidos com erro acima da qual se abre um alarme. |
| Pedidos mínimos | Abaixo deste número de pedidos, a percentagem não conta. Um erro em três pedidos são 33% e não quer dizer nada. |
| Scripts falhados | Quantas execuções falhadas abrem um alarme. |
| Atraso da fila (s) | Quanto tempo o trabalho de fundo pode ficar para trás antes de ser considerado atrasado. |
| Disco livre (%) | Abaixo desta percentagem, avisa. |
| Janela (min) | O período em que tudo o que está acima é contado. |
Dica
Numa instalação com pouco tráfego, sobe os Pedidos mínimos. É o campo que evita alarmes falsos em apps que só são usadas de manhã.
Sessões e limites
Duas definições que valem para toda a plataforma:
- Duração da sessão (h) — quanto tempo uma sessão dura sem actividade. Enquanto se trabalha, a sessão renova-se sozinha; só a inactividade prolongada obriga a entrar de novo.
- Ficheiro máximo (MB) — o tamanho máximo de um ficheiro carregado em qualquer app da instalação.
Actualizar a plataforma
A secção de actualização mostra a versão instalada e a lista de versões disponíveis. O processo tem dois botões de propósito:
- Preparar — vai buscar a versão escolhida e prepara-a sem tocar em nada do que está a servir. A plataforma continua a funcionar.
- Quando a preparação termina, aparece o plano: quantas bases de dados vão ser migradas, que ficheiros de apps são reescritos e em quantas versões, mais o aviso de que as bases de dados são copiadas antes de se mexer em nada.
- Aplicar esta actualização — só depois de leres o plano. A plataforma fica indisponível durante o reinício e volta na versão nova.
Atenção
Se houver trabalho por gravar em alguma app, o plano di-lo e o botão de aplicar não aparece. Grava esse trabalho e prepara outra vez.
Se alguma coisa correr mal a meio, a versão anterior é reposta automaticamente e o ecrã di-lo — incluindo o registo do que falhou.
Aplicação móvel
A última secção serve a app Android com que se entra nas apps desta plataforma. Tem dois ficheiros para transferir e um código QR por app — está explicado em detalhe no capítulo App móvel.
Perguntas frequentes
Mudei um limiar e não recebi nada. Os alarmes só são avaliados de minuto a minuto e apenas dentro da janela definida. Confirma também que o interruptor Avisos por email está ligado e que há destinatários preenchidos.
Posso ter servidores de email diferentes por app? Sim — e é o normal. O email desta página é só o dos avisos da plataforma; cada app configura os seus canais nas definições dela.
Quem consegue ver esta página? Apenas contas com perfil de administrador. Um developer não a vê na barra lateral nem lá entra por endereço directo.