|
|
| (同じ利用者による、間の24版が非表示) |
| 19行目: |
19行目: |
| | | | |
| | == オブジェクトタイプ Object Types == | | == オブジェクトタイプ Object Types == |
| − | *[[#ホスト定義|ホスト定義]] (Host definitions) | + | *[[ホスト定義]] (Host definitions) |
| − | *ホストグループ定義 | + | *[[ホストグループ定義]] (Host group definitions) |
| − | *サービス定義 | + | *[[サービス定義]] (Service definitions) |
| − | *サービスグループ定義 | + | *[[サービスグループ定義]] (Service Group Definition) |
| − | *通知定義 | + | *[[通知定義]](Contact Definition) |
| − | *通知グループ定義 | + | *[[通知グループ定義]] (Contact Group Definition) |
| − | *時間帯定義 | + | *[[時間帯定義]] (Time Period Definition) |
| − | *コマンド定義 | + | *[[コマンド定義]] (Command Definition) |
| − | *サービス依存定義
| + | *[[サービス依存定義]] (Service Dependency Definition) |
| − | *サービスエスカレーション定義
| + | *[[サービスエスカレーション定義]] (Service Escalation Definition) |
| − | *ホスト依存定義
| + | *[[ホスト依存定義]] (Host Dependency Definition) |
| − | *ホストエスカレーション定義
| + | *[[ホストエスカレーション定義]] (Host Escalation Definition) |
| − | *ホスト依存定義
| + | *[[拡張ホスト情報定義]] (Extended Host Information Definition) |
| − | *ホストエスカレーション定義
| + | *[[拡張サービス情報定義]] (Extended Service Information Definition) |
| − | *拡張ホスト情報定義
| + | |
| − | *拡張サービス情報定義
| + | |
| − | | + | |
| − | | + | |
| − | <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> </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>
| + | |
Nagiosのオブジェクト設定フォーマットの1つの特徴として、他のオブジェクト定義からの継承プロパティーをオブジェクト定義として作ることができるということがあります。継承オブジェクトの動作方法についてはここにあります。オブジェクト定義の作成やメンテナンスをより簡単にするためにこのドキュメントを読んで充分に理解することをつよくお薦めします。 また, 違った形で退屈な設定作業のための近道をオブジェクトのトリックで提供しているので研究してください。
重要な点としては、ホスト、サービスや通知定義のいくつかの設定が変更されても Nagiosがあなたが設定ファイルの中で変更したそれを認識しない場合があるということです。このような挙動をするオブジェクトの設定にはアスタリスクマークを付けています (*)。このような動きの理由は 状態保存オプションがプログラムワイドに有効になっていたり、設定の値が 外部コマンドで実行中に変更される場合、Nagiosは設定ファイルの 状態保存ファイルに保存されている値を選択するからです。
この問題を解決する方法の１つとしては、ホスト、サービスや通知定義の retain_nonstatus_information設定を使用してnon-status情報は保存しないようにすることです。この設定で無効にするとNagiosが（再）起動した際に保存ファイルの状態よりも設定ファイルの初期値を参照するようになります。このオプションを使用するのはあまり推奨していません、というのは(あなたの視点から見て) 予期しない結果になってしまうからです。
