Merge branch 'main' into changepath

Author: vasireddy99

src/content/BlogPosts/blogPosts.yaml

@@ -6,6 +6,21 @@ description:
 path: /blog
 
 blogs:
+  - title: "AWS Distro for OpenTelemetry Lambda Layers are now available with ADOT Collector v0.35.0"
+    author: "Pavan Sai Vasireddy"
+    date: "03-November-2023"
+    body:
+      "ADOT Lambda Layers now distribute ADOT Collector v0.35.0 with new layers supporting AMD64 and ARM64 Lambda functions"
+    link: "/docs/ReleaseBlogs/aws-distro-for-opentelemetry-lambda-layer-v0.35.0"
+
+  - title: "AWS Distro for OpenTelemetry v0.35.0 is now available"
+    author: "Bryan Aguilar"
+    date: "02-November-2023"
+    body:
+      "AWS Distro for OpenTelemetry v0.35.0 is now available. You can download the latest AWS Distro for OpenTelemetry Collector image
+        from the Amazon Elastic Container Registry (Amazon ECR) Public Gallery."
+    link: "/docs/ReleaseBlogs/aws-distro-for-opentelemetry-collector-v0.35.0"
+
   - title: "AWS Distro for OpenTelemetry Java Instrumentation v1.31.0 is now available"
     author: "Paurush Garg"
     date: "26-Oct-2023"

src/content/Blogs/ReleaseBlogs/aws-distro-for-opentelemetry-collector-v0.35.0.mdx

