Kubernetes Install
  • Updated on 21 May 2019
  • 1 minute to read
  • Contributors
  • Print
  • Share
  • Dark
    Light

Kubernetes Install

  • Print
  • Share
  • Dark
    Light

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

Create a DaemonSet

The Stackify Retrace container will run as a DaemonSet to ensure that a single instance is running on each server.

Adjust the following configuration and deploy to your Kubernetes cluster.

stackify-retrace.yaml:

apiVersion: extensions/v1beta1
kind: DaemonSet
metadata:
  name: stackify-retrace
spec:
  template:
    metadata:
      labels:
        app: stackify-retrace
    spec:
      containers:
        - name: stackify-retrace
          image: stackify/retrace
          env:
            - name: STACKIFY_KEY
              value: "YOUR ACTIVATION KEY"
            - name: STACKIFY_ENV
              value: "YOUR ENVIRONMENT NAME"
          volumeMounts:
            - name: hostfs 
              mountPath: /hostfs
              readOnly: true
            - name: stackify
              mountPath: /var/stackify
              readOnly: false
      volumes:
        - name: hostfs
          hostPath:
            path: /
        - name: stackify
          hostPath:
            path: /var/stackify
            type: DirectoryOrCreate

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/PHP/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

Stackify offers an advanced installation path to avoid some of these limitations by installing on the host system. See Kubernetes Install on Host.

Was this article helpful?