Docker Install
  • Updated on 19 Nov 2019
  • 1 minute to read
  • Contributors
  • Print
  • Share
  • Dark
    Light

Docker Install

  • Print
  • Share
  • Dark
    Light

This document details how to install Retrace in a Docker environment.

Create a Volume

The following volume allows for your application containers and the Stackify Retrace container to communicate.

docker volume create stackify

Run Retrace Container

Run the Stackify Retrace container (ensure that this container is always running via --restart always or your own method).

docker pull stackify/retrace
docker run -d --restart always \
 -e "STACKIFY_KEY=YOUR_ACTIVATION_KEY" \
 -e "STACKIFY_ENV=YOUR_ENVIRONMENT_NAME" \
 -v stackify:/var/stackify \
 -v /:/hostfs:ro \
 --user 0:0 \
 stackify/retrace:latest 

Note: Replace YOUR_ACTIVATION_KEY and YOUR_ENVIRONMENT_NAME.

Run Retrace Container via Compose

version: '3'
services:
  stackify:
    image: stackify/retrace:latest 
      environment:
       - STACKIFY_KEY=YOUR_ACTIVATION_KEY
       - STACKIFY_ENV=YOUR_ENVIRONMENT_NAME
      user: 0:0
      volumes:
       - stackify:/var/stackify
       - /:/hostfs:ro

Note: Replace YOUR_ACTIVATION_KEY and YOUR_ENVIRONMENT_NAME.

Application Setup

The following guides detail how to configure your application containers for APM.

Limitations

The following are known limitations of Retrace when using the Stackify Retrace container.

  • Apache/Nginx/Syslog Log Collectors are disabled
  • Auto Agent update is disabled
  • Agent restarting via Retrace is disabled
  • Server Service listing limited to SystemV (service status will be marked as UNKNOWN)
  • JMX MBeans is disabled
Was this article helpful?