General Reference - Network

This page stands as a quick reference to the basic requirements of and general technical information on Instana.

Host Agent

The Instana Host agent listens on all private IP addresses on port 42699. You cannot change the local port number 42699 of the agent. However, you can add the option http.listen to the configuration file etc/instana/com.instana.agent.main.config.Agent.cfg. The option can be used to control the listen addresses for the local agent.

The following values are allowed:

To listen on all available network interfaces (including public IPs)

http.listen = 0.0.0.0

or

http.listen = *

If you choose not to define the configuration value, the agent by default listens only on the loopback device (127.0.0.1) and the container bridge network gateways available (for example, on a Docker network bridge gateway IP 172.17.0.1).

If you have a single IP that is not the loopback or bridge device, it can be defined by setting the http.listen option to an IP available on the local host. Note that this will add the given IP to the list of local IPs, it will not overwrite it. For example:

http.listen = 192.168.9.23

The fact that the agent is reachable on port 42699 is not sufficient to make sure that all applications can be traced. For language-specific port requirements, see Network requirements.

Language Sensors

For supported languages where Instana offers language-specific sensors, the sensors will, by default, search the localhost and default gateway on port 42699 for a running instance of the Instana Host Agent where applicable.

See also: