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!

---

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';