Nms-adhocFiles: Difference between revisions

From I Will Fear No Evil
Jump to navigation Jump to search
 
Line 6: Line 6:
== RRD ==
== RRD ==
* Reside in the NMS API root path rrd/<hostname>/<pollerGenerated>/filterDir/rrdFilename.rrd
* Reside in the NMS API root path rrd/<hostname>/<pollerGenerated>/filterDir/rrdFilename.rrd
* Do NOT use dash '-', as rrdtool gets heartburn when it sees it
* Do NOT use dash '-' in filenames, as rrdtool gets heartburn when it sees it (why?  WTF?)
* in general, if there is an rrd file, there should be a rendering template associated with it, or why bother making the rrd.
* minimal testing of rrd against adhoc metrics from nrpe.  Additional debugging needed here.


== File ==
== File ==

Latest revision as of 13:43, 14 July 2023

Files created by the NMS or users

Just a basic description of the files that are generated by the NMS or users for the NMS to consume.


RRD

  • Reside in the NMS API root path rrd/<hostname>/<pollerGenerated>/filterDir/rrdFilename.rrd
  • Do NOT use dash '-' in filenames, as rrdtool gets heartburn when it sees it (why? WTF?)
  • in general, if there is an rrd file, there should be a rendering template associated with it, or why bother making the rrd.
  • minimal testing of rrd against adhoc metrics from nrpe. Additional debugging needed here.

File

  • resides in NMS API root path file/<hostname>/<checkName.txt>
  • Only supporting txt right now. Likely will not need support for other types
  • API to support this needs to be written for UI to display

DebugFile

  • resides in NMS API root path file/<hostname>/debugger/<checkName.txt>
  • Expect raw JSON
  • Overwrites on every iteration
  • Not intended to be consumed by UI. This is to debug issues with Graph generation normally.

templates

  • resides in NMS API root path templates/<function>/???
  • Break out function as directories to make clear what is going on where
  • Keep up on the debuggers here

logs

  • resides in NMS API root path logs/<logName.log>
  • logrotate set for this directory

config

  • resides in NMS API root path app/config.php
  • Should remain fairly static after install
  • contains salt, so backups should be made for recovery