slashmo / swift-statsd-client

metrics backend for swift-metrics that uses the statsd protocol

SwiftStatsDClient

a metrics backend for swift-metrics that uses the statsd protocol, and can be used to integrate applications with observability solutions that support statsd including:

• AWS
• Azure
• Google Cloud
• IBM Cloud
• Grafana
• Graphite
• Many others

Getting started

Create an instance of the StatsdClient and boostrap the MetricsSystem in your application's main:

let statsdClient = try StatsdClient(host: host, port: port)
MetricsSystem.bootstrap(statsdClient)

See selecting a metrics backend implementation for more information.

Remember to also shutdown the client before you application terminates:

statsdClient.shutdown()

Architecture

StatsdClient uses SwiftNIO to establish a UDP connection to the statsd server.

Metrics types are mapped as following:

• Counter -> Counter
• Gauge -> Gauge
• Recorder -> Histogram
• Timer -> Timer

Security

Please see SECURITY.md for details on the security process.

Getting involved

Do not hesitate to get in touch as well, over on https://forums.swift.org/c/server