docs: support for env variable in tracing capture modes

Author: Pankaj Agrawal

docs/content/core/tracing.mdx

@@ -61,24 +61,52 @@ public class App implements RequestHandler<APIGatewayProxyRequestEvent, APIGatew
 }
 ```
 
-By default this annotation will automatically record method responses and exceptions.
 If you want to customize segment name that appears in traces, use:
-`@Tracing(segmentName="yourCustomName")`
+
+```java:title=CustomSegmentName.java
+public class App implements RequestHandler<APIGatewayProxyRequestEvent, APIGatewayProxyResponseEvent> {
+
+    @Tracing(segmentName="yourCustomName")
+    public APIGatewayProxyResponseEvent handleRequest(APIGatewayProxyRequestEvent input, Context context) {
+    ...
+    }
+```
+
+By default, this annotation will automatically record method responses and exceptions. You can change the default behavior by setting
+the environment variables `TRACING_CAPTURE_RESPONSE` and `TRACING_CAPTURE_ERROR` as needed. Optionally, you can override behavior by
+different supported `captureMode` to record response, exception or both.
 
 <Note type="warning">
   <strong>Returning sensitive information from your Lambda handler or functions, where Tracer is used?</strong>
   <br/><br/>
-  You can disable Tracer from capturing their responses and exception as tracing metadata with <strong><code>captureResponse=false</code></strong> and <strong><code>captureError=false</code></strong>
+  You can disable Tracer from capturing their responses and exception as tracing metadata with <strong><code>captureMode=DISABLED</code></strong>
+  or globally by setting environment variables <strong><code><strong><code>captureMode=DISABLED</code></strong></code></strong> and <strong><code>TRACING_CAPTURE_ERROR</code></strong> to `false`.
 </Note><br/>
 
 ```java:title=HandlerWithoutCapturingResponseOrError.java
 public class App implements RequestHandler<APIGatewayProxyRequestEvent, APIGatewayProxyResponseEvent> {
 
-    @Tracing(captureError = false, captureResponse = false)
+    @Tracing(captureMode=CaptureMode.DISABLED)
     public APIGatewayProxyResponseEvent handleRequest(APIGatewayProxyRequestEvent input, Context context) {
     ...
     }
 ```
+Globally:
+
+```yaml:title=template.yaml
+Resources:
+    HelloWorldFunction:
+        Type: AWS::Serverless::Function
+        Properties:
+        ...
+        Runtime: java8
+
+        Tracing: Active
+        Environment:
+            Variables:
+                TRACING_CAPTURE_RESPONSE: false # highlight-line
+                TRACING_CAPTURE_ERROR: false # highlight-line
+```
 
 ### Annotations
 

docs/content/index.mdx

@@ -123,7 +123,9 @@ Environment variable | Description | Utility
 **POWERTOOLS_SERVICE_NAME** | Sets service name used for tracing namespace, metrics dimension and structured logging | All
 **POWERTOOLS_METRICS_NAMESPACE** | Sets namespace used for metrics | [Metrics](./core/metrics)
 **POWERTOOLS_LOGGER_SAMPLE_RATE** | Debug log sampling | [Logging](./core/logging)
-**LOG_LEVEL** | Sets logging level | [Logging](./core/logger)
+**LOG_LEVEL** | Sets logging level | [Logging](./core/logging)
+**TRACING_CAPTURE_RESPONSE** | Enables/Disables tracing mode to capture method response | [Tracing](./core/tracing)
+**TRACING_CAPTURE_ERROR** | Enables/Disables tracing mode to capture method error | [Tracing](./core/tracing)
 
 ## Tenets