オブジェクト定義のソースを表示

== 導入 Introduction ==

Nagiosのオブジェクト設定フォーマットの1つの特徴として、他のオブジェクト定義からの継承プロパティーをオブジェクト定義として作ることができるということがあります。継承オブジェクトの動作方法についてはここにあります。オブジェクト定義の作成やメンテナンスをより簡単にするためにこのドキュメントを読んで充分に理解することをつよくお薦めします。 また, 違った形で退屈な設定作業のための近道を[http://nagios.sourceforge.net/docs/3_0/objecttricks.html オブジェクトのトリック]で提供しているので研究してください。

設定ファイルを作成または編集する時、以下の事を覚えておいて下さい：<br>

1.'#'文字で始まる行はコメントであり、実行されない <br>
2.設定の名前は大文字小文字を区別する <br>
3.設定行の中のセミコロン(;)の後の文字はコメントとして扱われ、実行されない<br>

== リテンションのメモ Retention Notes  ==
重要な点としては、ホスト、サービスや通知定義のいくつかの設定が変更されても Nagiosがあなたが設定ファイルの中で変更したそれを認識しない場合があるということです。このような挙動をするオブジェクトの設定にはアスタリスクマークを付けています (*)。このような動きの理由は [http://nagios.sourceforge.net/docs/3_0/objectdefinitions.html#retain_state_information 状態保存]オプションがプログラムワイドに有効になっていたり、設定の値が [http://nagios.sourceforge.net/docs/3_0/configmain.html#check_external_commands 外部コマンド]で実行中に変更される場合、Nagiosは設定ファイルの [http://nagios.sourceforge.net/docs/3_0/objectdefinitions.html#state_retention_file 状態保存ファイル]に保存されている値を選択するからです。

この問題を解決する方法の１つとしては、ホスト、サービスや通知定義の retain_nonstatus_information設定を使用してnon-status情報は保存しないようにすることです。この設定で無効にするとNagiosが（再）起動した際に保存ファイルの状態よりも設定ファイルの初期値を参照するようになります。このオプションを使用するのはあまり推奨していません、というのは(あなたの視点から見て) 予期しない結果になってしまうからです。

== サンプル設定ファイル Sample Configuration Files ==
注釈: サンプル設定ファイルは [http://nagios.sourceforge.net/docs/3_0/quickstart.html クイックスタートインストールガイド]に従うと、/usr/local/nagios/etc/ にインストールされます。


== オブジェクトタイプ Object Types ==
*[[#ホスト定義|ホスト定義]]　(Host definitions)
*ホストグループ定義
*サービス定義
*サービスグループ定義
*通知定義
*通知グループ定義
*時間帯定義
*コマンド定義
*サービス依存定義
*サービスエスカレーション定義
*ホスト依存定義
*ホストエスカレーション定義
*ホスト依存定義
*ホストエスカレーション定義
*拡張ホスト情報定義
*拡張サービス情報定義


<div style="background:#cbcbcb;font-family: verdana,arial,serif; font-size: 10pt; font-weight: bold;">ホスト定義　(Host definitions)<span id="ホスト定義"></span></div>
<div style="font-family: verdana,arial,serif; font-size: 8pt; font-weight: bold; text-decoration: underline;">説明</div>
ホスト定義は、物理的なサーバ、ワークステーション、あなたのネットワークにあるデバイスなどを定義するのに使用されます。

<div style="font-family: verdana,arial,serif; font-size: 8pt; font-weight: bold; text-decoration: underline;">定義フォーマット</div>
注意: 赤の設定は必須ですが、黒の設定は任意です。

赤で書かれた設定は必須ですが、黒でかかれているものは任意です。

<table class="Default" border="0">
  <tr>
    <td class="Definition" colspan="3">define host{</td></tr>
  <tr>
    <td></td>

    <td class="Required">host_name</td>
    <td class="Required"><i>host_name</i></td></tr>
  <tr>
    <td></td>
    <td class="Required">alias</td>
    <td class="Required"><i>alias</i></td></tr>
  <tr>

    <td></td>
    <td class="Optional">display_name</td>
    <td class="Optional"><i>display_name</i></td></tr>
  <tr>
    <td></td>
    <td class="Required">address</td>
    <td class="Required"><i>address</i></td></tr>

  <tr>
    <td></td>
    <td class="Optional">parents</td>
    <td class="Optional"><i>host_names</i></td></tr>
  <tr>
    <td></td>
    <td class="Optional">hostgroups</td>

    <td class="Optional"><i>hostgroup_names</i></td></tr>
  <tr>
    <td></td>
    <td class="Optional">check_command</td>
    <td class="Optional"><i>command_name</i></td></tr>
  <tr>
    <td></td>

    <td class="Optional">initial_state</td>
    <td class="Optional">[o,d,u]</td></tr>
  <tr>
    <td></td>
    <td class="Required">max_check_attempts</td>
    <td class="Required">#</td></tr>
  <tr>

    <td></td>
    <td class="Optional">check_interval</td>
    <td class="Optional">#</td></tr>
  <tr>
    <td></td>
    <td class="Optional">retry_interval</td>
    <td class="Optional">#</td></tr>

  <tr>
    <td></td>
    <td class="Optional">active_checks_enabled</td>
    <td class="Optional">[0/1]</td></tr>
  <tr>
    <td></td>
    <td class="Optional">passive_checks_enabled</td>

    <td class="Optional">[0/1]</td></tr>
  <tr>
    <td></td>
    <td class="Required">check_period</td>
    <td class="Required"><i>timeperiod_name</i></td></tr>
  <tr>
    <td></td>

    <td class="Optional">obsess_over_host</td>
    <td class="Optional">[0/1]</td></tr>
  <tr>
    <td></td>
    <td class="Optional">check_freshness</td>
    <td class="Optional">[0/1]</td></tr>
  <tr>

    <td></td>
    <td class="Optional">freshness_threshold</td>
    <td class="Optional">#</td></tr>
  <tr>
    <td></td>
    <td class="Optional">event_handler</td>
    <td class="Optional"><i>command_name</i></td></tr>

  <tr>
    <td></td>
    <td class="Optional">event_handler_enabled</td>
    <td class="Optional">[0/1]</td></tr>
  <tr>
    <td></td>
    <td class="Optional">low_flap_threshold</td>

    <td class="Optional">#</td></tr>
  <tr>
    <td></td>
    <td class="Optional">high_flap_threshold</td>
    <td class="Optional">#</td></tr>
  <tr>
    <td></td>

    <td class="Optional">flap_detection_enabled</td>
    <td class="Optional">[0/1]</td></tr>
  <tr>
    <td></td>
    <td class="Optional">flap_detection_options</td>
    <td class="Optional">[o,d,u]</td></tr><!--<tr><td></td><td class="Optional">failure_prediction_enabled</td><td class="Optional">[0/1]</td></tr>//-->
  <tr>

    <td></td>
    <td class="Optional">process_perf_data</td>
    <td class="Optional">[0/1]</td></tr>
  <tr>
    <td></td>
    <td class="Optional">retain_status_information</td>
    <td class="Optional">[0/1]</td></tr>

  <tr>
    <td></td>
    <td class="Optional">retain_nonstatus_information</td>
    <td class="Optional">[0/1]</td></tr>
  <tr>
    <td></td>
    <td class="Required">contacts</td>

    <td class="Required"><i>contacts</i></td></tr>
  <tr>
    <td></td>
    <td class="Required">contact_groups</td>
    <td class="Required"><i>contact_groups</i></td></tr>
  <tr>
    <td></td>

    <td class="Required">notification_interval</td>
    <td class="Required">#</td></tr>
  <tr>
    <td></td>
    <td class="Optional">first_notification_delay</td>
    <td class="Optional">#</td></tr>
  <tr>

    <td></td>
    <td class="Required">notification_period</td>
    <td class="Required"><i>timeperiod_name</i></td></tr>
  <tr>
    <td></td>
    <td class="Optional">notification_options</td>
    <td class="Optional">[d,u,r,f,s]</td></tr>

  <tr>
    <td></td>
    <td class="Optional">notifications_enabled</td>
    <td class="Optional">[0/1]</td></tr>
  <tr>
    <td></td>
    <td class="Optional">stalking_options</td>

    <td class="Optional">[o,d,u]</td></tr>
  <tr>
    <td></td>
    <td class="Optional">notes</td>
    <td class="Optional"><i>note_string</i></td></tr>
  <tr>
    <td></td>

    <td class="Optional">notes_url</td>
    <td class="Optional"><i>url</i></td></tr>
  <tr>
    <td></td>
    <td class="Optional">action_url</td>
    <td class="Optional"><i>url</i></td></tr>
  <tr>

    <td></td>
    <td class="Optional">icon_image</td>
    <td class="Optional"><i>image_file</i></td></tr>
  <tr>
    <td></td>
    <td class="Optional">icon_image_alt</td>
    <td class="Optional"><i>alt_string</i></td></tr>

  <tr>
    <td></td>
    <td class="Optional">vrml_image</td>
    <td class="Optional"><i>image_file</i></td></tr>
  <tr>
    <td></td>
    <td class="Optional">statusmap_image</td>

    <td class="Optional"><i>image_file</i></td></tr>
  <tr>
    <td></td>
    <td class="Optional">2d_coords</td>
    <td class="Optional"><i>x_coord,y_coord</i></td></tr>
  <tr>
    <td></td>

    <td class="Optional">3d_coords</td>
    <td class="Optional"><i>x_coord,y_coord,z_coord</i></td></tr>
  <tr>
    <td>&nbsp;&nbsp;&nbsp;</td>
    <td class="Definition" colspan="2">}</td></tr></table>

<div style="font-family: verdana,arial,serif; font-size: 8pt; font-weight: bold; text-decoration: underline;">定義の実例</div>
<pre>define host{

	host_name			bogus-router

	alias				Bogus Router #1

	address				192.168.1.254

	parents				server-backbone

	check_command			check-host-alive

	check_interval			5

	retry_interval			1

	max_check_attempts		5

	check_period			24x7

	process_perf_data		0

	retain_nonstatus_information	0

	contact_groups			router-admins

	notification_interval		30

	notification_period		24x7

	notification_options		d,u,r

	}

</pre>

<div style="font-family: verdana,arial,serif; font-size: 8pt; font-weight: bold; text-decoration: underline;">定義の説明</div>
<table>
  <tr>
    <td valign="top"><strong>host_name</strong>:</td>
    <td>この設定は、ホストを特定するのに使用される省略名を定義するのに使用されます。それはこの特定のホストを参照するためのホストグループとサービス定義において使用されます。ホストはそれらに関連した（監視されている)多重サービスを持っている。適切に使用される時、$HOSTNAME$[http://nagios.sourceforge.net/docs/3_0/macros.html マクロ]はこの省略名を含むでしょう。 </td>
  </tr>
<tr>
    <td valign="top"><strong>alias</strong>:</td>
    <td>この設定は、ホストを特定するのに使用されるより長い名前か記述を定義するのに使用されます。それは、あなたがより簡単に特定のホストを確認するのを許可するために提供されます。適切に使用される時、$HOSTNAME$[http://nagios.sourceforge.net/docs/3_0/macros.html マクロ]はこの省略名を含むでしょう。 </td></tr>

<tr>
    <td valign="top"><strong>address</strong>:</td>
    <td>この設定は、ホストのアドレスを定義するのに使用されます。 通常、これはIPアドレスです、それが本当にあなたが欲しいものであるかもしれませんが。(ホストの状態をチェックするのにそれを使用できる限り)あなたは、IPアドレスの代わりにホストを特定するのにFQDNを使用できますが、DNSサービスが3333ccleでなければ、これは問題を起こすかもしれません。適切に使用される時、$HOSTNAME$[http://nagios.sourceforge.net/docs/3_0/macros.html マクロ]はこの省略名を含むでしょう。<br><b>注意:</b> あなたがホスト定義におけるアドレス設定を指定しないなら、そのホストの名前はアドレスとして使用されるでしょうこれをすることに関する警告の言葉、しかしながら…もしDNSが失敗するとプラグインがホスト名を解決できないので、あなたのサービスチェックの大部分は失敗するでしょう。</td></tr>