Inleiding
In dit document wordt beschreven hoe aangepaste gebeurtenissen in AppDynamics kunnen worden geconfigureerd met behulp van de REST-API en hoe deze kunnen worden gekoppeld aan gezondheidsregels voor automatische waarschuwingen.
Voorwaarden
- Toegang tot een AppDynamics SaaS- of on-premises Controller-instantie
- Rechten voor het maken en beheren van gebeurtenissen, gezondheidsregels en beleidsregels
- Controller versie 21.x of hoger
- Meldingskanalen (e-mail, sms of integraties van derden) geconfigureerd
- Basiskennis van REST API's en de AppDynamics-gebruikersinterface
Vereisten
Zorg ervoor dat u aan deze vereisten voldoet voordat u begint met:
- AppDynamics Controller versie 21.x of hoger (voor de nieuwste gebeurtenissen en waarschuwingsfuncties)
- REST API-toegang ingeschakeld voor uw controller
- Meldingskanalen (e-mail, sms of integraties) geconfigureerd voor levering van waarschuwingen
Gebruikte componenten
- AppDynamics-controller
- AppDynamics-agents
- Meldingskanalen
De informatie in dit document is gebaseerd op de apparaten in een specifieke laboratoriumomgeving. Alle apparaten die in dit document worden beschreven, hadden een opgeschoonde (standaard)configuratie. Als uw netwerk live is, moet u zorgen dat u de potentiële impact van elke opdracht begrijpt.
Achtergrondinformatie
In een wereld van steeds dynamischer cloud-native architecturen is proactieve monitoring essentieel om de veerkracht van het systeem te waarborgen en de gemiddelde tijd tot oplossing (MTTR) te verkorten. AppDynamics biedt robuuste observatiemogelijkheden, waaronder de mogelijkheid om aangepaste gebeurtenissen en waarschuwingen te maken die operatieteams helpen anomalieën sneller te detecteren en met precisie te reageren.
Out-of-the-box statistieken zijn van cruciaal belang, maar moderne systemen vereisen vaak contextspecifieke observeerbaarheid. Of u nu CI / CD-pijpleidingen, aangepaste automatiseringstools of externe systemen integreert, het injecteren van aangepaste gebeurtenissen in AppDynamics zorgt voor:
- Uniforme zichtbaarheid voor systeem- en bedrijfsstatistieken
- Realtime detectie van toepassingsspecifieke anomalieën
- Minder handmatige interventie door geautomatiseerde acties
Soms is het zinvol om aangepaste gebeurtenissen te maken om specifieke aspecten van uw toepassing te bewaken. Dit artikel is bedoeld om u te helpen bij het maken van aangepaste gebeurtenissen via REST API in AppDynamics-controller en het instellen van een waarschuwing op basis van de aangepaste gebeurtenis.
Configureren
Deze sectie behandelt het stapsgewijze proces om aangepaste gebeurtenissen te maken en waarschuwingen te configureren in AppDynamics Controller.
Configuraties
Stap 1: Aangepaste evenementen maken via REST API
Aangepaste gebeurtenissen kunnen worden gegenereerd met behulp van de AppDynamics REST API. Dit is handig voor het integreren van externe systemen, aangepaste scripts, automatiseringsframework of hulpprogramma's van derden:
Voorbeeld API-oproep:
POST https:///controller/rest/applications//events?severity=ERROR&summary=Application+Stopped&eventtype=CUSTOM&customeventtype=App_Stop&comment=Please_start_application
Belangrijkste parameters:
- Vervang <controller-url> en <application_id> door uw controllergegevens.
- Vereiste parameters:
- ERNST (INFO, WAARSCHUWING, FOUT)
- Samenvatting (korte beschrijving)
- gebeurtenistype (moet CUSTOM zijn)
- CustomerEventType (uw aangepaste label voor gebeurtenistype)
- Commentaar (optioneel gedetailleerd bericht)
Een succesvolle aanvraag retourneert een gebeurtenis-ID die de aanmaak bevestigt
Voorbeeld: "De gebeurtenis-id: 550346816 is gemaakt"
Zichtbaarheidstip: vergeet niet het aangepaste filter in de Events UI in te schakelen om de geïnjecteerde gebeurtenissen te bekijken.

