KEPLIN Docs

Innstillinger for plattformen

Plattformens administrasjonsdeler, én om gangen: prosesser, grenser, antivirus, e-post, alarmer, OpenTelemetry, kunstig intelligens, autentisering for apper, mobilapp, maler, ubrukte filer, installasjon og åpen kildekode.

Innstillinger er kontrollpanelet for hele installasjonen. Det er ikke innstillingene til en app — de bor inne i hver app og reiser med den. Her bestemmes hva plattformen gjør av seg selv, hvor den sender varslene, fra hvilke verdier den bekymrer seg, og hvor lenge en økt varer.

Det åpnes med elementet Innstillinger nederst i sidefeltet. Bare kontoer med administratorprofil kommer inn.

Delene ligger i en navigasjon til venstre, i grupper: Plattform, Varsler, Observerbarhet, Kunstig intelligens, Apper, Installasjon og Om. Én del åpnes om gangen, og adressen endres med den, så nettleserens tilbakeknapp fører til forrige del. Gruppen Installasjon vises bare i en installasjon med én enkelt organisasjon. På en smal skjerm blir navigasjonen en nedtrekksliste over delen.

Skjermen Innstillinger for plattformen, med navigasjonen til delene til venstre
Skjermen Innstillinger for plattformen, med navigasjonen til delene til venstre

Merk

Hver del har sin egen knapp Lagre, i toppfeltet, som bare lagrer den delen. Den som bytter del uten å lagre, mister det som ble skrevet der.

Prosesser

Delen Prosesser slår på og av det som kjører av seg selv mens ingen ser på. Det er tre uavhengige brytere:

Bryter Hva som skjer når den er på Hva du mister når du slår den av
Planlegger Kjører tidsplanene, de planlagte rapportene og tidsurene i arbeidsflytene. Ingenting slettes: de avtalte klokkeslettene kjører rett og slett ikke før du slår den på igjen.
Indeks for observerbarhet Flytter det appene registrerer til den sentrale indeksen og bruker oppbevaringsfristene til hver app. Radar-skjermene viser gamle data, og loggene blir liggende for alltid.
Varsler i sanntid Varslene når skjermen til den som jobber, i øyeblikket. Varslene opprettes og leveres fortsatt — men de dukker først opp ved neste besøk.

Bryteren for varsler på e-post ligger i delen Alarmer.

Hver bryter trer i kraft når du klikker på Lagre, uten at serveren startes på nytt: det du slår på, starter i samme øyeblikk, og avslåtte sanntidsvarsler lukkes med en gang.

De tre bryterne i delen Prosesser
De tre bryterne i delen Prosesser

Advarsel

Å slå av Planlegger er årsak nummer én til «skriptene mine har sluttet å kjøre». Ser en tidsplan død ut, sjekk denne bryteren før du gransker skriptet. Det samme gjelder planlagte rapporter og ventetrinn i arbeidsflyter — alle avhenger av den samme motoren.

Antivirus

Delen Antivirus kobler plattformen til et antivirus via ICAP, slik at filene som kommer inn i appene, kontrolleres før de lagres, og viser filene i karantene. Den beskrives i Antivirus.

E-post

Det er her plattformen sender sine egne alarmer — ikke å forveksle med e-posten hver app sender til brukerne sine, som konfigureres i varselkanalene til appen.

Fyll ut:

  1. Server og Port til e-posttjenesten.
  2. Sikkerhet — SSL/TLS krypterer fra starten av tilkoblingen (port 465); STARTTLS hvis serveren tilbyr det åpner tilkoblingen ukryptert og går over til TLS hvis serveren tilbyr det (port 587); Ingen krypterer aldri, for interne servere uten TLS (port 25). Uten bruker og passord autentiseres ikke utsendelsen.
  3. Bruker og Passord til utsendingskontoen. Passordet skrives én gang og vises aldri igjen på skjermen: feltet sier fra at det er angitt, og å la det stå tomt betyr «ikke rør», aldri «slett».
  4. Avsender — adressen mottakeren ser.
  5. Mottakere: adresser, kommaseparert, som får alle alarmer. Står det tomt, varsler hver app dem som er tilordnet den, og apper uten noen tilordnet og plattformen varsler de aktive administratorene.

Seksjonen for e-posten til varslene, ferdig utfylt
Seksjonen for e-posten til varslene, ferdig utfylt

Alarmer

Delen Alarmer bestemmer om plattformen varsler på e-post, og fra hvilke verdier.

Bryteren Varsler på e-post, øverst, slår på varslene. Når den er av, blir ingen varslet, og problemene oppdages først når noen åpner Radar. Varslene sendes via serveren i delen E-post.

