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.mycompany1.co.uk
  /opt/observium/add_device.php opengear.sg3.mgt.mycompany1.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): {{ :nms: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';