Add environment variable to disable statsd metric collection

README.md

@@ -69,6 +69,8 @@ tags = ['version:1', 'application:web']
 api.Event.create(title=title, text=text, tags=tags)
 ```
 
+In development, you can disable any `statsd` metric collection using `DD_DOGSTATSD_DISABLE=True` (or any not-empty value).
+
 ## DogStatsD
 
 In order to use DogStatsD metrics, the Agent must be [running and available](https://docs.datadoghq.com/developers/dogstatsd/?tab=python).

datadog/dogstatsd/base.py

@@ -100,6 +100,9 @@ def __init__(
         If set, it is appended to the constant (global) tags of the statsd client.
         :type DD_VERSION: string
 
+        :envvar DD_DOGSTATSD_ENABLE: Enable any statsd metric collection (default True)
+        :type DD_DOGSTATSD_ENABLE: boolean
+
         :param host: the host of the DogStatsd server.
         :type host: string
 
@@ -154,6 +157,12 @@ def __init__(
                 log.warning("Port number provided in DD_DOGSTATSD_PORT env var is not an integer: \
                 %s, using %s as port number", dogstatsd_port, port)
 
+        # Check enabled
+        if os.environ.get('DD_DOGSTATSD_ENABLE', 'True') in {'True', 'true', 'yes', '1'}:
+            self._enabled = True
+        else:
+            self._enabled = False
+
         # Connection
         self._max_payload_size = max_buffer_len
         if socket_path is not None:
@@ -412,6 +421,9 @@ def _report(self, metric, metric_type, value, tags, sample_rate):
         """
         if value is None:
             return
+
+        if self._enabled is not True:
+            return
 
         if self._telemetry:
             self.metrics_count += 1