Et nytt problem i en publisert app, eller et løst problem som skjer igjen, varsler alltid, uten terskel. Hva som utløser hvert varsel og hva e-posten sier, står i Varsler på e-post.

Terskler forteller plattformen hva som er normalt og hva som fortjener en e-post. Alle vurderes innenfor vinduet som angis sist i seksjonen.

Verdi Hva den betyr
Serverfeil i API-ene (%) Andel forespørsler som feiler på serveren (5xx) som åpner et alarm om utbredt feil, med minst 5 feil i vinduet. Avvisninger, avbrutte forespørsler og valideringsfeil teller ikke.
Minste antall forespørsler Under dette antallet forespørsler teller ikke prosenten. Én feil av tre forespørsler er 33 % og betyr ingenting.
Mislykkede skript Hvor mange mislykkede kjøringer som åpner en alarm.
Forsinkelse i køen (s) Hvor lenge bakgrunnsarbeidet kan henge etter før det regnes som forsinket.
Ledig diskplass (%) Under denne prosenten varsles det.
Vindu (min) Perioden alt det over telles innenfor.

Tips

I en installasjon med lite trafikk, sett opp Minste antall forespørsler. Det er feltet som hindrer falske alarmer i apper som bare brukes om morgenen.

Grenser

To innstillinger som gjelder for hele plattformen:

  • Øktens varighet (t) — hvor lenge en økt varer uten aktivitet. Mens du jobber, fornyer økten seg selv; bare langvarig inaktivitet tvinger deg til å logge inn på nytt.
  • Største fil (MB) — den største størrelsen på en fil som lastes opp i en hvilken som helst app i installasjonen. Den gjelder også for filer som lastes opp til en apps assets. Den går opp til 100 MB. Import av apper avhenger ikke av denne verdien: den tar imot pakker på opptil 1 GB (se Importere og eksportere apper).

OpenTelemetry

Delen OpenTelemetry, i gruppen Observerbarhet, sender det som skjer i appene, til firmaets OpenTelemetry-server, via OTLP over HTTP i JSON. Radar virker som før: sendingen er en kopi.

  1. Skriv grunnadressen for OTLP over HTTP under Adresse, for eksempel https://otel.empresa.pt:4318. Keplin legger til /v1/traces og /v1/logs.
  2. Valgfritt: klikk på Legg til header under Headere og skriv Navn og Verdi for tjenestens autentiseringsheadere, for eksempel Authorization eller x-api-key. Verdiene lagres kryptert og vises ikke igjen; tomt beholdes den lagrede verdien.
  3. Velg under Hva som sendes:
    • API-kall og skriptkjøringer, som traces, med trace- og span-ID-ene som Keplin allerede bruker;
    • Radar-feil, som logger, med feilens type, melding og stakkspor, koblet til tracen;
    • Revisjon, som logger: hvem som endret hva i plattformen, uten før og etter;
    • Aktivitet i nettleseren, som traces: de åpnede skjermene, klikkene og lesingene. Det er mye: slå det bare på hvis tjenesten tåler det.
  4. Klikk på Test tilkoblingen. Testen bestås når serveren tar imot en testsending.
  5. Slå på Send til OpenTelemetry og klikk på Lagre.

Delen OpenTelemetry, med adressen, en header og de valgte signalene
Delen OpenTelemetry, med adressen, en header og de valgte signalene

Sendingen starter i det øyeblikket den slås på, uten historikken. Dataene i forespørslene og svarene sendes aldri. Status viser tidspunktet for den siste sendingen og hvor mange spans og logger som er sendt siden serveren startet, og den siste feilen, hvis den er nyere enn den siste sendingen.

Offentlig adresse

Den Offentlige adressen er adressen folk åpner plattformen med, for eksempel https://plattform.eksempel.no. Den brukes i lenkene i e-poster, for eksempel lenken for å gjenopprette passordet til appkontoer. Delen ligger i gruppen Installasjon, som bare vises i en installasjon med én tenant; i multitenant gjelder adressen til hver tenant.

Den fylles ut ved en administrators første pålogging, med adressen administratoren logget på via. Hvis det ikke er adressen folk bruker (for eksempel hvis administratoren logget på via IP-en til det interne nettverket), retter du den og klikker på Lagre.

Uten Offentlig adresse fungerer gjenoppretting av passord bare for apper som er publisert på et eget domene. Adressen som følger med en forespørsel, brukes aldri til lenken, fordi den som sender forespørselen velger den.

Plattformens PostgreSQL-server

