The home of Dockerized components of the Dynatrace Application Monitoring enterprise solution. All components are available on the Docker Hub.
Dynatrace Application Monitoring, with its PurePath technology, is the world's leading application monitoring solution - trusted by more than 7500 customers around the globe. It supports all your major technology stacks and integrates into your Continuous Delivery pipelines to allow you to build world-class, high-quality software.
If you are looking for monitoring containerized applications in dynamic Docker environments, please visit Dynatrace SaaS Docker monitoring.
You can quickly bring up an entire Dockerized Dynatrace AppMon environment by using Docker Compose with any of the provided docker-compose.yml files like so:
git clone https://github.com/Dynatrace/Dynatrace-Docker.git
cd Dynatrace-Docker
docker-compose up
in case of using branch:
git clone https://github.com/Dynatrace/Dynatrace-Docker.git -b <BRANCH_NAME>
cd Dynatrace-Docker
docker-compose up
In order to be able to work further on the same instance with Appmon running in the background use deamon option:
docker-compose up -d
Logs can be displayed by:
docker-compose logs -f
docker-compose up will install Dynatrace Server, Dynatrace Collector and Dynatrace Master Agent. Then, you can install your Agents.
In order to build slim version:
docker-compose build
In order to build full version:
docker-compose -f docker-compose-debian.yml build
Docker Compose is a tool for defining and running multi-container applications, where an application's services are configured in docker-compose.yml files. Typically, you want to use:
docker-compose up -d
or
docker-compose up -d --build
NOTE:
[] - is optional
-f - uses alternative docker-compose.yml file
-d - run as deamon
If you want to run slim version(s) you can skip -f option.
In order to create container(s)
docker-compose create
docker-compose -f docker-compose-debian.yml create
In order to run already created container(s)
docker-compose start
docker-compose -f docker-compose-debian.yml start
In order to build unbuilt image(s), (re)create container(s) and run them in deamon mode
docker-compose up -d
docker-compose -f docker-compose-debian.yml up -d
In order to rebuild image(s), (re)create container(s) and run them in deamon mode
docker-compose up -d --build
docker-compose -f docker-compose-debian.yml up -d --build
If you run as deamon and you want to see logs, you can follow each service logs using
docker-compose logs -f
Configuration relies on supplying docker-compose with environment variables defined in .env file. Some variables need to be passed to Dockerfile via ARG for correct building an Server image, that's way it is recommended to change variables only from .env file.
Ports can be also configured in .env file. By default it uses values from Communication Connections Documentation.
Please see each component's README file for more specific details about configuration.
The example above leaves your Dynatrace AppMon environment without a proper license. However, you can add your license by editing .env file and put it as value for DT_SERVER_LICENSE_KEY_FILE_URL variable.
Also, you can conveniently have a license provisioned at container runtime by specifying a URL to a Dynatrace License Key File in the DT_SERVER_LICENSE_KEY_FILE_URL environment variable. If you don't happen to have a web server available to serve the license file to you, Netcat can conveniently serve it from your command line, exactly once, via nc -l 1337 < dtlicense.key, where 1337 is an available port on your local machine. A sudo may be required depending on which port you eventually decide to choose.
git clone https://github.com/Dynatrace/Dynatrace-Docker.git
cd Dynatrace-Docker
DT_SERVER_LICENSE_KEY_FILE_URL=http://$YOUR_IP:1337 docker-compose up
In the example above, you have to let DT_SERVER_LICENSE_KEY_FILE_URL point to a valid Dynatrace AppMon License Key file. If you don't have a license yet, you can obtain a Dynatrace AppMon Free Trial License here. However, you don't need to have your license file hosted by a server: if you can run a console, Netcat can conveniently serve it for you on port 80 via sudo nc -l 80 < dtlicense.key.
See the following integrations for more information:
Want to see all your Docker Metrics in one place? See the Dynatrace Docker Monitor Plugin for more information.
When running Docker on Windows or a Mac via the Docker Toolbox, make sure your Docker Machine has sufficient resources available to run Dynatrace AppMon together with your Dockerized application:
- Stop the Docker Machine in VirtualBox
- Give your Docker Machine at least 2 CPUs
- Give your Docker Machine at least 4 GB of RAM
- Finally, start your Docker Quickstart Terminal for the changes to take effect.
This offering is Dynatrace Community Supported. Feel free to share any problems, questions and suggestions with your peers on the Dynatrace Community's Application Monitoring & UEM Forum.
Licensed under the MIT License. See the LICENSE file for details.