Integraties / Statushub

Toon uw API en sitestatus in Statushub.


Door uw StatusHub account te integreren met Uptrends zijn automatische statusupdates van de services op uw StatusHub-statuspagina mogelijk. Het configureren van de integratie tussen beide systemen bestaat uit drie stappen.

  1. Webhook-integraties configureren in StatusHub.
  2. Een integratie creëren en deze webhooks specificeren in Uptrends.
  3. Servicelinks creëren in Uptrends om Uptrends-monitors aan StatusHub-services te kunnen koppelen.

Deze pagina bevat een gedetailleerde beschrijving van de stappen die nodig zijn om Uptrends te integreren in uw StatusHub-statuspagina's.

1. Webhook-integraties configureren in StatusHub

  • Eerst bereidt u alles voor aan de kant van StatusHub. Log in op uw StatusHub-account en klik op het potloodpictogram om uw statussite te bewerken.
  • Klik op 'Service & integrations' in het menu aan de linkerkant. Vervolgens bewerkt u de eerste service die u wilt besturen met Uptrends.
  • Zoek in het menu met services het gedeelte 'Enable/disable integrations'. Klik op de knop Uptrends en zorg dat deze gemarkeerd is.
  • Klik onderaan in het menu op 'Update Service'. Terug in het serviceoverzicht ziet u dat er nu een URL bij de service wordt vermeld in de volgende vorm:
    https://hooks.statushub.io/hooks/generic_hook?token=598f3b0da9ba4738  
    Deze URL gaat u straks gebruiken om Uptrends te koppelen aan deze StatusHub-service.
  • Herhaal deze procedure voor elke service die u wilt besturen met Uptrends.

Hiermee is het configureren van de integratie in StatusHub voltooid.

Tip: Er is in Uptrends geen beperking op het aantal StatusHub-services dat u kunt besturen. U kunt zo veel servicelinks creëren als u nodig hebt, of met slechts één service beginnen.

2. De integratie configureren in Uptrends

  • Open in uw Uptrends-account het menu Alerts bovenaan en kies de optie 'Integraties'.
  • Klik op Integratie toevoegen in de rechterbovenhoek om een geheel nieuwe StatusHub-integratie in te stellen.
  • Kies StatusHub als het integratietype. Voer een naam in voor deze integratie (bijvoorbeeld StatusHub).
  • Vervolgens geeft u ons informatie over uw StatusHub-services. Klik op de knop Service toevoegen om een service toe te voegen.
  • Voer voor elke StatusHub-service de servicenaam en service-URL in. De service-URL is de webhook-URL die u zojuist hebt gemaakt door de Uptrends-functie in StatusHub in te schakelen.
  • Klik tot slot op Opslaan om uw instellingen op te slaan. De nieuwe StatusHub-integratie verschijnt op de pagina Integraties.

3. De StatusHub-integratie gebruiken in alertdefinities

Voordat de integratie daadwerkelijk kan worden gebruikt, moet deze worden gekoppeld aan ten minste één alertdefinitie en moeten een aantal servicelinks worden geconfigureerd. Een servicelink is de koppeling tussen een Uptrends-controleregel en een StatusHub-service. Alerts voor die controleregel zullen worden verzonden naar de service waaraan u deze koppelt.

  • Navigeer naar een van uw alertdefinities of maak een nieuwe (Alerts > Alertdefinities).
  • Selecteer het escalatieniveau waaraan u StatusHub wilt toevoegen.
  • Zoek in het gedeelte Alerts versturen door integraties de StatusHub-integratie. Als u er geen ziet, gaat u terug naar stap 2 om te controleren of u een StatusHub-integratie hebt gecreëerd.
  • De integratie is nog niet actief; klik op het selectievakje om deze in dit escalatieniveau te activeren.
  • Er verschijnt een knop Servicelink toevoegen. Klik erop om een koppeling te creëren tussen een Uptrends-controleregel aan de linkerkant en een StatusHub-service aan de rechterkant. Met behulp van deze instellingen beschikt u over verfijnde controle over welke Uptrends-controleregel welke service bijwerkt in StatusHub. U kunt zo veel servicelinks aan deze escalatie toevoegen als u nodig hebt.
  • Klik links onderaan op de knop Opslaan om deze alertdefinitie op te slaan.
Tip: Bij de meeste configuraties worden eenvoudige een-op-een-servicelinks gebruikt tussen controleregels en services. Maar het is ook mogelijk om meer geavanceerde configuraties te creëren. U kunt bijvoorbeeld meerdere servicelinks creëren die een enkele controleregel gebruiken om verschillende services in StatusHub te updaten.

Wat u kunt verwachten als uw integratie is voltooid

De normale voorwaarden voor alertdefinities zijn van toepassing. Wanneer Uptrends een fout detecteert voor een van uw controleregels, genereren wij een alert op basis van de instellingen in uw escalatieniveaus. Wanneer een escalatieniveau een nieuwe alert triggert, genereren we een nieuw incident in StatusHub voor de desbetreffende service(s). De servicestatus wordt gewijzigd in Service disruption, en het nieuwe incident krijgt de status Investigating. Uw StatusHub-statuspagina wordt onmiddellijk bijgewerkt met deze wijzigingen.

Deze situatie blijft ongewijzigd zolang de errorsituatie in Uptrends voortduurt. In de tussentijd kunt u uw StatusHub-services naar eigen inzicht bijwerken. Zodra Uptrends detecteert dat de error is opgelost, updaten we uw service naar Service is operating normally en het incident naar Monitoring. Wanneer u zeker weet dat het probleem is opgelost, kunt u het incident in StatusHub instellen op Resolved. Op deze manier kunt u altijd bepalen wat er op uw statuspagina wordt weergegeven.

Heeft u vragen over het maken van de juiste setup? Neem dan contact op met ons supportteam.