Skip to main content

Agent name identification

In the WhaTap monitoring service, the term, "object" is used for comprehensive meaning of a monitoring target, and it is sometimes used interchangeably with the agent. To distinguish the objects to be monitored, the different names must be used. WhaTap identifies the target through the object name and object ID.

  • The object (agent) names must be unique on a project basis.
  • Object ID = CRC32 (object name). If the object ID or name has been changed, the previous data is not connected.

WhaTap basically uses the data collected from database servers to identify each server while collecting monitoring data. Basic information uses the database server as a unique identifier by a combination of database server type, IP address, service port, 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 of the collection server and agent caused by the stop of the database server, network disconnection, or agent problem is restored, the continuity of the data from the reconnected agent is maintained.

The default pattern used to identify the database server is as follows:

  • object_name String

    Default {type}-{ip2}-{ip3}-{port}

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

    {type}Use the value set in whatap.app_name.
    {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
    {port}Database server port
    {hostname}Host name
  • auto_oname_enabled Boolean

    Default false

    The function to automatically obtain the agent name (oname) from the server is activated. Upon application, the options for and -Dwhatap.oname are ignored. It obtains oname through communication with the collection server and then starts the agent's normal operation.

  • auto_oname_prefix String

    Default agent

    When an agent name is automatically granted from the server, the prefix of the agent name (business name as usual) is used. The prefix + serial number (from 1) is assigned.

  • auto_oname_reset Int

    Default 0

    Modify it to obtain a new agent name from the server. If the agent name is automatically granted, the system environment variable, whatap.oname is set. Once set, the system environment variables are not changed until the Java instance is restarted. For a reset, modify the value of auto_oname_reset. If you change it to a value different from the current setting, it is to be applied.