Send StatsD metrics from an app

Send StatsD lines from an app's containers to the agent on their machine, which publishes them as custom metrics every minute.

Last updated 18 November 2026View as Markdown

The agent on every machine of a deployed app listens on UDP port 8125 for the containers on that machine; nothing outside the machine can reach it. Every minute it publishes what it aggregated as custom metrics under the namespace App/<app name>, with an instance dimension naming the machine. It publishes with the app's own credentials, so you grant nothing for it.

Prerequisites

  • A deployed app (see What is Apps?). Nothing else: no IAM permission of yours is used.
  • Room in the Custom metric series quota (see Quotas).

Send the lines

Not available in Console. StatsD is sent from your application's code.

Line Kind What is published each minute
name:value|c[|@rate] Counter The sum of the increments, divided by the sample rate
name:value|g Gauge The last value; +n and -n adjust it
name:value|ms, |h, |d Timer, histogram, distribution The count, sum, minimum and maximum of the values; count and sum divided by the sample rate
name:value|s Set The number of distinct values

DogStatsD tags (|#key:value,…) become dimensions; a line with more than nine tags is dropped, and a tag named instance is ignored. Read a counter's per-minute total with the sum statistic and a timer's average with avg. A gauge is published every minute for ten minutes after its last update.

Result

The series appear under Monitoring, Custom metrics, in the namespace App/<app name>, within about a minute of the first line. Characters a namespace cannot hold are replaced with -. Lines the agent could not parse or the platform refused are counted in the app's activity, with the first reason.

Did this page help you?