ja:documentation:pandorafms:monitoring:03_remote_monitoring

差分

このページの2つのバージョン間の差分を表示します。

この比較画面へのリンク

両方とも前のリビジョン 前のリビジョン
次のリビジョン		 前のリビジョン
ja:documentation:pandorafms:monitoring:03_remote_monitoring [2024/05/15 08:42] – [リモート実行モジュール] junichija:documentation:pandorafms:monitoring:03_remote_monitoring [2024/12/14 23:35] (現在) – [SNMP インタフェースウィザード] junichi
行 167: 行 167:
  
 最初の 3つのステップが OK (コード 250) であれば、SMTP は正常です。メールを実際に送信する必要はありません (必要であればそのような設定も可能です)。これにより、プレーンテキストを用いたプロトコルに対する TCP チェックが実現できます。 最初の 3つのステップが OK (コード 250) であれば、SMTP は正常です。メールを実際に送信する必要はありません (必要であればそのような設定も可能です)。これにより、プレーンテキストを用いたプロトコルに対する TCP チェックが実現できます。
 +
 +<wrap #ks3_4 />
  
 ==== リモート実行モジュール ==== ==== リモート実行モジュール ====
行 223: 行 225:
  
 </WRAP> </WRAP>
 +
 +<wrap #ks3_5 />
  
 ==== ネットワークモジュールの共通拡張機能 ==== ==== ネットワークモジュールの共通拡張機能 ====
  
