パフォーマンスデータのソースを表示

== 導入 Introduction ==
Nagiosは [http://nagios.sourceforge.net/docs/3_0/plugins.html プラグイン] が返すステータスデータにパフォーマンスデータをつける事を許容しており、外部で動作するアプリケーションに処理させることも許容しています。パフォーマンスデータのタイプの違いの記述はデータ処理をどのように行うかというの情報は以下で述べます･･･ 


== パフォーマンスデータのタイプ Types of Performance Data ==
Nagiosから得られるパフォーマンスデータには2つの基本的なカテゴリがあります： 

#チェックパフォーマンスデータ
#プラグインパフォーマンスデータ 

チェックパフォーマンスデータはホストやサービスチェックの実際の実行と関係のある内部データです。これはサービスチェック遅延 (例：サービスチェックが予定された時間と比べてどれだけ"遅れて"実行されたか) とホスト､サービスチェックの実行時間がどれぐらいであったかと言うことが含まれています。このタイプのパフォーマンスデータは実行される全チェックで有効です。 [http://nagios.sourceforge.net/docs/3_0/macrolist.html#hostexecutiontime $HOSTEXECUTIONTIME$]と[http://nagios.sourceforge.net/docs/3_0/macrolist.html#serviceexecutiontime $SERVICEEXECUTIONTIME$]、 [http://nagios.sourceforge.net/docs/3_0/macros.html マクロ] にてホスト、サービスチェックの実行時間を取得でき、 [http://nagios.sourceforge.net/docs/3_0/macrolist.html#hostlatency $HOSTLATENCY$]と[http://nagios.sourceforge.net/docs/3_0/macrolist.html#servicelatency $SERVICELATENCY$] マクロにてホスト、サービスチェック実行がどれぐらい"遅延"しているか取得できます


プラグインパフォーマンスデータ はホスト､サービスチェックで使用する特定のプラグインの外部データです。プラグイン特有のデータにはパケットロスのパーセンテージ、ディスク空き容量、CPU負荷、現在のログインユーザ数などの情報が含まれています。 - 基本的にはプラグインが実行されたときの任意のメトリックタイプです。プラグイン特有のパフォーマンスデータはオプションで、プラグインによっては対応していないものもあるでしょう。プラグイン特有のパフォーマンスデータは(もし対応していれば) [http://nagios.sourceforge.net/docs/3_0/macrolist.html#hostperfdata $HOSTPERFDATA$] と [http://nagios.sourceforge.net/docs/3_0/macrolist.html#serviceperfdata $SERVICEPERFDATA$] [http://nagios.sourceforge.net/docs/3_0/macros.html マクロ]で取得できます。プラグインがどのように$HOSTPERFDATA$と$SERVICEPERFDATA$マクロへ加わりNagiosにパフォーマンスデータを返すことができるかについて、詳細は読んでください。 

== プラグインパフォーマンスデータ Plugin Performance Data ==
通常はプラグインは計測データのタイプの状態を示した1行のテキストを返します。たとえばcheck_pingプラグインはおそらく次の行を返すでしょう： 

 PING ok - Packet loss = 0%, RTA = 0.80 ms 

このシンプルな出力のタイプは、$HOSTOUTPUT$か$SERVICEOUTPUT$ [http://nagios.sourceforge.net/docs/3_0/macros.html macros] で利用可能です (このプラグインがホストチェックで使われているのか、サービスチェックで使われているのかによる)。 


プラグインがNagiosにパフォーマンスデータを返したければ、通常のテキストの返り文字列の後ろにパイプ文字(|)を加え、1つ以上のパフォーマンスデータメトリクス文字列を付け加えます。例としてcheck_pingプラグインを見てみると、パケットロスのパーセンテージとround tripタイムパフォーマンスデータメトリクスを返しています。サンプル出力は以下です： 

 PING ok - Packet loss = 0%, RTA = 0.80 ms | percent_packet_loss=0, rta=0.80

Nagiosはこのフォーマットのプラグイン出力を2つのパートに分割します： 

#パイプ文字の前のすべての出力は、"通常の"プラグイン出力であると考えられ、$HOSTOUTPUT$か$SERVICEOUTPUT$マクロに保存されます
#パイプ文字の後のすべての出力は、プラグイン特有のパフォーマンスデータであると考えられ、$HOSTPERFDATA$または$SERVICEPERFDATA$マクロに保存されます


上記の例では、 $HOSTOUTPUT$または$SERVICEOUTPUT$マクロは、 "PING ok - Packet loss = 0%, RTA = 0.80 ms" (引用記号は除く) を保存し、$HOSTPERFDATA$または$SERVICEPERFDATA$マクロは "percent_packet_loss=0, rta=0.80" (引用記号は除く)を保存します。 

パフォーマンスデータ（通常のテキスト出力と同様）の複数のラインがプラグインから得られることは、[http://nagios.sourceforge.net/docs/3_0/pluginapi.html プラグインAPIドキュメンテーション]に記述されています。



[[ファイル:Note.gif|bottom]]note: Nagiosデーモンはプラグインパフォーマンスデータを直接処理しないので、パフォーマンスデータがどのように見えるのか、全く気にしません。 パフォーマンスデータのフォーマットまたは内容に本来は限界が全くありません。しかし、パフォーマンスデータを処理するために外部アドオン（例:PerfParse）を使用しているならば、アドオンはプラグインが特定のフォーマットでパフォーマンスデータを返すと予想しているかもしれません。アドオンの詳細な情報はドキュメンテーションをチェックしてください。


== パフォーマンスデータ処理 Processing Performance Data ==
Nagiosとプラグインからのパフォーマンスデータを処理したいのであれば、以下の作業を行う必要があります： 

#process_performance_dataオプションを有効にする。
#パフォーマンスデータをファイルに書く、もしくは外部コマンドで処理するようNagiosをセットアップする。 


パフォーマンスデータの処理をファイルに書いて実行するか、コマンドで実行するかはインフォメーションを読んでください。 


== コマンドを使ってパフォーマンスデータを処理する Processing Performance Data Using Commands ==
パフォーマンスデータを処理する最も柔軟な方法は、Nagiosに後で処理をさせるために外部アプリケーションでデータを処理するか、リダイレクト命令（あなたが指定する）を実行させることです。 それぞれ、Nagiosがプロセスホストとサービスパフォーマンスデータに実行するコマンドは、 [http://nagios.sourceforge.net/docs/3_0/configmain.html#host_perfdata_command host_perfdata_command] と [http://nagios.sourceforge.net/docs/3_0/configmain.html#service_perfdata_command service_perfdata_command]オプションで測定されます。 

他のアプリケーションで後で処理するためにサービスチェックパフォーマンスデータをテキストファイルにリダイレクトする命令定義の例は、下記になります： 

<pre>
define command{

	command_name	store-service-perfdata

	command_line	/bin/echo -e "$LASTSERVICECHECK$\t$HOSTNAME$\t$SERVICEDESC$\t$SERVICESTATE$\t$SERVICEATTEMPT$\t$SERVICESTATETYPE$\t$SERVICEEXECUTIONTIME$\t$SERVICELATENCY$\t$SERVICEOUTPUT$\t$SERVICEPERFDATA$" >> /usr/local/nagios/var/service-perfdata.dat

	}
</pre>

[[ファイル:Hint.gif|bottom]]Tip: この柔軟な方法の間は、CPUのオーバーヘッドが比較的高くなります。多数のホストとサービスのためにパフォーマンスデータを処理しているならば、多分あなたはNagiosがその代わりにファイルにパフォーマンスデータを書くことを望むでしょう。この方法は、次のセクションで記述されます。

== パフォーマンスデータをファイルに出力する  Writing Performance Data To Files ==
Nagiosが直接、[http://nagios.sourceforge.net/docs/3_0/configmain.html#host_perfdata_file host_perfdata_file]と[http://nagios.sourceforge.net/docs/3_0/configmain.html#service_perfdata_file service_perfdata_file]オプションを使用しているテキストファイルにすべてのホストとサービスパフォーマンスデータを書くことができます。ホストとサービスパフォーマンスデータがファイルに書かれるフォーマットは、[http://nagios.sourceforge.net/docs/3_0/configmain.html#host_perfdata_file_template host_perfdata_file_template]と [http://nagios.sourceforge.net/docs/3_0/configmain.html#service_perfdata_file_template service_perfdata_file_template]オプションで測定されます。 


サービスパフォーマンスデータのファイルフォーマットテンプレートの例は、このようになるかもしれません： 

 service_perfdata_file_template=[SERVICEPERFDATA]\t$TIMET$\t$HOSTNAME$\t$SERVICEDESC$\t$SERVICEEXECUTIONTIME$\t$SERVICELATENCY$\t$SERVICEOUTPUT$\t$SERVICEPERFDATA$


デフォルトで、テキストファイルは"append"モードで開けられます。"write"モードまたは"non-blocking read/write"（パイプに書くとき、役に立つ）に変える必要があるならば、 [http://nagios.sourceforge.net/docs/3_0/configmain.html#host_perfdata_file_mode host_perfdata_file_mode] と [http://nagios.sourceforge.net/docs/3_0/configmain.html#service_perfdata_file_mode service_perfdata_file_mode] オプションを使用します。 


さらに、定期的にNagiosに[http://nagios.sourceforge.net/docs/3_0/configmain.html#host_perfdata_file_processing_command host_perfdata_file_processing_command] と [http://nagios.sourceforge.net/docs/3_0/configmain.html#service_perfdata_file_processing_command service_perfdata_file_processing_command ]オプションを使用しているパフォーマンスデータファイルを処理しなさいという命令（例:入れ替える）を実行させることができます。これらの命令が実行される間隔は、 [http://nagios.sourceforge.net/docs/3_0/configmain.html#host_perfdata_file_processing_interval host_perfdata_file_processing_interval] と [http://nagios.sourceforge.net/docs/3_0/configmain.html#service_perfdata_file_processing_interval service_perfdata_file_processing_interval] オプションによって管理されます。