AWS Distro for OpenTelemetry Helm Charts
:warning: Warning: ADOT Helm Charts is deprecated and the recommended way for users who use EKS on EC2 and want to ingest metrics is using the ADOT EKS add-on, a wrapper around the OpenTelemetry Operator. By using the respective custom resource configuration you can run it, for example, as a Deployment or a Daemonset. For details, see this example of how to use the add-on to ingest metrics into Amazon Managed Service for Prometheus.
Introduction
This AWS Distro for OpenTelemetry (ADOT) Helm Charts repository contains Helm charts to provide easy mechanisms to setup the ADOT Collector and other collection agents to collect telemetry data such as metrics, logs and traces to send to AWS monitoring services.
This repository contains a Helm chart to provide easy to operate, end-to-end AWS Elastic Kubernetes Service (EKS) on AWS Elastic Compute Cloud (EC2) monitoring with AWS Distro for OpenTelemetry(ADOT) Collector for metrics. This Helm chart is useful for customers who use EKS on EC2 and want to collect metrics to send to Amazon CloudWatch Container Insights and Amazon Managed Service for Prometheus(AMP).
Getting Started
Helm must be installed to use the chart. Please refer to Helm's documentation to get started.
Once Helm is set up properly, add this repo as follows:
$ helm repo add aws-observability https://aws-observability.github.io/aws-otel-helm-charts
$ helm search repo aws-observability # Run this command in order to see the charts.:warning: Warning: Fluent Bit and Fargate logging templates are deprecated and were removed from the Helm chart on December 30th, 2022 (>= 0.11.0)
There is planned work in the upstream OpenTelemetry repositories to stabilize logs, and so that means that our Helm Chart will have to be updated to reflect these eventual changes. The changes required for our Helm Chart include:
- Removing the Fluent Bit logging templates
- Removing the Fargate logging templates
Therefore, we recommend revising any code that utilizes these templates by December 30th, 2022 or continue to use the version of the Helm Chart that pre-dates December 30th (<= 0.10.0), 2022 to avoid any issues. As an alternative, you can also make use of the aws-for-fluent-bit Helm Chart (more details).
Once logs are stabilized upstream and implemented, a new version of the Helm Chart will be released and users may upgrade to this instance instead. Thank you for your cooperation.
Contributing
See CONTRIBUTING.md for more information.
NOTE: we're currently not accepting new PRs as we're evaluating our priorities concerning the ADOT Helm Charts. We plan to update this repo with a concrete timeline with the new policy by end of March 2023.
License
This project is licensed under the Apache 2.0 License.
ADOT Roadmap
You can track upcoming features and enhancements for ADOT on its roadmap.
Support
Please note that as per policy, we're providing support via GitHub on a best effort basis. However, if you have AWS Enterprise Support you can create a ticket and we will provide direct support within the respective SLAs.
Security issue notifications
If you discover a potential security issue in this project we ask that you notify AWS/Amazon Security via our vulnerability reporting page. Please do not create a public github issue.