KEPLIN Docs

Alustan asetukset

Alustan hallintaosiot yksi kerrallaan: prosessit, rajat, virustorjunta, sähköposti, hälytykset, OpenTelemetry, tekoäly, sovellusten tunnistautuminen, mobiilisovellus, mallit, käyttämättömät tiedostot, asennus ja avoin lähdekoodi.

Asetukset on koko asennuksen ohjauspaneeli. Se ei ole yhden sovelluksen asetukset — ne asuvat kunkin sovelluksen sisällä ja matkustavat sen mukana. Täällä päätetään, mitä alusta tekee itsestään, minne se lähettää varoitukset, mistä arvoista alkaen se huolestuu ja kuinka kauan istunto kestää.

Se avataan kohdasta Asetukset sivupalkin pohjalta. Vain ylläpitäjäprofiilin tilit pääsevät sinne.

Osiot ovat vasemmalla olevassa navigaatiossa ryhmittäin: Alusta, Varoitukset, Havainnoitavuus, Tekoäly, Sovellukset, Asennus ja Tietoja. Kerrallaan avautuu yksi osio, ja osoite vaihtuu sen mukana, joten selaimen paluupainike vie edelliseen osioon. Ryhmä Asennus näkyy vain yhden organisaation asennuksessa. Kapealla näytöllä navigaatiosta tulee valintaluettelo osion yläpuolelle.

Alustan asetusten näyttö, jossa osioiden navigointi on vasemmalla
Alustan asetusten näyttö, jossa osioiden navigointi on vasemmalla

Huomio

Jokaisella osiolla on oma Tallenna-painike otsikkorivillä, ja se tallentaa vain kyseisen osion. Jos vaihdat osiota tallentamatta, osioon kirjoitettu katoaa.

Prosessit

Prosessit-osio kytkee päälle ja pois sen, mikä käy itsestään, kun kukaan ei katso. Valitsimia on kolme, toisistaan riippumatonta:

Valitsin Mitä tapahtuu, kun se on päällä Mitä menetät, kun kytket sen pois
Ajastin Suorittaa ajastukset, ajastetut raportit ja työnkulkujen ajastimet. Mitään ei poisteta: sovitut ajat vain eivät toteudu ennen kuin kytket takaisin päälle.
Havainnoinnin indeksi Siirtää sovellusten kirjaamat tiedot keskusindeksiin ja soveltaa kunkin sovelluksen säilytysaikoja. Radarin näytöt näyttävät vanhaa dataa ja lokit säilyvät ikuisesti.
Reaaliaikaiset ilmoitukset Ilmoitukset saapuvat työskentelevän näytölle heti. Ilmoituksia luodaan ja toimitetaan edelleen — mutta ne näkyvät vasta seuraavalla käynnillä.

Sähköpostivaroitusten valitsin on osiossa Hälytykset.

Kukin kytkin tulee voimaan, kun napsautat Tallenna, ilman palvelimen uudelleenkäynnistystä: mitä kytket päälle, käynnistyy samalla hetkellä, ja pois kytketyt reaaliaikaiset ilmoitukset sulkeutuvat heti.

Prosessit-osion kolme valitsinta
Prosessit-osion kolme valitsinta

Varoitus

Ajastimen kytkeminen pois on ykkössyy ilmiölle ”skriptini lakkasivat pyörimästä”. Jos ajastus vaikuttaa kuolleelta, tarkista tämä valitsin ennen kuin tutkit skriptiä. Sama pätee ajastettuihin raportteihin ja workflow'iden odotusaskeliin — kaikki riippuvat samasta moottorista.

Virustorjunta

Osio Virustorjunta liittää alustan virustorjuntaan ICAPin kautta, jotta sovelluksiin tulevat tiedostot tarkistetaan ennen tallennusta, ja näyttää karanteenissa olevat tiedostot. Se kuvataan sivulla Virustorjunta.

Sähköposti

