feat: provide monitoring-related configurations (#3611)

In accordance with getsentry/sentry-docs#12660

Author: aldy505

docker-compose.yml

@@ -84,6 +84,10 @@ x-snuba-defaults: &snuba_defaults
     # Leaving the value empty to just pass whatever is set
     # on the host system (or in the .env file)
     SENTRY_EVENT_RETENTION_DAYS:
+    # If you have statsd server, you can utilize that to monitor self-hosted Snuba containers.
+    # To start, state these environment variables below on your `.env.` file and adjust the options as needed.
+    SNUBA_STATSD_HOST: # Example value: "100.100.123.123". Must be an IP address, not domain name
+    SNUBA_STATSD_PORT: # Example value: 8125
 services:
   smtp:
     <<: *restart_policy

relay/config.example.yml

@@ -18,3 +18,14 @@ processing:
 #
 # health:
 #  max_memory_percent: 1.0
+
+# If you have statsd server, you can utilize that to monitor self-hosted Relay.
+# To start, uncomment the following line and adjust the options as needed.
+#
+# metrics:
+#  statsd: "100.100.123.123:8125" # It is recommended to use IP address instead of domain name
+#  prefix: "sentry.relay" # Adjust this to your needs, default is "sentry.relay"
+#  sample_rate: 1.0 # Adjust this to your needs, default is 1.0
+#  # `periodic_secs` is the interval for periodic metrics emitted from Relay.
+#  #  Setting it to `0` seconds disables the periodic metrics.
+#  periodic_secs: 5

sentry/sentry.conf.example.py

@@ -396,3 +396,21 @@ def get_internal_network():
 # to allow specific hosts. It might be IP addresses or domain names (without `http://` or `https://`).
 
 # SENTRY_OPTIONS["relay.span-normalization.allowed_hosts"] = ["example.com", "192.168.10.1"]
+
+##############
+# Monitoring #
+##############
+
+# By default, Sentry uses dummy statsd monitoring backend that is a no-op.
+# If you have a statsd server, you can utilize that to monitor self-hosted
+# Sentry for "sentry"-related containers.
+#
+# To start, uncomment the following line and adjust the options as needed.
+
+# SENTRY_METRICS_BACKEND = 'sentry.metrics.statsd.StatsdMetricsBackend'
+# SENTRY_METRICS_OPTIONS: dict[str, Any] = {
+#     'host': '100.100.123.123', # It is recommended to use IP address instead of domain name
+#     'port': 8125,
+# }
+# SENTRY_METRICS_SAMPLE_RATE = 1.0   # Adjust this to your needs, default is 1.0
+# SENTRY_METRICS_PREFIX = "sentry."  # Adjust this to your needs, default is "sentry."

symbolicator/config.example.yml

@@ -6,3 +6,10 @@ logging:
 metrics:
   statsd: null
 sentry_dsn: null # TODO: Automatically fill this with the internal project DSN
+
+# If you have statsd server, you can utilize that to monitor self-hosted Symbolicator.
+# To start, uncomment the following line and adjust the options as needed.
+#
+# metrics:
+#   statsd: "100.100.123.123:8125" # It is recommended to use IP address instead of domain name
+#   prefix: "sentry.symbolicator" # Adjust this to your needs, default is "symbolicator"