-{{  :wiki:cap5_snmp_8.png?700  }} +   * **Custom ID**: allows you to store an ID of an external application to facilitate the integration of Pandora FMS with third-party applications. For example, a Configuration management database (CMDB). 
- +   * **Interval**: Module execution interval, which [[:en:documentation:pandorafms:management_and_operation:12_console_setup#other_setup|can be customized]] by an Administrator user in a predefined way and then used by standard users. 
-  * **Custom ID**: It allows to store an ID of an external application to facilitate the integration of Pandora FMS with third party applications. For example, a //Configuration management database//  (CMDB). +   * **Post process**: for post-processing of the module (multiplying or dividing the returned value), for example when getting bytes and wanting to display the value in Megabytes. 
-  * **Interval**: The module's execution interval, which can be [[:en:documentation:04_using:12_console_setup#other_configuration|customized]] by an Admin user in a predefined way and then be used by standard users. +   * **Min. Value** and **Max. Value**: Any value below the minimum or above the maximum will be taken as invalid and discarded. 
-  * **Post process**: The module's post processing. It is useful to multiply or divide the returned value, e.g. when you obtain bytes and you want to show the value in Megabytes. +   * **Export target**: Only available with Export server. 
-  * **Min. Value**  y **Max. Value**: Any value under the minimum or over the maximum will be taken as no valid and will be discarded. +   * **Category**: Only used in conjunction with the [[:en:documentation:pandorafms:command_center:01_introduction|Command Center (Metaconsole)]]. 
-  * **Export target**: It is only available in Pandora FMS Enterprise Version, if you have configured [[:en:documentation:05_big_environments:03_export_server|an Export server]]+   * If **Cron** from is enabled, the module will be executed once when the current date and time match the date and time set in Cron from, ignoring the module's own interval. 
 +   * **Target IP**: IP address of the device to monitor. The ''_agentname_'' or ''_agentalias_'' macro can be used as long as the agent name or its alias has a valid IP address.
  
   * **カスタムID(Custom ID)**: Pandora FMS とサードパーティアプリケーションの統合を容易にするために、外部アプリケーションの ID を保存できます。 たとえば、 //構成管理データベース//(CMDB) などです。   * **カスタムID(Custom ID)**: Pandora FMS とサードパーティアプリケーションの統合を容易にするために、外部アプリケーションの ID を保存できます。 たとえば、 //構成管理データベース//(CMDB) などです。
-  * **間隔(Interval)**: 管理者ユーザによってあらかじめ[[:ja:documentation:04_using:12_console_setup#other_configuration|カスタマイズ]]された、標準ユーザが利用できるモジュールの実行間隔。+  * **間隔(Interval)**: 管理者ユーザによってあらかじめ[[:ja:documentation:pandorafms:management_and_operation:12_console_setup#other_configuration|カスタマイズ]]された、標準ユーザが利用できるモジュールの実行間隔。
   * **保存倍率(Post process)**: モジュールの事後処理です。モジュールの値に掛け算や割り算を行うのに便利です。例えば、バイト単位のデータをメガバイトで表示したい場合などです。   * **保存倍率(Post process)**: モジュールの事後処理です。モジュールの値に掛け算や割り算を行うのに便利です。例えば、バイト単位のデータをメガバイトで表示したい場合などです。
   * **最小値(Min. Value)**: モジュールの最小値です。これより小さな数値は、不正とみなして破棄されます。   * **最小値(Min. Value)**: モジュールの最小値です。これより小さな数値は、不正とみなして破棄されます。
-  * **エクスポートターゲット(Export target)**: モジュールから返される値を[[:ja:documentation:05_big_environments:03_export_server|エクスポートサーバ]]へ渡すのに便利です。Pandora FMS Enterprise 版にのみにあり、エクスポートサーバを事前に設定する必要があります。詳細はエクスポートサーバの説明を参照してください。 +  * **エクスポートターゲット(Export target)**: エクスポートサーバにのみあります。 
- +  * **カテゴリ(Category)**: このカテゴリは、通常のユーザインターフェイスには影響しません。[[:ja:documentation:pandorafms:command_center:01_introduction|コマンドセンター(メタコンソール)]] と一緒に使用するためのものです。 
-**Cron** +  * **Cron** from が有効になっている場合、モジュール自体の間隔を無視して、現在の日付と時刻が Cron from で設定された日付と時刻と一致すると、モジュールは 1 回実行されます。 
- +  * **対象 IP(Target IP)**: 監視するデバイスの IP アドレス。エージェント名またはその別名に有効な IP アドレスがある場合は、''_agentname_'' または ''_agentalias_'' マクロを使用できます。
-If //Cron from//  is enabled, the module will be run once the current date and time match the date and time configured in //Cron from//, ignoring the module's own interval. +
- +
-//Cron 開始(Cron from)// が設定されているとモジュールの実行間隔は無視され、モジュールは //Cron 開始(Cron from)// で指定した日時に実行されます。 +
- +
-You may specify time periods in when the module will be executed; following the nomenclature: Minute, Hour, Month day, Month, Week day and there are three different possibilities: +
- +
-モジュールが実行される期間を指定できます。 分、時、日、月、曜日の命名法に従い、次の 3 つのパターンがあります。 +
- +
-  * **Cron from**  It has **Any**  set in all its fields, with no time restriction for monitoring. +
-  * If **Cron from**  → some specific value and **Cron to**  all in **Any**: It will be executed just when it matches the set number. E.g.: ''15 20 * * *''  will only be executed everyday at 20:15. +
-  * **Cron from**  → some specific value and **Cron to**  → → some specific value: It will be executed during the set interval. E.g.: ''5 * * * *''  and ''10 * * * *'', it will be executed every hour between minutes 5 and 10 (this is equivalent ''5-10 * * * *''). +
- +
-  * **Cron 開始(Cron from)** すべてのフィールドに **Any** が設定されている場合は、監視の時間制限はありません。 +
-  * **Cron 開始(Cron from)** が特定の値で、**Cron 終了(Cron to)** に **Any** が設定されている場合は、設定された値にマッチした際に実行されます。例: ''15 20 * * *'' は、毎日 20:15 に実行されます。 +
-  * **Cron 開始(Cron from)** が特定の値で、**Cron 終了(Cron to)** も特定の値が設定されている場合は、設定された期間で実行されます。例: ''5 * * * *'' および ''10 * * * *'' は、毎時 5分と 10分の間に実行されます。(''5-10 * * * *'' と同等です) +
- +
-Example, execute every Monday at 6:30:  +
- +
-例えば、次の設定ではモジュールは毎週月曜 6:30 に実行されます。 +
- +
-{{  :wiki:cron_from_ex1.png?600  }} +
- +
-Example, execute everyday between 6h and 7h: +
- +
-毎日 6時と 7時の間に実行する例: +
- +
-{{  :wiki:cron_from_ex2.png?600  }} +
- +
-For local modules, add the line //module_crontab//  corresponding to the file [[:en:documentation:03_monitoring:02_operations#programmed_monitoring|agent configuration]]. +
- +
-ローカルモジュールでは、[[:ja:documentation:03_monitoring:02_operations#指定時間モニタリング|エージェント設定ファイル]]に //module_crontab// を設定することで対応します。 +
- +
-**Timeout** +
- +
-**タイムアウト(Timeout)** +
- +
-Time the agent will wait for the execution of the module in seconds. +
- +
-エージェントがモジュールの実行を待機する時間 (秒単位)。 +
- +
-**Category** +
- +
-**カテゴリ(Category)** +
- +
-This categorization has no effect on the normal user interface, it is intended to be used together with the [[:en:documentation:06_metaconsole:01_introduction|Metaconsole]]. +
- +
-このカテゴリは、通常のユーザインターフェイスには影響しません。[[:ja:documentation:06_metaconsole:01_introduction|メタコンソール]] と一緒に使用するためのものです。+
  
 ===== SNMP モニタリング ===== ===== SNMP モニタリング =====
行 308: 行 266:
   * リモートデバイスのチェックをしたい特定の OID を確認します。(Pandora FMS ウィザードや SNMP OID ブラウザを使うこともできます)   * リモートデバイスのチェックをしたい特定の OID を確認します。(Pandora FMS ウィザードや SNMP OID ブラウザを使うこともできます)
   * デバイスが返す値をどのように扱えばよいかを確認します。SNMP デバイスは、それぞれ異なるファーマットでデータを返します。Pandora FMS は、ほとんどすべてのデータを扱うことができます。カウンタデータは、Pandora が ''remote_snmp_inc'' として管理する特別重要なものです。それは、数値データとしてではなく、カウンタとして認識されます。多くの SNMP データはカウンタ値になっています。それを正しく監視するためには、''remote_snmp_inc'' として設定する必要があります。   * デバイスが返す値をどのように扱えばよいかを確認します。SNMP デバイスは、それぞれ異なるファーマットでデータを返します。Pandora FMS は、ほとんどすべてのデータを扱うことができます。カウンタデータは、Pandora が ''remote_snmp_inc'' として管理する特別重要なものです。それは、数値データとしてではなく、カウンタとして認識されます。多くの SNMP データはカウンタ値になっています。それを正しく監視するためには、''remote_snmp_inc'' として設定する必要があります。
 +
 +<wrap #ks4_2 />
  
 ==== SNMP のネットワークモジュールでのモニタリング ==== ==== SNMP のネットワークモジュールでのモニタリング ====
  
-Pandora FMS のデータベースには、直接使用できる OID がいくつか含まれています。 たとえば、モジュールを作成するときに Cisco MIB コンポーネントを選択すると、Cisco で使用可能な変換済みの OID チェックのリストを表示します。+Pandora FMS includes some OIDs in its database that you can use directly. MIBs are a collection of definitions that define the properties of the managed object within the device to be managed.
  
-{{ wiki:Cap5_snmp_4.png?500 }}+Pandora FMS のデータベースには、直接使用できる OID がいくつか含まれています。MIB は、管理対象デバイス内の管理対象オブジェクトのプロパティを定義する定義のコレクションです。
  
-このコンポーネントを選択すると、使用可能な OID から選択でき、フィールドに必要な情報が入力されます。+<WRAP center round tip 90%>
  
-{{ wiki:Cap5_snmp_5.png?700 }}+There are more MIBs included in Pandora FMS and with the Enterprise version MIB packages are included for different devices.
  
-**作成(Create)** をクリックします。最近作成されたモジュールのデータを表示するには、上部の **表示(View)** タブをクリックします。また、(一度データを受信していれば) **グラフ(Graph)** をクリックすると、下部に SNMP グラフがリアルタイムで表示されます。+</WRAP>
  
-{{ wiki:SNMP_nueva.png?700 }}+<WRAP center round tip 90%> 
 + 
 +Pandora FMS にはさらに多くの MIB が含まれており、Enterprise 版ではさまざまなデバイス用の MIB パッケージが含まれています。
  
-<WRAP center round tip 60%> 
-Pandora FMS および Enterprise 版には、さまざまなデバイス用の MIB パッケージがさらにあります。 
 </WRAP> </WRAP>
  
-SNMP を介して要素を監視できるようにするには、SNMP コミュニティとは何かを理解しておく必要があります。 モジュールの作成で、**手動設定(Manual setup)** を選択します。+To be able to monitor any other element via SNMP, its SNMP community must be known. During module creation you must select **Manual setup**. In the **Type** field there are three options for SNMP, selecting one of them will expand the form showing the additional fields for SNMP.
  
-{{ wiki:Cap5_snmp_1.png?700 }}+SNMP 経由で他の要素を監視できるようにするには、その SNMP コミュニティがわかっている必要があります。モジュールの作成中に、**手動設定(Manual setup)** を選択する必要があります。**タイプ(Type)** フィールドには、SNMP の 3 つのオプションがあり、そのうちの 1 つを選択すると、フォームが展開され、SNMP の追加フィールドが表示されます。
  
-**タイプ(Type)** フィールドには、SNMP の 3つのオプションがあります。それらの 1つを選択すると、フォームは拡大され、SNMP の追加フィールドが表示されます。([[https://www.youtube.com/watch?v = aUXwcm4ZrUY|より詳細のビデオチュートリアル]]) +   * **SNMP community**: It is like a user ID or password that allows access to the statistics of a router or other device (SNMPv1 and SNMPv2c versions since SNMPv3 uses authentication by credentials). By default, devices come with a read-only public community (**public**) and generally each network administrator changes all community strings to custom values in the device configuration. 
- +   * **SNMP OID**: OID identifier to monitor, which consists of a string of numbers and periods. These strings are automatically translated into more descriptive alphanumeric strings if the corresponding MIBs are installed on the system. 
-{{ wiki:Cap5_snmp_2.png?700 }}+   * **Target IP**: IP address of the device to monitor. The ''_agentname_'' or ''_agentalias_'' macro can be used as long as the agent name or its alias has a valid IP address.
  
   * **SNMP コミュニティ(SNMP community)**: これは、ルータの統計データまたは他のデバイスの統計データへのアクセスを許可するユーザ ID またはパスワードのようなものです(SNMPv1 および SNMPv2c。SNMPv3 は資格情報認証を使用します)。デバイスには、デフォルトで読み取りモードの **public** コミュニティがあります。通常は、各ネットワーク管理者は、デバイスの設定ですべてのコミュニティ文字列をカスタム値に変更します。   * **SNMP コミュニティ(SNMP community)**: これは、ルータの統計データまたは他のデバイスの統計データへのアクセスを許可するユーザ ID またはパスワードのようなものです(SNMPv1 および SNMPv2c。SNMPv3 は資格情報認証を使用します)。デバイスには、デフォルトで読み取りモードの **public** コミュニティがあります。通常は、各ネットワーク管理者は、デバイスの設定ですべてのコミュニティ文字列をカスタム値に変更します。
- 
   * **SNMP OID**: 監視する OID 識別子。これは数値とドットで構成されます。対応する MIB がシステム内にインストールされている場合、これは、より説明的な英数字の文字列に自動的に変換されます。   * **SNMP OID**: 監視する OID 識別子。これは数値とドットで構成されます。対応する MIB がシステム内にインストールされている場合、これは、より説明的な英数字の文字列に自動的に変換されます。
- +  * **対象 IP(Target IP)**: 監視するデバイスの IP アドレス。エージェント名またはその別名に有効な IP アドレスがある場合、''_agentname_'' または ''_agentalias_'' マクロを使用できます。
-MIB は、管理対象のデバイス内で管理されるアイテムのプロパティを定義するコレクションです。 実際にはデータベースではありませんが、実装によって異なります。各 SNMP コンピュータプロバイダーには、MIB のツリー構造の排他的なセクションがあります。 +
- +
-文字で表した OID は次のような形式になります。 +
- +
-<code> iso.org.dod.internet.private.transition.products.chassis.card.slotCps.cpsSlotSummary.cpsModuleTable.cpsModuleEntry.cpsModuleModel.3562.3 +
-</code> +
- +
-数値では次のようになります。 +
- +
-  1.3.6.1.4.868.2.4.1.2.1.1.1.3.3562.3+
  
 ==== ソフトウエアエージェントからの SNMP モニタリング ==== ==== ソフトウエアエージェントからの SNMP モニタリング ====
行 418: 行 367:
 ==== MIB 管理 ==== ==== MIB 管理 ====
  
-Pandora FMS は、事前に決定された方法で、''/usr/share/snmp/mibs'' にある OS によって管理されている MIB ディレクトリの MIB を利用します。また、新しい MIB は、**MIBアップローダー** を使用して追加(および管理)できます。これらの MIB は、Pandora でのみ利用され、保存先は、''{PANDORA_CONSOLE}/attachment/mibs'' です。+Pandora FMS by default uses the MIBs that are hosted by the operating system in:
  
-{{  :wiki:pfms-monitoring-snmp-mib_uploader.png  }}+Pandora FMS はデフォルトで、以下にあるオペレーティングシステムが持つ MIB を使用します。
  
-<WRAP center round tip 60%> +<file> 
-この機能は、//SNMP ポーリング// のための MIB のみを管理します。//SNMP トラップ// の場合は、[[ja:documentation:03_monitoring:08_snmp_traps_monitoring|SNMP トラップ監視]] を参照してください。 +  /usr/share/snmp/mibs.
-</WRAP>+
  
-==== Pandora FMS SNMP ブラウザ ====+</file>
  
-<WRAP center round tip 60%> +New MIBs can be added (and managed later) via the **MIB uploader** functionality from the **Operation** menu → **Monitoring** → **SNMP**.
-{{wiki:icono-modulo-enterprise.png |Enterprise 版}}Enterprise 版バージョン 744 以降で利用できます +
-</WRAP>+
  
-SNMP ブラウザはデバイスのツリーの全体を取得するため、操作には数分かかる場合があります。特定のブランチに限定して時間を短縮することもできます。 +新しい MIB は、**操作(Operation)** メニュー → **モニタリング(Monitoring)** → **SNMP** から **MIB アップローダー(MIB uploader)** 機能を介して追加 (および後で管理) できます。
-//監視(Monitoring)// > //SNMP// > **SNMPブラウザ(SNMP Browser)** からアクセスします。+
  
-たとえば、Cisco® デバイスの enterprise サブ MIB ツリーの情報のみを取得するには、次のような OID を利用します。+These MIBs are only used by Pandora FMS and are stored in the route:
  
-  .1.3.6.1.4.1.9+これらの MIB は Pandora FMS によってのみ使用され、以下に保存されます。
  
-The browser is used to browse, which means clicking on each branch and obtain values. The system will ask for that information and will show the requested OID information (if available). If there is no information about the device OID, this is only displayed in numeric format. The OID descriptive information is stored through [[https://en.wikipedia.org/wiki/Management_information_base|MIBs]]. If there is no MIB for the device you wish to explore, you may have to look for "pieces of information" throughout the information displayed by Pandora FMS, which is complex and takes time.+<file> 
 +  {PANDORA_CONSOLE}/attachment/mibs.
  
-ブラウザを使用して操作します。各ブランチをクリックすることにより値を取得します。システムは情報を問い合わせ、指定された OID 情報(利用可能な場合)を表示します。 デバイスの OID に関する情報がない場合は、これは数値形式でのみ表示されます。OID に関する説明は [[https://en.wikipedia.org/wiki/Management_information_base|MIB]] にあります。探査したいデバイスの MIB がない場合、Pandora FMS が表示する情報の中から、複雑で時間がかかる "情報の断片" を探す必要があるかもしれません。+</file>
  
-Pandora FMS SNMP ブラウザでは、取得した OID の値と翻訳された OID の値(利用可能な場合)の両方でテキスト文字列を検索できます。既知の特定の文字列を探し、それらの OID を見つける場合に特に役立ちます。複数のエントリが見つかった場合は、1つのエントリから別のものに移動でき、黄色で強調表示されます。+<WRAP center round tip 60%>
  
-{{ wiki:snmp_browser_module_creator.png?800 }}+This functionality **only manages** the MIBs for SNMP Polling, in the case of SNMP Traps see the chapter [[:en:documentation:pandorafms:monitoring:08_snmp_traps_monitoring|Monitoring with SNMP traps]].
  
-複数の OID を選択し、"エージェントモジュールの作成(Create agent modules)" をクリックすることによりエージェントに追加することができます。それには、上記の OID で監視されるエージェントを選択し、右側のボックスに追加します。これらのモジュールは、**モジュールの追加(Add modules)** をクリックすると作成されます。+</WRAP>
  
-{{ wiki:SNMP1.png?800 }}+<WRAP center round tip 60%>
  
-{{ wiki:SNMP12.png?500 }}+この機能は、SNMP ポーリングのための MIB のみを管理します。SNMP トラップの場合は、[[ja:documentation:pandorafms:monitoring:08_snmp_traps_monitoring|SNMP トラップ監視]] を参照してください。
  
-また、複数の OID を選択し、"ポリシーモジュール作成(Create policy modules)" ボタンを使うことにより、ポリシーへ追加することもできます。+</WRAP>
  
-{{ wiki:SNMP21.png }}+==== Pandora FMS SNMP ブラウザ ====
  
-これらの OID のモジュール設定を追加したポリシーをすべて選択します。これらの OID の新たなポリシーを作成したい場合は、"新規ポリシーの作成(Create new policy)" をクリックします。+The SNMP Browser performs a complete walk-through of the device tree. This operation can take several minutes, and it is possible to traverse precise branches and shorten the traversal. It is accessed from **Monitoring** → **SNMP** → **SNMP Browser**.
  
-{{ wiki:SNMP33.png?500 }}+SNMP ブラウザはデバイスのツリーの全体を取得します。操作には数分かかる場合があります。特定のブランチに限定して時間を短縮することもできます。 
 +**モニタリング(Monitoring)** → **SNMP** → **SNMP ブラウザ(SNMP Browser)** からアクセスします。
  
-名前、グループ、ポリシーの説明のフィールドに入力し、"ポリシーの作成(Create policy)" をクリックします。それらを右側のボックスに追加し、**モジュールの追加(Add modules)** をクリックして、この設定をポリシーに適用します。+The system will request that information from the system and will also display (if available) the requested OID information. If there is no information about the OID of the device, it is displayed only in numeric format. The descriptive information of the OIDs is stored by the managed information bases or MIB. If you don't have a MIB for the device you want to explore, you probably have to resort to looking for "pieces of information" in the information displayed by Pandora FMS, which is complex and takes time.
  
-{{ wiki:SNMP31.png?500 }}+システムは対象システムにその情報を要求し、要求された OID 情報 (利用可能な場合) も表示します。 デバイスの OID に関する情報がない場合は、数値形式でのみ表示されます。 OID の記述情報は、管理された情報ベースまたは MIB に格納されているものです。 探索したいデバイスの MIB がない場合は、おそらく Pandora FMS によって表示される情報の中から「情報の一部」を探す必要がありますが、これは複雑で時間がかかります。
  
 +The SNMP browser also allows you to search for a text string both in the obtained OID values and in the translated values of the OID themselves (if available). This is especially useful for searching for specific known strings and locating their OID. If it locates several entries, it will allow us to jump from one occurrence to another, and it will show them highlighted in yellow.
  
-{{ wiki:SNMP32.png?500 }}+SNMP ブラウザでは、取得した OID 値と、OID 自体の翻訳された値 (利用可能な場合) の両方でテキスト文字列を検索することもできます。 これは、特定の既知の文字列を検索し、その OID を特定する場合に特に役立ちます。 複数のエントリが見つかった場合は、あるエントリから別のエントリにジャンプすることができ、それらのエントリが黄色で強調表示されて表示されます。
  
-特定の OID を選択する場合は、OID の詳細から "エージェントモジュール作成(Create agent module)" ボタンを使用できます。 このボタンをクリックすると、特定のエージェントを選択できるようになり、選択したすべての SNMP データがそのエージェント内のモジュールの作成にリダイレクトされます。+It is possible to select several OID and add them to an agent by clicking the **Create agent modules** button. To do this, the agents that will be monitored with said OID are selected and added to the box on the right. You can also select multiple OID to add to a [[:en:documentation:pandorafms:complex_environments_and_optimization:02_policy|monitoring policy]].
  
-{{ wiki:SNMP41.png?800 }}+**エージェントモジュールの作成(Create agent modules)** ボタンをクリックすると、複数の OID を選択してエージェントに追加できます。 これを行うには、上記の OID で監視されるエージェントを選択し、右側のボックスに追加します。 複数の OID を選択して [[:ja:documentation:pandorafms:complex_environments_and_optimization:02_policy|監視ポリシー]] に追加することもできます。
  
-SNMP モジュールエディターから、ネットワークモジュールを作成または編集するときは、"SNMPブラウザ(SNMP Browser)" をクリックして SNMP ブラウザーを起動します。ポップアップウィンドウで開きます。+<wrap #ks4_6 />
  
-探している OID を選択したら、フィルターアイコンをクリックしてその OID を選択すると、エージェントで使用されるモジュール定義の対応するフィールドに自動的に反映されます。+==== Pandora FMS SNMP ウィザード ====
  
-{{ wiki:Snmp browser from module creation.jpg?800 }}+**SNMP Wizard**
  
-==== Pandora FMS SNMP ウィザード ====+**SNMP ウィザード**
  
-エージェント管理画面に、リモートからモジュールを作成するツール、エージェントウィザードがあります。+Administration view of an agent.
  
-{{  :wiki:agent_wizard.png  }}+エージェントの管理画面。
  
-**SNMP ウィザード**+{{ :wiki:agent_wizard_snmp_wizard.png }}
  
-{{  :wiki:agent_wizard.png  }}+You must define the destination IP address (the **Target IP** field cannot use the macro ''_agentname_'' or ''_agentalias_''), community and other optional parameters (SNMP v3 is supported) to do an SNMP Walk to the target. Once the information is received correctly, a form will appear for the creation of modules such as **Devices**, **Processes**, **Free space on disk**, **Temperature sensors** and **Other SNMP data**.
  
-ホストに snmpwalk するために、対象の IP アドレス、コミュニティ、その他オプションパラメータ (SNMP v3 をサポートしています) を設定する必要があります。+ターゲットへの SNMP Walk を実行するには、宛先 IP アドレス (**対象 IP(Target IP)** フィールドではマクロ ''_agentname_'' または ''_agentalias_'' は使用できません)、コミュニティ、およびその他のオプションパラメータ (SNMP v3 がサポートされています) を定義する必要があります。情報が正しく受信されると、**デバイス**、**プロセス**、**ディスクの空き容量**、**温度センサー**、**その他の SNMP データ** などのモジュールを作成するためのフォームが表示されます。
  
-{{  :wiki:snmp_wizard_form.png  }}+The type of module is selected and added to the creation list. When this process is finished, you can click on the **Create Modules** button.
  
-データを受信すると、モジュール作成のフォームが表示されます。+モジュールのタイプが選択され、作成リストに追加されます。この処理が完了したら、**モジュールの作成(Create Modules)** ボタンをクリックできます。
  
-SNMP ウィザードでは、さまざまな種類の SNMP データからモジュールの作成が可能です。+This wizard will create two types of modules:
  
-  * **Devices** +このウィザードでは、次の 2 種類のモジュールが作成されます。
-  * **Processes** +
-  * **Free Space on disk** +
-  * **Temperature Sensors** +
-  * **Other SNMP Data**+
  
-  * **デバイス(Devices)** +   * **SNMP modules for queries with static OID**: Sensors, Memory, CPU, etc. 
-  * **プロセス(Processes)** +   * **Plugin modules for queries with dynamic OID or calculated data**: Processes, Disk space, Used memory expressed as a percentage, etc.
-  * **ディスク空き容量(Free space on disk)** +
-  * **温度センサ(Temperature sensors)** +
-  * **その他 SNMP データ(Other SNMP Data)**+
  
-{{  :wiki:snmp_wizard_module_creator.png  }}+   * **固定の OID をもったデータのための SNMP モジュール**  (センサー、メモリデータ、CPUデータなど) 
 +   * **動的な OID または計算したデータのためのプラグインモジュール**  (プロセス、ディスク空き容量、メモリ使用率など)
  
-モジュールの種類を選択し、左のウインドウから右へ必要なものをもっていきます。終わったら、モジュール作成(Create modules)ボタンをクリックします。+<WRAP center round important 60%>
  
-このウィザードは、以下の 2つの種類のモジュールを作成します。+For plugin type modules we will use the remote SNMP plugin, so if the plugin is not installed on the system, these features will remain disabled. The plugin should have the name **snmp_remote.pl** regardless of its location.
  
-  * **固定の OID をもったデータのための SNMP モジュール**  (センサー、メモリデータ、CPUデータなど) +</WRAP> 
-  * **動的な OID または計算したデータのためのプラグインモジュール**  (プロセス、ディスク空き容量、メモリ使用率など) + 
-<WRAP center round important 60%> すべてのプラグインモジュールでは、SNMP リモートプラグインを利用します。このプラグインがシステムにインストールされていないと、これらの機能は無効になります。プラグインは、 "snmp_remote.pl" という名前である必要があります。置き場所はどこでも構いません。 </WRAP>+<WRAP center round important 60%> 
 + 
 +すべてのプラグインモジュールでは、SNMP リモートプラグインを利用します。このプラグインがシステムにインストールされていないと、これらの機能は無効になります。プラグインは、 **snmp_remote.pl** という名前である必要があります。置き場所はどこでも構いません。 
 + 
 +</WRAP> 
 + 
 +In order for the SNMP wizard to be able to obtain data from an SNMP device thanks to the remote components, it is necessary to meet 2 requirements:
  
 SNMP ウィザードがリモートコンポーネントを使って SNMP デバイスからデータを取得できるようにするには、2つの要件を満たす必要があります。 SNMP ウィザードがリモートコンポーネントを使って SNMP デバイスからデータを取得できるようにするには、2つの要件を満たす必要があります。
 +
 +   * Have the Private Enterprise Number (PEN) of the device manufacturer registered in Pandora.
 +   * Have the SNMP wizard components registered and enabled in Pandora for the device manufacturer.
  
   * Pandora FMS にデバイス製造元のプライベートエンタープライズ番号(PEN)を登録する。   * Pandora FMS にデバイス製造元のプライベートエンタープライズ番号(PEN)を登録する。
   * Pandora FMS でデバイス製造元の SNMP ウィザードコンポーネントを登録して有効にする。   * Pandora FMS でデバイス製造元の SNMP ウィザードコンポーネントを登録して有効にする。
 +
 +If the scanned device meets these requirements, all modules from which data could be obtained will be displayed to give the opportunity to select which to create and which not.
  
 スキャンしたデバイスがこれらの要件を満たしている場合、データを取得できた可能性のあるすべてのモジュールが表示され、作成するモジュールと作成しないモジュールを選択できます。 スキャンしたデバイスがこれらの要件を満たしている場合、データを取得できた可能性のあるすべてのモジュールが表示され、作成するモジュールと作成しないモジュールを選択できます。
  
-これらのモジュールは、それらを生成したウィザードコンポーネントが属するグループに基づいて、ブロックで表示されます。+Once the Create modules button is pressed, a summary list of the chosen modules will be displayed.go with your setup. In this list you will see the modules that cannot be created, either because they already exist in the agent or because 2 or more modules with the same name have been configured in the wizard itself.
  
-すべてのブロックは、参照を容易にするために、最初は圧縮されて表示されます。そうすることで、選択範囲やデータを変更するように拡張できます。さらに、モジュールが作成対象としてマークされている各ブロックでは、これを示す情報アイコンが表示されます。+モジュールの作成(Create modules) ボタンを押すと、選択したモジュールの概要リストが表示されます。セットアップに進みます。このリストには、エージェントに既に存在しているか、ウィザード自体に同じ名前のモジュールが 2 つ以上設定されているために作成できないモジュールが表示されます。
  
-{{  :wiki:img8_wizard_components.png  }}+<WRAP center round tip 60%>
  
-ブロックをデプロイする場合、追加するモジュールと追加しないモジュールを選択できます。また、各モジュールの名前、説明、またはしきい値を個別に変更するオプションも選択できます。+Take into account that if the value of the Module collected by the wizard is of type [[:en:documentation:pandorafms:monitoring:02_operations#tipos_de_modulos|incremental or absolute incremental]], said value **is not the increment itself** but a reference value. To obtain an incremental value, two readings are necessary, for this reason the value of the Module will indicate "zero" until the next reading is performed.
  
-{{  :wiki:img9_wizard_components.png  }}+</WRAP>
  
-//モジュールの作成(Create modules)//  をクリックすると、選択したモジュールとその設定の概要一覧が表示されます。この一覧には、エージェントにすでに存在するか、同じ名前で 2つ以上のモジュールがウィザード自体で設定されていることで作成できなかったモジュールが表示されます。+<WRAP center round tip 60%>
  
-<WRAP center round tip 60%> ウィザードによって収集されたモジュールの値が [[:ja:documentation:03_monitoring:02_operations#e383a2e382b8e383a5e383bce383abe381aee7a8aee9a19e|**generic_data_inc** または **generic_data_inc_abs**]] の場合、その値は **増分値そのものではなく**  参照値であることに注意してください。増分値を取得するには、2回の読み取りが必要です。そのため、モジュールの値は、次の読み取りが完了するまで "ゼロ" を示します。 </WRAP>+ウィザードによって収集されたモジュールの値が [[:ja:documentation:pandorafms:monitoring:02_operations#モジュールの種類|増分または絶対増分]] のタイプである場合、その値は **増分そのものではなく** 参照値であることに注意してください。増分値を取得するには 2 回の読み取りが必要です。このため、モジュールの値は、次の読み取りが実行されるまで「ゼロ」を示します。
  
-それらをエージェントに追加する前に、前述のモジュールの作成を確認するか、モジュールをキャンセルしてウィザードの結果を変更するかの選択ができます。+</WRAP>
  
-{{  :wiki:img10_wizard_components.png  }}+Before they are added to the agent, there will be one last chance to confirm the creation of these modules or to cancel it and continue modifying the output of the wizard.
  
-モジュールの作成が確認されると、確認している間に同じモジュールが別の方法で作成された場合にモジュールが重複しないように、作成できるかどうか 1つずつ再評価されます。+エージェントに追加する前に、これらのモジュールの作成を進めるか、キャンセルしてウィザードの出力の変更をするかの選択が最後にあります。
  
-プロセスが正常に完了したか、作成できなかったモジュールがあるかどうかが通知されます。+<wrap #ks4_7 />
  
 +==== SNMP インタフェースウィザード ====
  
-**SNMP インタフェースウィザード**+{{ :wiki:agent_wizard_snmp_interfaces_wizard.png }}
  
-{{  :wiki:agent_wizard_snmp_interfaces_wizard.png  }}+This Wizard navigates the SNMP branch **IF-MIB::interfaces**, offering the possibility to create multiple modules of various interfaces with multiple selection. After selecting the destination IP address (the **Target IP** field cannot use the ''_agentname_'' or ''_agentalias_'' macro) and other required fields, the system will make an SNMP query to the destination machine and fill in the module creation form.
  
-エージェントウィザードには、インターフェイスを参照するために特別に作成された SNMP ウィザードがあります。 このウィザードは、SNMP ブランチ **IF-MIB::interfaces** を参照し、複数の選択肢を持つ異なるインターフェイスの複数のモジュールを作成する機能を提供します。対象 IP、コミュニティなどを選択した後、システムは SNMP クエリをホストに送信します。その後、モジュール作成フォームに入力します。+このウィザードは、SNMP ブランチ **IF-MIB::interfaces** を参照し、複数の選択によりさまざまなインターフェースの複数のモジュールを作成する機能を提供します。宛先 IP アドレス (**対象 IP(Target IP)** フィールドでは ''_agentname_'' または ''_agentalias_'' マクロは使用できません) とその他の必須フィールドを選択すると、システムは宛先マシンに対して SNMP クエリを実行し、モジュール作成フォームに入力します。
  
-{{  :wiki:agent_wizard_snmp_interfaces_creation.png  }}+<WRAP center round important 60%>
  
-左側の窓から 1つ以上のインターフェースを選択します。 その後、それに関して利用可能な要素(説明、速度、インバウンド/アウトバウンドトラフィックなど)が右側に表示されます。 この窓から 1つ以上の要素を選択し、**モジュールの作成(Create module)** をクリックして、左側の窓で選択したインターフェイスごとにこれらのモジュールを作成できます。+In order for the interface SNMP wizard to obtain data from an SNMP device, the SNMP device must return data from the **IF-MIB** branch.
  
-<WRAP center round important 60%> 
-SNMP インターフェースウィザードが SNMP デバイスからデータを取得するには、SNMP デバイスがブランチ //IF-MIB// からデータを返す必要があります。 
 </WRAP> </WRAP>
  
-追加可能なモジュールを備えた、デバイスで選択したすべてのインターフェースの概要を示す設定ブロックが表示されます。このブロックで選択されたモジュールとそのしきい値は、ネットワークインターフェイスに行われるデフォルト設定になります。 インターフェイスに一般的な監視を追加しないように、このブロックを無効にすることができます。+<WRAP center round important 60%>
  
-{{  :wiki:img11_wizard_components.png  }}+SNMP インターフェースウィザードが SNMP デバイスからデータを取得するには、SNMP デバイスがブランチ **IF-MIB** からデータを返す必要があります。
  
-また、ネットワークインターフェースごとに特定のブロックがあり、監視するインターフェースを選択できます。さらに、前のブロックで一般的な監視が設定されている場合、チェックされたすべてのインターフェイスがそれらの設定を使用します。 +</WRAP>
- +
-{{  :wiki:img12_wizard_components.png  }} +
- +
-各インターフェイスブロックでは、インターフェイスの特定の設定を指定することもできます。つまり、一般的な監視ブロックに含まれていない特定のモジュールを追加したり、特定のケースでそれらの設定を別の設定で上書きしたりできます。 +
-特定のケースごとにモジュールの名前と説明を変更することもできます。特定の設定が有効になるように、インターフェイスブロックを監視対象としてマークする必要があります。 +
- +
-{{  :wiki:img13_wizard_components.png  }} +
- +
-すべてのブロックは、参照を容易にするために、最初は圧縮されて表示されます。選択やデータを変更するために展開できます。 さらに、モジュールが作成対象としてマークされている各ブロックには、それを示す情報アイコンが表示されます。+
  
-//モジュールの作成(Create modules)// をクリックすると、選択したモジュールとその設定の概要一覧が表示されます。この一覧には、エージェントにすでに存在するか、ウィザードで同じ名前のモジュールが 2つ以上構成されているために作成できないモジュールが表示されます。+Once the creation of the modules has been confirmed, it will be re-evaluated one by one if they can be created or not, to avoid duplicate modules in the event that the same modules have been created by another means during the confirmation time.
  
-すべての変更を行ったのち、それらがエージェントに追加される前に、それらのモジュールの作成を確認するか、それをキャンセルしてウィザードの結果を変更し続けるかを最後に選択します。+モジュールの作成が確認されると、確認時間中に別の方法で同じモジュールが作成された場合のモジュールの重複を避けるために、モジュールの作成が可能かどうかが 1 つずつ再評価されます。
  
-{{  :wiki:img14_wizard_components.png  }}+We will be notified if the process could be completed successfully or, on the contrary, there has been a module that could not be created.
  
-モジュールの作成が確認されると、モジュールが 1つずつ再評価され、作成できるかどうかが確認されます。確認時間内に同じモジュールが別の方法で作成された場合にモジュールが重複しないようにします。+処理が正常に完了した場合、または逆に作成できなかったモジュールがあった場合は通知されます。
  
-プロセスが正常に完了したか、作成できなかったモジュールがあるかどうかが通知されます。+<wrap #ks5 />
  
 ===== WMI でのリモート Windows モニタリング ===== ===== WMI でのリモート Windows モニタリング =====
行 703: 行 646:
  
 リモートプラグインはスクリプトまたは実行形式のファイルで、パラメータに応じて **単一の** 値を返します。結果は、数値、二値(0:エラー、0 以外:正常)、またはテキスト文字列です。リモートプラグインは通常、入力パラメータを許可します。デフォルトでいくつかのサーバプラグインがインストールされており、すぐに使用できますが、ユーザは必要に応じていつでも追加できます。 リモートプラグインはスクリプトまたは実行形式のファイルで、パラメータに応じて **単一の** 値を返します。結果は、数値、二値(0:エラー、0 以外:正常)、またはテキスト文字列です。リモートプラグインは通常、入力パラメータを許可します。デフォルトでいくつかのサーバプラグインがインストールされており、すぐに使用できますが、ユーザは必要に応じていつでも追加できます。
 +
 +There are two kinds of remote plugin: standard and type Nagios. The difference is mainly that the Nagios type respond with an error level and **also, optionally, with a descriptive string.**
  
 リモートプラグインには、標準タイプと Nagios タイプの 2種類があります。 違いは、Nagios リモートプラグインはエラーレベルに加えて説明文字列で応答することです。 リモートプラグインには、標準タイプと Nagios タイプの 2種類があります。 違いは、Nagios リモートプラグインはエラーレベルに加えて説明文字列で応答することです。
行 708: 行 653:
 ==== リモートプラグイン管理 ==== ==== リモートプラグイン管理 ====
  
-{{  :wiki:pfms-servers-plugins-menu-ng-767.png  }}+It is accessed by **Management** → **Servers** → **Plugins**, a new window will open with a list of registered plugins. Each item has its corresponding edit and delete buttons, except if it has modules in use which can be listed using the **Lock** button.
  
-Click on **Servers** and then **Plugins**, and a new window will open:+**管理(Management)** → **サーバ(Servers)** → **プラグイン(Plugins)** からアクセスすると、新しいウィンドウが開き、登録されているプラグインのリストが表示されます。 **ロック** ボタンと共に表示されている使用中のモジュールがある場合を除き、各項目には対応する編集ボタンと削除ボタンがあります。
  
-**サーバ(Servers)**、そして **プラグイン(Plugins)** をクリックするとウインドウが開きます。+When editing a plugin:
  
-{{  :wiki:pfms-servers-plugins-menu-ng-767-registered_plugins.png  }}+プラグインの編集:
  
-By clicking on one of them, the following dialogue will open:+   * **Plug-in type**: Allows you to establish whether it is standard or Nagios type. 
 +   * **Max. timeout**: To set the waiting time for its execution, special attention must be paid to this value since it must cover enough time for the execution otherwise it will not obtain any value. 
 +   * The description field is important since it will be seen in the user interface of the plugin, choose a short and explanatory legend.
  
-いずれかをクリックすると次のダイアログが開きます。+   * **プラグインタイプ(Plug-in type)**: 標準か Nagios かを設定できます。 
 +   * **最大タイムアウト(Max. timeout)**: 実行タイムアウト時間を設定します。実行には十分な時間を確保する必要があるため、この値には特に注意してください。そうしないと、値を取得できません。(不明状態となります) 
 +   * 説明フィールドはプラグインのユーザインターフェイスに表示されるため重要です。短く内容がわかる記載をしてください。
  
-{{  :wiki:pfms-servers-plugins-menu-ng-767-edit_plugin_for_udp_check.png  }}+<WRAP center round tip 90%>
  
-  * **Plug-in type**: It allows setting whether it is standard or Nagios. +   * When executing a plugin, there are three wait values: the server's, the plugin's, and the module's. The one of the server prevails over the others, and secondly, the one of the plugin. For example, with server timeout values of 10 seconds, that of the plugin at 20 and that of a module with this plugin at 30, **the maximum time that will wait for the execution of that module will be 10 seconds.** 
-  * **Max. timeout**: To fix the waiting time for its execution, pay special attention to this value since it has to provide enough time for execution, otherwise you will not get any values.+   * When **editing** a plugin and it is in use by at least one agent, you **will not be able to add or delete macros**.
  
-  * **プラグインタイプ(Plug-in type)**: 標準か Nagios かを設定できます。 +</WRAP>
-  * **最大タイムアウト(Max. timeout)**: 実行タイムアウト時間を設定します。実行には十分な時間を確保する必要があるため、この値には特に注意してください。そうしないと、値を取得できません。(不明状態となります)+
  
 <WRAP center round tip 60%> <WRAP center round tip 60%>
  
-In a plugin execution, there are three timeouts: those of servere, those of plugins and those of modules. Please note that the server prevails over the others, and secondly that of the plugin. That is, if you have a server with a 10-second timeout and a plugin with a 20-second timeout and a module that uses that plugin with a 30-second timeout, **the maximum time to wait for the execution of that module will be 10 seconds.**</WRAP>+   * プラグインの実行には、サーバ、プラグイン、モジュールの 3つのタイムアウトがあります。 サーバのタイムアウトが他よりも優先され、次にプラグインのタイムアウトが優先されることに注意してください。 つまり、タイムアウトが 10秒のサーバとタイムアウトが 20秒のプラグインがあり、そのプラグインをタイムアウトが 30秒で使用するモジュールがある場合、そのモジュールのタイムアウトは 10秒になります。 
 +   * プラグインを**編集**し、それが少なくとも 1 つのエージェントによって使用されている場合、**マクロを追加または削除することはできません**。
  
-<WRAP center round tip 60%> 
-プラグインの実行には、サーバ、プラグイン、モジュールの 3つのタイムアウトがあります。 サーバのタイムアウトが他よりも優先され、次にプラグインのタイムアウトが優先されることに注意してください。 つまり、タイムアウトが 10秒のサーバとタイムアウトが 20秒のプラグインがあり、そのプラグインをタイムアウトが 30秒で使用するモジュールがある場合、そのモジュールのタイムアウトは 10秒になります。 
 </WRAP> </WRAP>
- 
-The description field is important since it will be seen in a plugin use interface by the user, make sure you choose a descriptive but short one. The following image shows a practical example: 
- 
-説明フィールドは、ユーザがプラグインを使用するインターフェースに表示されるため重要です。説明的で短いものを選択してください。 次の画像は実際の例を示しています。 
- 
-{{  :wiki:pfms-servers-plugins-menu-ng-767-edit_plugin_description.png  }} 
- 
-Essential configuration values: 
- 
-重要な設定値: 
- 
-{{  :wiki:pfms-servers-plugins-menu-ng-767-edit_plugin_command.png  }} 
- 
-  * **プラグインコマンド(Plug-in command)**: プラグインコマンドのパスです。標準のインストールでのデフォルトでは、''/usr/share/pandora_server/util/plugin/'' です。任意のパスを設定できます。独自のプラグインを利用する場合は、どこにプラグインを置いたかを確認し、実行権限(''chmod 755'')がついていることを確認してください。 
- 
-  * **プラグインパラメータ(Plug-in parameters)**: コマンドのパラメータは、コマンドの後にスペース区切りで指定するものです。このパラメータには、''_field1_ _field2_ ... _fieldN_'' といったマクロが利用できます。これらのマクロはモジュール設定のテキストフィールドとして表示されるため、ユーザはプラグインモジュール使用時の複雑さを抽象化できます。これにより、ユーザは、スクリプトの動作や呼び出し方法を知らなくても、スクリプト呼び出しパラメーターを入力できます。 
- 
-それぞれのマクロは 3つのフィールドがあります: 
- 
-{{  :wiki:pfms-servers-plugins-menu-ng-767-edit_plugin_macro_parameters.png  }} 
- 
-  * **Description**: A short label next to the field in the form. 
-  * **Default value**: The default value assigned to the field. 
-  * **Help**: A text with an explanation of the macro, to show some examples of use or better explain what that field is for. 
-  * The **Add macro**  and **Delete macro**  buttons are used to add and delete macros accordingly. 
- 
-  * **説明(Description)**: マクロの簡単な説明です。フィールドのラベルになります。 
-  * **デフォルト値(Default value)**: デフォルトでフィールドに割り当てられる値です。 
-  * **ヘルプ(Help)**: マクロの説明です。フィールドの設定例などを記載するとよいでしょう。 
-  * **マクロの追加(Add macro)** および **マクロの削除(Delete macro)** ボタンは、マクロの追加および削除に利用します。 
- 
-<WRAP center round info 60%> 
- 
-When you **edit**  a plugin and it is used by at least one agent, **you won't be able to **//add or delete//** the macros**. 
- 
-</WRAP> 
- 
-<WRAP center round info 60%> 
- 
-プラグインを**編集**し、それが少なくとも 1 つのエージェントによって使用されている場合、**マクロを**//追加または削除//**することはできません**。 
- 
-</WRAP> 
- 
  
 === 内部マクロ === === 内部マクロ ===
行 1018: 行 922:
  
 ===== 経路監視 ===== ===== 経路監視 =====
- 
-<WRAP center round tip 60%> 
- 
-Version NG 715 or higher. 
- 
-</WRAP> 
- 
-<WRAP center round tip 60%> 
- 
-バージョン NG 715 以降 
- 
-</WRAP> 
  
 Pandora FMS offers by default the monitoring of complete routes between two points in the network, visually indicating the path that is being followed at all times to communicate between these two points. Pandora FMS route analyzer uses an agent plugin to map the route. Pandora FMS offers by default the monitoring of complete routes between two points in the network, visually indicating the path that is being followed at all times to communicate between these two points. Pandora FMS route analyzer uses an agent plugin to map the route.
  • ja/documentation/pandorafms/monitoring/03_remote_monitoring.1715762547.txt.gz
  • 最終更新: 2024/05/15 08:42
  • by junichi