For interne PostgreSQL-datakilder (se Koble til databaser) trenger installasjonen en PostgreSQL-server der plattformen oppretter databasene. Konfigurasjonen tilhører installasjonen, ikke en app: i en installasjon for én organisasjon ligger den i Innstillinger, i delen Administrert PostgreSQL i gruppen Installasjon; i en installasjon med flere kunder ligger den i installasjonens backoffice. Fyll inn adresse, port, administrasjonskonto og grensen for databaser per kunde, lagre og bruk Test serveren for å bekrefte at plattformen kan opprette databaser på den serveren. Til den er konfigurert, er valget PostgreSQL under fanen Intern deaktivert når du oppretter en datakilde.

Nettlesermotor

Skjermbildene som agenter ber om via MCP, og skjermtestene (se Testprosjektet) bruker en nettleser uten skjerm som kjører på serveren. Det finnes bare én for hele installasjonen, i en egen prosess og med lav prioritet: når maskinen er presset, er det nettleseren som gir etter, ikke forespørslene fra appene.

Delen Nettlesermotor, i gruppen Installasjon (i en installasjon med flere kunder, i installasjonens backoffice), viser Tilstand (kjører, eller lukket til neste jobb), om Chromium er installert, Jobber som kjører og står i kø, ledig Minne og Siste feil. Den har også grensene som beskytter serveren:

Grense Hva den gjør
Samtidige jobber Hvor mange sider som er åpne samtidig. Flere sider, mer minne og CPU.
Forespørsler i kø Når køen er full, avvises en ny forespørsel med en gang, med årsaken.
Minutter ledig før lukking Lukket bruker nettleseren ikke minne; neste jobb åpner den igjen.
Minimum ledig minne (MB) Under dette åpnes ingen ny side. 0 slår av vernet.

Lukk nettleseren nå gir minnet tilbake med en gang. Hvis Chromium mangler, laster Installer Chromium det ned; installasjonen og oppdateringene av plattformen installerer det allerede og sjekker at det starter.

Oppdatere plattformen

Hvor og hvordan du oppdaterer avhenger av installasjonens modus:

  • Installasjon for én organisasjon: ingen oppdatering via grensesnittet. Delen Oppdateringer i Innstillinger viser Installert versjon: og kommandoen som skal kjøres i serverens konsoll med zip-filen for den nye versjonen, med en knapp for å kopiere den. Installasjonsprogrammet beholder innstillingene og dataene og kjører migreringene; for å gå tilbake til en tidligere versjon installerer du zip-filen for den versjonen.
  • Installasjon med flere kunder: oppdateringen gjøres i installasjonens backoffice, under Oppdateringer, og det er den skjermen resten av denne seksjonen beskriver. Innstillingene til hver kunde har ingen oppdateringer.

Oppdateringsseksjonen viser den installerte versjonen og listen over tilgjengelige versjoner. Prosessen har to knapper, med vilje:

  1. Forbered — henter den valgte versjonen og gjør den klar uten å røre noe av det som betjenes. Plattformen fortsetter å virke.
  2. Når forberedelsen er ferdig, kommer planen: hvor mange databaser som skal migreres, hvilke appfiler som skrives om og i hvor mange versjoner, pluss beskjeden om at databasene kopieres før noe røres.
  3. Ta i bruk denne oppdateringen — først etter at du har lest planen. Plattformen er utilgjengelig under omstarten og kommer tilbake i den nye versjonen.

Planen til en oppdatering, før den tas i bruk
Planen til en oppdatering, før den tas i bruk

Merk

Har en app endringer på disken som ennå ikke er i historikken, sier planen det, og oppdateringen lagrer dem først, i en egen oppføring, før den skriver filene på nytt. Filer som plattformen skriver selv, som kopiene av skriptavhengigheter som en tidsplan lager, teller ikke.

Går noe galt underveis, gjenopprettes den forrige versjonen automatisk, og skjermen sier det — inkludert loggen over hva som feilet.

Gjenopprettingen fører databasene, og også appfilene som migreringene hadde skrevet om, tilbake til tilstanden før oppdateringen.

Serverkontroll

På oppdateringsskjermen viser blokken Serverkontroll om maskinen har det appenes skript, skjermbildene og skjermtestene trenger: Chromium, skriptenes isolasjon, skriptenes nettverksregler og plattformens prosesser som kjører med installasjonens bruker. Kontrollen kjøres på slutten av installasjonen, på slutten av hver oppdatering og når serveren starter; Kontroller nå kjører den på forespørsel.

Sammendraget sier «Alt er i orden.», hvor mange advarsler det er, eller hvor mange problemer som gjenstår å løse. Hvert problem oppgir hva som ikke virker, og viser kommandoen som løser det, som kjøres som root i serverens konsoll.

Kunstig intelligens

Gruppen Kunstig intelligens inneholder delen Leverandører: tenantens AI-tjenester som skriptene i appene kan bruke, med legitimasjonen og de tillatte modellene. Se AI-leverandører.

