Docs » µAPM Deployment Guide

µAPM Deployment Guide 🔗

SignalFx Microservices APM offers a holistic and detailed view of your environments by observing every transaction across your distributed services. To achieve this, you must instrument your applications for tracing and configure them to report trace spans to the local SignalFx Smart Agent. The Smart Agent reports basic system-level summary metrics about each host’s utilization and enables advanced correlation features between traces and infrastructure in SignalFx. It also adds identifying metadata to each trace span as it forwards them to the SignalFx Smart Gateway, where the magic of SignalFx µAPM happens.

The Smart Gateway observes every transaction across your distributed services, generates metrics for each unique span and trace path, and prioritizes interesting outlier traces to forward to SignalFx as part of our NoSample™ Tail-Based Distributed Tracing feature. The Smart Gateway can be deployed as a single instance or as a scalable, coordinated cluster for high-availability and volume applications (using Etcd – embedded, or as a client – for cluster discovery and coordination).

The deploy SignalFx µAPM in your environment:

  1. Instrument your applications based on your language.
  2. Deploy the Smart Agent on all application hosts.
  3. Deploy the Smart Gateway.

Instructions for deploying each of these elements are shown in the following sections.


Each distinct application environment should be paired with a distinct Smart Gateway cluster. For more information on how to properly leverage SignalFx Microservices APM’s features to monitor and troubleshoot within multiple application environments, see managing multiple Smart Gateway clusters.