From d7ebb2f99ccf26101faee86d0d87ebae58000d11 Mon Sep 17 00:00:00 2001 From: Cecylia Bocovich Date: Tue, 8 Jul 2025 14:17:37 -0400 Subject: [PATCH] Add clarification to broker-spec on client-*-ips --- doc/broker-spec.txt | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/doc/broker-spec.txt b/doc/broker-spec.txt index 6d0ca40..b502cb4 100644 --- a/doc/broker-spec.txt +++ b/doc/broker-spec.txt @@ -104,6 +104,9 @@ Metrics data from the Snowflake broker can be retrieved by sending an HTTP GET r rounded up to the nearest multiple of 8. Each country code only appears once. + Note that this descriptor field name is misleading. We use IP addresses + to partition by country, but this metric counts polls, not unique IPs. + "client-ampcache-count" NUM NL [At most once.] @@ -119,6 +122,9 @@ Metrics data from the Snowflake broker can be retrieved by sending an HTTP GET r method, rounded up to the nearest multiple of 8. Each country code only appears once. + Note that this descriptor field name is misleading. We use IP addresses + to partition by country, but this metric counts polls, not unique IPs. + "client-sqs-count" NUM NL [At most once.] @@ -134,6 +140,9 @@ Metrics data from the Snowflake broker can be retrieved by sending an HTTP GET r rounded up to the nearest multiple of 8. Each country code only appears once. + Note that this descriptor field name is misleading. We use IP addresses + to partition by country, but this metric counts polls, not unique IPs. + "snowflake-ips-nat-restricted" NUM NL [At most once.]