Tätä kautta alusta lähettää omat hälytyksensä — ei pidä sekoittaa sähköpostiin, jota kukin sovellus lähettää omille käyttäjilleen ja joka määritetään sovelluksen ilmoituskanavissa.

Täytä:

  1. Sähköpostipalvelun Palvelin ja Portti.
  2. Suojaus — SSL/TLS salaa yhteyden alusta alkaen (portti 465); STARTTLS, jos palvelin tarjoaa sen avaa yhteyden salaamatta ja siirtyy TLS:ään, jos palvelin tarjoaa sitä (portti 587); Ei mitään ei salaa koskaan, sisäisille palvelimille ilman TLS:ää (portti 25). Ilman käyttäjää ja salasanaa lähetys ei tunnistaudu.
  3. Lähetystilin Käyttäjä ja Salasana. Salasana kirjoitetaan kerran eikä se koskaan palaa näytölle: kenttä alkaa kertoa, että se on asetettu, ja sen jättäminen tyhjäksi tarkoittaa ”älä koske”, ei koskaan ”poista”.
  4. Lähettäjä — osoite, joka näkyy vastaanottajalle.
  5. Vastaanottajat: pilkuin erotellut osoitteet, jotka saavat kaikki hälytykset. Tyhjänä kukin sovellus varoittaa siihen määritettyjä henkilöitä, ja sovellukset, joihin ei ole määritetty ketään, sekä alusta varoittavat aktiivisia ylläpitäjiä.

Varoitusten sähköpostin osio täytettynä
Varoitusten sähköpostin osio täytettynä

Hälytykset

Hälytykset-osio määrittää, varoittaako alusta sähköpostilla ja mistä arvoista alkaen.

Yläreunan valitsin Sähköpostivaroitukset kytkee varoitukset päälle. Kun se on pois päältä, kukaan ei saa varoitusta, ja ongelmat huomataan vasta Radaria avattaessa. Varoitukset lähtevät Sähköposti-osion palvelimen kautta.

Uusi ongelma julkaistussa sovelluksessa tai toistuva ratkaistu ongelma varoittaa aina ilman raja-arvoa. Mikä laukaisee minkäkin hälytyksen ja mitä sähköposti kertoo, kerrotaan sivulla Sähköpostihälytykset.

Kynnysarvot kertovat alustalle, mikä on normaalia ja mikä ansaitsee sähköpostin. Kaikki arvioidaan osion lopussa määritetyn ikkunan sisällä.

Arvo Mitä se tarkoittaa
API-palvelinvirheet (%) Palvelimella epäonnistuvien pyyntöjen (5xx) osuus, jonka ylittyessä avataan laajan häiriön hälytys, kun ikkunassa on vähintään 5 virhettä. Hylkäykset, perutut pyynnöt ja validointivirheet eivät ole mukana.
Pyyntöjen vähimmäismäärä Tämän pyyntömäärän alle prosenttia ei lasketa. Yksi virhe kolmesta pyynnöstä on 33 % eikä tarkoita mitään.
Epäonnistuneet skriptit Montako epäonnistunutta suoritusta avaa hälytyksen.
Jonon viive (s) Kuinka paljon taustatyö saa jäädä jälkeen ennen kuin se katsotaan myöhästyneeksi.
Vapaa levytila (%) Tämän prosentin alittuessa varoitetaan.
Ikkuna (min) Jakso, jonka sisällä kaikki yllä oleva lasketaan.

Vinkki

Vähäliikenteisessä asennuksessa nosta Pyyntöjen vähimmäismäärää. Se on kenttä, joka estää väärät hälytykset sovelluksissa, joita käytetään vain aamuisin.

Rajat