@@ -0,0 +1,74 @@
+---
+title: 'AWS Distro for OpenTelemetry v0.35.0'
+description:
+    This blog post is the release announcement for ADOT Collector v0.35.0
+---
+
+import SectionSeparator from "components/MdxSectionSeparator/sectionSeparator.jsx"
+
+<SectionSeparator />
+
+[AWS Distro for OpenTelemetry (ADOT)](https://aws-otel.github.io/) Collector v0.35.0 is now available.
+You can download the latest [ADOT Collector image](https://gallery.ecr.aws/aws-observability/aws-otel-collector) from the
+[Amazon Elastic Container Registry (Amazon ECR)](https://aws.amazon.com/ecr/) Public Gallery.
+
+<SectionSeparator />
+
+**Notice**
+
+We are aware of a potential issue in the google.golang.org/grpc package (CVE-2023-44487), used by the AWS Distribution for Open Telemetry (ADOT) Collector up to and including v0.34.0.
+We have a new release of the ADOT Collector, v0.35.0 updating packages affected by this vulnerability. We recommend that users update their ADOT Collector
+to at least v0.35.0 at the earliest opportunity. See https://aws-otel.github.io/docs/getting-started/collector for information on deploying the ADOT Collector.
+
+**Upstream changelog**
+
+* [OpenTelemetry Collector v0.87.0](https://github.com/open-telemetry/opentelemetry-collector/releases/tag/v0.87.0)
+* [OpenTelemetry Collector v0.88.0](https://github.com/open-telemetry/opentelemetry-collector/releases/tag/v0.88.0)
+* [OpenTelemetry Collector Contrib v0.87.0](https://github.com/open-telemetry/opentelemetry-collector-contrib/releases/tag/v0.87.0)
+* [OpenTelemetry Collector Contrib v0.88.0](https://github.com/open-telemetry/opentelemetry-collector-contrib/releases/tag/v0.88.0)
+
+**New Components**
+
+The following feature gates are now enabled by default. The filelog receiver, filestorage extension, and AWS CloudwatchLogs exporter
+can be used with no command line changes. The feature gate can still be used to disable the usage of these components in an ADOT
+Collector configuration. 
+
+`adot.receiver.filelog`
+`adot.exporter.awscloudwatchlogs
+`adot.extension.file_storage`
+
+** Important: ADOT Collector v0.35.0 Breaking Change **
+
+Users of the `statsd` receiver, please refer to GitHub Issue - [Warning: StatsD Receiver → EMF Exporter
+Metric Pipeline Breaking Change](https://github.com/aws-observability/aws-otel-collector/issues/2249) for information on a breaking change.
+
+** Important: ADOT Collector v0.35.0 Breaking Change
+
+Users of the `awscontainerinsightreceiver`, please refer to the [GitHub Issue - Warning: Container Image Default User Change → Important
+consideration for AWSContainerInsightReceiver](https://github.com/aws-observability/aws-otel-collector/issues/2317) for more information on a breaking change.
+
+- 
+
+Detailed release notes are available via - [GitHub](https://github.com/aws-observability/aws-otel-collector/releases).
+All code changes are upstream in the respective OpenTelemetry project components.
+
+**Download**
+
+Detailed technical documentation is available on the [ADOT developer site](https://aws-otel.github.io/),
+and you can [download the distribution](https://aws-otel.github.io/download) from
+[GitHub](https://github.com/aws-observability/aws-otel-collector/releases/tag/v0.35.0).
+You can also download the latest [ADOT Collector image](https://gallery.ecr.aws/aws-observability/aws-otel-collector)
+from the [Amazon Elastic Container Registry (Amazon ECR)](https://aws.amazon.com/ecr/) Public Gallery.
+
+To learn more about how to use AWS Distro for OpenTelemetry (ADOT) to collect data for your observability solution,
+check out the hands-on [AWS Observability workshop](https://observability.workshop.aws/en/adot.html).
+Please file an [issue](https://github.com/aws-observability/aws-otel-community/issues) if you have any
+questions about the distribution, features, or its components.
+
+We also welcome you to participate in the [OpenTelemetry project](https://github.com/open-telemetry).
+The project was [approved for incubation](https://www.cncf.io/blog/2021/08/26/opentelemetry-becomes-a-cncf-incubating-project/) status
+in August 2021 by the Cloud Native Computing Foundation Technical Oversight Committee (CNCF TOC). Learn more about
+[AWS Distro for OpenTelemetry](https://aws.amazon.com/blogs/opensource/category/management-tools/aws-distro-for-opentelemetry/) on the
+[AWS Open Source Blog](https://aws.amazon.com/blogs/opensource/category/management-tools/aws-distro-for-opentelemetry/), where we announced
+the distribution’s [general availability for tracing](https://aws.amazon.com/blogs/opensource/aws-distro-for-opentelemetry-is-now-ga-for-tracing/) in September 2021
+and the distribution's [general availability for metrics](https://aws.amazon.com/blogs/opensource/aws-distro-for-opentelemetry-is-now-generally-available-for-metrics/) in May 2022.

src/content/Blogs/ReleaseBlogs/aws-distro-for-opentelemetry-lambda-layer-v0.35.0.mdx

@@ -0,0 +1,55 @@
+---
+title: 'AWS Distro for OpenTelemetry Lambda Layers that contains ADOT Collector v0.35.0 are now available'
+description:
+    Nov 2023 release announcement for ADOT Lambda layers
+---
+
+import SectionSeparator from "components/MdxSectionSeparator/sectionSeparator.jsx"
+
+<SectionSeparator />
+
+AWS Distro for OpenTelemetry Lambda Layers now supports AMD64 and ARM64 in the following AWS regions:
+
+|Region                   | AMD64 | ARM64 |
+|-------------------------|-------|-------|
+|Asia Pacific (Mumbai)    |  ✓    |  ✓    |
+|Asia Pacific (Singapore) |  ✓    |  ✓    |
+|Asia Pacific (Sydney)    |  ✓    |  ✓    |
+|Asia Pacific (Tokyo)     |  ✓    |  ✓    |
+|Asia pacific (Seoul)     |  ✓    |  ✓    |
+|Canada (Central)         |  ✓    |  ✓    |
+|Europe (Frankfurt)       |  ✓    |  ✓    |
+|Europe (Ireland)         |  ✓    |  ✓    |
+|Europe (London)          |  ✓    |  ✓    |
+|Europe (Stockholm)       |  ✓    |  ✓    |
+|Europe(Paris)            |  ✓    |  ✓    |
+|South America (Sao Paulo)|  ✓    |  ✓    |
+|US East (N. Virginia)    |  ✓    |  ✓    |
+|US East (Ohio)           |  ✓    |  ✓    |
+|US West (N California)   |  ✓    |  ✓    |
+|US West (Oregon)         |  ✓    |  ✓    |
+
+<SectionSeparator />
+
+### Release Highlights
+
+- Python layer [**aws-otel-python-<amd64|arm64>-ver-1-20-0**](https://aws-otel.github.io/docs/getting-started/lambda/lambda-python) contains OpenTelemetry Python `v1.20.0` and ADOT Collector for Lambda `v0.35.0`
+- Nodejs layer [**aws-otel-nodejs-<amd64|arm64>-ver-1-17-1**](https://aws-otel.github.io/docs/getting-started/lambda/lambda-js) contains OpenTelemetry JavaScript Core `v1.17.1` with AWS Lambda Instrumentation `v0.37.1` and ADOT Collector for Lambda `v0.35.0`
+- Java-Wrapper layer [**aws-otel-java-wrapper-<amd64|arm64>-ver-1-31-0**](https://aws-otel.github.io/docs/getting-started/lambda/lambda-java) contains OpenTelemetry Java `v1.31.0` and ADOT Collector for Lambda `v0.35.0`
+- Java-Agent layer [**aws-otel-java-agent-<amd64|arm64>-ver-1-31-0**](https://aws-otel.github.io/docs/getting-started/lambda/lambda-java-auto-instr) contains AWS Distro for OpenTelemetry Java Instrumentation `v1.31.0` and ADOT Collector for Lambda `v0.35.0`
+- Collector layer **aws-otel-collector-<amd64|arm64>-ver-0-88-0** contains ADOT Collector for Lambda `v0.35.0`. Compatible with [.NET](https://aws-otel.github.io/docs/getting-started/lambda/lambda-dotnet) and [Go](https://aws-otel.github.io/docs/getting-started/lambda/lambda-go) runtimes.
+
+### Download
+
+Learn more about AWS Distro for Open Telemetry Lambda support [here](https://aws-otel.github.io/docs/getting-started/lambda). All code changes are made upstream in the respective OpenTelemetry project components. Please file an [issue](https://github.com/aws-observability/aws-otel-community/issues) if you have any questions about the features, or its components.
+
+We also welcome you to participate in the [OpenTelemetry project](https://github.com/open-telemetry). The project was [approved for incubation](https://www.cncf.io/blog/2021/08/26/opentelemetry-becomes-a-cncf-incubating-project/) status in August 2021 by the Cloud Native Computing Foundation Technical Oversight Committee (CNCF TOC).
+
+More blog posts about
+[AWS Distro for OpenTelemetry](https://aws.amazon.com/blogs/opensource/category/management-tools/aws-distro-for-opentelemetry/) can be found on the
+[AWS Open Source Blog](https://aws.amazon.com/blogs/opensource/category/management-tools/aws-distro-for-opentelemetry/).
+
+
+### Author
+
+[Pavan Sai Vasireddy](https://github.com/vasireddy99) is as a Software Development Engineer on the AWS OpenSource Observability team. He is passionate about monitoring and observability, currently focussed on release engineering for ADOT, building monitoring tools and contributing to open source.

src/content/Downloads/downloads.yaml

@@ -1,3 +1,9 @@
+- version: 'AWS Distro for OpenTelemetry Collector Version 0.35.0'
+  releaseDate: 'November-02-2023'
+  license: 'Apache-2.0'
+  releaseNotesLink: 'https://github.com/aws-observability/aws-otel-collector/releases/tag/v0.35.0'
+  documentationLink: 'https://github.com/aws-observability/aws-otel-collector/blob/v0.35.0/README.md'
+  downloadLink: 'https://gallery.ecr.aws/aws-observability/aws-otel-collector'
 - version: 'AWS Distro for OpenTelemetry Collector Version 0.34.0'
   releaseDate: 'October-17-2023'
   license: 'Apache-2.0'

src/docs/getting-started/container-insights.mdx

@@ -32,6 +32,26 @@ CloudWatch Container Insights collects metrics for many resources such as CPU, m
 It also provides diagnostic information such as container restart failures.
 The metrics are aggregated at the cluster, node, pod, task, and service level as CloudWatch metrics.
 
+Note: Collecting infrastructure metrics through `awscontainerinsightreceiver` requires running ADOT Collector with privileged root access as it also collects container-related data from `cadvisor`.
+For EKS deployments, use the [Security Context](https://kubernetes.io/docs/reference/kubernetes-api/workload-resources/pod-v1/#security-context-1) to specify the root user as owner of the Collector process:
+```
+containers:
+    - name: aws-otel-collector
+      image: public.ecr.aws/aws-observability/aws-otel-collector:latest
+      securityContext:
+          runAsUser: 0
+          runAsGroup: 0
+```
+For ECS deployments, use the [Task Definition](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ecs-taskdefinition-containerdefinition.html#cfn-ecs-taskdefinition-containerdefinition-user) to specify the user owner of the collector process:
+```
+{
+  "name": "aoc-collector",
+  "image": "public.ecr.aws/aws-observability/aws-otel-collector:latest",
+  "user": "root",
+  ...
+ }
+```
+
 The following platforms are supported:
 
 - <Link to="/docs/getting-started/container-insights/eks-infra">Amazon EKS and Kubernetes platforms on Amazon EC2</Link>

src/docs/getting-started/container-insights/ecs-prometheus.mdx

@@ -321,6 +321,7 @@ NOTE: You need to replace placeholder values with actual value
 
 - The account id in the example is `123456` and is used in ARN for taskRole and executionRole, replace it with your own AWS account id.
 - `amazon/aws-otel-collector:v0.11.0` is using dockerhub (potential throttle) and you can use `latest` tag if you don't want to lock version.
+- Collecting infrastructure metrics requires running ADOT Collector with root access and this can be configured through `user` in the container definition.
 - `/aoc/ecs-prometheus` is the name of <Link to="/docs/setup/ecs/config-through-ssm">SSM parameter</Link>.
 - `networkMode` can be `bridge`, `host`, `awsvpc`. For fargate, it has to be `awsvpc`.
 - `logConfiguration` is for log from ADOT Collector itself. Log groups for metrics/log collected by collector is configured using `AOT_CONFIG_CONTENT`.
@@ -338,6 +339,7 @@ e.g. `cpu 255 memory 511` is invalid pair.
     {
       "name": "adot",
       "image": "amazon/aws-otel-collector:v0.11.0",
+      "user": "root",
       "secrets": [
         {
           "name": "AOT_CONFIG_CONTENT",

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

@@ -69,7 +69,7 @@ Find the supported regions and amd64(x86_64)/arm64 layer ARN in the table below
 
 |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-collector-<architecture\>-ver-0-84-0:1 | Contains ADOT Collector v0.33.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-collector-<architecture\>-ver-0-88-0:1 | Contains ADOT Collector v0.35.0 |
 
 ### Enable Tracing
 Once you’ve instrumented the Lambda function code and deployed to Lambda service, you can follow the instructions below to apply Lambda layer.

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

@@ -87,7 +87,7 @@ Find the supported regions and amd64(x86_64)/arm64 layer ARN in the table below
 
 |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-collector-<architecture\>-ver-0-84-0:1 | Contains ADOT Collector v0.33.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-collector-<architecture\>-ver-0-88-0:1 | Contains ADOT Collector v0.35.0 |
 
 ### Enable Tracing
 Once you’ve instrumented the Lambda function code and deployed to Lambda service, you can follow the instructions below to apply Lambda layer.

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

@@ -29,7 +29,7 @@ Find the supported regions and amd64(x86_64)/arm64 layer ARN in the table below
 
 |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-agent-<architecture\>-ver-1-30-1:1 | Contains [ADOT Java Auto-Instrumentation Agent v1.30.0](https://github.com/aws-observability/aws-otel-java-instrumentation/releases/tag/v1.30.0) <br/><br/> Contains ADOT Collector v0.33.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-agent-<architecture\>-ver-1-31-0:1 | Contains [ADOT Java Auto-Instrumentation Agent v1.31.0](https://github.com/aws-observability/aws-otel-java-instrumentation/releases/tag/v1.31.0) <br/><br/> Contains ADOT Collector v0.35.0 |
 
 ### Enable auto-instrumentation for your Lambda function
 

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

@@ -39,7 +39,7 @@ Find the supported regions and amd64(x86_64)/arm64 layer ARN in the table below
 
 |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-<architecture\>-ver-1-30-0:1 | Contains [OpenTelemetry for Java v1.28.0](https://github.com/open-telemetry/opentelemetry-java/releases/tag/v1.30.0) with [Java Instrumentation v1.30.0](https://github.com/aws-observability/aws-otel-java-instrumentation/releases/tag/v1.30.0) <br/><br/> Contains ADOT Collector v0.33.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-<architecture\>-ver-1-31-0:1 | Contains [OpenTelemetry for Java v1.31.0](https://github.com/open-telemetry/opentelemetry-java/releases/tag/v1.31.0) with [Java Instrumentation v1.31.0](https://github.com/aws-observability/aws-otel-java-instrumentation/releases/tag/v1.31.0) <br/><br/> Contains ADOT Collector v0.35.0 |
 
 ### Enable auto-instrumentation for your Lambda function
 To enable the AWS Distro for OpenTelemetry in your Lambda function, you need to add and configure the layer, and then enable tracing.