Skip to content

Downloads

FusionReactor Agent

The FusionReactor Agent monitors Java and ColdFusion. It provides real-time and historical data on web transactions, memory and CPU usage, database query performance, code details like memory and thread profiling, garbage collection data, automated error detection, and more.

Current version: 12.0.1 - 12 March 2024

Learn more

Release notes
MD5

Manually installing FusionReactor requires you to directly place the FusionReactor installation files and configure the JVM arguments on your application servers.

Step 1: Create a directory structure for FusionReactor

Step 2: Download files into the directory structure

FusionReactor JAR
Debugger Native Library

Step 3: Stop your application server

Step 4: Add additional JVM arguments to your application server configuration

  • Add a Java agent path (-javaagent argument) pointing to the fusionreactor.jar file.

  • The Debug native library path (-agentpath argument) needs to be pointing to the debug library.

Step 5: Restart your application server

Learn more

Manual installation

The full installer or preconfigured installation of FusionReactor both include the FRAM (FusionReactor Administration Manager) and should only take a few minutes to set up.

Step 1: Download the required full installer

Full installer
Windows
Linux
MacOS

Step 2: Run the installer and follow the instructions on the welcome screen

Step 3: Open the instance manager and install an instance

Learn more

Automatic installer

Step 1: Start with your base image

FROM {your image}
Step 2: Create a FusionReactor directory in the /opt directory

RUN mkdir -p /opt/fusionreactor/instance/{your instance name}
Step 3: Add the fusionreactor.jar file to the FusionReactor instance directory

ADD https://download.fusionreactor.io/FR/Latest/fusionreactor.jar /opt/fusionreactor/instance/{your instance name}

Step 4: Add the debug library file (libfrjvmti_x64.so) to the FusionReactor instance directory

ADD https://download.fusionreactor.io/FR/Latest/libfrjvmti_x64.so /opt/fusionreactor/instance/{your instance name}

Step 5: Set the JAVA_OPTS environment variable to include FusionReactor in the JVM arguments

ENV JAVA_OPTS="-javaagent:/opt/fusionreactor/instance/{your instance name}/fusionreactor.jar=name=tomcat,address=8088 -agentpath:/opt/fusionreactor/instance/{your instance name}/libfrjvmti_x64.so"
Step 6: Build your Docker image

Your Dockerfile should now be set up to create a Docker image with FusionReactor integrated into your chosen instance. Make sure to replace {your image} with the actual base image you intend to use and {your instance name} with your instance (eg. Tomcat) and look at our fusionreactor-docker GitHub repository for other example Dockerfiles.


Learn more

Install in Docker

To install FusionReactor in your CommandBox, we recommend using the commandbox-fusionreactor module.

Step 1: Install the commandbox-fusionreactor module

CommandBox> install commandbox-fusionreactor

Step 2: Register your FusionReactor license

 CommandBox> fusionreactor register XXXXX-XXXXX-XXXXX-XXXXX-XXXXX

Step 3 (optional): Use the following command to access the FusionReactor web admin

CommandBox> fusionreactor open


Legacy versions

It is possible to download previous versions of the FusionReactor Agent.

Observability Agent

The Observability Agent, an open source autoconfiguration and installation tool, is a wrapper for the Grafana Agent that can install the agent, detect which services are running on your machine, and automatically create a configuration file with integrations for detected services.

Local install using code snippets

Step 1: In a terminal, download and run the installer

curl -O -L "https://github.com/intergral/observability-agent/releases/latest/download/observability-agent-autoconf.sh"
chmod a+x "observability-agent-autoconf.sh"
sudo /bin/bash observability-agent-autoconf.sh

Step 1 In a terminal, download and run the installer

Invoke-WebRequest -Uri "https://github.com/intergral/observability-agent/releases/latest/download/observability-agent-autoconf.ps1" -OutFile "observability-agent-autoconf.ps1".\observability-agent-autoconf.ps1

Docker

Step 1: Prepare the API key

Before running your application in Docker, obtain an API key from the service or application you are working with. This API key is essential for authentication and configuration.

Step 2: Determine the environment variables

Determine which environment variables are required for your specific service or application. These environment variables are used to configure and customize the behavior of the service when running in Docker.

Step 3: Run the Docker container

docker run --env api_key=<your_api_key> --env mysql_connection_string=root:my-secret-pw@(mysql:3306)/ intergral/observability-agent:latest

Kubernetes

Step 1: Download files from our GitHub repo

  • fr-cloud-kps-values.yaml

  • fr-cloud-kps-authentication-secret.yaml

Step 2: Customize the two files for installation

  • fr-cloud-kps-values.yaml

Change CLUSTER_NAME to your Kubernetes cluster name.

  • fr-cloud-authentication-secret.yaml

Change PASSWORD to your FR Cloud API key.

Step 3: Run the following commands to create a new namespace to hold & deploy stack

kubectl create namespace kube-prometheus-stack
helm repo add prometheus-community https://prometheus-community.github.io/helm-charts
helm repo update
kubectl apply -n kube-prometheus-stack -f fr-cloud-kps-authentication-secret.yaml
helm upgrade --install -n kube-prometheus-stack -f fr-cloud-kps-values.yaml kube-prometheus-stack prometheus-community/kube-prometheus-stack --version 52.0.1

Learn more

Shipping K8s to FR