This page details installing Collector instances and covers critical information needed before installation. It also covers embedded Collector restrictions.
For troubleshooting tips, click here.
What to know before Collector installation
A Collector should always be placed close (in terms of latency) to the connected Agents. There are thousands of start-up round-trips between them to instrument application classes. A Collector should be placed in the same sub-net, or at least in the same data center as the Agents and instrumented applications. This allows connecting to the AppMon Server over the WAN if needed.
The number of Collectors is not the exclusive sizing factor, but also JVM heap memory and the number of cores (and naturally disk space) available to a Collector process determines the number of Agents it can take. Also, Collectors need a lot more heap and disk space (for class cache and inheritance map) if the instrumented applications are different, so applications should be hooked to Collector groups according to their similarity. Sensible grouping of apps and equally sized Collectors in a group are also prerequisite for Collector - Agent load balancing. See Collector Best Practices to adapt settings when your requirements change or ask sales or support.
init.dshell scripts allow Collectors (and the Server) to start as non-root or under the desired user account.
If your Linux uses
systemdfor startup, see the attached
systemdscript samples (wrappers for
The installation requires Java Runtime Environment (JRE) 1.8 or later. Because the Unix installer does not include the private JRE for Collector run time (Windows and Linux do), you should update your system's public JRE to 1.8 first, as that is required for the Collector run time.
Some Linux flavors come with low limits for the maximum number of files, sockets, and processes or threads per user (1024). This normally poses no problem for the AppMon Collector. However, if running several of them within one user account and a couple of dozen Agents are connected to each Collector, raise both settings. Some Linux Operating Systems have limits of 64k, so stay on the safe side for situation such as a high number of Agent Groups. Increase low limits generously with this formula:
(500) + (3 * number of Agents connected) * (number of Collectors running on account)
Check limits before setting them too low or lower than they were, which could harm your system.
Check hard limits (and set them) to account for desired soft limits, as soft limits cannot exceed hard limits. Permissions are required.
Set limits permanently for daemons in
/etc/security/limits.conf. See an explanation in that file for more information.
Per User Check hard limit Check soft limit Set soft limit on the fly files/sockets
ulimit -n <numberToSet>
ulimit -u <numberToSet>
You can force a check for 2048 at Collector-startup with the
-openfilesparameter, but be aware that several run under the same user.
Collector installation directory
This table lists directories of special interest created when installing a Collector.
||The executables and the main configuration file
||Class cache directory.|
||Main configuration directory.|
Download the full Windows installation package for your architecture. Do a custom installation if you only need the Collector.
The setup defaults to an installation path (
C:\Program Files\Dynatrace\Dynatrace 7.0.
Installation creates Start menu entries and registers an auto-starting Windows service, configured to connect to an AppMon Server on the same machine (localhost) on the default port (6698 or 6699 (SSL)) and name (AppMon Collector 7.0).
Run the installation using a designated account. You can define
DT_RUNASUSER in the script.
Download the AppMon Collector installation JAR file. The Linux Collector installation file is named
dynatrace-collector-<version>-linux-x86.jar, implying 32-bit on the x86 platform if you look at the other namings, but contains both bitnesses.
On Linux, the installer prompts for bitness (32-bit or 64-bit) and for the installation directory, which defaults to
<currentDirectory>/dynatrace-collector-7.0. This path is referred to as
If installing on Solaris, HP-UX, AIX, z/Linux, or z/OS, the installer prompts you for
JAVA_HOME, which specifies the Java installation used to run the AppMon Collector. The Linux version comes with a private JVM.
The recommended installation is in
/opt. Start the installation by issuing:
cd /opt sudo java -jar <path>/dynatrace-collector-<version>-<platform>.jar sudo chown -R <DT_RUNASUSER>:<DT_USER'SGROUP> /opt/dynatrace-<version>
dynaTraceCollector shell script to
Define DT_RUNASUSER in the script. You can also define other variables like DT_OPTARGS and DT_INSTANCE if necessary.
Add this script to the system boot by using
chkconfig --add dynaTraceCollector or, depending on your distribution, such as on Debian or Ubuntu, use
sudo update-rc.d dynaTraceCollectorNonRoot defaults.
If you do not specify a
DT_RUNASUSER, then register the script and restart, the Collector starts in the root. This means
temp belong to the root. To correct this, rerun the
dtcollector not work on your Linux flavor, try
ps aux|grep dtcollector. The first, short output is for the launcher and the second, long one is for the Collector. The third one is for
The user the Collector runs under is at the very beginning, before the PID.
Install extra collector instances
The Collector names (Windows: service names) and the ports each Collector listens for Agents must be unique.
If you want your Collector instance to connect to a specific Server other than
-server <dynaTraceServerName> to the registration (Windows) or shell script (Linux/Unix).
The first start of the new Collector instance creates the directory structure
<DT_HOME>\collector\instances\<CollectorInstanceName> that replicates the structure of the default instance and copies the files from there.
This sample code shows how to register and start a new service called
Dynatrace Collector 7.0 (MyCollector) that listens for classic Agent connections on port 9997 and AppMon Agents on port 8044:
CD %DT_HOME% dtcollector -service install -instance MyCollector -listen :9997 -listenHttp :8044 sc start "Dynatrace Collector (MyCollector)"
To register an extra Collector service instance that listens for classic Agents on port 9997, AppMon Agents on port 8044 and connects to
myAppMonServer (on a different machine):
dtcollector -service install -instance MyCollector -listen :9997 -listenHttp :8044 -server myAppMonServer
To un-register a Collector instance, for example to possibly re-register it with new arguments:
sc stop "Dynatrace Collector 7.0 (MyCollector)" sc delete "Dynatrace Collector 7.0 (MyCollector)"
%DT_HOME%/dtcollector -service uninstall -instance MyCollector
Linux and Unix
The following sample code prepares and starts a Collector instance
collector02 that listens classic Agents on port 9997, AppMon Agents on port 8044 and connects to a Server on the same machine on the default port (6698).
cd $DT_HOME ./dtcollector -instance collector02 -listen :9997 -listenHttp :8044
To start the
collector02 instance at system startup, copy the
$DT_HOME/init.d/dynaTraceCollector shell script, for example using Save As to create the flle
/etc/init.d/dynaTraceCollector02. Make the following minimum changes:
DT_OPTARGS="-instance collector02" DT_INSTANCE=collector02
Be sure the
DT_OPTARGS="-instance <instanceName>" are the same.
Add the script to the startup items by using
/sbin/chkconfig ‐-add dynaTraceCollector02 (or the chkconfig equivalent on your distribution).
Check for running Collectors by using
ps ax | grep dtcollector.
Agent connection balancing
See the Collector Groups section to learn how to balance the load between several Collectors.
Embedded collector usage restrictions
The AppMon Server includes an embedded (as opposed to stand-alone) Collector that should only be used for testing purposes. The embedded Collector is started in-process with the Server, a stand-alone Collector service / daemon must be explicitly started. Enable the embedded Collector in the Client by selecting Settings > Dynatrace Server > Services and selecting the Allow Agent Connections to Dynatrace Server check box under Embedded Collector Settings. You must restart the AppMon Server after changing this setting.
The table indicates whether the embedded Collector can () or cannot () be used by different AppMon editions in different (license) scenarios.
|Production||Pre-production (aka Test Center)||Dev team