Kaksi asetusta, jotka pätevät koko alustalle:

  • Istunnon kesto (h) — kuinka kauan istunto kestää ilman toimintaa. Työskennellessä istunto uusiutuu itsestään; vain pitkittynyt joutilaisuus pakottaa kirjautumaan uudelleen.
  • Tiedoston enimmäiskoko (MB) — ladatun tiedoston enimmäiskoko missä tahansa asennuksen sovelluksessa. Se koskee myös sovelluksen asseteihin ladattuja tiedostoja. Se on enintään 100 MB. Sovellusten tuonti ei riipu tästä arvosta: se hyväksyy enintään 1 GB:n paketit (katso Sovellusten tuonti ja vienti).

OpenTelemetry

Ryhmän Havainnoitavuus osio OpenTelemetry lähettää sovelluksissa tapahtuvan yrityksen OpenTelemetry-palvelimelle OTLP/HTTP:llä JSON-muodossa. Radar toimii kuten ennenkin: lähetys on kopio.

  1. Kirjoita kohtaan Osoite OTLP/HTTP:n perusosoite, esimerkiksi https://otel.empresa.pt:4318. Keplin lisää /v1/traces ja /v1/logs.
  2. Valinnainen: napsauta kohdassa Otsakkeet Lisää otsake ja kirjoita palvelun tunnistautumisotsakkeiden Nimi ja Arvo, esimerkiksi Authorization tai x-api-key. Arvot tallennetaan salattuina eivätkä näy enää; tyhjänä tallennettu arvo säilyy.
  3. Valitse kohdassa Mitä lähetetään:
    • API-kutsut ja skriptiajot traceina, Keplinin jo käyttämillä trace- ja span-tunnisteilla;
    • Radarin virheet lokeina, virheen tyypin, viestin ja pinon kanssa, traceen liitettyinä;
    • Auditointi lokeina: kuka muutti mitä alustalla, ilman ennen- ja jälkeen-tietoja;
    • Selaimen toiminta traceina: avatut näkymät, napsautukset ja luvut. Sitä on paljon: ota se käyttöön vain, jos palvelu kestää sen.
  4. Napsauta Testaa yhteys. Testi menee läpi, kun palvelin hyväksyy testilähetyksen.
  5. Ota käyttöön Lähetä OpenTelemetryyn ja napsauta Tallenna.

Osio OpenTelemetry: osoite, yksi otsake ja valitut signaalit
Osio OpenTelemetry: osoite, yksi otsake ja valitut signaalit

Lähetys alkaa käyttöönoton hetkellä ilman historiaa. Pyyntöjen ja vastausten dataa ei koskaan lähetetä. Tila näyttää viimeisimmän lähetyksen ajan ja montako spania ja lokia on lähetetty palvelimen käynnistyksen jälkeen sekä viimeisimmän virheen, jos se on viimeisintä lähetystä uudempi.

Julkinen osoite

Julkinen osoite on osoite, jolla ihmiset avaavat alustan, esimerkiksi https://alusta.esimerkki.fi. Sitä käytetään sähköpostien linkeissä, kuten sovellustilien salasanan palautuslinkissä. Osio on Asennus-ryhmässä, joka näkyy vain asennuksessa, jossa on yksi tenant; multitenantissa pätee kunkin tenantin osoite.

Se täytetään ylläpitäjän ensimmäisellä kirjautumisella sillä osoitteella, jonka kautta hän kirjautui. Jos se ei ole osoite, jota ihmiset käyttävät (esimerkiksi jos ylläpitäjä kirjautui sisäverkon IP-osoitteen kautta), korjaa se ja napsauta Tallenna.

Ilman Julkista osoitetta salasanan palautus toimii vain sovelluksissa, jotka on julkaistu omassa verkkotunnuksessa. Pyynnön mukana tulevaa osoitetta ei koskaan käytetä linkkiin, koska pyynnön tekijä valitsee sen.

Alustan PostgreSQL-palvelin

