差分

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

--- ja:documentation:pandorafms:monitoring:13_user_monitorization [2025/07/19 22:42] – [手動実行（エージェントから、プラグインとして）] junichi
+++ ja:documentation:pandorafms:monitoring:13_user_monitorization [2026/08/07 21:57] (現在) – [パラメータと設定] junichi
@@ 行 157: / 行 157: @@
 <WRAP center round download 90%>
-https://pandorafms.com/library/selenium-4-discovery/
+[[https://marketplace.pandorafms.com/entries/pandorafms.selenium.4]]
 </WRAP>
@@ 行 366: / 行 366: @@
 <WRAP center round box 90%>
- <font inherit/Courier New,Courier,monospace;;inherit;;inherit>module_plugin /path/to/binary/file/pandora_selenium -c /path/to/configuration/file -s /path/to/side/file -t task_name -i agent_interval -g ID_group -x -S IP_address_Tentacle_server:Tentacle_port</font>
+ <font inherit/Courier New,Courier,monospace;;inherit;;inherit>module_plugin /var/spool/pandora/data_in/discovery/pandorafms.selenium.4/bin/pandora_selenium -c /path/to/configuration/file -s /path/to/side/file -t task_name -i agent_interval -g ID_group -x</font>
 </WRAP>
@@ 行 385: / 行 385: @@
 <WRAP center round box 90%>
+ <font inherit/Courier New,Courier,monospace;;inherit;;inherit>module_plugin /path/to/binary/file/pandora_selenium -c /path/to/configuration/file -s /path/to/side/file -t task_name -i agent_interval -g ID_group -x -S IP_address_Tentacle_server:Tentacle_port</font>
-<font inherit/Courier New,Courier,monospace;;inherit;;inherit>
-module_plugin /パス/への/バイナリ/ファイル/pandora_selenium -c /パス/への/構成/ファイル -s /パス/への/side/ファイル -t タスク名 -i エージェント間隔 -g ID_グループ -x -S IP_住所_Tentacle_サーバー:Tentacle_ポート
-</font>
 </WRAP>
@@ 行 424: / 行 421: @@
 <file>
 {
 "worker_mode" : "<local | remote>",
@@ 行 448: / 行 446: @@
 "browser_height" : "<height>",
 "global_timeout" : "<seconds>",
-"wait_between_commands" : "<seconds>"
+"wait_between_commands" : "<seconds>",
+"phase_summarize" : "<1 | 0>",
+"legacy_data_structure" : "<1 | 0>",
+"legacy_data_agent_name" : "<agent_name>",
+"legacy_data_agent_group" : "<group_name>"
 }
 </file>
-コンフィギュレーションの各要素：
+Each configuration element:
+設定の各要素：
+|''worker_mode''   |It indicates whether the transaction will be launched locally or remotely.  |
+|''run_mode''   |It indicates whether the plugin will run with drivers or in Docker.  |
+|''browser''   |It indicates the web browser to be used for the transaction.  |
+|''driver_url''   |It indicates the URL to Selenium 4 server \\ to execute the transaction. \\ Only in ''remote/driver'' mode.  |
+|''ssh_address''   |It indicates the IP address of the server to which it will connect by SSH to execute the plugin. \\ Only in ''remote/docker'' mode.  |
+|''ssh_port''   |**Optional**. \\ It indicates the port number for SSH connection. \\ By default: ''22''. \\ Only in ''remote/docker'' mode.  |
+|''ssh_user''   |It specifies the user for SSH connection. \\ Only in ''remote/docker'' mode.  |
+|''ssh_password''   |It indicates the user's password ''ssh_user''. \\ Only in ''remote/docker'' mode.  |
+|''ssh_password_encrypt''   |**Optional**. \\ It indicates whether the above password is sent encrypted (''1'') or not (''0''). \\ Only in ''remote/docker'' mode. \\ Passwords may be encrypted by executing \\ the plugin from Pandora FMS Discovery server.  |
+|''ssh_temp_folder''   |**Optional**. \\ It specifies the path to the temporary directory for the necessary files \\ during execution on the SSH server. \\ By default: ''/tmp''. \\ Only in ''remote/docker'' mode.  |
+|''docker_image''   |**Optional**. \\ It indicates the name of the Docker image to run the transaction. \\ By default: ''pandorafms/pandora_selenium_headless''. \\ Only in ''docker'' mode.  |
+|''chromedriver_path''   |**Optional**. \\ It specifies the path to ''chromedriver'' binary.((Default: ''/usr/share/pandora_server/util/selenium_headless_drivers/chromedriver'')) \\ Only in ''local/driver'' mode.  |
+|''chrome_binary_path''   |**Optional**. \\ It specifies the path to Google Chrome binary.((Default: ''/usr/share/pandora_server/util/selenium_headless_drivers/chrome/google-chrome'')) \\ Only in ''local/driver'' mode.  |
+|''chrome_user_data_dir''   |**Optional**. \\ It specifies the path to the data directory (''data dir'') of Google Chrome that you wish to use.  |
+|''chrome_profile''   |**Optional**. \\ It specifies the name of the Google Chrome profile to be used. \\ It must be inside the ''data_dir''. \\ If not specified, the browser's default profile will be used.  |
+|''geckodriver_path''   |It specifies the path to the ''geckodriver'' binary.((Default: ''/usr/share/pandora_server/util/selenium_headless_drivers/geckodriver''))   \\ Only in ''local/driver'' mode.|
+|''firefox_binary_path''   |It specifies the path to the Mozilla Firefox binary.((Default: ''/usr/share/pandora_server/util/selenium_headless_drivers/firefox/firefox'')) \\ Only in ''local/driver'' mode.  |
+|''firefox_profile''   |**Optional**. \\ It specifies the path to Mozilla Firefox profile directory you wish to use. \\ If not specified, the browser's default profile will be used.  |
+|''accept_insecure_certs''   |**Optional**. \\ If set to ''1'', insecure SSL certificates from URLs accessed \\ during the transaction will be automatically accepted as valid.  |
+|''monitor_stats''   |**Optional**. \\ If it is indicated with value ''1'', connection statistics modules \\ will be generated to the main URL of the indicated SIDE file.  |
+|''browser_width''   |**Optional**. \\ It indicates the width of the web browser in pixels for the transaction. \\ By default: ''1920''.  |
+|''browser_height''   |**Optional**. \\ It indicates the height of the browser in pixels for the transaction. \\ By default: ''1080''.  |
+|''global_timeout''   |**Optional**. \\ It indicates the global timeout in seconds for tasks performed by the plugin, \\ such as connecting to Selenium server, starting browser drivers, etc. \\ It is also the default timeout used for Selenium commands to be executed. \\ By default: ''5''.  |
+|''wait_between_commands''   |**Optional**. \\ It indicates the time in seconds that the plugin \\ will wait between each SIDE command it executes. \\ This value may be adjusted with the SIDE itself \\ by means of the ''setSpeed'' command. \\ By default: ''0''.  |
+| ''phase_summarize''  | **Optional**. \\ Sets the transaction’s Global_Time as the sum of the Time modules for all phases.  |
+| ''legacy_data_structure''  | **Optional**. \\ Enables the renaming of modules created in the transaction that used Selenium 3. Useful for migrating tasks from Selenium 3 to Selenium 4 and reporting on modules that already existed.  |
+| ''legacy_data_agent_name''  | **Optional**. \\ If ''legacy_data_structure'' is enabled, the name of the agent to which the task will report.  |
+| ''legacy_data_agent_group''  | **Optional**. \\ If ''legacy_data_structure'' is enabled, the name of the group to which the agent to which the task will report will belong.  |
 | ''worker_mode''  | トランザクションがローカルで開始されるか、リモートで開始されるかを示す。  |
@@ 行 477: / 行 511: @@
 | ''browser_height''  | **オプション**. \\ トランザクションのブラウザの高さをピクセル単位で示す。 \\ デフォルト： ''1080''.  |
 | ''global_timeout''  | **オプション**. \\ プラグインが実行するタスクのグローバルタイムアウトを秒単位で示します。 \\ また、Seleniumコマンドが実行される際のデフォルトのタイムアウトでもあります。 \\ デフォルト： ''5''.  |
-| ''wait_between_commands''  | **オプション**. \\ プラグインがSIDEコマンドを実行するまでの待機時間を秒単位で示します。 \\ この値はSIDE本体で''setSpeed''コマンドにより調整可能。 \\ デフォルト： ''0''.  |
+| ''wait_between_commands''  | **オプション**. \\ プラグインが SIDE コマンドを実行するまでの待機時間を秒単位で示します。 \\ この値は SIDE 本体で ''setSpeed'' コマンドにより調整可能。 \\ デフォルト： ''0''.  |
+| ''phase_summarize''  | **オプション**。 \\ トランザクションの Global_Time を、すべてのフェーズの Time モジュールの合計値として設定します。 |
+| ''legacy_data_structure''  | **オプション**。 \\ Selenium 3 を使用して作成されたトランザクション内のモジュールの名前変更を有効にします。Selenium 3 から Selenium 4 へタスクを移行する場合や、既存のモジュールに関するレポートを作成する場合に役立ちます。 |
+| ''legacy_data_agent_name''  | **オプション**。 \\ ''legacy_data_structure'' が有効な場合、タスクがレポートを送信するエージェントの名前を指定します。 |
+| ''legacy_data_agent_group''  | **オプション**。 \\ ''legacy_data_structure'' が有効な場合、タスクがレポートを送信するエージェントが所属するグループの名前を指定します。 |
-例えば、こうだ：
+例:
 <file>
@@ 行 513: / 行 551: @@
 ===== .SIDEファイル用コマンド =====
-追加モジュールを生成するために、以下のカスタムコマンドを設定することができます。 ''<nowiki>//</nowiki>''):
+The following custom commands may be configured to generate additional modules (all custom commands must begin with ''<nowiki>//</nowiki>''):
+追加のモジュールを生成するために、次のカスタムコマンドを設定できます (すべてのカスタムコマンドは ''<nowiki>//</nowiki>'' で始まる必要があります)。
+|''<nowiki>//phase_start:<phase_name></nowiki>''   |It indicates the beginning of a stage, which will \\ last until another ''<nowiki>//phase_start</nowiki>'' command is found \\  or until the end of the test. \\  This will generate a module with the status of the stage and another module with the time it has taken to complete. \\  For example: ''<nowiki>//phase_start:Login</nowiki>''   |
+|''<nowiki>//getValue;<module_name>;<module_type>;<regexp></nowiki>''   |It generates a module with content from the web page \\   which may be obtained by means of a regular expression \\   from the source code of the web page. \\   For example: \\ ''<nowiki>//getValue;Temperature;generic_data;<span class="temperature">(\d+\.*\,*\d*).*</span></nowiki>'' \\   You would get the temperature indicated on a web page with this line in its source code: \\ ''<nowiki><p> The temperature of the solar panel is: <span class="temperature">54 º C</span></p></nowiki>''   |
+|''<nowiki>//getVariable;<module_name>;<module_type>;<variable></nowiki>''   |It generates a module with the content \\   of a variable stored in the SIDE with the following ''store'' commands. \\   For example: \\ ''<nowiki>//getVariable;List count;generic_data;listCount</nowiki>''   |
+|''<nowiki>//getScreenshot;<module_name></nowiki>''   |It generates a module with a screenshot of the current browser. \\   For example: \\ ''<nowiki>//getScreenshot;URL home</nowiki>''   |
-| ''<nowiki>//phase_start:<phase_name></nowiki>''  | フェーズの開始を示す。このフェーズは、別の''<nowiki>//phase_start</nowiki>''コマンドが見つかるか、 テストが終了するまで続く。 \\ これは、フェーズのステータスを示すモジュールと、完了までにかかった時間を示す別のモジュールを生成する。 \\ 例えば、こうだ： ''<nowiki>//phase_start:Login</nowiki>''  |
+| ''<nowiki>//phase_start:<phase_name></nowiki>''  | フェーズの開始を示す。このフェーズは、別の''<nowiki>//phase_start</nowiki>''コマンドが見つかるか、 テストが終了するまで続く。 \\ これは、フェーズのステータスを示すモジュールと、完了までにかかった時間を示す別のモジュールを生成する。 \\ 例： ''<nowiki>//phase_start:Login</nowiki>''  |
-| ''<nowiki>//getValue;<module_name>;<module_type>;<regexp></nowiki>''  | ウェブページのソースコードから正規表現で得られるウェブページの内容を含むモ ジュールを生成する。 \\ 例えば、こうだ： \\ ''<nowiki>//getValue;Temperature;generic_data;<span class="temperature">(\d+\.*\,*\d*).*</span></nowiki>'' \\ ソースコードにこの行があるウェブページでは、温度が表示される： \\ ''<nowiki><p> The temperature of the solar panel is: <span class="temperature">54 º C</span></p></nowiki>''  |
+| ''<nowiki>//getValue;<module_name>;<module_type>;<regexp></nowiki>''  | ウェブページのソースコードから正規表現で得られるウェブページの内容を含むモ ジュールを生成する。 \\ 例： \\ ''<nowiki>//getValue;Temperature;generic_data;<span class="temperature">(\d+\.*\,*\d*).*</span></nowiki>'' \\ ソースコードにこの行があるウェブページでは、温度が表示される： \\ ''<nowiki><p> The temperature of the solar panel is: <span class="temperature">54 º C</span></p></nowiki>''  |
-| ''<nowiki>//getVariable;<module_name>;<module_type>;<variable></nowiki>''  | 以下の''store''コマンドで、SIDEに格納された変数の中身をモジュールとして生成する。 \\ 例えば、こうだ： \\ ''<nowiki>//getVariable;List count;generic_data;listCount</nowiki>''  |
+| ''<nowiki>//getVariable;<module_name>;<module_type>;<variable></nowiki>''  | 以下の''store''コマンドで、SIDEに格納された変数の中身をモジュールとして生成する。 \\ 例： \\ ''<nowiki>//getVariable;List count;generic_data;listCount</nowiki>''  |
-| ''<nowiki>//getScreenshot;<module_name></nowiki>''  | 現在のブラウザのスクリーンショットを含むモジュールを生成します。 \\ 例えば、こうだ： \\ ''<nowiki>//getScreenshot;URL home</nowiki>''  |
+| ''<nowiki>//getScreenshot;<module_name></nowiki>''  | 現在のブラウザのスクリーンショットを含むモジュールを生成します。 \\ 例： \\ ''<nowiki>//getScreenshot;URL home</nowiki>''  |
 プラグインで実行可能なSIDEファイルのコマンドは以下の通りです（使用方法についてはSelenium IDEのドキュメントを参照してください）：