オブジェクト定義

提供: Nagios 3翻訳プロジェクト Wiki
2010年8月6日 (金) 16:44時点におけるWikiadmin (トーク | 投稿記録)による版 (オブジェクトタイプ Object Types)

移動: 案内検索

導入 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
    }
定義の実例
define host{

	host_name			bogus-router

	alias				Bogus Router #1

	address				192.168.1.254

	parents				server-backbone

	check_command			check-host-alive

	check_interval			5

	retry_interval			1

	max_check_attempts		5

	check_period			24x7

	process_perf_data		0

	retain_nonstatus_information	0

	contact_groups			router-admins

	notification_interval		30

	notification_period		24x7

	notification_options		d,u,r

	}

定義の説明
host_name: この設定は、ホストを特定するのに使用される省略名を定義するのに使用されます。それはこの特定のホストを参照するためのホストグループとサービス定義において使用されます。ホストはそれらに関連した(監視されている)多重サービスを持っている。適切に使用される時、$HOSTNAME$マクロはこの省略名を含むでしょう。
alias: この設定は、ホストを特定するのに使用されるより長い名前か記述を定義するのに使用されます。それは、あなたがより簡単に特定のホストを確認するのを許可するために提供されます。適切に使用される時、$HOSTNAME$マクロはこの省略名を含むでしょう。
address: この設定は、ホストのアドレスを定義するのに使用されます。 通常、これはIPアドレスです、それが本当にあなたが欲しいものであるかもしれませんが。(ホストの状態をチェックするのにそれを使用できる限り)あなたは、IPアドレスの代わりにホストを特定するのにFQDNを使用できますが、DNSサービスが3333ccleでなければ、これは問題を起こすかもしれません。適切に使用される時、$HOSTNAME$マクロはこの省略名を含むでしょう。
注意: あなたがホスト定義におけるアドレス設定を指定しないなら、そのホストの名前はアドレスとして使用されるでしょうこれをすることに関する警告の言葉、しかしながら…もしDNSが失敗するとプラグインがホスト名を解決できないので、あなたのサービスチェックの大部分は失敗するでしょう。