Sisäisiä PostgreSQL-tietolähteitä varten (ks. Tietokantojen yhdistäminen) asennus tarvitsee PostgreSQL-palvelimen, jolle alusta luo tietokannat. Määritys kuuluu asennukselle, ei sovellukselle: yhden organisaation asennuksessa se on Asetuksissa Asennus-ryhmän osiossa Hallittu PostgreSQL; usean asiakkaan asennuksessa se on asennuksen hallintapaneelissa. Täytä osoite, portti, hallintatili ja tietokantojen enimmäismäärä asiakasta kohden, tallenna ja vahvista Testaa palvelin-painikkeella, että alusta pystyy luomaan tietokantoja tuolle palvelimelle. Kunnes se on määritetty, Sisäinen-välilehden PostgreSQL-vaihtoehto on pois käytöstä tietolähdettä luotaessa.

Selainmoottori

Kuvakaappaukset, joita agentit pyytävät MCP:n kautta, ja näkymätestit (katso Testiprojekti) käyttävät palvelimella toimivaa selainta ilman näyttöä. Koko asennuksessa on vain yksi, omassa prosessissaan ja matalalla prioriteetilla: kun koneen resurssit käyvät vähiin, selain joustaa, eivät sovellusten pyynnöt.

Osio Selainmoottori ryhmässä Asennus (usean asiakkaan asennuksessa asennuksen hallintapaneelissa) näyttää Tila-kohdan (käynnissä, tai suljettu seuraavaan työhön asti), onko Chromium asennettu, käynnissä ja jonossa olevat Työt, vapaan Muisti-määrän ja Viimeisin virhe -kohdan. Siinä ovat myös palvelinta suojaavat rajat:

Raja Mitä se tekee
Samanaikaiset työt Kuinka monta sivua on auki samanaikaisesti. Enemmän sivuja, enemmän muistia ja suoritinta.
Pyyntöjä jonossa Kun jono on täynnä, uusi pyyntö hylätään heti syyn kanssa.
Joutominuutit ennen sulkemista Suljettuna selain ei vie muistia; seuraava työ avaa sen uudelleen.
Vähimmäisvapaa muisti (Mt) Tämän alapuolella uutta sivua ei avata. 0 poistaa suojan käytöstä.

Sulje selain nyt vapauttaa muistin heti. Jos Chromium puuttuu, Asenna Chromium lataa sen; asennus ja alustan päivitykset asentavat sen jo ja tarkistavat, että se käynnistyy.

Alustan päivittäminen

Missä ja miten päivitetään riippuu asennuksen tilasta:

  • Yhden organisaation asennus: käyttöliittymästä ei päivitetä. Asetusten osio Päivitykset näyttää Asennettu versio: ja komennon, joka ajetaan palvelimen konsolissa uuden version zip-paketilla, sekä painikkeen sen kopioimiseen. Asennusohjelma säilyttää asetukset ja tiedot ja ajaa migraatiot; aiempaan versioon palataan asentamalla sen version zip.
  • Usean asiakkaan asennus: päivitys tehdään asennuksen hallintapaneelissa kohdassa Päivitykset, ja tämän osion loppu kuvaa juuri sitä näyttöä. Yksittäisten asiakkaiden Asetuksissa ei ole päivityksiä.

Päivitysosio näyttää asennetun version ja saatavilla olevien versioiden listan. Prosessissa on tarkoituksella kaksi painiketta:

  1. Valmistele — hakee valitun version ja valmistelee sen koskematta mihinkään, mikä palvelee. Alusta jatkaa toimintaansa.
  2. Kun valmistelu päättyy, näkyviin tulee suunnitelma: montako tietokantaa migratoidaan, mitkä sovellusten tiedostot kirjoitetaan uudelleen ja monessako versiossa, sekä huomautus siitä, että tietokannoista otetaan kopiot ennen kuin mihinkään kosketaan.
  3. Ota tämä päivitys käyttöön — vasta luettuasi suunnitelman. Alusta ei ole käytettävissä uudelleenkäynnistyksen aikana ja palaa uudessa versiossa.

Päivityksen suunnitelma ennen käyttöönottoa
Päivityksen suunnitelma ennen käyttöönottoa

