Skip to main content

Node.js environment configuration

The Whatap agent writes the necessary settings for each agent in whatap.conf. The agent locates and loads the configuration file through the environment variables. When the Node.js server operates in a container or PaaS environment, the agent settings are configured using environment variables. For user convenience, the WhaTap Monitoring Service also provides the agent configuration function.

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.conf file that is in the monitoring target server. You can also click Download configuration file to download the whatap.conf file.

Note

  • 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 or false 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.

  • 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​

Agent CONFIG.

  1. In Agent List, select the number1 agent to add options to.

  2. In number2 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.

  3. Check the description and default value of the selected option key, and then enter the setting.

    • To cancel the selected option, select Delete icon.
    • To add new options, select Add and then repeat Step 2.

  4. After adding the desired options, select Apply on the upper right of the screen.

Apply the selected options and settings to agents.

Note
  • To initialize the content in modification, select Reset icon 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​

Modifying options

  1. Scroll up or down the screen, or select a desired option to edit or delete from the option list on the left.

  2. Select or edit the desired value for the option to change. To delete an option, select Delete icon.

  3. Select Apply to apply your changes.

Note

  • If you want to move to the top of the screen, select number3 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.

  1. If you check Applying multiple Agent on the upper right of the screen, checkboxes are created for each option.

  2. Select the checkboxes of the options you want to apply simultaneously. You can select multiple items.

  3. On the upper right of the screen, select Apply.

  4. If the Applying Agent window appears, select an agent to apply the changed options to. To select all, select Select all.

  5. 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.conf 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.

Note

  • 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.

  1. In the Agent list, select an agent to export the settings to a json file.

  2. On the upper right of the screen, select Export icon.

  3. Download the json file.

  4. In Agent list, select other agents.

  5. On the upper right of the screen, select Import icon.

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.