Meldingen voor beheerders
fremforge meldt operationele problemen via drie kanalen:
- Bel: het belpictogram in de bovenbalk van
/<org>/_admin/*. Per beheerder, de laatste 30 dagen, met een klik door naar de betreffende instellingenpagina. - Banner op de instellingenpagina: een vaste banner bovenaan de betreffende instellingenpagina (de SSO-instellingenpagina toont bijvoorbeeld een banner over het verlopen van het SSO-certificaat). Verdwijnt zodra de onderliggende situatie is opgelost.
- E-mail: naar de beheerders van de organisatie bij kritieke situaties. We bezorgen via Lettermint (een subverwerker in de EU); de bron van de sjablonen staat in de repository, zodat de inhoud controleerbaar is.
Dezelfde situatie kan via meerdere kanalen binnenkomen. E-mail gaat altijd samen met bel en banner, een banner gaat altijd samen met de bel, en meldingen die alleen in de bel staan zijn niet kritiek.
Situaties
| Situatie | Bel | Plaats van de banner | Opmerkingen | |
|---|---|---|---|---|
| PAT verloopt (op organisatieniveau) | ja | /_admin/api-tokens | ja | Trap: 30 → 14 → 7 → 1 dag |
| SSO-certificaat verloopt | ja | /_admin/sso | ja | Trap: 30 → 14 → 7 → 0 dagen |
| Verouderde uitnodigingen | ja | /_admin/members | nee | Uitnodigingen waar >30 dagen niets mee is gedaan |
| Juridische documenten gewijzigd | ja | /_admin/legal/changelog | nee | Bevestig om weg te werken |
| Legal hold actief | ja | /_admin/compliance/legal-hold | ja | De bel blijft staan tot de hold is opgeheven |
| Integriteit van de auditketen | ja | /_admin/audit-log | nee | Toont broken, partial, anchor_mismatch |
| Prognose van het runnerverbruik | ja | /_admin/billing | nee | Overgeslagen op dag 1 van een nieuwe factuurperiode |
| Opslagquotum bijna bereikt | ja | /_admin/billing | ja | Gaat af bij >=90%, verdwijnt bij <80% |
| Kritieke SAST-bevindingen langer dan 7 dagen open | ja | /_admin/security/findings/sast | nee | Alleen ernst critical |
Meldingen voor individuele gebruikers (ook via Lettermint):
| Situatie | Ontvanger | |
|---|---|---|
| PAT van een gebruiker verloopt | eigenaar van de PAT | ja |
| Export mislukt | aanvrager | ja |
| Issue verloopt morgen of is over tijd | de toegewezen personen van het issue, anders de auteur | ja, één dagelijks overzicht; zie Herinneringen aan vervaldatums |
| Je pull requests en branches zonder push in 14 dagen (organisaties met Active work aan) | de persoon van wie het werk is | ja, hooguit één dagelijks overzicht; zie Stilliggend werk |
Hoe je elke waarschuwing wegwerkt
PAT verloopt
Vervang de PAT op /<org>/_admin/api-tokens en geef een nieuwe uit. De nieuwe PAT begint met een nieuwe verloopklok; de bel verdwijnt de volgende ochtend.
Is de eigenaar uit de organisatie vertrokken, dan kun je de PAT op dezelfde pagina meteen intrekken. Er is bewust geen optie om te “verlengen”.
SSO-certificaat verloopt
Vervang het ondertekeningscertificaat in je IdP en dan:
- Wacht: fremforge ziet het nieuwe certificaat automatisch binnen 24 uur en zet de waarschuwingstrap stop.
- Of klik op “Test SSO” op
/<org>/_admin/ssoom meteen opnieuw te controleren.
De controle van het certificaat loopt via de uitgaande proxy van fremforge (de API-pod heeft geen directe uitgaande verbinding), dus de toestaanlijsten gelden. Mislukt de controle, kijk dan of je IdP bereikbaar is vanaf de uitgaande proxy.
Verouderde uitnodigingen
Verstuur de uitnodiging opnieuw (dat ververst de vervaldatum) of trek haar in. Verouderde uitnodigingen stellen geen gegevens van de organisatie bloot; de bel is er om de ledenlijst netjes te houden.
Juridische documenten gewijzigd
Wanneer fremverk een nieuwe versie van de Voorwaarden, de verwerkersovereenkomst (DPA) of de AUP publiceert, gaat de bel af voor elke organisatie. Ga naar /<org>/_admin/legal/changelog om de verschillen te bekijken en te bevestigen; daarna verdwijnt de bel voor je organisatie.
De bevestiging legt vast wie het deed en wanneer, voor het klantdossier.
Legal hold actief
Deze bel verdwijnt NIET vanzelf. Voor het opheffen van een legal hold is nodig:
- Vastleggen waarom (het audittrail gaat naar de archiefbucket in LTS).
- Een actie van een operator op
/<org>/_admin/compliance/legal-hold.
De bel blijft bewust staan, zodat elke beheerder haar tijdens de hele hold-periode ziet: afwijkingen van de bewaartermijn onder DPA §9 mogen onmogelijk te vergeten zijn.
Integriteit van de auditketen
Er zijn drie mogelijke toestanden die niet ok zijn:
broken: het doorlopen van de keten is bij een rij mislukt. Roep de dienstdoende op.partial: het doorlopen van de keten is afgekapt door de rijlimiet (zeer grote organisaties). Plan een nieuwe run met een ruimere limiet.anchor_mismatch: de hashketen op schijf komt niet overeen met het WORM-anker in OBS. Roep meteen de dienstdoende op.
Neem bij elke toestand die niet ok is contact op met support@frem.sh en vermeld de slug van je organisatie; wij pakken het op.
Prognose van het runnerverbruik
Verschijnt als je maandelijkse verbruik van runner-minuten naar verwachting boven het inbegrepen quotum uitkomt. Wat je kunt doen:
- Je abonnement verhogen (eenmalige verhogingen zijn mogelijk op
/<org>/_admin/billing). - Bevestigen om de melding voor de rest van de huidige periode weg te klikken.
Opslagquotum
Met hysterese: de waarschuwing gaat af bij ≥90% van de opslag in je abonnement en verdwijnt bij <80%. Wat je kunt doen:
- Ongebruikte repository’s of LFS-objecten verwijderen.
- Grote artefacten naar je eigen OBS-bucket verplaatsen en er via een URL naar verwijzen.
- Je abonnement upgraden.
Bezorging van e-mail
Alle e-mails komen van notifications@frem.sh. Het antwoordadres is support@frem.sh (antwoorden komen in de supportwachtrij terecht, niet in een zwart gat).
Krijg je geen meldingsmails:
- Controleer op
/<org>/_admin/membersof het e-mailadres van de beheerder actueel is. - Controleer of
notifications@frem.sh(en de SPF vanfrem.sh) niet ergens onderweg in quarantaine belandt. - Controleer of de waarschuwing echt afgaat: de bel is leidend, de e-mail is een extraatje.
We versturen teruggekaatste meldingsmails niet opnieuw. De bel blijft branden tot de onderliggende situatie is opgelost: de bel is de bron van waarheid.
Wat NIET wordt gemeld
Dingen die bewust niet in de meldingen voor beheerders zitten:
- Meldingen per PR of per commit: die staan in de meldingsinstellingen van je repository, niet in de beheerconsole.
- Systeemwaarschuwingen van Forgejo (mislukte mirrorsynchronisaties, overtredingen van pushregels): die gaan naar de instellingenpagina van de betreffende repository, niet naar de bel voor beheerders.
- Mislukte betalingen: die lopen via de factuurmail en het aanmaningsproces, niet via de bel.
Mis je iets, meld het dan via frem.sh/_app/feedback. We voegen waarschuwingen toe waar de kosten van een gemiste gebeurtenis groter zijn dan de kosten van de ruis, en die lat ligt echt hoog.