Merge branch 'aa-docs-for-usage-data-add-method' into 'master'

Docs for usage data add method

See merge request gitlab-org/gitlab!54804

doc/development/usage_ping.md

@@ -742,7 +742,7 @@ Arguments:
 - or a `block`: which is evaluated
 - `fallback: -1`: the common value used for any metrics that are failing.
-Example of usage:
+Usage:
 ```ruby
 alt_usage_data { Gitlab::VERSION }
@@ -750,6 +750,17 @@ alt_usage_data { Gitlab::CurrentSettings.uuid }
 alt_usage_data(999)
 ```
+### Adding counters to build new metrics
+
+When adding the results of two counters, use the `add` usage data method that 
+handles fallback values and exceptions. It also generates a valid SQL export.
+
+Example usage:
+
+```ruby
+add(User.active, User.bot)
+```
+
 ### Prometheus Queries
 In those cases where operational metrics should be part of Usage Ping, a database or Redis query is unlikely