Autentisering for apper

Delen Autentisering for apper, i gruppen Apper, registrerer leverandørene som appenes brukere kan logge inn via: Microsoft Entra ID, Google, en OpenID Connect- eller OAuth 2.0-tjeneste og, i en installasjon med én enkelt tenant, Active Directory. Den beskrives i Logge inn med autentiseringsleverandører.

Mobilapp

Delen Mobilapp betjener Android-appen du bruker for å logge inn i appene på denne plattformen. Den har to filer å laste ned og en QR-kode per app — det er forklart i detalj i kapittelet Mobilappen.

Seksjonen for mobilappen, med nedlastingene og QR-koden
Seksjonen for mobilappen, med nedlastingene og QR-koden

Maler

Delen Maler, i gruppen Apper, viser malene til denne plattformen: de som er lagret i appene med Lagre som mal (se Appmaler). Systemmaler hører til installasjonen og vises ikke her.

Hver rad viser navn, versjon, beskrivelse, appen malen kommer fra, datoen den ble lagret og størrelsen. For hver mal:

  • Last ned laster ned filen .keplintemplate, for å ta den med til en annen installasjon.
  • Søppelkasseikonet sletter malen. Bekreftelsen vises på selve raden: klikk på Slett for å bekrefte, eller på Avbryt. Malen forsvinner fra galleriet i Ny app, og apper som allerede er opprettet fra den, endres ikke.

Delen Maler, med en mal som er lagret fra en app
Delen Maler, med en mal som er lagret fra en app

Ubrukte filer

Filene som er lastet opp i appene, slettes ikke av seg selv: verken når posten som hadde dem, slettes, når et vedlegg erstattes eller når et skjema blir halvferdig. Delen Ubrukte filer finner dem og lar deg velge hva som skal bort. Ingenting slettes av seg selv.

  1. Klikk på Søk etter ubrukte filer i toppteksten. Søket kjøres i bakgrunnen på serveren: du kan forlate siden og komme tilbake, og det fortsetter.
  2. Under søket viser siden fremdriften (for eksempel «3 av 12 apper») og hva som leses. Hver app vises så snart den er ferdig, med filene som ingen kjent referanse bruker: navn, størrelse, opplastingsdato og versjoner. Ikonet ved siden av navnet laster ned filen, slik at du kan kontrollere hva det er.
  3. Velg filene og klikk på Slett valgte. Siden ber om bekreftelse; før sletting kontrollerer plattformen de valgte filene på nytt, og en fil som i mellomtiden har blitt tatt i bruk, blir værende.

Delen Ubrukte filer, med resultatet av det siste søket
Delen Ubrukte filer, med resultatet av det siste søket

Resultatet lagres: når du kommer tilbake til delen, vises det siste søket, med dato og hvor lang tid det tok. Søk på nytt gjentar søket i alle appene, og Søk i denne appen, i toppteksten til en app, bare i den. Avbryt søket stopper et søk som pågår. Hvis serveren starter på nytt midt i, sier siden at det siste søket ble avbrutt halvveis. Tid per kilde viser hvor lang tid det tok å lese hver database, slik at du forstår hvor tiden går i et tregt søk.

En fil regnes som brukt når tokenet dens forekommer i appens design, i appens SQLite-databaser (inkludert prosesser og varsler) eller i en tekstkolonne i en tabell i modellen, i en hvilken som helst versjon. Datasources med kun lesing leses ikke, fordi Keplin aldri skriver i dem. En tabell utenfor modellen eller et eksternt system blir ikke sett: kontroller før du sletter. Filer fra de siste 24 timene teller ikke med, og en app med en database som ikke kan leses, havner utenfor listen.

Advarsel

En slettet fil kommer ikke tilbake. Bytene forlater appens lagring, og filen forlater registeret i alle versjonene.

Åpen kildekode

Delen Åpen kildekode viser bibliotekene med åpen kildekode som er installert i plattformen, med versjonen og lisensen til hvert bibliotek. Navnet på hvert bibliotek åpner prosjektets side. Skriv i søkefeltet for å filtrere listen etter navn eller lisens.

Vanlige spørsmål

Jeg endret en terskel og fikk ingenting. Alarmene vurderes bare minutt for minutt og bare innenfor det angitte vinduet. Sjekk også at bryteren Varsler på e-post i delen Alarmer er på, og at serveren i delen E-post er fylt ut.

Kan jeg ha ulike e-postservere per app? Ja — og det er det normale. E-posten på denne siden er bare den for plattformens varsler; hver app konfigurerer sine kanaler i sine egne innstillinger.

Hvem kan se denne siden? Bare kontoer med administratorprofil. En developer ser den verken i sidefeltet eller kommer inn via en direkte adresse.