From 3e8af747b329f6656a410160e8da14fd8227c8fc Mon Sep 17 00:00:00 2001
From: Mattie Fu <mattiefu@google.com>
Date: Fri, 5 Feb 2021 11:33:31 -0500
Subject: [PATCH] docs: Update stackdriver examples for tracing and stats
 (#613)

* docs: Update stackdriver examples for tracing and stats

* update based on review
---
 README.md | 34 ++++++++++++++++++++++++++++++++--
 1 file changed, 32 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 3f58f9483..19fa0bf7e 100644
--- a/README.md
+++ b/README.md
@@ -203,7 +203,7 @@ try {
 
 TIP: If you are experiencing version conflicts with gRPC, see [Version Conflicts](#version-conflicts).
 
-## OpenCensus Tracing
+## Client request tracing: OpenCensus Tracing
 
 Cloud Bigtable client supports [OpenCensus Tracing](https://opencensus.io/tracing/),
 which gives insight into the client internals and aids in debugging production issues.
@@ -258,6 +258,8 @@ StackdriverTraceExporter.createAndRegister(
       .setProjectId("YOUR_PROJECT_ID")
       .build());
 ```
+You can view the traces on the Google Cloud Platform Console 
+[Trace](https://console.cloud.google.com/traces) page.
 
 By default traces are [sampled](https://opencensus.io/tracing/sampling) at a rate of about 1/10,000.
 You can configure a higher rate by updating the active tracing params:
@@ -273,7 +275,7 @@ Tracing.getTraceConfig().updateActiveTraceParams(
 );
 ```
 
-## OpenCensus Stats
+## Enabling Cloud Bigtable Metrics: OpenCensus Stats
 
 Cloud Bigtable client supports [Opencensus Metrics](https://opencensus.io/stats/),
 which gives insight into the client internals and aids in debugging production issues.
@@ -376,6 +378,34 @@ BigtableDataSettings.enableOpenCensusStats();
 BigtableDataSettings.enableGfeOpenCensusStats();
 ```
 
+You can view the metrics on the Google Cloud Platform Console
+[Metrics explorer](https://console.cloud.google.com/monitoring/metrics-explorer)
+page.
+
+You can configure how frequently metrics are pushed to StackDriver and the
+[Monitored resource type](https://cloud.google.com/monitoring/api/resources) by
+updating `StackdriverStatsConfiguration`:
+
+``` java
+// Example: configuring export interval and monitored resource type
+StackdriverStatsExporter.createAndRegister(
+    StackdriverStatsConfiguration.builder()
+        .setProjectId("YOUR_PROJECT_ID")
+        // Exporting metrics every 10 seconds
+        .setExportInterval(Duration.create(10, 0))
+        // Configure monitored resource type. A common practice is to use the
+        // monitored resource objects that represent the physical resources
+        // where your application code is running. See the full list of
+        // monitored resource type here:
+        // https://cloud.google.com/monitoring/api/resources
+        .setMonitoredResource(MonitoredResource.newBuilder()
+             .setType("global")
+             .putLabels("project_id", "YOUR_PROJECT_ID")
+           .build())
+        .build()
+);
+```
+
 ## Version Conflicts
 
 google-cloud-bigtable depends on gRPC directly which may conflict with the versions brought