Skip to main content

Agent name identification

WhaTap basically uses the data collected from application servers to identify each server while collecting monitoring data. Basic information uses the application server as a unique identifier by a combination of application server's type, IP address, and such. If necessary, use the name set by the user or change the pattern to a unique value. The agent name must be unique.

The reason why the data extracted from the application server is used, is like the following. When a communication loss caused by the stop of the application server, network disconnection, or agent problem between the collection server and the agent, is restored, the continuity of the data from the reconnected agent is maintained.

Agent naming method

The default patterns used to identify the application server are as follows:

Default pattern

To change the default pattern value, modify whatap.conf as follows:


Variable of the agent name

{type}Name of the application server
{ip0}The first byte of the IPv4 address is used. (e.g. 10 in
{ip1}The second byte of the IPv4 address is used. (e.g. 11 in
{ip2}The third byte of the IPv4 address is used. (e.g. 12 in
{ip3}The fourth byte of the IPv4 address is used. (e.g. 13 in
{process}Process name of the application server
{hostname}Host name
{dockerid}ID of the docker container
{ips}It is the full IP (IPv4, IPv6).
{cmd}Process name. It is the value of the executable args[0].
{cmd_full}All command lines are processed using hash value. They correspond to all executable args.

Setting the agent name

  • object_name String

    Default {app_name}-{ip2}-{ip3}-{cmd}-{cmd_full}

    It is an agent naming (ONAME) scheme to identify applications. An OID is created based on the ONAME.

  • app_name String

    It is a component used in the agent naming (ONAME) scheme to identify applications. It corresponds to the {type} among the object_name options.