Nms-adhocFiles: Difference between revisions
Jump to navigation
Jump to search
(Created page with "==== 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 '-', as rrdtool gets heartburn when it sees it == 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...") |
m (→RRD) |
||
(One intermediate revision by the same user not shown) | |||
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 == | ||
Line 17: | Line 19: | ||
* Expect raw JSON | * Expect raw JSON | ||
* Overwrites on every iteration | * Overwrites on every iteration | ||
* Not intended to be consumed by UI. This is to debug issues with Graph generation normally. | |||
== templates == | == templates == |
Latest revision as of 12: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