dokucama

This is an old revision of the document!

---

To see the topology from a certain device's perspective:

Select device > Ports > Map

FOLDERS:

/opt/observium/config.php     # For multiple settings
/opt/observium/logs
/opt/observium   # all scripts are here

---

OBSERVIUM
Housekeeping : https://docs.observium.org/tuning/#housekeeping
Update : https://docs.observium.org/updating/

./discovery.php -V    # to see the CURRENT version
svn update
/opt/observium/discovery.php -u

Tuning: https://docs.observium.org/tuning/

---

Add and delete devices. Recreate device doesn't delete history:

/opt/observium/delete_device.php opengear.sg3.mgt.grapeshot.co.uk
/opt/observium/add_device.php opengear.sg3.mgt.grapeshot.co.uk ap v3 ODC XXXXXXXXXXXX YYYYYYYYYYY sha aes 161 udp

—-

Adding alert checkers:

• http://docs.observium.org/alerting_examples/
• http://www.maartenmoerman.nl/?p=612
• https://github.com/mgmoerman/docs/blob/master/observium-alert-checkers.md
• http://demo.observium.org/

Things to REMEMBER:

• Association, like in “device.device_id in” not something we can edit manually but gets generated when we do:
  • Alert Checker > device_down > Associations > Device in > Select all
  • ^^ We need to do this regularly to account for new or gone devices!
• In order to edit the “Entity Association Ruleset” access observium via managment address. If you access via public address, the menu appears empty!

This is an example of production alerts checkers (change it to xml extension): observium_templates_alert_allxml.txt

---

OBSERVIUM AND PAGER DUTY

• https://www.pagerduty.com/docs/guides/observium-integration-guide/

/opt/observium/test_alert.php -dc 1
https://api.pagerduty.com/

---

HOUSEKEEPING

/opt/observium/housekeeping.php -ya -d

---

REMOVED ALERTS:
traff_perc_70 : Test Conditions: ifInOctets_perc ge 70 ifOutOctets_perc ge 70 - Device Match * - Entity Match ifType equals ethernetCsmacd

---

TROUBLESHOOTING:

/opt/observium/discovery.php -V    # to check current version
tail -f observium.log /opt/observium/logs/observium.log # for snmp polling logs

mysql -p -u observium   # to access the database (credentials in config.php)
use observium;   # connects database
show tables;
describe alert_log;
SELECT * FROM alert_log where log_type = 'FAIL' ORDER BY timestamp DESC LIMIT 10;  # to check last alerts 
describe devices;
select device_id, hostname, sysName from devices where device_id = '440';