2.1.1 Changing the JP1/IM - Agent settings with integrated agent host
- Organization of this subsection
(1) Change to IP binding method (optional)
If you want to change to IP binding method, change the following settings:
-
Configuring JP1/IM agent control base
-
Configuring Prometheus server
-
Configuring Alertmanager
-
Configuring Node exporter
-
Configuring Windows exporter
-
Configuring Blackbox exporter
-
Configuring Yet another cloudwatch exporter
For details about how to change the settings, see the physical host settings in Change to IP binding method in 7.3.6 Newly installing JP1/IM - Agent with integrated agent host (for Windows) and 8.3.6 Newly installing JP1/IM - Agent with integrated agent host (for UNIX) of the JP1/Integrated Management 3 - Manager Configuration Guide.
(2) Configuration changes on container systems
If you need to change the settings, it is recommended that you recreate Docker image or Podman image.
If you make configuration changes after you start a container, note the following:
-
Delete function and update function of definition file by the definition file operation facility is not available. Updating or deleting using the definition file operation facility in a container environment will result in a KNBC00019-E error.
-
If you want to edit a file in a container, you must run the following command to connect to the container after you launch the container:
-
For Docker
# docker exec-it container name /bin/bash
-
For Podman
# podman exec-it container name /bin/bash
-
-
The steps for editing unit definition file are to edit the service-management program definition file in the container. For example, for supervisord, edit supervisord definition file (supervisord.conf).
(3) Change the setting of Web scenario-monitoring function
(a) Changing Browser Settings on agent host
When you add or change the language used to display a browser, you must make the appropriate language available to the browser.
Check whether the language to be used has been added in the setting window of the browser to be used. If not, add the language to be used because Codegen run and monitoring by Playwright may not work properly.
(b) Changing authentication Settings
If you change the settings for the client authentication or HTTP authentication (Basic authentication) when Playwright accesses the monitored Web application, you need to review the settings for certificates, passwords, etc.
For the required settings, see Authentication settings in 1.21.2(13)(b) JP1/IM - Agent Setup in the JP1/Integrated Management 3 - Manager Configuration Guide.
(c) Modify Web scenario file
The behavior when modifying Web scenarios generated using Codegen is not supported.
For the codes recorded by Codegen operation, see Browser operations and operations that can be recorded and measured as Web scenarios described in Web scenario creation function (playwright codegen) in 3.15.1(1)(m) Web scenario monitoring function in the JP1/Integrated Management 3 - Manager Overview and System Design Guide.
If you want to change Web scenario file, perform the following steps:
-
Remove Web scenario file.
-
Create a new Web scenario file.
See Creating a New Web Scenario File in 1.21.2(13)(b) Setting up JP1/IM - Agent in the JP1/Integrated Management 3 - Manager Configuration Guide.
(d) Removing a Web scenario file
Here are the steps to remove a Web scenario file:
-
Shut down Web exporter.
Stops Web exporter running Web scenario file to be deleted.
-
Remove Web scenario file.
You remove Web scenario file that you have created.
For details about Web scenario file, see Web scenario file (any name.spec.ts) in Chapter 2. Definition Files in the JP1/Integrated Management 3 - Manager Command, Definition File and API Reference.
For details on how to remove configuration file, see 1.21.2(1)(a) Edit the configuration files (for Windows) in the JP1/Integrated Management 3 - Manager Configuration Guide.
-
Change Playwright configuration file.
From Playwright configuration file, remove the definition that runs Web scenario file that you want to remove.
For details about Playwright configuration file, see Playwright configuration file (jpc_playwright.config.ts) in Chapter 2. Definition Files in the JP1/Integrated Management 3 - Manager Command, Definition File and API Reference.
For details on configuration file editing procedure, see To edit the configuration files (for Windows) in 1.19.3(1)(a) Common way to setup in the JP1/Integrated Management 3 - Manager Configuration Guide.
-
Change Web exporter discovery configuration file.
From Web exporter discovery configuration file, remove the definition that runs Web scenario file that you want to remove.
For details about Web exporter discovery configuration file, see Web exporter discovery configuration file (jpc_file_sd_config_web.yml) in Chapter 2. Definition Files in the JP1/Integrated Management 3 - Manager Command, Definition File and API Reference.
For details on configuration file editing procedure, see To edit the configuration files (for Windows) in 1.19.3(1)(a) Common way to setup in the JP1/Integrated Management 3 - Manager Configuration Guide.
-
Start Web exporter.
(e) Changing Web exporter operation settings
Editing Playwright configuration file (jpc_playwright.config.ts) is performed in the following cases:
-
When you create a new Web scenario file
See Setting up Playwright configuration file in 1.21.2(13)(b) Setting up JP1/IM - Agent in the JP1/Integrated Management 3 - Manager Configuration Guide.
-
When Web scenario file is removed
See the procedure Change Playwright configuration file. in 2.1.1(3)(d) Removing a Web scenario file.
-
Changing the runtime configuration of Web scenario file
For details about Playwright configuration file, see Playwright configuration file (jpc_playwright.config.ts) in Chapter 2. Definition Files in the JP1/Integrated Management 3 - Manager Command, Definition File and API Reference.
For details on configuration file editing procedure, see To edit the configuration files (for Windows) in 1.19.3(1)(a) Common way to setup in the JP1/Integrated Management 3 - Manager Configuration Guide.
(f) Change Web exporter settings that Prometheus server will scrape
Editing Web exporter discovery configuration file (jpc_file_sd_config_web.yml) is performed in the following cases:
-
When you create a new Web scenario file
See Setting up Web exporter discovery configuration file in 1.21.2(13)(b) Setting up JP1/IM - Agent in the JP1/Integrated Management 3 - Manager Configuration Guide.
-
When Web scenario file is removed
See the procedure Change Web exporter discovery configuration file. in 2.1.1(3)(d) Removing a Web scenario file.
-
To change the settings of other Web scenario-monitoring functions
For details about Web exporter discovery configuration file, see Web exporter discovery configuration file (jpc_file_sd_config_web.yml) in Chapter 2. Definition Files in the JP1/Integrated Management 3 - Manager Command, Definition File and API Reference.
For details on configuration file editing procedure, see To edit the configuration files (for Windows) in 1.19.3(1)(a) Common way to setup in the JP1/Integrated Management 3 - Manager Configuration Guide.