Aggiungere un modello di allarme
Per aggiungere un modello di allarme, vai su /root/Alarming e seleziona Aggiungi modello di allarme dal menu a tendina Modelli di allarme o cliccando sull'icona a sinistra del menu a tendina:
Inserisci un nome e un oggetto per il messaggio di allarme. Quindi configura il messaggio di allarme utilizzando i tag disponibili nei tre elenchi a discesa dei tag. I tag comuni sono tag che descrivono l'allarme in generale (timestamp, durata...), il secondo set di tag, i tag dell'oggetto sorgente, descrive l'oggetto a cui è collegato il dispositivo di allarme o il gruppo di allarme, mentre il terzo set di tag, i tag dell'oggetto di origine, descrive l'oggetto che ha effettivamente emesso l'allarme.
Se nel messaggio di allarme deve essere inviato un segno di percentuale, ad esempio in un link codificato URL, deve essere preceduto dal carattere "%". Il carattere "/" codificato URL (ad esempio %2F) deve essere scritto come %%2F
Gli allarmi vengono inviati in formato testo semplice per impostazione predefinita. Se lo si desidera, gli allarmi possono essere inviati anche in formato HTML. A tal fine, la sezione Corpo deve iniziare con un tag HTML. Come punto di partenza, consultare l'esempio di modello HTML fornito a destra della sezione Corpo. Il contenuto di questo esempio può essere incollato direttamente nella sezione Corpo e modificato lì secondo necessità.
Esempio di modello completo di e-mail di allarme
Definizione dell'oggetto:
SKOOR Engine - Alarm from %o %n on Device %-A -- State: %s Event: %e
Risultato per un lavoro: SKOOR Engine - Allarme da Deviceprinter su stampante Device -- Stato: Evento Major: AlarmOpened
Risultato per uno SLO: SKOOR Engine - Allarme da reparto stampa SLO su stampante Device -- Stato: Evento Major: AlarmOpened Definizione
del corpo:
Common: ======== +-------------------------------------------------------------------- # Event type: %e # Device: %-A # Reason: %r +-------------------------------------------------------------------- Time Stamp Current: %t Time Stamp Opened: %T Duration: %d Comment: %c Currently Assigned: %q Alarming object: %u Alarms on object: %U Source Object (Alarm from): ============================ The object where the Alarm-Group/Device is linked to Name: %n Type: %o State: %s Statistics: %S1 Statistics detail: %S2 Values: %v Device Address: %a Device Name: %A Job info: %i Alarm limits: %h Origin Object (Alarm Cause) ============================ The real culprit, initial reason Name: %-n Type: %-o State: %-s Values: %-v Device Address: %-a Device Name: %-A Job Info: %-i Alarm Limits: %-h
Il corpo del messaggio effettivamente ricevuto sarebbe quindi (per l'esempio SLO sopra riportato):
Comune:
========
+--------------------------------------------------------------------#
Tipo di evento:
AlarmOpened# Dispositivo: printer#
Motivo: SLO "Reparto stampa" è nello stato "Major" poiché il lavoro "Snmp sysName.0" su "printer" è nello stato "Major" poiché il codice di errore è 5 (errore di timeout) > 0 (nessun errore)
+--------------------------------------------------------------------
Data e ora attuali: 24/08/2017 17:03:35 (MET)
Data e ora di apertura: 24/08/2017 17:03:35 (MET)
Durata: 0s
Commento:
Attualmente assegnato: Oggetto
allarme: http://<SKOOR Engine-server>/?do=navigate-obj&type=SLO&id=93
Allarmi sull'oggetto: http://<SKOOR Engine-server>/?do=navigate-alarm&type=SLO&id=93&alarmid=7189&ts=1385049815 Oggetto
sorgente (allarme da):
============================
L'oggetto a cui è collegato il
gruppo di allarmi/dispositivo Nome: Reparto stampa
Tipo: SLO
Stato: Grave
Statistiche: Warning: 0
Minor: 0
Major: 1 Dettagli
statistiche: Il lavoro "Snmp sysName.0" è Major
Valori:
Indirizzo dispositivo: Nome
dispositivo: Informazioni
sul lavoro:
Limiti di allarme: Oggetto
di origine (causa dell'allarme)
============================
Il vero colpevole, motivo iniziale
Nome: Snmp sysName.0
Tipo: Lavoro
Stato: Major
Valori: Codice di errore = 5 (Errore di timeout)
Indirizzo del dispositivo: 10.1.0.156 Nome
del dispositivo: stampante Informazioni
sul lavoro: Timeout richiesta da 10.1.0.156:161. (OID 1) Limiti
di allarme: Warning: se qualsiasi codice
di errore <> 0 (nessun errore)
Major: se qualsiasi codice
di errore > 0 (nessun errore)
I collegamenti ipertestuali HTTP %u e %U nell'e-mail consentono al destinatario di passare direttamente all'oggetto SKOOR Engine (%u) che ha emesso l'allarme o all'elenco degli allarmi dell'oggetto.
Esempio di modello di file CSV completo dell'allarme
Definizione dell'oggetto:
Alarm from %o %n State: %s Event: %e %t
Definizione del corpo:
Event Type: %e, Timestamp Current: %t, Opened: %T, Duration: %d, Comment: %c, Name: %n, Device Address: %a, Device Name: %A, Job Info: %i, Object Type: %o, State: %s, Values: %v, Limits: %h, Alarm Info (short): %0, Alarm Info (long): %1, Alarm Info (file):%2, Name: %-n, DeviceAddress: %-a, Device Name: %-A, Job Info: %-I, Object Type: %-o, State: %-s, Values: %-v, Alarm Limits: %-h, Origin Alarm Info (short): %-0, Origin Alarm Info (long): %-1, Origin Alarm Info (file):%-2
Esempio di modello SMS di allarme
Per gli SMS si consiglia di definire un modello di allarme separato. In generale, per i modelli SMS verrà considerato solo l'oggetto e il corpo verrà ignorato. Per messaggi più lunghi, utilizzare solo il campo del corpo del messaggio e lasciare vuoto il campo dell'oggetto. Verranno quindi inviati più SMS.
Definizione dell'oggetto:
Alarm %t %e %-n on %-A
SMS risultante: Allarme 2017.08.24 13:59:50 (Europa/Zurigo) AlarmSeverityUp Icmp su localhost
Configurazione URL per i tag %u e %U
Per poter aprire un oggetto nel SKOOR Engine direttamente da un messaggio di allarme, è necessario configurare l'URL del SKOOR Engine impostando il parametro ui_url nel seguente file di configurazione:
/etc/opt/eranger/eranger-server.cfg
Esempio per il server SKOOR Engine skoorsrv:
ui_url = https://skoorsrv

