docs: add observableGauge to the prometheus experimental example (#4267)

* docs: add observableGauge to the prometheus experimental example

Signed-off-by: Francois LP <[email protected]>

* docs: add gauge image to README

Signed-off-by: Francois LP <[email protected]>

* refactor: change comment wording

from @pichlermarc

Co-authored-by: Marc Pichler <[email protected]>

---------

Signed-off-by: Francois LP <[email protected]>
Co-authored-by: Marc Pichler <[email protected]>
Co-authored-by: Daniel Dyla <[email protected]>

Author: 3 people

experimental/examples/prometheus/README.md

@@ -60,6 +60,7 @@ If you are using the default configurations, the prometheus client will be avail
 
 <p align="center"><img src="images/prom-counter.png?raw=true"/></p>
 <p align="center"><img src="images/prom-updowncounter.png?raw=true"/></p>
+<p align="center"><img src="images/prom-gauge.png?raw=true"/></p>
 
 ## Useful links
 

experimental/examples/prometheus/images/prom-gauge.png

@@ -39,6 +39,23 @@ observableCounter.addCallback(observableResult => {
   observableResult.observe(counter, attributes);
 });
 
+const randomMetricPromise = async () =>
+  new Promise(resolve =>
+    setTimeout(resolve(Math.floor(Math.random() * 100)), 50)
+  );
+
+const observableGauge = meter.createObservableGauge(
+  'observable_gauge_requests',
+  {
+    description: 'Example of an ObservableGauge',
+  }
+);
+// Callbacks are run when metrics are scraped
+observableGauge.addCallback(async observableResult => {
+  const value = await randomMetricPromise();
+  observableResult.observe(value, attributes);
+});
+
 // Record metrics
 setInterval(() => {
   counter++;