Merge branch 'main' into lambdadocchnage

Author: Kausik-A

src/docs/getting-started/java-sdk/trace-auto-instr.mdx

@@ -93,7 +93,7 @@ artifact, any usage of it will be disabled by the agent.
 ##### For Gradle:
 ```kotlin lineNumbers=true
 dependencies {
-    implementation("io.opentelemetry:opentelemetry-api:1.16.0")
+    implementation("io.opentelemetry:opentelemetry-api:1.19.1")
 }
 ```
 
@@ -103,7 +103,7 @@ dependencies {
   <dependency>
     <groupId>io.opentelemetry</groupId>
     <artifactId>opentelemetry-api</artifactId>
-    <version>1.16.0</version>
+    <version>1.19.1</version>
   </dependency>
 </dependencies>
 ```

src/docs/getting-started/java-sdk/trace-manual-instr.mdx

@@ -37,7 +37,7 @@ to align dependency versions for non-contrib components.
 ##### For Gradle:
 ```kotlin lineNumbers=true
 dependencies {
-    api(platform("io.opentelemetry:opentelemetry-bom:1.16.0"))
+    api(platform("io.opentelemetry:opentelemetry-bom:1.19.1"))
 
     implementation("io.opentelemetry:opentelemetry-api")
     implementation("io.opentelemetry:opentelemetry-exporter-otlp")
@@ -46,7 +46,7 @@ dependencies {
 
     implementation("io.opentelemetry:opentelemetry-extension-aws")
     implementation("io.opentelemetry:opentelemetry-sdk-extension-aws")
-    implementation("io.opentelemetry.contrib:opentelemetry-aws-xray:1.16.0")
+    implementation("io.opentelemetry.contrib:opentelemetry-aws-xray:1.19.1")
 }
 ```
 
@@ -57,7 +57,7 @@ dependencies {
     <dependency>
       <groupId>io.opentelemetry</groupId>
       <artifactId>opentelemetry-bom</artifactId>
-      <version>1.16.0</version>
+      <version>1.19.1</version>
       <type>pom</type>
       <scope>import</scope>
     <dependency>
@@ -87,7 +87,7 @@ dependencies {
   <dependency>
     <groupId>io.opentelemetry.contrib</groupId>
     <artifactId>opentelemetry-aws-xray</artifactId>
-    <version>1.16.0</version>
+    <version>1.19.1</version>
   </dependency>
 </dependencies>
 ```
@@ -211,7 +211,7 @@ library instrumentation. When using this, do not include `opentelemetry-bom`.
 ##### For Gradle:
 ```kotlin lineNumbers=true
 dependencies {
-    api(platform("io.opentelemetry.instrumentation:opentelemetry-instrumentation-bom-alpha:1.16.0-alpha"))
+    api(platform("io.opentelemetry.instrumentation:opentelemetry-instrumentation-bom-alpha:1.19.1-alpha"))
 
     implementation("io.opentelemetry:opentelemetry-api")
     implementation("io.opentelemetry:opentelemetry-exporter-otlp")
@@ -230,7 +230,7 @@ dependencies {
     <dependency>
       <groupId>io.opentelemetry.instrumentation</groupId>
       <artifactId>opentelemetry-instrumentation-bom-alpha</artifactId>
-      <version>1.16.0-alpha</version>
+      <version>1.19.1-alpha</version>
       <type>pom</type>
       <scope>import</scope>
     <dependency>
@@ -264,7 +264,7 @@ The `opentelemetry-instrumentation-aws-sdk-2.2` artifact provides instrumentatio
 ##### For Gradle:
 ```java lineNumbers=true
 dependencies {
-    api(platform("io.opentelemetry.instrumentation:opentelemetry-instrumentation-bom-alpha:1.16.0-alpha"))\
+    api(platform("io.opentelemetry.instrumentation:opentelemetry-instrumentation-bom-alpha:1.19.1-alpha"))\
 
     implementation("io.opentelemetry.instrumentation:opentelemetry-aws-sdk-2.2")
 
@@ -279,7 +279,7 @@ dependencies {
     <dependency>
       <groupId>io.opentelemetry.instrumentation</groupId>
       <artifactId>opentelemetry-instrumentation-bom-alpha</artifactId>
-      <version>1.16.0-alpha</version>
+      <version>1.19.1-alpha</version>
       <type>pom</type>
       <scope>import</scope>
     <dependency>
@@ -397,7 +397,7 @@ class RequestHandler {
 
 ### Creating Metrics
 
-Up to v1.16.0 of OpenTelemetry for Java, there are few libraries and frameworks that make use of the Metrics API.
+Up to v1.19.1 of OpenTelemetry for Java, there are few libraries and frameworks that make use of the Metrics API.
 Similarly to Traces, you can create custom metrics in your application using the OpentTelemetry API and SDK.
 
 In the following example application we demonstrate how to use the three types of metric instruments that

src/docs/getting-started/lambda/lambda-java.mdx

@@ -39,7 +39,7 @@ Find the supported regions and AMD64 (x86_64) layer ARN in the table below for t
 
 |Supported   Regions  |Lambda layer ARN format  | Contents |
 |---------------------|-------------------------|----------|
-| ap-northeast-1<br/>ap-northeast-2<br/>ap-south-1<br/>ap-southeast-1<br/>ap-southeast-2<br/>ca-central-1<br/>eu-central-1<br/>eu-north-1<br/>eu-west-1<br/>eu-west-2<br/>eu-west-3<br/>sa-east-1<br/>us-east-1<br/>us-east-2<br/>us-west-1<br/>us-west-2 | arn:aws:lambda:<region\>:901920570463:layer:aws-otel-java-wrapper-amd64-ver-1-8-0:1 | Contains [OpenTelemetry for Java v1.18.0](https://github.com/open-telemetry/opentelemetry-java/releases/tag/v1.18.0) with [Java Instrumentation v1.18.0](https://github.com/open-telemetry/opentelemetry-java-instrumentation/releases/tag/v1.18.0) <br/><br/> Contains the [ADOT Collector for Lambda v0.22.0](https://github.com/aws-observability/aws-otel-collector/releases/tag/pkg%2Flambdacomponents%2Fv0.22.0) |
+| ap-northeast-1<br/>ap-northeast-2<br/>ap-south-1<br/>ap-southeast-1<br/>ap-southeast-2<br/>ca-central-1<br/>eu-central-1<br/>eu-north-1<br/>eu-west-1<br/>eu-west-2<br/>eu-west-3<br/>sa-east-1<br/>us-east-1<br/>us-east-2<br/>us-west-1<br/>us-west-2 | arn:aws:lambda:<region\>:901920570463:layer:aws-otel-java-wrapper-amd64-ver-1-18-0:1 | Contains [OpenTelemetry for Java v1.18.0](https://github.com/open-telemetry/opentelemetry-java/releases/tag/v1.18.0) with [Java Instrumentation v1.18.0](https://github.com/open-telemetry/opentelemetry-java-instrumentation/releases/tag/v1.18.0) <br/><br/> Contains the [ADOT Collector for Lambda v0.22.0](https://github.com/aws-observability/aws-otel-collector/releases/tag/pkg%2Flambdacomponents%2Fv0.22.0) |
 
 Find the supported regions and ARM64 layer ARN in the table below for the ARNs to consume.
 

src/docs/getting-started/x-ray.mdx

@@ -184,12 +184,14 @@ exporters:
 
 ##### OTel span CW Logs metadata translation
 
+The attributes in this section are translated into the AWS resource field `cloudwatch_logs`. This resource field is used to correlate Cloudwatch Log Groups with the segments associated with it. This correlation can be explored when analyzing individual traces in the X-Ray console.
+
 | OTel Attributes env var | X-Ray data model field    | Notes                                                                                                                                                                                                                                                                                                                                       |
 |-------------------------|---------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| aws.log.group.arns      | cloudwatch_logs.arn       | <ul><li> If value of aws.log.group.arns is not an empty slice, then the exporter creates a CloudWatch log object with log group and ARN for all ARNs. If aws.log.group.arns value is an empty slice and value of aws.log.group.names is not an empty slice, then exporter creates a CloudWatch log object with only a log group. </li></ul> |
-| aws.log.group.names     | cloudwatch_logs.log_group |                                                                                                                                                                                                                                                                                                                                             |
+| aws.log.group.arns      | cloudwatch_logs.arn       |                                                                                                                                                                                                                                                                                                                                             |
+| aws.log.group.names     | cloudwatch_logs.log_group | If both `aws.log.group.arns` and `aws.log.group.names` are defined, precedence is given to `aws.log.group.arns`                                                                                                                                                                                                                             |
 
-See [AWS X-Ray Segment Documents](https://docs.aws.amazon.com/xray/latest/devguide/xray-api-segmentdocuments.html) for more information on the AWS X-Ray data model. See [OpenTelemetry data model spec](https://github.com/open-telemetry/opentelemetry-specification) for more information on OpenTelemetry data model.
+See [AWS X-Ray Segment Documents](https://docs.aws.amazon.com/xray/latest/devguide/xray-api-segmentdocuments.html) for more information on the AWS X-Ray data model. See [OpenTelemetry data model spec](https://github.com/open-telemetry/opentelemetry-specification) for more information on OpenTelemetry data model. See [X-Ray Logging Configuration](https://docs.aws.amazon.com/xray/latest/devguide/xray-sdk-java-configuration.html#xray-sdk-java-configuration-logging) for references of expected log pattern.
 
 ### Enable The Customized X-Ray Annotations
 By using OpenTelemetry SDK, we can add the customized attributes for each trace subsegment. By default, these OpenTelemetry