Observium

Detta är en gammal version av dokumentet!

Observium är ett system som används för nätverksövervakning. Systemet kan konfigureras till att skicka ut sina larm via så kallade webhooks och Orbiq har ett API för att ta emot utskicken via Webhooks från Observium och omvandla dessa till larm i Orbiq.

Så här ser mappningen ut mellan data från Observium och larmhanteringen i Orbiq:

Komponent i payload	Exempel på indata	Mappning inom Orbiq	Kommentar
ALERT_STATE	ALERT, ALERT REMINDER, RECOVER	Aktiv, Aktiv, Normal	Orbiq hanterar påminnelser om larm från Observium som ett aktivt händelse
ALERT_SEVERITY	Warning, Critical o.s.v.	Warning, Critical o.s.v.	Larmprio (severity) från Orbservium lagras i klartext
ALERT_TIMESTAMP	2023-04-03 09:31:18 +02:00	Source_time: 2023-04-03 09:31:18 +02:00	Tidstämpeln från Orbservium lagras som source_timestamp i Orbiq. Orbiq skapar även en egen tidstämpel för när larmet har tagits emot och sparar det som orbiq_timestamp
ALERT_ID	418812	{Alert_ID} Används som `subject (eller beteckning för larmpunkten)` för larmmeddelandet i Orbiq	Orbiq grupperar larmhändelser under unika beteckningar för larmpunkten. Alla larm från Observium som avser samma uppsatta ”regel” har också samma ”Alert_ID”, d.v.s. alla larmhändelser över tid, för samma typ av larm från samma enhet (exempelvis uteblivet pingsvar från switchXYZ) delar samma unika ”Alert_ID”. Därför används detta värde för att benämna larmpunkten. Eftersom detta ID inte ger någon meningsfull information till användaren, rekommenderar vi att användaren anger att Orbiq ska visa larmpunktens beskrivningstext istället för larmpunktens beteckning i larmlistan.
ALERT_MESSAGE ENTITY_NAME DEVICE_HOSTNAME DEVICE_LOCATION	ALERT: [mysitesw50] [device] mysitesw50 mysitesw50 Mylocation, MyCity	{Alert_Message} {Entity_Name} {Device_Hostname} {Device_Location} (det vill säga värdet för respektive variabel med mellanslag som skiljetecken) används som `beskrivningstext för larmpunkten` i Orbiq.	Om {Entity_Name} och {Device_Hostname} har samma innehåll, skrivs endast ett av dessa fält ut i beskrivningstexten. Värdet för beskrivningstexten uppdateras varje gång ett nytt larm kommer in, så eventuella förändringar av värden från Observium kommer att återspeglas i Orbiq. Kombinationen av dessa parametrar ger en bättre beskrivning av larmpunkten och därför rekommenderar vi att användaren anger att Orbiq ska visa larmpunktens beskrivningstext istället för larmpunktens beteckning i larmlistan.
ENTITY_URL ENTITY_NAME ENTITY_ID ENTITY_TYPE ENTITY_DESCRIPTION DEVICE_HOSTNAME DEVICE_SYSNAME DEVICE_DESCRIPTION DEVICE_ID DEVICE_URL DEVICE_HARDWARE DEVICE_OS DEVICE_TYPE DEVICE_LOCATION	http://url/device/device=1234/ mysitesw50 1679 device mysitesw50 mysitesw50 mysitesw50 ”” 1679 http://url/device/device=1234/ DG534F Switch 2512-24T-PoEP HPE ProCurve AB.32.03.0001 network Mylocation, MyCity	”metadata”: { ”entity_url”: ”http://url/device/device=1234/”, ”entity_name”: ”mysitesw50”, … }	Egenskaperna i denna rad lagras i Orbiq i form av metadata. Dessa data visas inte via Orbiqs användargränssnitt, men de finns lagrade i databasen och är tillgängliga via systemets API.