Ensure that your system meets the requirements before installing an agent on your machine.
Check the following requirements to install our agent properly:
- Windows 2008 R2 and newer.
- Supported versions of Linux include all major Linux distributions (Redhat, CentOS, Ubuntu, Debian and more).
- You need to install the Stackify Agent on each machine that you intend to monitor.
- Port 443 needs to be open, outbound only, for the device(s) you install the monitoring agent on.
- Your environment is either physical or virtual, and we also support Rackspace, Amazon Web Services, Azure, and many other cloud-based infrastructures.
- Proxy servers require additional configuration to allow the agent to send HTTP traffic.
Installing the Agent
The Retrace agent is simply a lightweight service that runs on your Windows or Linux server, virtual machine, or Azure role. Once the agent is installed, it is responsible for all communication between the server and the Retrace hosted services. When the agent is first installed, it discovers processes on your server to detect all running processes, services, Web apps, disks/mount points, Ethernet connections, and more. Each agent creates a secure outbound connection over port 443, which it uses for all communication with the Retrace Portal. (No inbound ports are required to be opened for Retrace to work in your environment.) You can find the instructions and links to download and install by logging into Retrace and clicking the Install Retrace menu link in the Settings tab.
Monitoring Your Server and Apps
Upon installation, the agent discovers your server and the apps hosted on that server is listed on the Apps page. Once you see your apps on this page, you can load the App's Dashboard and configure monitors and alerts so you can be notified of any issues. To get an overview of how App and Server monitors are configured, read Configuring Your First Monitors.
Profiling The Performance Of Your Apps
The Retrace agent comes with a light-weight profiler that integrates to the CLR(Common Language Runtime) process for certain applications. For .NET applications hosted within IIS(Internet Information Services), ensure that profiling is enabled to automatically begin profiling Web transactions in your code. For certain types of apps, you may need to create some additional configuration to let the agent know how to profile it.
Standard IIS Web Apps
Enable the CLR Profiler to start tracking the performance of these apps. You can do this by editing the Stackify.ini file in the Retrace install directory or from the Server Settings within the Retrace Portal.
If your app is not hosted with IIS, let the Retrace agent know how to profile this application. Follow this guide to tell Retrace to track your app. Also, these guides help if you are trying to profile a Self-Hosted Web API or a Self-Hosted WCF application. If your app is a Windows Service, Scheduled Task or Azure Webjob, the profiler will not be able to use the typical request/response cycle of a Web app to automatically profile your code. You need to define transactions manually in order to profile these types of applications.
Here is an overview of tracking non-web transactions.
.NET Core applications require a bit of extra configuration since they use Kestrel to manage the request pipeline in its process. You need to add the StackifyMiddleware to your Startup event and ensure profiling .NET Core application is enabled for your device. Follow this guide to enable .NET Core apps.
Classic Application Pools
If you are using Classic IIS App Pools, you need to ensure your app is using the StackifyHttpModule. Follow this guide to enable classic IIS app pools.