Introduzione
In questo documento viene descritto come configurare gli eventi personalizzati in AppDynamics utilizzando l'API REST e connetterli alle regole di integrità per gli avvisi automatici.
Prerequisiti
- Accesso a un'istanza di AppDynamics SaaS o di un controller locale
- Autorizzazioni per creare e gestire eventi, regole di integrità e criteri
- Controller versione 21.x o successiva
- Canali di notifica (e-mail, SMS o integrazioni di terze parti) configurati
- Conoscenze di base delle API REST e dell'interfaccia utente AppDynamics
Requisiti
Prima di iniziare, verificare che siano soddisfatti i seguenti requisiti:
- AppDynamics Controller versione 21.x o successiva (per le funzionalità più recenti relative a eventi e avvisi)
- Accesso all'API REST abilitato per il controller
- Canali di notifica (e-mail, sms o integrazioni) configurati per il recapito degli avvisi
Componenti usati
- AppDynamics Controller
- Agenti AppDynamics
- Canali di notifica
Le informazioni discusse in questo documento fanno riferimento a dispositivi usati in uno specifico ambiente di emulazione. Su tutti i dispositivi menzionati nel documento la configurazione è stata ripristinata ai valori predefiniti. Se la rete è operativa, valutare attentamente eventuali conseguenze derivanti dall'uso dei comandi.
Premesse
In un mondo di architetture cloud native sempre più dinamiche, il monitoraggio proattivo è essenziale per garantire la resilienza del sistema e ridurre il tempo medio di risoluzione (MTTR). AppDynamics offre solide funzionalità di osservabilità, inclusa la possibilità di creare eventi e avvisi personalizzati che consentono ai team operativi di rilevare le anomalie più rapidamente e rispondere con precisione.
Le metriche preconfigurate sono fondamentali, ma i sistemi moderni spesso richiedono l'osservabilità specifica del contesto. Iniettando eventi personalizzati in AppDynamics, indipendentemente dal fatto che si stiano integrando pipeline CI/CD, strumenti di automazione personalizzati o sistemi esterni, è possibile:
- Visibilità unificata su metriche aziendali e di sistema
- Rilevamento in tempo reale di anomalie specifiche dell'applicazione
- Riduzione degli interventi manuali grazie ad azioni automatizzate
Talvolta è utile creare eventi personalizzati per monitorare aspetti specifici dell'applicazione. In questo articolo viene illustrato come creare eventi personalizzati tramite l'API REST in AppDynamics Controller e come configurare un avviso in base all'evento personalizzato.
Configurazione
In questa sezione viene descritto il processo dettagliato per la creazione di eventi personalizzati e la configurazione di avvisi in AppDynamics Controller.
Configurazioni
Passaggio 1: Creazione di eventi personalizzati tramite l'API REST
Gli eventi personalizzati possono essere generati utilizzando l'API REST di AppDynamics. Ciò è utile per l'integrazione di sistemi esterni, script personalizzati, framework di automazione o strumenti di terze parti:
Esempio di chiamata API:
POST https:///controller/rest/applications//events?severity=ERROR&summary=Application+Stopped&eventtype=CUSTOM&customeventtype=App_Stop&comment=Please_start_application
Parametri chiave:
- Sostituire <controller-url> e <application_id> con i dettagli del controller.
- Parametri obbligatori:
- gravità (INFO, WARN, ERROR)
- riepilogo (breve descrizione)
- eventtype (deve essere CUSTOM)
- customeventtype (etichetta del tipo di evento personalizzato)
- commento (messaggio dettagliato facoltativo)
Una richiesta riuscita restituisce un ID evento che conferma la creazione
Esempio: "Creazione dell'evento con ID:550346816 completata"
Suggerimento visibilità: Non dimenticare di abilitare il filtro Personalizzato nell'interfaccia utente Eventi per visualizzare gli eventi inseriti.

Passaggio 2: Filtraggio e monitoraggio degli eventi personalizzati
- Nell'interfaccia utente del controller passare alla sezione Eventi.
- Utilizzare Filtra per eventi personalizzati per aggiungere il tipo di evento o le proprietà.
- È possibile specificare coppie chiave/valore per un filtro più granulare.
- Utilizzare All per la logica AND (tutte le proprietà devono corrispondere) o Any per la logica OR (almeno una proprietà corrisponde)
In questo modo è possibile tenere traccia e analizzare in modo mirato gli eventi iniettati nell'applicazione.
Passaggio 3: Configurazione degli avvisi: Azioni e criteri
Azioni:
- Specificare l'operazione da eseguire quando viene attivato un evento personalizzato, ad esempio l'invio di messaggi di posta elettronica, messaggi SMS o la chiamata di un webhook:

Criteri:
- Creare un nuovo criterio o modificarne uno esistente:

- Nel criterio, configurare il filtro eventi personalizzato in modo che corrisponda all'evento personalizzato definito.


- Nella scheda Azioni criterio aggiungere una nuova azione e selezionare l'azione personalizzata creata:

- Salvare l'avviso: Dopo aver configurato l'avviso, fare clic su Salva per crearlo:

Una volta creato l'avviso, questo viene attivato ogni volta che nel controller viene generato un evento personalizzato corrispondente ai criteri specificati.
Verifica
- Inviare un evento personalizzato di test tramite l'API REST:

- Confermare la visibilità nell'interfaccia utente Eventi (controllare i filtri):

- Verificare che Action sia attivato per l'evento personalizzato:

- Convalida recapito tramite il canale di notifica configurato:


Risoluzione dei problemi
Problema |
Procedura di risoluzione dei problemi |
Evento non visibile
|
- Verificare che il filtro personalizzato sia abilitato per il tipo di evento nell'interfaccia utente eventi
- Verificare i parametri eventtype e customeventtype nella chiamata API.
|
Errori API
|
- Errore comune: "Riepilogo eventi non specificato." Fornisci sempre un riepilogo nella richiesta
- Verificare l'autenticazione e l'ID dell'applicazione nella chiamata API.
|
Avviso non attivato
|
- Verificare che la regola e il criterio di integrità siano configurati correttamente.
- Controllare la configurazione del canale di notifica (configurazione del server e-mail/sms).
|
Limiti di eventi personalizzati
|
- Il controller ha limiti per il conteggio degli schemi di eventi personalizzati e le dimensioni degli eventi.
- Consultare la documentazione per la registrazione di grandi volumi o di schemi complessi
|
Conclusioni
Gli eventi personalizzati e gli avvisi in AppDynamics offrono un modo efficace per arricchire la strategia di osservabilità. Sia che si stia eseguendo l'integrazione con strumenti CI/CD, servizi esterni o semplicemente estendendo la visibilità nei principali flussi di lavoro, queste funzionalità assicurano un rilevamento e una risoluzione dei problemi più rapidi prima che abbiano un impatto sugli utenti. Inizia a sfruttare l'intelligence dell'osservabilità personalizzata per migliorare il monitoraggio da reattivo a predittivo.
Ulteriore assistenza
In caso di domande o di problemi, contatta il supporto AppDynamics e includi dettagli quali messaggi di errore, informazioni di configurazione o registri rilevanti per accelerare la risoluzione dei problemi.
Informazioni correlate