Huomio

Jos jossakin sovelluksessa on levyllä muutoksia, jotka eivät vielä ole historiassa, suunnitelma kertoo sen ja päivitys tallentaa ne ensin omana merkintänään ennen kuin se kirjoittaa tiedostot uudelleen. Tiedostot, jotka alusta kirjoittaa itse, kuten ajastuksen tekemät kopiot skriptien riippuvuuksista, eivät vaikuta.

Jos jokin menee kesken kaiken pieleen, edellinen versio palautetaan automaattisesti ja näyttö kertoo sen — mukaan lukien lokin siitä, mikä epäonnistui.

Palautus palauttaa tietokannat ja myös sovellusten tiedostot, jotka migraatiot olivat kirjoittaneet uudelleen, päivitystä edeltävään tilaan.

Palvelimen tarkistus

Päivitysten näkymässä lohko Palvelimen tarkistus näyttää, onko koneella se, mitä sovellusten skriptit, kuvakaappaukset ja näkymätestit tarvitsevat: Chromium, skriptien eristys, skriptien verkkosäännöt ja alustan prosessit asennuksen käyttäjänä ajettuina. Tarkistus ajetaan asennuksen lopussa, jokaisen päivityksen lopussa ja palvelimen käynnistyessä; Tarkista nyt ajaa sen pyynnöstä.

Yhteenveto sanoo ”Kaikki on kunnossa.”, montako varoitusta on tai montako ongelmaa on ratkaisematta. Jokainen ongelma kertoo, mikä ei toimi, ja näyttää komennon, joka sen ratkaisee, ajettavaksi root-käyttäjänä palvelimen konsolissa.

Tekoäly

Tekoäly-ryhmässä on Palveluntarjoajat-osio: tenantin tekoälypalvelut, joita sovellusten skriptit voivat käyttää, tunnistetietoineen ja sallittuine malleineen. Ks. Tekoälypalveluntarjoajat.

Sovellusten tunnistautuminen

Ryhmän Sovellukset osio Sovellusten tunnistautuminen rekisteröi palvelut, joiden kautta sovellusten käyttäjät voivat kirjautua: Microsoft Entra ID, Google, OpenID Connect- tai OAuth 2.0 -palvelu ja yhden tenantin asennuksessa Active Directory. Se kuvataan sivulla Kirjautuminen tunnistautumispalveluilla.

Mobiilisovellus

Mobiilisovellus-osio palvelee Android-sovellusta, jolla tämän alustan sovelluksiin kirjaudutaan. Siinä on kaksi ladattavaa tiedostoa ja QR-koodi sovellusta kohden — se on selitetty yksityiskohtaisesti luvussa Mobiilisovellus.

Mobiilisovelluksen osio latauksineen ja QR-koodeineen
Mobiilisovelluksen osio latauksineen ja QR-koodeineen

Mallit

Ryhmän Sovellukset osio Mallit luettelee tämän alustan mallit: sovelluksista toiminnolla Tallenna mallipohjaksi tallennetut (katso Sovellusmallit). Järjestelmämallit kuuluvat asennukseen eivätkä näy täällä.

Jokainen rivi näyttää nimen, version, kuvauksen, sovelluksen, josta malli tuli, tallennuspäivän ja koon. Kunkin kohdalla:

  • Lataa lataa tiedoston .keplintemplate, jotta sen voi viedä toiseen asennukseen.
  • Roskakorikuvake poistaa mallin. Vahvistus näkyy itse rivillä: vahvista napsauttamalla Poista tai peru napsauttamalla Peruuta. Malli poistuu Uusi sovellus -galleriasta, eivätkä siitä jo luodut sovellukset muutu.

Osio Mallit, jossa on sovelluksesta tallennettu malli
Osio Mallit, jossa on sovelluksesta tallennettu malli

Käyttämättömät tiedostot

