Docker Install

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.
Use Image stackify/retrace-arm64 if running on an ARM processor.

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
volumes:
  stackify:
    external:
      name: stackify

Note: Replace YOUR_ACTIVATION_KEY and YOUR_ENVIRONMENT_NAME.

Application Setup

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

• .Net Core
• Java
• PHP
• Node.js
• Ruby
• Python

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