サービス定義のソースを表示

<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>
サービス定義は、ホストで走る「サービス」を特定するのに使用されます。 「サービス」という用語は非常に緩く使用されます。 それはホスト(POP、SMTP、HTTPなど)またはホスト(pingへの応答、ログインしているユーザの数、空きのdiskスペースなど) に関連している、測定基準のある他のタイプにおける実際のサービスを意味することが出来ます。サービス定義への異なった議論は以下に概説されています。
<div style="font-family: verdana,arial,serif; font-size: 8pt; font-weight: bold; text-decoration: underline;">定義フォーマット</div>
注意: 赤の設定は必須ですが、黒の設定は任意です。
<table>
  <tr>
    <td class="Definition" colspan="3">define service{</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="Optional">hostgroup_name</td>
    <td class="Optional"><i>hostgroup_name</i></td></tr>
  <tr>
    <td></td>
    <td class="Required">service_description</td>

    <td class="Required"><i>service_description</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="Optional">servicegroups</td>
    <td class="Optional">servicegroup_names</td></tr>
  <tr>
    <td></td>
    <td class="Optional">is_volatile</td>
    <td class="Optional">[0/1]</td></tr>
  <tr>

    <td></td>
    <td class="Required">check_command</td>
    <td class="Required"><i>command_name</i></td></tr>
  <tr>
    <td></td>
    <td class="Optional">initial_state</td>
    <td class="Optional">[o,w,u,c]</td></tr>

  <tr>
    <td></td>
    <td class="Required">max_check_attempts</td>
    <td class="Required">#</td></tr>
  <tr>
    <td></td>
    <td class="Required">check_interval</td>

    <td class="Required">#</td></tr>
  <tr>
    <td></td>
    <td class="Required">retry_interval</td>
    <td class="Required">#</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_service</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,w,c,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">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">[w,u,c,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="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="Optional">stalking_options</td>
    <td class="Optional">[o,w,u,c]</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>&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 service{

	host_name		linux-server

	service_description	check-disk-sda1

	check_command		check-disk!/dev/sda1

	max_check_attempts	5

	check_interval	5

	retry_interval	3

	check_period		24x7

	notification_interval	30

	notification_period	24x7

	notification_options	w,c,r

	contact_groups		linux-admins

	}
</pre>

<div style="font-family: verdana,arial,serif; font-size: 8pt; font-weight: bold; text-decoration: underline;">定義の説明</div>
{|
  |- valign="top"
    |<strong>host_name</strong>: 
    |この設定は、サービスが「走っている」または関連している    [http://nagios.sourceforge.net/docs/3_0/objectdefinitions.html#host ホスト] の<i>省略名</i>を指定するのに使用されます。複数のホストがコンマによって切り離されるべきです。  


  |- valign="top"
    |<strong>hostgroup_name</strong>: 
    |この設定は、サービスが「走っている」または関連している [http://nagios.sourceforge.net/docs/3_0/objectdefinitions.html#hostgroup ホストグループ]  の<i>省略名</i>を指定するのに使用されます。複数のホストがコンマによって切り離されるべきです。 hostgroup_nameはhost_nameの設定の代わり、または追加に使用されるかもしれません。
   

  |- valign="top"
    |<strong>service_description;</strong>: 
    |この設定は、スペース、ダッシュおよびコロン (セミコロン、アポストロフィ、および引用符は避けられるべきです)    を含むかもしれないサービスの記述を定義するのに使用されます。  サービスが同じホストに関連づけた二つは全く同じ記述を持つことが出来ません。 サービスは唯一彼らの<i>ホスト名</i>と<i>サービス記述</i>設定と同一視されています。
    

  |- valign="top"
    |<strong>display_name</strong>: 

    |この設定は、このサービスのためのウェブインタフェースに表示されるべき別名称    を定義するのに使用されます。 もし指定されないなら、これはあなたが<i>サービス記述</i>    設定に指定する値をデフォルトとします。 注意: ウェブインタフェースの将来のバージョンは    使用になるでしょうが、現在のCGIはこのオプションは使用しません。  


  |- valign="top"
    |<strong>servicegroups</strong>: 
    |この設定は、サービスが属している複数のservicegroupsの<i>省略名</i>を特定    するのにおいて使用されます。   複数のホストがコンマによって切り離されるべきです。この設定は[http://nagios.sourceforge.net/docs/3_0/objectdefinitions.html#servicegroup servicegroup] 定義における<i>メンバー</i>設定を使用することに代わる手段として使用されるかもしれません。  


  |- valign="top"

    |<strong>is_volatile</strong>: 
    |この設定はサービスが「不安定である」か否かに関係なく、使用されます。サービスは通常、不安定では「ありません」。[http://nagios.sourceforge.net/docs/3_0/volatileservices.html ここ]で不安定なサービスと彼らがどう通常のサービスと異なるかに関する詳しい情報を見つけることができます。Value: 0 = サービスは不安定ではありません、 1 = サービスは不安定です。  


  |- valign="top"
    |<strong>check_command</strong>: 
    |
      <p>この設定は、サービスの状態をチェックするためにNagiosが実行させる[http://nagios.sourceforge.net/docs/3_0/objectdefinitions.html#command コマンド]の<i>省略名</i>を指定するのに使用されます。[http://nagios.sourceforge.net/docs/3_0/configmain.html#service_check_timeout サービス_チェック_タイムアウト] によって、サービスチェック命令が走ることができる最大時間は制御されます。</p>  


  |- valign="top"
    |<strong>initial_state</strong>: 
    |Nagiosはスタートする時、デフォルトで全てのサービスがOK状態にあると仮定するでしょう。あなたは、サービスのためにこの設定を使用することによって、初期状態を無視する事ができます。 正当なオプションは: <b>o</b> = OK, <b>w</b> = WARNING, <b>u</b> = UNKNOWN, and <b>c</b> = CRITICAL.   


  |- valign="top"
    |<strong>max_check_attempts</strong>: 
    |この設定はNagiosが、OK状態以外の何らか状態に戻るかどうかのサービスチェックコマンド 再試行する回数を定義するのに使用されます。この値を1に設定する事は、再びサービスチェックを再試行せずに、 Nagiosにアラートを引き起こさせるでしょう。  


  |- valign="top"
    |<strong>check_interval</strong>: 
    |この設定は、次の「通常」のサービスのチェックの計画をする前に待つために「タイム・ユニット」の数を定義するのに使用されます。「通常」のチェックは、サービスがOK状態にある時か、非OK状態にあるが既に再チェックされた時に起こるものです。しかし<b>最大限チェック試行</b>の回数、既に再チェックされております。あなたが60のデフォルト値から[http://nagios.sourceforge.net/docs/3_0/configmain.html#interval_length 間隔_長さ] ディレクティブを変えていないと、この数は分を意味するでしょう。[http://nagios.sourceforge.net/docs/3_0/checkscheduling.html チェックスケジューリング]ドキュメンテーションでこの値に関する詳しい情報を見つけることができます。  


  |- valign="top"
    |<strong>retry_interval</strong>: 
    |この設定はサービスの際チェックをスケジュールする前にどれだけ待つかその待ち時間を"time units"で指定します。 サービスはnon-OKステートに変化した際にこの値の間隔で再チェックをスケジュールします。サービスの再試行がステートが変化しないまま<b>max_check_attempts</b>で設定した回数に達したら<b>check_interval</b>で指定した"通常の"再試行の間隔にもどります。  [http://nagios.sourceforge.net/docs/3_0/configmain.html#interval_length interval_length]  設定をデフォルトの60から変えない限り、この値は1分になります。 [http://nagios.sourceforge.net/docs/3_0/checkscheduling.html チェックスケジューリング ]ドキュメンテーションでこの値に関する詳しい情報を見つけることができます。  


  |- valign="top"
    |<strong>active_checks_enabled [http://nagios.sourceforge.net/docs/3_0/objectdefinitions.html#retention_notes *]</strong>: 
    |この設定はサービスのアクティブチェックを有効にするかどうかを決定します。    値:0 = アクティブチェックを無効, 1 = アクティブチェックを有効 (デフォルト)  


  |- valign="top"
    |<strong>passive_checks_enabled [http://nagios.sourceforge.net/docs/3_0/objectdefinitions.html#retention_notes *]</strong>: 
    |この設定はサービスのパッシブチェックを有効にするかどうかを決定します。      値:0 = パッシブホストチェックを無効, 1 = パッシブホストチェックを有効 (デフォルト)   


  |- valign="top"
    |<strong>check_period</strong>: 
    |この設定はサービスのアクティブチェックが有効な間の [http://nagios.sourceforge.net/docs/3_0/objectdefinitions.html#timeperiod 時間帯]     の短い名前を指定します。  


  |- valign="top"
    |<strong>obsess_over_service [http://nagios.sourceforge.net/docs/3_0/objectdefinitions.html#retention_notes *]</strong>: 
    |この設定はサービスを[http://nagios.sourceforge.net/docs/3_0/configmain.html#ocsp_command ocsp_command] を使って"取り付く"かどうかを指定します。  
 
     
  |- valign="top"
    |<strong>check_freshness [http://nagios.sourceforge.net/docs/3_0/objectdefinitions.html#retention_notes *]</strong>: 
    |この設定はサービスに対して[http://nagios.sourceforge.net/docs/3_0/freshness.html フレッシュネスチェック] を有効にするかどうかを指定します。値: 0 = フレッシュネスチェックを無効, 1 = フレッシュネスチェックを有効 (デフォルト)  


  |- valign="top"
    |<strong>freshness_threshold</strong>: 
    |この設定はサービスに対するフレッシュネスしきい値を(秒単位で)指定します。 この設定を0にすると、Nagiosはフレッシュネスしきい値を自動計算します。


 |- valign="top"
    |<strong>event_handler_enabled [http://nagios.sourceforge.net/docs/3_0/objectdefinitions.html#retention_notes *]</strong>: 
    |この設定はこのサービスのイベントハンドラが有効かそうでないか判断するために使用します。      値：0 = サービスイベントハンドラ 無効、1 = サービスイベントハンドラ 有効   


  |- valign="top"
    |<strong>low_flap_threshold</strong>: 
    |この設定はサービスに対するフラップ検知の低しきい値を指定します。      フラップ検知の詳細は[http://nagios.sourceforge.net/docs/3_0/flapping.html ここ]を参照して下さい。     この設定を0にすると、[http://nagios.sourceforge.net/docs/3_0/configmain.html#low_service_flap_threshold low_service_flap_threshold]    設定によりプログラムワイドに指定されます。   


  |- valign="top"
    |<strong>high_flap_threshold</strong>: 
    |この設定はサービスに対するフラップ検知の高しきい値を指定します。フラップ検知の詳細は[http://nagios.sourceforge.net/docs/3_0/flapping.html ここ]を参照して下さい。 この設定を0にすると、[http://nagios.sourceforge.net/docs/3_0/configmain.html#high_service_flap_threshold high_service_flap_threshold] 
設定によりプログラムワイドに指定されます。   


  |- valign="top"
    |<strong>flap_detection_enabled [http://nagios.sourceforge.net/docs/3_0/objectdefinitions.html#retention_notes *]</strong>: 
    |この設定はサービスに対するフラップ検知を有効にするかどうかを決定します。 フラップ検知に関する詳細は [http://nagios.sourceforge.net/docs/3_0/flapping.html ここ]にあります。 値:0 = パフォーマンスデータ処理を無効にする, 1 = パフォーマンスデータ処理を有効にする   


  |- valign="top"
    |<strong>flap_detection_options</strong>: 
    |この設定は[http://nagios.sourceforge.net/docs/3_0/flapping.html フラップ検知ロジック]を使用してサービスの状態をどのようにするかを決定します。 有効なオプションは次の1つまたは複数の組み合わせです: <b>o</b> = OK states, <b>w</b> = WARNING  states, <b>c</b> = CRITICAL states, <b>u</b> = UNKNOWN states.
|- valign="top"


  |- valign="top"
    |<strong>process_perf_data [http://nagios.sourceforge.net/docs/3_0/objectdefinitions.html#retention_notes *]</strong>: 

    |この設定はサービスに対するパフォーマンスデータを処理するかどうかを指定します。  値:0 = パフォーマンスデータ処理を無効にする, 1 = パフォーマンスデータ処理を有効にする 
  

  |- valign="top"
    |<strong>retain_status_information</strong>: 
    |この設定はプログラムを再起動した際にサービス状態に関連した情報を保持したままとするか否かを決定します。これは  [http://nagios.sourceforge.net/docs/3_0/configmain.html#retain_state_information retain_state_information] 
を使って状態保持を有効にする場合にのみ機能します。 値: 0 = ステータス状態保持を無効, 1 = ステータス状態保持を有効   


  |- valign="top"
    |<strong>retain_nonstatus_information</strong>: 
    |この設定はプログラムの再起動時に状態以外の情報を保持するかどうかを決定します。これは [http://nagios.sourceforge.net/docs/3_0/configmain.html#retain_state_information retain_state_information]  設定を使って状態保持が有効になっている場合にのみ機能します。 値: 0 = ステータス以外の状態保持を無効, 1 = ステータス以外の状態保持を有効  


  |- valign="top"
    |<strong>notification_interval</strong>: 
    |この設定はサービスが<i>まだ</i>OK状態で無い事を再通知する際にどれだけ待つかの"タイムユニット"数を指定します。[http://nagios.sourceforge.net/docs/3_0/configmain.html#interval_length interval_length]  を変更していないのであればデフォルト値の60がセットされ、１分を意味します。 この値を0にすると、Nagiosはサービスに問題が発生した際に通知先に再通知<i>しません</i>  - 問題の通知は１度しか行われない事になります。  


  |- valign="top"
    |<strong>first_notification_delay</strong>: 
    |この設定はサービスがOK状態で無い時に最初の問題を通知する際にどれだけ待つかの"タイムユニット"数を指定します。[http://nagios.sourceforge.net/docs/3_0/configmain.html#interval_length interval_length]  を変更していないのであればデフォルト値の60がセットされ、１分を意味します。もしこの値を0にすると、Nagiosはすぐに問題を通知するでしょう。   

      
  |- valign="top"
    |<strong>notification_period</strong>: 
    |この設定はサービスのイベント通知を連絡先に送信することができる[http://nagios.sourceforge.net/docs/3_0/objectdefinitions.html#timeperiod 時間帯]の省略名 を指定するのに使う。通知期間外の場合サービス通知はされない。  
      

  |- valign="top"
    |<strong>notification_options</strong>: 
    |この設定はいつサービスの通知がされるのか決めるのに使う。 以下のオプションのうちひとつ以上の組み合わせを選べます: <b>w</b> = WARNINGの時通知する, <b>u</b> =   UNKNOWNの時に通知する, <b>c</b> = CRITICALの時に通知する, <b>r</b> = 復旧時に通知する,  <b>f</b> = [http://nagios.sourceforge.net/docs/3_0/flapping.html flapping]が止まった時に通知する, そして<b>s</b> = [http://nagios.sourceforge.net/docs/3_0/downtime.html ダウンタイムのスケジュール]  の開始と終了時に通知する。あなたがオプションで<b>n</b>を指定すると通知は行われない。  君がオプションをひとつも選ばなければすべての通知可能なものすべてにおいて通知されます。       例: 君がもし<b>w,r</b>を選ぶとWARNINGの時とサービス復旧時に通知されます。  

      
    |- valign="top"
    |<strong>notifications_enabled [http://nagios.sourceforge.net/docs/3_0/objectdefinitions.html#retention_notes *]</strong>: 
    |この設定はサービスの通知を行うかどうか決めるのに使う。 値: 0 = サービスの通知を行わない、1 =       サービスの通知を行う。   
      
      
   |- valign="top"
    |<strong>contacts</strong>: 
    |これはサービスの障害(または復旧)の時に通知される[http://nagios.sourceforge.net/docs/3_0/objectdefinitions.html#contact contacts]  の<i>ショートネーム</i>のリストです。 複数のコンタクトを指定する場合カンマで区切る必要があります。君が少ない人数に通知を行いたく、わざわざ [http://nagios.sourceforge.net/docs/3_0/objectdefinitions.html#contactgroup contactgroups]を設定したくない時に役立ちます。 あなたは最低ひとつのコンタクトを指定するかそれぞれのサービスで コンタクトグループの設定をしないといけない。  
      
      
  |- valign="top"
    |<strong>contact_groups</strong>: 
    |これはサービスの障害(または復旧)の時に通知される[http://nagios.sourceforge.net/docs/3_0/objectdefinitions.html#contactgroup contactgroups]の<i>ショートネーム</i>のリストです。複数のコンタクトグループを指定する場合カンマで区切る必要があります。あなたは最低ひとつのコンタクトを指定するかそれぞれのサービスでコンタクトグループの設定をしないといけない。   
      
  
  |- valign="top"
    |<strong>stalking_options</strong>: 
    |この設定は「追跡」をどのサービス状態で可能にするかを決めます。有効なオプションは、以下の1つ以上の組み合わせです:  <b>o</b> = OK状態を追跡する、<b>w</b> = WARNING状態を追跡する、<b>u</b> = UNKNOWN状態を追跡する、<b>c</b> = CRITICAL状態を追跡する。状態の追跡に関する詳細な情報は[http://nagios.sourceforge.net/docs/3_0/stalking.html ここ]にあります。
  
      
  |- valign="top"
    |<strong>notes</strong>: 

    |この設定は、サービスに関連する注釈の任意の文字列を定義します。 I注釈を指定すれば、それは[http://nagios.sourceforge.net/docs/3_0/cgis.html#extinfo_cgi 拡張情報] のCGIで見ることができるでしょう(指定したサービスに関する情報を見ているとき)。

    
  |- valign="top"
    |<strong>notes_url</strong>: 
    |この設定は、サービスに関する詳細な情報を提供するのに用意できる、任意のURLを定義するのに使用します。 このURLを指定すると、ここで指定するURLをリンクする赤いフォルダのアイコンがCGI（サービス情報を見ているとき） の中で見れるでしょう。 どんな有効なURLでも使用できます。相対パスを使うつもりであるなら、基本のパスはCGI (すなわち <i>/cgi-bin/nagios/</i>)にアクセスのに用いられているものと同じようにします。 サービスや非常通知方法、その他に関する詳細な情報を他のサポートスタッフが利用できるようにしたいのであれば、これはとても有用です。

    
  |- valign="top"
    |<strong>action_url</strong>: 
    |この設定は、サービスに関して行われる多くの動作を提供するのに用いる、 任意のURLを定義するのに使用します。 のURLを指定すると、ここで指定するURLをリンクする 赤い「板」のアイコンがCGI（サービス情報を見ているとき）の中で見れるでしょう。 どんな有効なURLでも使用できます。相対パスを使うつもりであるなら、基本のパスはCGI (すなわち <i>/cgi-bin/nagios/</i>)にアクセスのに用いられているものと同じようにします。   

      
  |- valign="top"
    |<strong>icon_image</strong>: 
    |この値は、このサービスと関連すべきGIF、PNG、JPGイメージの名前を定義するのに用います。このイメージは[http://nagios.sourceforge.net/docs/3_0/cgis.html#status_cgi ステータス]と     [http://nagios.sourceforge.net/docs/3_0/cgis.html#extinfo_cgi 拡張情報]のCGIで表示されます。イメージの大きさが40x40ピクセルであれば、ちょうどよく見えるでしょう。 サービスのイメージはHTMLイメージディレクトリの中の<b>logos/</b>サブディレクトリ（すなわち<i>/usr/local/nagios/share/images/logos</i>） にあると思われます。    

      
  |- valign="top"
    |<strong>icon_image_alt</strong>: 
    |この値は<i>&lt;icon_image&gt;</i>の引数によって指定されるイメージのALTタグで使用する任意の文字列を定義するために使われます。 ALTタグは、[http://nagios.sourceforge.net/docs/3_0/cgis.html#status_cgi ステータス]や   [http://nagios.sourceforge.net/docs/3_0/cgis.html#extinfo_cgi 拡張情報]、 [http://nagios.sourceforge.net/docs/3_0/cgis.html#statusmap_cgi ステータスマップ]の CGIで使われます。    
|}