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