Docs » µAPM Deployment Guide » Monitoring the SignalFx Smart Gateway

Monitoring the SignalFx Smart Gateway

Monitoring your Smart Gateway is paramount to ensure its correct operation and that you have deployed the appropriate Smart Gateway capacity to handle your workload. To this effect, SignalFx provides built-in, curated dashboards for the Smart Gateway. They will appear in your organization soon after you deploy the Smart Gateway.

Configuring the SignalFx Smart Agent to monitor the Smart Gateway

For these dashboards to fully populate with all the data you need to monitor the health and resource utilization of your Smart Gateway, you need to deploy the SignalFx Smart Agent on your Smart Gateway instances. This makes sure that the relevant metrics are being reported to SignalFx.

When configuring the Smart Agent on your gateway instances, pay attention to the following settings:

  • Make sure the hostname used by the agent matches the ServerName used by the Smart Gateway.
  • Enable the collectd/signalfx-metadata monitor, and configure it to report its metrics with two additional dimensions: a source: gateway dimension, and a cluster dimension whose value matches the ClusterName used by the Smart Gateway.

Finally, configure the following monitors to provide the appropriate metrics for the Smart Gateway monitoring dashboards:

hostname: REPLACE-WITH-SERVER-NAME
signalFxAccessToken: YOUR_SIGNALFX_API_TOKEN
ingestUrl: https://ingest.YOUR_SIGNALFX_REALM.signalfx.com

monitors:
  - type: host-metadata
  - type: collectd/cpu
  - type: collectd/df
  - type: collectd/disk
  - type: collectd/interface
  - type: collectd/load
  - type: collectd/memory
  - type: collectd/vmem
  - type: collectd/signalfx-metadata
    extraDimensions:
      source: gateway
      cluster: REPLACE-WITH-CLUSTER-NAME

Metrics emitted by the SignalFx Smart Gateway

In addition to the metrics listed in APM identities and SignalFx metrics, we also emit the metrics listed below. All metrics sent by the Smart Gateway have a host dimension matching the configured ServerName, as well as the source:gateway dimension.

Metric Name Additional Dimensions Description
gateway.commit samplerCommit: the sampler’s commit SHA, gatewayCommit: the gateway’s commit SHA Gauge with a constant value of 1 for the SHAs of the components that make up the Smart Gateway.
gateway.processedTraces none Cumulative counter of all traces processed by this gateway or cluster
gateway.processedSpans none Cumulative counter of all spans processed by this gateway or cluster
gateway.sentTraces none Cumulative counter of all traces that were selected by the Smart Gateway and sent to SignalFx
gateway.sentSpans none Cumulative counter of all spans that were selected by the Smart Gateway and sent to SignalFx
dropped_spans reason: the reason the span was dropped Cumulative counter of all spans dropped by the Smart Gateway
dropped_traces reason: the reason the trace was dropped Cumulative counter of all traces dropped by the Smart Gateway