Meldingsopties
Wanneer een nieuw incident wordt aangemaakt, neemt het de standaard meldingsinstellingen van de app over. Wanneer een Error- of Performance-incident is aangemaakt, kunnen de meldingsinstellingen op de incidentpagina zelf worden gewijzigd. Als een incident is gesloten, wordt het heropend zodra er een nieuwe melding wordt verzonden. Er zijn zes meldingsopties beschikbaar:- Every Occurrence
- First in Deploy
- First After Close
- Never Notify
- Every Nth per Hour
- Every Nth per Day
Every Occurrence
Er wordt een melding verzonden elke keer dat een incident wordt geactiveerd. Deze optie kent een afkoelperiode van 5 minuten. Dit betekent dat als een incident 20 keer per minuut wordt geactiveerd, gedurende 20 minuten, u op minuut 0, 5, 10, 15 en 20 een melding ontvangt.First in Deploy
Er wordt een melding verzonden bij de eerste keer dat een incident optreedt nadat een nieuwe deploy marker is ontvangen. U moet deploy markers instellen, zodat AppSignal een deploy kan detecteren en kan weten wanneer een incident voor de eerste keer in een deploy is opgetreden.First After Close
Er wordt een melding verzonden bij de eerste keer dat een incident optreedt nadat het incident eerder is gesloten. Incidenten kunnen worden geopend en gesloten in de zijbalk van de incidentdetailpagina. Deze optie is geschikt voor incidenten die niet worden veroorzaakt door een codebug, maar door een externe oorzaak (bijv. een externe partij heeft een verbindingsprobleem) en die niet kunnen worden gesloten door een nieuwe versie van de app te deployen.Never Notify
Er wordt nooit een melding verzonden wanneer het incident wordt geactiveerd. Dit wordt vooral gebruikt voor fouten die zich zullen blijven voordoen en die u wilt blijven volgen, maar die niet op korte termijn worden opgelost. Als u het incident helemaal niet wilt ontvangen, kan de actie negeren of de fout negeren helpen.Every Nth per Hour/Day
Er wordt elke n-de keer per uur of per dag een melding verzonden, afhankelijk van uw voorkeuren. Er zijn veel scenario’s waarin dit nuttig kan zijn:- Facturatiefout: Stel u voor dat er nu en dan een facturatiefout optreedt, buiten uw controle om. Dit gebeurt maximaal 5 keer per dag, en u wilt het weten als dit aantal plotseling toeneemt. Door het in te stellen op “elke 10e keer per dag”, krijgt u een melding bij elke 10e, 20e, 30e gebeurtenis, enz.
- API-fout: Misschien hebt u een API die door veel mensen wordt gebruikt. Bij het experimenteren met een API komen fouten die het gevolg zijn van vergissingen vaak voor. U wilt mogelijk pas op de hoogte worden gebracht wanneer het aantal fouten een drempelwaarde bereikt. U kunt het bijvoorbeeld instellen om u elke 1000e keer per uur op de hoogte te brengen, wat erop kan duiden dat de API om uiteenlopende redenen niet meer functioneert.
- Tijdens een incident: Stel u voor dat er iets ernstig kapot is. Er treden honderden fouten per uur op, maar u hebt er grip op. Het is misschien geen goed idee om alle meldingen volledig te negeren, maar het ontvangen van elke afzonderlijke melding zou u in meldingen doen verdrinken. Dit is het ideale moment om het aantal meldingen dat u ontvangt te beheren door uw fouten tijdelijk op n-de/uur in te stellen.
Meldingsinstellingen voor foutincidenten
Foutincidenten worden geïdentificeerd door de (klasse)naam van de fout, zoalsActiveRecord::RecordNotFound, en als de fout binnen een actie is opgetreden, door de actienaam. (bijv. StandardError in BlogpostsController#show).
Meldingsinstellingen voor performance-incidenten
Performance-incidenten worden geïdentificeerd door hun “action”-naam, zoalsBlogpostsController#show.
Zodra we een nieuwe actie detecteren, maken we daar een incident voor aan. Op dat punt kunt u de standaard meldingsinstellingen overschrijven en aanpassen wanneer u op de hoogte gebracht wilt worden en welke drempelwaarde de duur van het performance-incident moet bereiken voordat er een melding wordt verzonden.
Bijv. voor acties waarbij de responstijden traag kunnen zijn, omdat ze interactie hebben met derden, kunt u de drempelwaarde voor de duur op 10 seconden zetten, terwijl u voor de homepage een drempelwaarde van 200 milliseconden kunt instellen.
Het drempelfilter wordt gebruikt in combinatie met de meldingsinstellingen. Bijv. als u First in deploy en 200ms als meldingsinstelling en drempelwaarde hebt ingesteld, moet een incidentvoorval aan beide voldoen voordat er een melding wordt verzonden.
Standaardwaarden voor organisatie en app-namespace
Meldingsinstellingen op een incident kunnen pas worden gewijzigd nadat het incident minstens één keer is opgetreden. Dit kan een probleem zijn als u nooit op de hoogte gebracht wilt worden, of als u een andere drempelwaarde voor performance-incidenten wilt instellen dan de standaard 200 milliseconden. Het is mogelijk om meldingsstandaarden te configureren per app-namespace of zelfs voor de hele organisatie. Hierdoor kunt u de gewenste meldingsinstellingen eenvoudiger toepassen op alle nieuwe incidenten en alle bestaande incidenten waarvan de meldingsinstellingen niet zijn aangepast.Standaard meldingsinstellingen voor de app
Elke applicatie heeft zijn eigen namespace-standaarden voor meldingsinstellingen. Een nieuw incident in de opgegeven namespace neemt de standaardinstellingen over die op deze pagina zijn ingesteld. Zie voor meer informatie de sectie overerving van meldingsstandaarden. Het wordt aanbevolen om de applicatie op te splitsen in namespaces die potentiële incidenten groeperen op ernst. Op die manier kunt u meldingsinstellingen voor een groep incidenten configureren en hoeft u niet elk incident afzonderlijk te configureren. Voor het admin-paneel van een app zou u bijvoorbeeld een namespace genaamdadmin kunnen aanmaken met als standaardmeldingsinstelling “Never notify”, aangezien fouten die in deze namespace optreden minder prioriteit hebben.
Standaard meldingsinstellingen voor de organisatie
Het is ook mogelijk om meldingsstandaarden op uw organisatie in te stellen. Deze standaarden worden gebruikt wanneer AppSignal een nieuwe applicatie detecteert en aanmaakt. Wanneer de nieuwe app wordt aangemaakt, worden de meldingsstandaarden van de organisatie toegepast als de app-meldingsstandaarden van die app. Wijzigingen aan de meldingsstandaarden van de organisatie zijn niet van toepassing op bestaande apps. Zie voor meer informatie de sectie overerving van meldingsstandaarden. Deze meldingsstandaarden op organisatieniveau organization-meldingen kunnen worden ingesteld in het admin-paneel van de organisatie. Het is mogelijk om standaarden te configureren voor elke namespace die in een van de huidige applicaties in uw organisatie wordt gedetecteerd.Overerving van meldingsstandaarden
De meldingsinstellingen borrelen omhoog van de incidentinstellingen naar de namespace-instellingen van de app. Als de meldingsinstellingen voor een incident niet zijn gewijzigd, worden de namespace-standaarden van de app gebruikt. Dit betekent dat u ook alle meldingsinstellingen van incidenten kunt wijzigen voor incidenten die hun meldingsinstellingen niet hebben aangepast, door simpelweg de standaarden van de app te wijzigen.- Wanneer AppSignal een nieuwe app detecteert, worden de namespace-standaarden van de organisatie toegepast.
- Wanneer namespace-meldingsstandaarden van de organisatie worden gewijzigd, gelden ze alleen voor nieuwe apps.
- Wanneer de namespace-meldingsstandaarden van een app worden gewijzigd, gelden ze voor alle nieuwe incidenten en bestaande incidenten zonder aangepaste meldingsinstellingen.
- Wanneer AppSignal een nieuw incident detecteert, worden de namespace-standaarden van de app gebruikt.
- Wanneer de meldingsinstellingen van een incident worden aangepast, worden vanaf dat moment de aangepaste meldingsinstellingen van het incident gebruikt.