PHP agent configuration
In the PHP agent, the required settings can be written and modified in whatap.ini. For user convenience, the agent configuration function is provided in WhaTap Monitoring Service.
Settings are usually reloaded at runtime. However, due to the setting mechanism, the options applied when Apache or PHP-FPM are started may need to be restarted.
Configuring the agent on the service screen
Home > Select Project > Management > Agent CONF.
You can add, modify, or delete agent configuration options in the Whatap Monitoring Service without directly modifying the whatap.ini file that is in the monitoring target server. You can also click Download configuration file to download the whatap.ini file.
-
This function is only available to the members with Edit role. The members without Edit role can only view the settings.
-
You can set the options in the following format.
- Select
true
orfalse
for a boolean value. - For numeric values, you can enter only number.
- When entering or modifying a text (string) value, check the option description in detail.
- Select
-
You cannot select any option that is not editable. (e.g.
license
) -
You may restart each agent depending on the option that has been added, modified, or deleted.
-
The option keys that can be applied may differ depending on the application type and agent version.
Adding options
-
In Agent List, select the agent to add options to.
-
In Write options, select options to add.
- You can find options to add in Search. Enter text to filter matching options.
- If you select Direct Input, you can enter the option keys and values.
-
Check the description and default value of the selected option key, and then enter the setting.
- To cancel the selected option, select .
- To add new options, select Add and then repeat Step 2.
-
After adding the desired options, select Apply on the upper right of the screen.
Apply the selected options and settings to agents.
- To initialize the content in modification, select on the upper right of the screen.
- If you select Apply without entering options, the options are deleted.
- The added options cannot be selected in the option list.
- The option keys that can be applied may differ depending on the application type and agent version.
- The example images may differ depending on the application type and agent version.
Modifying or deleting options
-
Scroll up or down the screen, or select a desired option to edit or delete from the option list on the left.
-
Select or edit the desired value for the option to change. To delete an option, select .
-
Select Apply to apply your changes.
-
If you want to move to the top of the screen, select Go to add options.
-
If you select Apply without entering options, the options are deleted.
Applying to multiple agents simultaneously
Changed options can be applied simultaneously to multiple agents that belong to a project.
-
If you check Applying multiple Agent on the upper right of the screen, checkboxes are created for each option.
-
Select the checkboxes of the options you want to apply simultaneously. You can select multiple items.
-
On the upper right of the screen, select Apply.
-
If the Applying Agent window appears, select an agent to apply the changed options to. To select all, select Select all.
-
Select Apply.
Setting the default values of the agent
To avoid the hassle of repeatedly applying the settings when adding a new agent to a project, you can create and apply default settings for each project and task.
Object kind default: In the whatap.ini file, the options can be commonly applied to the agents classified as
whatap.okind
, and the applied options can be checked.Project default: The options can be commonly applied to all agents belonging to the project, and the applied options can be checked.
-
If you select Object kind default or Project default tab and then apply the options, it is useful to commonly manage agents.
-
The application order of options is as follows: Object kind default, Project default, and Agent CONFIG..
- If the value of option b is 1000 in Project default and it is 2000 in Object kind default, the option value set in Object kind default, 2000 takes precedence.
- If the value of option b is null in Project default and it is 2000 in Object kind default, the option value set in Object kind default takes precedence.
Sharing the agent settings
Agent settings can be saved as a json file, and the file can be loaded and applied to other agents.
-
In the Agent list, select an agent to export the settings to a json file.
-
On the upper right of the screen, select .
-
Download the json file.
-
In Agent list, select other agents.
-
On the upper right of the screen, select .
Check the agent settings fetched from the json file.
Guide to the agent configuration options
The following links provide descriptions of the options that can be set.
Agent name identification
The following explains how to set the agent name in order to identify the monitoring target.
Control of agent functions
The following provides the method how to control the functions of the application server.
Agent communication settings
The following provides the method how to set the communication for the application server.
Agent performance settings
The following provides how to configure the settings for the application server's performance.
Agent log configuration
The location and options of the PHP agent can be set.
Transactions
The following explains how to set an agent to trace and analyze performance data for each transaction within PHP applications. It evaluates the application performance by tracing transaction requests, response time, and resource usage.
DB, SQL
It provides the configuration for PHP agent DB and SQL.
HTTPC, API Call
It provides the settings for HTTPC and API calls of the PHP agent.
User count
The following describes the number of PHP agent users.
Apdex
It describes the PHP agent Apdex.
Statistic
It describes the PHP agent statistics.
Topology map
It describes the PHP agent topology map.
Shared memory
It describes the PHP agent's shared memory.