Automatic MRTG Configuration Management documentation

[TBT]

Where can we find documentation on the "Automatic MRTG Configuration Management" configuration option?

[DoubleDoubleA]

It turns out we don't have an external doc on that, however, while we address that gap, here's what we have internally:

As of XI 2024R1.2, users may opt in to automatic management of MRTG Configuration.

To opt in, go to Admin->System Config->System Settings->General. Check the box for "Automatic MRTG Configuration Management" and then "Update Settings".

You can see the MRTG configuration that XI expects to exist by going to Configure->CCM->Advanced->MRTG Files. If you have MRTG configuration which is missing from this page, you can run /usr/local/nagiosxi/scripts/import_mrtg_configuration.php to attempt an automatic scan.

Once imported, configuration file referenced are linked to a host. If the host is deleted, the file reference will also be deleted.
When you Apply Configuration, Nagios XI will only retain the MRTG files that are listed in the MRTG Files section of the CCM - any others will be deleted.

[lyraellington121]

The note about Apply Configuration removing MRTG files that aren't listed in the CCM is especially helpful and easy to overlook. One question: if someone already has a number of manually maintained MRTG configuration files, is there a recommended migration process before enabling this option? I'd be interested to know whether it's best to run the import script first and verify everything in Configure → CCM → Advanced → MRTG Files before applying the configuration to avoid accidentally removing existing files.

[gwalters]

The note about Apply Configuration removing MRTG files that aren't listed in the CCM is especially helpful and easy to overlook. One question: if someone already has a number of manually maintained MRTG configuration files, is there a recommended migration process before enabling this option? I'd be interested to know whether it's best to run the import script first and verify everything in Configure → CCM → Advanced → MRTG Files before applying the configuration to avoid accidentally removing existing files.https://essaypay.com/blog/how-to-write-an-essay-fast/

That's definitely something people could easily miss so it's a really useful question to raise.

[lvlDev]

Maybe a safer approach would be to back up all existing MRTG configuration files before enabling Automatic MRTG Configuration Management. Then run the import script, verify that all files appear in CCM, and only apply the configuration after confirming everything has been imported correctly.