Docs » µAPM PG Deployment Guide

µAPM PG Deployment Guide 🔗

Site map for µAPM Previous Generation documentation

µAPM PG Deployment Guide contents 🔗

SignalFx Microservices APM Previous Generation (µPAM PG) 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 µAPM PG 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).

To deploy µAPM PG 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 µAPM PG’s features to monitor and troubleshoot within multiple application environments, see managing multiple Smart Gateway clusters.