Börjar med Föregående version. Nästa version. | Föregående version. |
integrationer:observium [2023/04/06 15:44] – dokuadmin | integrationer:observium [2023/09/08 09:09] (aktuell) – dokuadmin |
---|
====== Observium ====== | ====== Observium ====== |
| |
[[https://www.observium.org/|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. | [[https://www.observium.org/|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. Information om vilken data som skickas via Webhooks kan fås [[https://docs.observium.org/alerting_transports/?h=webhook#web-hook|här]]. |
| |
Så här ser mappningen ut mellan data från Observium och larmhanteringen i Orbiq: | Så här ser mappningen ut mellan data från Observium och larmhanteringen i Orbiq: |
| TITLE \\ --- \\ ENTITY_NAME \\ ENTITY_URL \\ CONDITIONS \\ METRICS \\ DURATION \\ --- \\ DEVICE_HOSTNAME \\ DEVICE_URL \\ DEVICE_HARDWARE \\ DEVICE_OS \\ DEVICE_LOCATION \\ DEVICE_UPTIME | ALERT: [vk-garnsw50] [device] \\ --- \\ Entity name: mysitesw50 \\ URL: http://url/device/device=1234/ \\ Conditions: device_status equals 0 (0) \\ Metrics: device_status = 0 \\ Duration: 5m 7s (2023-04-03 09:26:11) \\ --- \\ Device: mysitesw50 \\ URL: https://url/device/device=1234/ \\ Hardware: DG534F Switch 2512-24T-PoEP \\ OS: HPE ProCurve AB.32.03.0001 \\ Location: Mylocation, MyCity \\ Uptime: Down (PING) 5m 7s | Uppgifterna används för att bygga ''texten för larmhändelsen'' i Orbiq || | | TITLE \\ --- \\ ENTITY_NAME \\ ENTITY_URL \\ CONDITIONS \\ METRICS \\ DURATION \\ --- \\ DEVICE_HOSTNAME \\ DEVICE_URL \\ DEVICE_HARDWARE \\ DEVICE_OS \\ DEVICE_LOCATION \\ DEVICE_UPTIME | ALERT: [vk-garnsw50] [device] \\ --- \\ Entity name: mysitesw50 \\ URL: http://url/device/device=1234/ \\ Conditions: device_status equals 0 (0) \\ Metrics: device_status = 0 \\ Duration: 5m 7s (2023-04-03 09:26:11) \\ --- \\ Device: mysitesw50 \\ URL: https://url/device/device=1234/ \\ Hardware: DG534F Switch 2512-24T-PoEP \\ OS: HPE ProCurve AB.32.03.0001 \\ Location: Mylocation, MyCity \\ Uptime: Down (PING) 5m 7s | Uppgifterna används för att bygga ''texten för larmhändelsen'' i Orbiq || |
| |
| ====== Inställning av larmutskick ====== |
| |
| I Observium registreras adressen till Orbiqs endpoint för mottagning av larm via Webhooks, enligt formatet nedan. Platshållarna {orbiq_url} och {observium_endpoint} ska bytas ut mot faktiska URL:en för Orbiq-installationen samt den benämning för endpointen som ska matchas mot inställningen för larmkällan i Orbiq. |
| https://{orbiq_url}/api/iqalarm/alarmEvent/observium/{observium_endpoint} |
| I Orbiq registreras en resurs för Orbservium. I fältet för "adress", anges samma beteckning som för {observium_endpoint} ovan. |
| I drop-down väljaren för larmformat, välj alternativet Orbservium, eller Orbservium-lt, beroende av hur ni vill att larmmeddelandet ska presenteras/lagras i Orbiq. ''Observium-lt'' (light), är ett mera avskalat format, medan ''Observium'' innehåller mera information ur larmmeddelandet. |
| |
| {{:integrationer:pasted:20230908-110553.png?600}} |
| |