[ECOINT-305] Add live bandwidth metric

cloudsmith/CHANGELOG.md

@@ -25,4 +25,9 @@
 
 ***Added***:
 
-* Initial Release
+## 0.0.3 / 2025-10-29
+
+### Added
+
+* Metric: `cloudsmith.bandwidth_bytes_interval` for real-time bandwidth tracking, through Cloudsmith v2 analytics endpoint (disabled by default; enable with `enable_realtime_bandwidth: true`). Uses fixed internal defaults (1-minute interval, aggregate `BYTES_DOWNLOADED_SUM`, look-back 120m, refresh 300s, min points 2).
+* Dashboard widget for realtime interval bytes.

cloudsmith/README.md

@@ -11,6 +11,8 @@ The integration collects data from Cloudsmith's APIs and maps them to the follow
 - **Events**: Security vulnerability findings, audit log activity, license and vulnerability policy violations, member summaries, and quota usage snapshots.
 - **Service Checks**: Health status of quota consumption and API connectivity.
 
+Optional realtime bandwidth metric (disabled by default) can be enabled to emit `cloudsmith.bandwidth_bytes_interval`, representing bytes downloaded over the most recent analytics interval. Enable it by setting `enable_realtime_bandwidth: true` in `cloudsmith.d/conf.yaml`.
+
 With this integration, customers gain centralized observability over their Cloudsmith package infrastructure, helping enforce compliance, troubleshoot issues faster, and optimize resource planning.
 
 
@@ -25,7 +27,7 @@ For Agent v7.21+ / v6.21+, follow the instructions below to install the Cloudsmi
 1. Run the following command to install the Agent integration:
 
    ```shell
-   datadog-agent integration install -t datadog-cloudsmith==1.1.0
+   datadog-agent integration install -t datadog-cloudsmith==1.2.0
    ```
 
 2. Configure your integration similar to core [integrations][4].
@@ -34,6 +36,16 @@ For Agent v7.21+ / v6.21+, follow the instructions below to install the Cloudsmi
 
 1. Edit the `cloudsmith.d/conf.yaml` file, in the `conf.d/` folder at the root of your Agent's configuration directory to start collecting your Cloudsmith performance data. See the [sample cloudsmith.d/conf.yaml][5] for all available configuration options.
 
+    Example snippet enabling realtime bandwidth:
+
+    ```yaml
+     - url: https://api.cloudsmith.io/v1
+       cloudsmith_api_key: <API-KEY>
+       organization: <ORG-NAME>
+       enable_realtime_bandwidth: true
+       realtime_metric_name: bandwidth.bytes
+    ```
+
 2. [Restart the Agent][6].
 
 ### Validation