Stap 2: Aangepaste gebeurtenissen filteren en bewaken
- Navigeer in de Controller UI naar de sectie Evenementen.
- Gebruik Filter op aangepaste gebeurtenissen om uw gebeurtenistype of eigenschappen toe te voegen.
- U kunt sleutel-/waardeparen opgeven voor meer granulaire filtering.
- Gebruik Alles voor AND-logica (alle eigenschappen moeten overeenkomen) of Alle voor OR-logica (ten minste één eigenschap komt overeen)
Dit maakt gerichte tracking en onderzoek van geïnjecteerde gebeurtenissen in uw toepassing mogelijk.
Stap 3: Waarschuwingen configureren: acties en beleid
Acties:
- Geef op wat er gebeurt wanneer een aangepaste gebeurtenis wordt geactiveerd (zoals e-mail verzenden, sms of een webhook oproepen):

Beleid:
- Maak een nieuw beleid of bewerk een bestaand beleid:

- Configureer in het beleid het aangepaste gebeurtenisfilter zodat het overeenkomt met de aangepaste gebeurtenis die u hebt gedefinieerd.


- Voeg op het tabblad Beleidsacties een nieuwe actie toe en selecteer de aangepaste actie die u hebt gemaakt:

- De waarschuwing opslaan: nadat u de waarschuwing hebt geconfigureerd, klikt u op Opslaan om deze aan te maken:

Zodra u de waarschuwing hebt gemaakt, wordt deze geactiveerd wanneer een aangepaste gebeurtenis die voldoet aan de opgegeven criteria wordt gegenereerd in de controller.
Verifiëren
- Een aangepaste testevent plaatsen via REST API:

- Bevestig de zichtbaarheid in de Events UI (controleer de filters):

- Valideren dat de actie is geactiveerd voor de aangepaste gebeurtenis:

- Levering valideren via het geconfigureerde meldingskanaal:


Problemen oplossen
uitgeven |
Stappen voor probleemoplossing |
Gebeurtenis niet zichtbaar
|
- Zorg ervoor dat het aangepaste filter is ingeschakeld in de Events UI
- Dubbelcheck eventtype en customevent type parameters in uw API-oproep.
|
API-fouten
|
- Veelvoorkomende fout: "Overzicht van gebeurtenissen is niet opgegeven." Geef altijd een samenvatting in je aanvraag
- Verifieer verificatie en toepassing-ID in de API-oproep.
|
Dringend bericht niet geactiveerd
|
- Bevestig dat de gezondheidsregel en het gezondheidsbeleid correct zijn geconfigureerd.
- Controleer de configuratie van het meldingskanaal (configuratie van e-mail/sms-server).
|
Aangepaste gebeurtenislimieten
|
- De controller heeft limieten voor het aantal aangepaste gebeurtenisschema's en de grootte van de gebeurtenis.
- Documentatie bekijken als u grote volumes of complexe schema's plaatst
|
Conclusie
Aangepaste gebeurtenissen en waarschuwingen in AppDynamics bieden een krachtige manier om uw observatiestrategie te verrijken. Of u nu werkt met CI/CD-tools, externe services of alleen de zichtbaarheid van belangrijke workflows vergroot, deze mogelijkheden zorgen voor een snellere detectie en oplossing van problemen voordat ze van invloed zijn op gebruikers. Maak gebruik van aangepaste observability intelligence om uw monitoring van reactief naar voorspellend te verhogen.
Verdere hulp nodig
Als u een vraag hebt of problemen ondervindt, neemt u contact op met AppDynamics Support en neemt u details op zoals foutmeldingen, configuratie-informatie of relevante logboeken om het oplossen van problemen te versnellen.
Gerelateerde informatie