[ECOINT-305] Add live bandwidth metric

[BartoszBlizniak]

This pull request adds support for a new real-time bandwidth metric to the Cloudsmith Datadog integration, allowing users to monitor minute-level bandwidth usage via the Cloudsmith v2 analytics endpoint. The metric is disabled by default and can be enabled through configuration. Documentation, configuration, code, and tests have all been updated to support and verify this new feature.

Realtime Bandwidth Metric Feature:

• Added support for the cloudsmith.bandwidth_bytes_interval metric, which tracks bytes downloaded over the most recent analytics interval using Cloudsmith v2 analytics endpoints. The metric is disabled by default and can be enabled with the enable_realtime_bandwidth: true configuration option. Internal defaults (1-minute interval, 120-minute look-back, 300s refresh, minimum 2 points) are used for metric collection. [1] [2] [3] [4] [5] [6]

Documentation Updates:

• Updated README.md and CHANGELOG.md to document the new metric, its configuration, and usage instructions, including example YAML configuration and installation version bump. [1] [2] [3] [4]

Versioning:

• Bumped package version to 1.2.0 to reflect the new feature addition.

Testing:

• Added tests to verify the correct emission of the real-time bandwidth metric, including edge cases where insufficient data points are present.

API Changes:

• Introduced new API endpoint constant ANALYTICS_METRICS_CLIENT_TIME_SERIES for accessing Cloudsmith v2 analytics time-series data.### What does this PR do?

A brief description of the change being made with this pull request.

Motivation

What inspired you to submit this pull request?

Review checklist

• PR has a meaningful title or PR has the no-changelog label attached
• Feature or bugfix has tests
• Git history is clean
• If PR impacts documentation, docs team has been notified or an issue has been opened on the documentation repo
• If this PR includes a log pipeline, please add a description describing the remappers and processors.

Additional Notes

Anything else we should know when reviewing?

[BartoszBlizniak]

Hey @dd-dominic - apologies, I didn't notice I was working off of my outdated fork and accidentally removed the branch completely (fortunately had backups). This should be all updated now!

[dd-dominic]

Ignore the ci validation - we can merge without it passing for now

[dd-dominic]

Waiting on agent team to take a look

[BartoszBlizniak]

Hey @dd-dominic, just a friendly bump on this one.

We have a customer waiting for this feature to be implemented so they can start monitoring their bandwidth and build a data backlog view in their buckets. 🙏

[cgarcia768]

Hi DD Team, we have an Enterprise customer that is urgently requesting this new capability. Are we able to get this update approved?

[dkirov-dd]

Oh, I just noticed that the validate CI job is failing.
Here's how to fix it:

1. Update the assets/configuration/spec.yaml to contain the new enable_realtime_bandwidth toggle and its description
2. Run ddev validate config cloudsmith -s to sync the conf.yaml.example with the spec

After that we should be good to merge!

[BartoszBlizniak]

Thank you @dkirov-dd - That's been done.