「オブジェクト定義」の版間の差分
39行目: | 39行目: | ||
<div style="background:#cbcbcb;font-family: verdana,arial,serif; font-size: 10pt; font-weight: bold;">ホスト定義 (Host definitions)<span id="ホスト定義"></span></div> | <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> | ||
− | + | ホスト定義は、物理的なサーバ、ワークステーション、あなたのネットワークにあるデバイスなどを定義するのに使用されます。 | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
<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> |
2010年8月6日 (金) 16:20時点における版
目次
導入 Introduction
Nagiosのオブジェクト設定フォーマットの1つの特徴として、他のオブジェクト定義からの継承プロパティーをオブジェクト定義として作ることができるということがあります。継承オブジェクトの動作方法についてはここにあります。オブジェクト定義の作成やメンテナンスをより簡単にするためにこのドキュメントを読んで充分に理解することをつよくお薦めします。 また, 違った形で退屈な設定作業のための近道をオブジェクトのトリックで提供しているので研究してください。
設定ファイルを作成または編集する時、以下の事を覚えておいて下さい:
1.'#'文字で始まる行はコメントであり、実行されない
2.設定の名前は大文字小文字を区別する
3.設定行の中のセミコロン(;)の後の文字はコメントとして扱われ、実行されない
リテンションのメモ Retention Notes
重要な点としては、ホスト、サービスや通知定義のいくつかの設定が変更されても Nagiosがあなたが設定ファイルの中で変更したそれを認識しない場合があるということです。このような挙動をするオブジェクトの設定にはアスタリスクマークを付けています (*)。このような動きの理由は 状態保存オプションがプログラムワイドに有効になっていたり、設定の値が 外部コマンドで実行中に変更される場合、Nagiosは設定ファイルの 状態保存ファイルに保存されている値を選択するからです。
この問題を解決する方法の1つとしては、ホスト、サービスや通知定義の retain_nonstatus_information設定を使用してnon-status情報は保存しないようにすることです。この設定で無効にするとNagiosが(再)起動した際に保存ファイルの状態よりも設定ファイルの初期値を参照するようになります。このオプションを使用するのはあまり推奨していません、というのは(あなたの視点から見て) 予期しない結果になってしまうからです。
サンプル設定ファイル Sample Configuration Files
注釈: サンプル設定ファイルは クイックスタートインストールガイドに従うと、/usr/local/nagios/etc/ にインストールされます。
オブジェクトタイプ Object Types
- ホスト定義 (Host definitions)
- ホストグループ定義
- サービス定義
- サービスグループ定義
- 通知定義
- 通知グループ定義
- 時間帯定義
- コマンド定義
- サービス依存定義
- サービスエスカレーション定義
- ホスト依存定義
- ホストエスカレーション定義
- ホスト依存定義
- ホストエスカレーション定義
- 拡張ホスト情報定義
- 拡張サービス情報定義
ホスト定義は、物理的なサーバ、ワークステーション、あなたのネットワークにあるデバイスなどを定義するのに使用されます。
注意: 赤の設定は必須ですが、黒の設定は任意です。
赤で書かれた設定は必須ですが、黒でかかれているものは任意です。
define host{ | ||
host_name | host_name | |
alias | alias | |
display_name | display_name | |
address | address | |
parents | host_names | |
hostgroups | hostgroup_names | |
check_command | command_name | |
initial_state | [o,d,u] | |
max_check_attempts | # | |
check_interval | # | |
retry_interval | # | |
active_checks_enabled | [0/1] | |
passive_checks_enabled | [0/1] | |
check_period | timeperiod_name | |
obsess_over_host | [0/1] | |
check_freshness | [0/1] | |
freshness_threshold | # | |
event_handler | command_name | |
event_handler_enabled | [0/1] | |
low_flap_threshold | # | |
high_flap_threshold | # | |
flap_detection_enabled | [0/1] | |
flap_detection_options | [o,d,u] | |
process_perf_data | [0/1] | |
retain_status_information | [0/1] | |
retain_nonstatus_information | [0/1] | |
contacts | contacts | |
contact_groups | contact_groups | |
notification_interval | # | |
first_notification_delay | # | |
notification_period | timeperiod_name | |
notification_options | [d,u,r,f,s] | |
notifications_enabled | [0/1] | |
stalking_options | [o,d,u] | |
notes | note_string | |
notes_url | url | |
action_url | url | |
icon_image | image_file | |
icon_image_alt | alt_string | |
vrml_image | image_file | |
statusmap_image | image_file | |
2d_coords | x_coord,y_coord | |
3d_coords | x_coord,y_coord,z_coord | |
} |