To facilitate communication between users and developers, we are introducing a new switch:
The idea behind this switch: advanced users that want to test a script or a function which appears not to be working properly usually switch to the command line. Should they require the assistance of the developer, they previously had to include the output of the script in an email. In most cases, this was not enough and resulted in more requests from the developer such as: creating and sending rawdump, creating and sending verbose output – annoying! This just became much easier thanks to
All you have to do is include the
--mammamia switch when launching a collector plugin from the command line. As a result, the plugin creates a directory with all relevant information. It can then be inspected with a text editor before compressing it to a tar or zip and sending it to the developer by email.
The following example depicts the use of the
$ ./get_netapp_perfdata.pl -H sim812 -o volume --mammamia MAMMMIA-info sucessfully written into '.../check_netapp_pro/store/..._sim812_volume_2014-06-02T06:35:15.mammamia'. Further instructions are in this directorys _README.txt $ cd check_netapp_pro/store/..._sim812_volume_2014-06-02T06\:35\:15.mammamia/ $ ls -l -rw-r--r-- 1 il staff 596 2 Jun 08:35 01-opts.txt -rw-r--r-- 1 il staff 7852 2 Jun 08:35 02-output.txt -rw-r--r-- 1 il staff 885 2 Jun 08:35 _README.txt -rw-r--r-- 1 il staff 33629 2 Jun 08:35 raw_dump.raw -rw-r--r-- 1 il staff 151328 2 Jun 08:35 ref_dump.txt $ cat _README.txt This directory contains: * opts: stdin (program arguments) * output: stdout (program output) & stderr (debug messages) * raw_dump, ref_dump: Data got from filer in a human-readable txt- and a binary raw-format. The latter can be deleted if your organizations security policy requires to visually scan the data. It's content is the same as that of the txt-file. The data in this directory is pure configuration and/or performance data. But please keep in mind, that if you set the password directly on the command line the password itself will be in the opts-file in cleartext. You can either delete it manually there or even better avoid this problem by using the --authfile switch. Please compress and tar this directory before you send it to firstname.lastname@example.org in order to get help or if you are going to request an additional feature for a specific command.