Re: U

Jochen Bern <Jochen.Bern-RMkW/[email protected]>
Newsgroups gmane.network.nagios.plugins.devel
Organization LINworks GmbH
Message-ID <[email protected]>
On 22.08.2013 12:31, Holger Weiß wrote:
> * Jochen Bern <Jochen.Bern-RMkW/[email protected]> [2013-08-22 01:09]:
>> You might want to also change [...]
> 
> Agreed, to both.  Could anyone provide a patch?

I have neither git nor SGML tools at hand, but I'll try (-> attached).

Kind regards,
								J. Bern
-- 
*NEU* - NEC IT-Infrastruktur-Produkte im <http://www.linworks-shop.de/>:
Server--Storage--Virtualisierung--Management SW--Passion for Performance
Jochen Bern, Systemingenieur --- LINworks GmbH <http://www.LINworks.de/>
Postfach 100121, 64201 Darmstadt | Robert-Koch-Str. 9, 64331 Weiterstadt
PGP (1024D/4096g) FP = D18B 41B1 16C0 11BA 7F8C DCF7 E1D5 FAF4 444E 1C27
Tel. +49 6151 9067-231, Zentr. -0, Fax -299 - Amtsg. Darmstadt HRB 85202
Unternehmenssitz Weiterstadt, Geschäftsführer Metin Dogan, Oliver Michel

------------------------------------------------------------------------------
Introducing Performance Central, a new site from SourceForge and 
AppDynamics. Performance Central is your source for news, insights, 
analysis and resources for efficient Application Performance Management. 
Visit us today!
http://pubads.g.doubleclick.net/gampad/clk?id=48897511&iu=/4140/ostg.clktrk

_______________________________________________________
Nagios Plugin Development Mailing List Nagiosplug-devel-5NWGOfrQmneRv+LV9MX5uipxlwaOVQ5f@public.gmane.org
Unsubscribe at https://lists.sourceforge.net/lists/listinfo/nagiosplug-devel
::: Please include plugins version (-v) and OS when reporting any issue. 
::: Messages without supporting info will risk being sent to /dev/null
developer-guidelines.diff (text/x-patch, 2.3 KB)
--- developer-guidelines.sgml.orig	2013-08-22 16:04:26.062241886 +0200
+++ developer-guidelines.sgml	2013-08-22 16:26:42.196242661 +0200
@@ -83,10 +83,18 @@
 		STDOUT and not print to STDERR.</para>
 
 		<section><title>Print only one line of text</title>
-		<para>Nagios will only grab the first line of text from STDOUT
-		when it notifies contacts about potential problems. If you print
-		multiple lines, you're out of luck (though this will be a feature of 
-		Nagios 3). Remember, keep your output short and to the point.</para>
+		<para>Starting with version 3, Nagios will process plugins' multiline
+		output, which should be formatted as:</para>
+		<literallayout>
+		SERVICE STATUS: First line of output | First part of performance data
+		Any number of subsequent lines of output, but note that buffers
+		may have a limited size | Second part of performance data, which
+		may have continuation lines, too
+		</literallayout>
+		<para>Note, however, that the default configs still do not include
+		the output's continuation lines into the notifications sent when
+		Nagios notifies contacts about potential problems.
+		Thus, keep your output short and to the point.</para>
 
 		<para>Output should be in the format:</para>
 		<literallayout>
@@ -319,10 +327,14 @@
 		</section>
 
 		<section><title>Performance data</title>
-		<para>Performance data is defined by Nagios as "everything after the | of the plugin output" -
-		please refer to Nagios documentation for information on capturing this data to logfiles.
-		However, it is the responsibility of the plugin writer to ensure the 
-		performance data is in a "Nagios plugins" format.
+		<para>Nagios 3 and newer will concatenate the parts following a "|" in a) the first
+		line output by the plugin, and b) in the second to last line, into a string it
+		passes to whatever performance data processing it has configured. (Note that it
+		currently does not insert additional whitespace between both, so the plugin needs
+		to provide some to prevent the last pair of a) and the first of b) getting run
+		together.) Please refer to the Nagios documentation for information on how to
+		configure such processing. However, it is the responsibility of the plugin writer
+		to ensure the performance data is in a "Nagios plugins" format.
 		This is the expected format:</para>
 
 		<literallayout>
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.