「オブジェクト定義」の版間の差分

提供: Nagios 3翻訳プロジェクト Wiki
移動: 案内検索
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>
時間帯は、通知とサービスチェックのため「有効な」回数であると考えられている
+
ホスト定義は、物理的なサーバ、ワークステーション、あなたのネットワークにあるデバイスなどを定義するのに使用されます。
様々な日々の期間の回数リストです。
+
それは1週間がいったん終わると「回転する」それぞれの曜日のための時間範囲となります。
+
正常なウィークリータイムへの異なったタイプの例外はサポートされます。
+
含む: 特定の平日、一般的な月の日々、特定の月の日々、カレンダー上の日々。
+
  
 
<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>

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)
  • ホストグループ定義
  • サービス定義
  • サービスグループ定義
  • 通知定義
  • 通知グループ定義
  • 時間帯定義
  • コマンド定義
  • サービス依存定義
  • サービスエスカレーション定義
  • ホスト依存定義
  • ホストエスカレーション定義
  • ホスト依存定義
  • ホストエスカレーション定義
  • 拡張ホスト情報定義
  • 拡張サービス情報定義


ホスト定義 (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
    }