Sovelluksiin ladatut tiedostot eivät poistu itsestään: eivät silloin, kun ne sisältänyt tietue poistetaan, eivät silloin, kun liite korvataan, eivätkä silloin, kun lomake jää kesken. Osio Käyttämättömät tiedostot löytää ne ja antaa valita, mitkä poistetaan. Mitään ei poisteta itsestään.

  1. Napsauta otsikossa Etsi käyttämättömät tiedostot. Haku ajetaan taustalla palvelimella: voit poistua sivulta ja palata, ja haku jatkuu.
  2. Haun aikana sivu näyttää edistymisen (esimerkiksi ”3/12 sovellusta”) ja sen, mitä luetaan. Jokainen sovellus näkyy heti valmistuttuaan tiedostoineen, joita mikään tunnettu viittaus ei käytä: nimi, koko, latauspäivä ja versiot. Nimen vieressä oleva kuvake lataa tiedoston, jotta voit tarkistaa, mikä se on.
  3. Valitse tiedostot ja napsauta Poista valitut. Sivu pyytää vahvistusta; ennen poistamista alusta tarkistaa valitut tiedostot uudelleen, ja tiedosto, joka on sillä välin otettu käyttöön, jää.

Osio Käyttämättömät tiedostot ja viimeisimmän haun tulos
Osio Käyttämättömät tiedostot ja viimeisimmän haun tulos

Tulos säilyy: kun palaat osioon, viimeisin haku näkyy päivämäärineen ja kestoineen. Etsi uudelleen toistaa haun kaikissa sovelluksissa, ja Etsi tästä sovelluksesta sovelluksen otsikossa vain siinä. Peruuta haku pysäyttää käynnissä olevan haun. Jos palvelin käynnistyy uudelleen kesken, sivu kertoo viimeisimmän haun jääneen kesken. Kunkin lähteen aika näyttää, kauanko kunkin tietokannan lukeminen kesti, jotta näet, mihin hitaan haun aika kuluu.

Tiedosto lasketaan käytetyksi, kun sen tunnus esiintyy sovelluksen suunnittelussa, sovelluksen SQLite-tietokannoissa (myös prosesseissa ja ilmoituksissa) tai mallin taulukon tekstisarakkeessa missä tahansa versiossa. Vain luku -datasourceja ei lueta, koska Keplin ei koskaan kirjoita niihin. Mallin ulkopuolista taulukkoa tai ulkoista järjestelmää ei nähdä: tarkista ennen poistamista. Viimeisten 24 tunnin tiedostot eivät ole mukana, ja sovellus, jonka tietokantaa ei voi lukea, jää luettelon ulkopuolelle.

Varoitus

Poistettu tiedosto ei palaa. Tavut poistuvat sovelluksen tallennustilasta ja tiedosto kaikkien versioiden rekisteristä.

Avoin lähdekoodi

Avoin lähdekoodi -osio luettelee alustaan asennetut avoimen lähdekoodin kirjastot sekä kunkin kirjaston version ja lisenssin. Kirjaston nimi avaa projektin sivun. Kirjoita hakukenttään suodattaaksesi luetteloa nimen tai lisenssin mukaan.

Usein kysytyt kysymykset

Muutin raja-arvoa enkä saanut mitään. Hälytykset arvioidaan vain minuutin välein ja ainoastaan määritetyn ikkunan sisällä. Varmista myös, että Hälytykset-osion valitsin Sähköpostivaroitukset on päällä ja että Sähköposti-osion palvelin on täytetty.

Voiko sovelluksilla olla eri sähköpostipalvelimet? Kyllä — ja se on normaalia. Tämän sivun sähköposti on vain alustan varoituksia varten; jokainen sovellus määrittää omat kanavansa omissa asetuksissaan.

Kuka näkee tämän sivun? Vain ylläpitäjäprofiilin tilit. Developer ei näe sitä sivupalkissa eikä pääse sinne suoralla osoitteellakaan.