両方とも前のリビジョン 前のリビジョン 次のリビジョン | 前のリビジョン |
ja:documentation:pandorafms:technical_reference:04_anexo_plugins_considerations [2024/09/01 07:34] – [プラグインと拡張のバージョン管理] junichi | ja:documentation:pandorafms:technical_reference:04_anexo_plugins_considerations [2024/10/11 22:53] (現在) – [自動検出処理] junichi |
---|
===== 概要 ===== | ===== 概要 ===== |
| |
The plugins allows to Pandora FMS to get information that requires a complex process or that requires the use of complex systems or APIs. Examples of plugins could be the Oracle® database monitoring that requires a full process for the monitoring and also some auto-discovery tasks. Other example could be a simple HTML parse, but that requires some that Goliat ([[:en:documentation:pandorafms:introduction:02_architecture#ks1_1_8|checking web server]]) can't do. | Plugins allow Pandora FMS to get information that requires complex processes or that requires the use of complex systems or APIs. A plugin example could be Oracle® database monitoring, which requires a full process for monitoring and also some auto-discovery tasks. Another example could be a simple HTML parse, but that requires some that Goliat ([[:en:documentation:pandorafms:introduction:02_architecture#ks1_1_8|checking web server]]) cannot do. |
| |
プラグインにより Pandora は、複雑な処理を必要とするものや、複雑なシステムや API を利用する必要のある情報収集を実行することができます。プラグインの例をあげると、複雑な処理が必要な Oracle データベースのモニタリングや、何らかの自動検出処理があります。他には、Goliat ([[:ja:documentation:pandorafms:introduction:02_architecture#ウェブサーバ_goliat|ウェブサーバチェック]]) が実行できないような簡単な HTML のパースができます。 | プラグインにより Pandora は、複雑な処理を必要とするものや、複雑なシステムや API を利用する必要のある情報収集を実行することができます。プラグインの例をあげると、複雑な処理が必要な Oracle データベースのモニタリングや、何らかの自動検出処理があります。他には、Goliat ([[:ja:documentation:pandorafms:introduction:02_architecture#ウェブサーバ_goliat|ウェブサーバチェック]]) が実行できないような簡単な HTML のパースができます。 |
Pandora のプラグイン実行には、[[:ja:documentation:pandorafms:introduction:02_architecture#pandora_fms_のソフトウエアエージェント|ソフトウエアエージェント]]での実行とサーバでの実行の二種類があります。 | Pandora のプラグイン実行には、[[:ja:documentation:pandorafms:introduction:02_architecture#pandora_fms_のソフトウエアエージェント|ソフトウエアエージェント]]での実行とサーバでの実行の二種類があります。 |
| |
* The server plugins do independent executions to collect each information piece. The server plugin execution is very difficult so it is only possible for plugins that are "lights", this is, that does need few or very few queries to get a single piece of information. A server plugin could be an specific HTML parse plugin that requires 2 or 3 queries and so it will charge a little job on the server. | * Server plugins do independent executions to collect each information piece. The server plugin execution is very difficult so it is only possible for "light" plugins, that is, that does need few or very few queries to get a single piece of information. A server plugin could be an specific HTML parse plugin that requires 2 or 3 queries and so it will charge a little job on the server. |
* The Software agent plugins allow to obtain several modules at the same time and for this reason they are much more flexible than the server plugins. They are perfects for plugins that need several queries to get an information piece; they allow more flexibility to the programmer so it's possible to return several modules at the same time. | * Software agent plugins allow to obtain several modules at the same time and for that reason they are much more flexible than server plugins. They are perfect for plugins that need several queries to get an information piece; they allow more flexibility to programmers so it is possible to return several modules at the same time. |
| |
* サーバプラグインは、収集する情報ごとに個々に実行されます。サーバプラグインの実行は、重くなく、一つの種類の情報を取得するのを簡単な処理にする必要があるため、とても難しいです。特定の HTML をパースするプラグインは、多くの処理を実装せずにサーバに負荷をかけないようにする必要があります。 | * サーバプラグインは、収集する情報ごとに個々に実行されます。サーバプラグインの実行は、重くなく、一つの種類の情報を取得するのを簡単な処理にする必要があるため、とても難しいです。特定の HTML をパースするプラグインは、多くの処理を実装せずにサーバに負荷をかけないようにする必要があります。 |
| |
===== 自動検出処理 ===== | ===== 自動検出処理 ===== |
| |
| To do recon tasks on plugins that need it, there are two possibilities: |
| |
プラグインで自動検出処理を実行するには、次の二種類の方法があります。 | プラグインで自動検出処理を実行するには、次の二種類の方法があります。 |
| |
一つは、Pandora サーバの自動検出サーバを利用しての構成です。これを行うには、特定の技術や状況に応じてアドホックなコードを作成する必要があります。自動検出処理は、Pandora サーバに負荷を与えます。そのため、大量のデータ処理が必要な場合は、この選択枝は考えるべきではありません。 | The first one consists on using Pandora server [[:en:documentation:pandorafms:complex_environments_and_optimization:05_satellite#ks4_1|Recon Task]] server. To that end, it will be necessary to create the //ad-hoc// code for the specific technology or situation. The Recon Tasks loads Pandora server, so, if for doing the recon task a lot of data requests are necessary, this option should not be considered. |
| |
エージェントプラグインを用いても自動検出処理を作成することができます。通常、エージェントプラグインは、Pandora サーバに対して送信する XML に記載されたモジュールを返します。しかし、エージェントのインストールと一緒にプラグインをインストールし、tentacle も入っていれば、Pandora サーバに XML を送信することができます。自動検出処理をエージェントプラグインから実行するには、この方法を利用することができます。さらに、通常のプラグインの実行と同じように、モジュールを追加します。自動検出処理が実行するように、エージェントの更新情報を Pandora へ XML で送信するようにプラグインを用意します。 | 一つは、Pandora サーバの[[:ja:documentation:pandorafms:complex_environments_and_optimization:05_satellite#自動検出タスクでのエージェント作成|自動検出]]サーバを利用しての構成です。これを行うには、特定の技術や状況に応じてアドホックなコードを作成する必要があります。自動検出処理は、Pandora サーバに負荷を与えます。そのため、大量のデータ処理が必要な場合は、この選択枝は考えるべきではありません。 |
| |
| It is also possible to create a recon task using an agent plugin. Usually, agent plugins return modules that are attached to the XML that the agent sends to Pandora server. But, consider that when installing the agent in a machine with it, [[:en:documentation:pandorafms:technical_reference:09_tentacle|Tentacle]] is also installed, and this allows to send XML to Pandora server. To do a recon task from an agent plugin, it is possible to use this, and besides adding the modules to the agent as a common plugin does, to give your plugin the capacity to send XML to Pandora with the information of other agents updated as a recon task would do. |
| |
| エージェントプラグインを用いても自動検出処理を作成することができます。通常、エージェントプラグインは、Pandora サーバに対して送信する XML に記載されたモジュールを返します。しかし、エージェントのインストールと一緒にプラグインをインストールし、[[:ja:documentation:pandorafms:technical_reference:09_tentacle|tentacle]] も入っていれば、Pandora サーバに XML を送信することができます。自動検出処理をエージェントプラグインから実行するには、この方法を利用することができます。さらに、通常のプラグインの実行と同じように、モジュールを追加します。自動検出処理が実行するように、エージェントの更新情報を Pandora へ XML で送信するようにプラグインを用意します。 |
| |
| The idea is that the plugin, besides creating average modules, collects the information and creates and sends the XML simulating other installed agents if necessary. |
| |
プラグインにより平均的なモジュールの作成および情報収集を行ったり、必要に応じて他のエージェントをシミュレートするXMLを作成して送信するという考え方です。 | プラグインにより平均的なモジュールの作成および情報収集を行ったり、必要に応じて他のエージェントをシミュレートするXMLを作成して送信するという考え方です。 |
| |
| The reason to create a plugin that sends data through XML and besides does recon task is to distribute the monitoring load among different machines and not centralize it into the server. |
| |
XML でデータを送信するプラグインを作成する理由は、自動検出処理の負荷をサーバに集中させずに分散することにあります。 | XML でデータを送信するプラグインを作成する理由は、自動検出処理の負荷をサーバに集中させずに分散することにあります。 |
ここで: | ここで: |
| |
* vX: plugin version, the step of one version to another is made when a new important functionality is added or an error that makes impossible the correct working of the plugin is corrected.The first version is the v1. | * ''vX'': plugin version, the step of one version to another is made when a new important functionality is added or an error that makes impossible the correct working of the plugin is corrected. The first version is always ''v1''. |
* rY: Plugin revisión, | * ''rY'': revision of the plugin, the transition from one revision to another occurs when a bug is fixed or a minor functionality is implemented. The first revision is always ''r1''. |
| |
* vX: プラグインのバージョンです。新しい重要な機能が追加されたり、プラグインが正常動作しないような不具合が修正されたりしたときに、あるバージョンから別のバージョンへあげられます。最初のバージョンは v1 です。 | * ''vX'': プラグインのバージョンです。新しい重要な機能が追加されたり、プラグインが正常動作しないような不具合が修正されたりしたときに、あるバージョンから別のバージョンへあげられます。最初のバージョンは ''v1'' です。 |
* rY: プラグインのリビジョンです。 | * ''rY'': プラグインのリビジョンです。バグが修正されたとき、またはマイナーな機能が実装されたときに、あるリビジョンから別のリビジョンへの移行が発生します。最初のリビジョンは常に ''r1'' です。 |
| |
The change to one revision to another is done when any bug is fixed or a minor feature is implemented. The first revision is the r1. | The change to one revision to another is done when any bug is fixed or a minor feature is implemented. The first revision is the r1. |