Skip to content

pingleig/aws-otel-collector

 
 

Repository files navigation

codecov CI CD GitHub release (latest by date)

Overview

AWS Distro for OpenTelemetry Collector(AWS OTel Collector) is a AWS supported version of the upstream OpenTelemetry Collector and is distributed by Amazon. It supports the selected components from the OpenTelemetry community. It is fully compatible with AWS computing platforms including EC2, ECS and EKS. It enables users to send telemetry data to AWS CloudWatch Metrics, Traces and Logs backends as well as the other supported backends.

See the AWS Distro for OpenTelemetry documentation for more information.

Getting Help

Use the community resources below for getting help with AWS OTel Collector.

  • Use GitHub issues for reporting bugs and requesting features.
  • Join our GitHub Community for AWS Distro for OpenTelemetry to ask your questions, file issues, request enhancements.
  • Open a support ticket with AWS Support.
  • If you think you may have found a bug, open an issue.
  • For contributing guidelines refer CONTRIBUTING.md.

AWS OTel Collector Built-in Components (in 2020)

This table represents the supported components of AWS OTel Collector in 2020. The highlighted components below are developed by AWS in-house. The rest of the components in the table are the essential default components that AWS OTel Collector will support.

Receiver Processor Exporter Extensions
prometheusreceiver attributesprocessor awsxrayexporter healthcheckextension
otlpreceiver resourceprocessor awsemfexporter pprofextension
awsecscontainermetricsreceiver queuedprocessor awsprometheusremotewriteexporter zpagesextension
awsxrayreceiver batchprocessor loggingexporter
statsdreceiver memorylimiter otlpexporter
tailsamplingprocessor fileexporter
probabilisticsamplerprocessor otlphttpexporter
spanprocessor prometheusexporter
filterprocessor datadogexporter
metricstransformprocessor dynatraceexporter
resourcedetectionprocessor newrelicexporter
sapmexporter
signalfxexporter

AWS OTel Collector AWS Components

Getting Started

Prerequisites

To build AWS OTel Collector locally, you will need to have Golang installed. You can download and install Golang here.

AWS OTel Collector Configuration

We built in a default configuration to our docker image and other format of release. So you can run AWS OTel Collector out of box with the default settings. Also, AWS OTel Collector configuration uses the same configuration syntax/design from OpenTelemetry Collector so you can customize or porting your OpenTelemetry Collector configuration files when running AWS OTel Collector. please refer Try out AWS OTel Collector section on configuring AWS OTel Collector.

Try out AWS OTel Collector

AWS OTel Collector supports all AWS computing platforms and docker/kubernetes. Here are some examples on how to run AWS OTel Collector to send telemetry data:

Build Your Own Artifacts

Use the following instruction to build your own AWS OTel Collector artifacts:

Release Process

Benchmark

The latest performance model result is here. The performance test conducted by following the instruction here.

License

AWS OTel Collector is licensed under an Apache 2.0 license.

About

AWS Distro for OpenTelemetry Collector

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Go 47.6%
  • Shell 28.1%
  • PowerShell 8.6%
  • Python 7.2%
  • Makefile 5.6%
  • Dockerfile 1.9%
  • Smarty 1.0%