通知定義のソースを表示

<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 contact{</td></tr>
  <tr>
    <td></td>
    <td class="Required">contact_name</td>
    <td class="Required"><i>contact_name</i></td></tr>

  <tr>
    <td></td>
    <td class="Optional">alias</td>
    <td class="Optional"><i>alias</i></td></tr>
  <tr>
    <td></td>
    <td class="Optional">contactgroups</td>

    <td class="Optional"><i>contactgroup_names</i></td></tr>
  <tr>
    <td></td>
    <td class="Required">host_notifications_enabled</td>
    <td class="Required">[0/1]</td></tr>
  <tr>
    <td></td>

    <td class="Required">service_notifications_enabled</td>
    <td class="Required">[0/1]</td></tr>
  <tr>
    <td></td>
    <td class="Required">host_notification_period</td>
    <td class="Required"><i>timeperiod_name</i></td></tr>
  <tr>

    <td></td>
    <td class="Required">service_notification_period</td>
    <td class="Required"><i>timeperiod_name</i></td></tr>
  <tr>
    <td></td>
    <td class="Required">host_notification_options</td>
    <td class="Required">[d,u,r,f,s,n]</td></tr>

  <tr>
    <td></td>
    <td class="Required">service_notification_options</td>
    <td class="Required">[w,u,c,r,f,s,n]</td></tr>
  <tr>
    <td></td>
    <td class="Required">host_notification_commands</td>

    <td class="Required"><i>command_name</i></td></tr>
  <tr>
    <td></td>
    <td class="Required">service_notification_commands</td>
    <td class="Required"><i>command_name</i></td></tr>
  <tr>
    <td></td>

    <td class="Optional">email</td>
    <td class="Optional"><i>email_address</i></td></tr>
  <tr>
    <td></td>
    <td class="Optional">pager</td>
    <td class="Optional"><i>pager_number or pager_email_gateway</i></td></tr>
  <tr>

    <td></td>
    <td class="Optional">address<i>x</i></td>
    <td class="Optional"><i>additional_contact_address</i></td></tr>
  <tr>
    <td></td>
    <td class="Optional">can_submit_commands</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>&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 contact{

	contact_name                    jdoe

	alias                           John Doe

	host_notifications_enabled		1

	service_notifications_enabled	1

	service_notification_period     24x7

	host_notification_period        24x7

	service_notification_options    w,u,c,r

	host_notification_options       d,u,r

	service_notification_commands   notify-by-email

	host_notification_commands      host-notify-by-email

	email			jdoe@localhost.localdomain

	pager			555-5555@pagergateway.localhost.localdomain

	address1			xxxxx.xyyy@icq.com

	address2			555-555-5555

	can_submit_commands	1

	}
</pre>

<div style="font-family: verdana,arial,serif; font-size: 8pt; font-weight: bold; text-decoration: underline;">定義の説明</div>
{|
  |- valign="top"
    |<strong>contact_name</strong>: 
    |この設定は通知先を特定する短い名前を定義するために使用されます。[http://nagios.sourceforge.net/docs/3_0/objectdefinitions.html#contactgroup コンタクトグループ]      定義を参照してください。      条件さえそろえば、$CONTACTNAME$ [http://nagios.sourceforge.net/docs/3_0/macros.html マクロ]にはこの値が含まれます。   


  |- valign="top"
    |<strong>alias</strong>: 
    |この設定は通知先に関する長い名前や説明を定義するために使用します。      条件さえそろえば、$CONTACTALIAS$ [http://nagios.sourceforge.net/docs/3_0/macros.html マクロ]にこの値が含まれます。      aliasを指定しなければ、<i>contact_name</i>をaliasとして使用するでしょう。  


  |- valign="top"
    |<strong>contactgroups</strong>: 
    |この設定は [http://nagios.sourceforge.net/docs/3_0/objectdefinitions.html#contactgroup コンタクトグループ]      に含まれる通知先の<i>短い名前</i>を特定します。      複数のコンタクトグループはカンマで区切ります。この設定は [http://nagios.sourceforge.net/docs/3_0/objectdefinitions.html#contactgroup コンタクトグループ]   定義の<i>members</i>設定の代わりに(もしく追加で)使われます。   


  |- valign="top"
    |<strong>host_notifications_enabled</strong>: 
    |この設定はホストの問題や復旧についての通知を通知先が受け取るかどうかを決定するために使用します。      値: 0 = 通知しない、 1 = 通知する。   


  |- valign="top"
    |<strong>service_notifications_enabled</strong>: 
    |この設定はサービスの問題や復旧についての通知を通知先が受け取るかどうかを決定するために使用します。      値: 0 = 通知しない、 1 = 通知する。   


  |- valign="top"
    |<strong>host_notification_period</strong>: 
    |この設定は通知先がホストの問題や復旧時に通知を受けている間の[http://nagios.sourceforge.net/docs/3_0/objectdefinitions.html#timeperiod 時間帯]      に短い名前を指定するために使われます。      あなたは通知先へのホスト通知の"呼び出し"時間として考える事ができます。      どのように動作し、間違った使い方によって起こりうる潜在的な問題があるかについての評細情報は [http://nagios.sourceforge.net/docs/3_0/timeperiods.html 時間帯]    を参照して下さい。   


  |- valign="top"
    |<strong>service_notification_period</strong>: 
    |この設定は通知先がサービスの問題や復旧時に通知を受けている間の [http://nagios.sourceforge.net/docs/3_0/objectdefinitions.html#timeperiod 時間帯]      に短い名前を指定するために使われます。      あなたは通知先へのサービス通知の"呼び出し"時間として考える事ができます。      どのように動作し、間違った使い方によって起こりうる潜在的な問題があるかについての評細情報は [http://nagios.sourceforge.net/docs/3_0/timeperiods.html 時間帯]      を参照して下さい。   


  |- valign="top"
    |<strong>host_notification_commands</strong>: 
    |この設定はホストの問題または復旧の通知先に通知するための[http://nagios.sourceforge.net/docs/3_0/objectdefinitions.html#command コマンド]      の<i>短い名前</i>のリストを定義するために使用されます。      複数の通知コマンドはカンマで区切る必要があります。      すべての通知コマンドは通知者が通知を受け取りたい時に発行されます。      通知コマンドが実行される最大の時間は [http://nagios.sourceforge.net/docs/3_0/configmain.html#notification_timeout notification_timeout]       オプションで制御できます。   


  |- valign="top"
    |<strong>host_notification_options</strong>: 
    |この設定は通知を通知先に送信することができるホストの状態を定義するために使用されます。      妥当な選択肢は以下の1つ以上の組み合わせです:      <b>d</b> = ホスト状態がDOWNの時に通知を行う, <b>u</b> = ホスト状態がUNREACHABLEの時に通知を行う, <b>r</b> =       ホストがリカバリ(UP状態)になった時に通知を行う, <b>f</b> = ホストが稼動と停止を繰り返す [http://nagios.sourceforge.net/docs/3_0/flapping.html フラッピング]       を起こした際に通知を行う, そして、<b>s</b> = ホストやサービスの[http://nagios.sourceforge.net/docs/3_0/downtime.html ダウンタイムのスケジュール]      の開始と終了の時に通知を行う。 <b>n</b>(無し)もオプションで、 通知先はどんな種類のホスト通知も受け取らない事になります。   


  |- valign="top"
    |<strong>service_notification_options</strong>: 
    |この設定は通知を通知先に送信することができるサービスの状態を定義するために使用されます。      妥当な選択肢は以下の1つ以上の組み合わせです:       <b>w</b> = サービス状態がWARNINGの時に通知する。<b>u</b> = ホスト状態がUNREACHABLEの時に通知を行う, <b>c</b> =       サービス状態がCRITICALの時に通知する。 <b>r</b> = サービス状態が復旧(OK状態)の時に通知する, そして、      <b>f</b> = サービスが稼動と停止を繰り返す [http://nagios.sourceforge.net/docs/3_0/flapping.html フラッピング]  を起こした際に通知を行う。<b>n</b>(無し)もオプションで, 通知者はどんな種類のサービス通知も受け取らない事になります。   


  |- valign="top"
    |<strong>service_notification_commands</strong>: 
    |この設定は<i>サービス</i>の問題または復旧の通知先に通知するための [http://nagios.sourceforge.net/docs/3_0/objectdefinitions.html#command コマンド]       の<i>短い名前</i>のリストを定義するために使用されます。      複数の通知コマンドはカンマで区切る必要があります。      すべての通知コマンドは通知者が通知を受け取りたい時に発行されます。  通知コマンドが実行される最大の時間は [http://nagios.sourceforge.net/docs/3_0/configmain.html#notification_timeout notification_timeout]  オプションで制御できます。   


  |- valign="top"
    |<strong>email</strong>: 
    |この設定は通知先のEメールアドレスを定義するのに使われます。      あなたが通知コマンドをどのように設定したかに依存し、通知先へアラートEメールを送出する事ができます。 条件さえ揃えば、 $CONTACTEMAIL$ [http://nagios.sourceforge.net/docs/3_0/macros.html マクロ] はこの値を含みます。   

   |- valign="top"
    |<strong>pager</strong>: 
    |この設定は通知先のポケットベルの番号を定義するために使用されます。  また、これは携帯Eメールアドレスになるかもしれません (例 pagejoe@pagenet.com)。      通知コマンドをどのように設定したかに依存しますが、 通知先へアラート通知を送出できます。 条件さえ揃えば、 $CONTACTPAGER$ [http://nagios.sourceforge.net/docs/3_0/macros.html マクロ] はこの値を含みます。   


  |- valign="top"
    |<strong>address<i>x</i></strong>: 
    |アドレスの設定は通知先が追加"アドレス"を定義するために使用されます。      アドレスとはなんでもOKです - 携帯番号、インスタントメッセンジャーアドレスなど。      通知コマンドをどのように設定したかに依存しますが、通知先へアラート通知を送出できます。 6つまでのアドレスをこの設定で定義できます (<i>アドレス1</i>から<i>アドレス6</i>)。 $CONTACTADDRESS<i>x</i>$ [http://nagios.sourceforge.net/docs/3_0/macros.html マクロ] はこの値を含みます。   


  |- valign="top"
    |<strong>can_submit_commands</strong>: 
    |この設定は通知先がCGIからNagiosに [http://nagios.sourceforge.net/docs/3_0/extcommands.html 外部コマンド] を送信できるかどうかを決定するために使用されます。      値: 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>: 
    |この設定は、通知に関するnon-status情報が全体のプログラムの再起動で保持するかどうか決定するのに用います。      [http://nagios.sourceforge.net/docs/3_0/configmain.html#retain_state_information retain_state_information      ]設定を使って状態の保持を有効にしているなら、これは役に立ちます。      値: 0 = non-status情報の保持を無効、1 = non-status情報の保持を有効。  

|}