Platform settings
The installation's administration panel — background work, warning email, thresholds, limits, updates and the mobile app.
The Settings are the control panel of the whole installation. They are not the settings of an app — those live inside each app and travel with it. Here is where you decide what the platform does on its own, where it sends its warnings, from what values it starts worrying, and how long a session lasts.
It opens through the Settings item, at the bottom of the sidebar. Only accounts with an administrator profile get in.
Nota
Every setting on this page is saved with the Save button, at the bottom of the screen. Leaving without saving keeps nothing.
Background work
The first section turns on and off what runs while nobody is watching. There are four independent switches:
| Switch | What happens when it is on | What you lose when you turn it off |
|---|---|---|
| Scheduler | Runs the schedules, the scheduled reports and the workflow timers. | Nothing is deleted: the appointed times simply do not run until it is back on. |
| Observability index | Moves what the apps record into the central index and applies each app's retention periods. | The Radar screens show stale data and the logs are kept forever. |
| Real-time notifications | Notifications reach the screen of whoever is working, on the spot. | Notifications go on being created and delivered — but they only appear on the next visit. |
| Email warnings | Warns when something crosses the limits defined further down. | Nobody is warned; problems are only discovered by opening the Radar. |
Atenção
Turning off the Scheduler is the number one cause of "my scripts stopped running". If a schedule looks dead, check this switch before investigating the script. The same goes for scheduled reports and for wait steps in workflows — they all depend on the same engine.
Warning email
This is how the platform sends its own alarms — not to be confused with the email each app sends to its users, which is configured in the app's notification channels.
Fill in:
- Server and Port of the email service.
- Implicit TLS — on for SMTPS (port 465); off for STARTTLS (port 587).
- User and Password of the sending account. The password is written once and never comes back to the screen: the field starts saying it is set, and leaving it empty means "do not touch", never "delete".
- From — the address that appears to whoever receives.
- Recipients — who receives the alarms, separated by commas.
When to warn
The thresholds tell the platform what is normal and what deserves an email. All of them are evaluated within the window defined at the end of the section.
| Value | What it means |
|---|---|
| API errors (%) | Percentage of failed requests above which an alarm opens. |
| Minimum requests | Below this number of requests, the percentage does not count. One error in three requests is 33% and means nothing. |
| Failed scripts | How many failed runs open an alarm. |
| Queue lag (s) | How long the background work may fall behind before being considered late. |
| Free disk (%) | Below this percentage, warn. |
| Window (min) | The period everything above is counted over. |
Dica
On an installation with little traffic, raise the Minimum requests. It is the field that avoids false alarms in apps that are only used in the morning.
Sessions and limits
Two settings that apply to the whole platform:
- Session length (h) — how long a session lasts without activity. While you work, the session renews itself; only prolonged inactivity forces you to sign in again.
- Max file (MB) — the maximum size of a file uploaded in any app of the installation.
Updating the platform
The update section shows the installed version and the list of available versions. The process has two buttons, on purpose:
- Prepare — fetches the chosen version and prepares it without touching anything that is being served. The platform keeps working.
- When the preparation finishes, the plan appears: how many databases will be migrated, which app files are rewritten and in how many versions, plus the notice that the databases are copied before anything is touched.
- Apply this update — only after you have read the plan. The platform becomes unavailable during the restart and comes back on the new version.
Atenção
If there is unsaved work in some app, the plan says so and the apply button does not appear. Save that work and prepare again.
If anything goes wrong along the way, the previous version is restored automatically and the screen says so — including the log of what failed.
Mobile app
The last section serves the Android app used to enter the apps of this platform. It has two files to download and one QR code per app — it is explained in detail in the Mobile app chapter.
Frequently asked questions
I changed a threshold and received nothing. Alarms are only evaluated minute by minute and only within the defined window. Also check that the Email warnings switch is on and that there are recipients filled in.
Can I have different email servers per app? Yes — and it is the normal thing. The email on this page is only the platform's warnings; each app configures its channels in its own settings.
Who can see this page? Only accounts with an administrator profile. A developer does not see it in the sidebar and does not get in by direct address either.