Skip to content

frigus02/opentelemetry-collector-contrib

 
 

Repository files navigation


Getting Started   •   Getting Involved   •   Getting In Touch

Go Report Card Build Status Codecov Status GitHub release (latest by date including pre-releases) Beta

Contributing   •   Vision   •   Design   •   Monitoring   •   Performance   •   Roadmap


OpenTelemetry Collector Contrib

This is a repository for OpenTelemetry Collector contributions that are not part of the core repository and core distribution of the Collector. Typically, these contributions are vendor specific receivers/exporters and/or components that are only useful to a relatively small number of users.

Adding New Components

Before you start please read the contributing guidelines.

Any component (receiver, processor, exporter, or extension) needs to implement the interfaces defined on the core repository. Familiarize yourself with the interface of the component that you want to write, and use existing implementations as reference.

NOTICE: The Collector is in Beta stage and as such the interfaces may undergo breaking changes. Component creators must be available to update or review their components when such changes happen, otherwise the component will be excluded from the default builds.

Generally, maintenance of components is the responsibility of contributors who authored them. If the original author or some other contributor does not maintain the component it may be excluded from the default build. The component will be excluded if it causes build problems, has failing tests or otherwise causes problems to the rest of the repository and the rest of contributors.

  • Create your component under the proper folder and use Go standard package naming recommendations.
  • Use a boiler-plate Makefile that just references the one at top level, ie.: include ../../Makefile.Common - this allows you to build your component with required build configurations for the contrib repo while avoiding building the full repo during development.
  • Each component has its own go.mod file. This allows custom builds of the collector to take a limited sets of dependencies - so run go mod commands as appropriate for your component.
  • Implement the needed interface on your component by importing the appropriate component from the core repo.
 Follow the pattern of existing components regarding config and factory source files and tests.

  • Implement your component as appropriate. Provide end-to-end tests (or mock backend/client as appropriate). Target is to get 80% or more of code coverage.
  • Add a README.md on the root of your component describing its configuration and usage, likely referencing some of the yaml files used in the component tests. We also suggest that the yaml files used in tests have comments for all available configuration settings so users can copy and modify them as needed.
  • Add a replace directive at the root go.mod file so your component is included in the build of the contrib executable.

General Recommendations

Below are some recommendations that apply to typical components. These are not rigid rules and there are exceptions but in general try to follow them.

  • Avoid introducing batching, retries or worker pools directly on receivers and exporters. Typically, these are general cases that can be better handled via processors (that also can be reused by other receivers and exporters).
  • When implementing exporters try to leverage the exporter helpers from the core repo, see exporterhelper package. This will ensure that the exporter provides zPages and a standard set of metrics.

Questions

Reach the Collector community on gitter if you have further questions.

Community Roles

Triagers (@open-telemetry/collector-contrib-triagers)

Approvers (@open-telemetry/collector-contrib-approvers):

Maintainers (@open-telemetry/collector-contrib-maintainer):

Learn more about roles in the community repository.

Component Reviewers

Exporters

Exporter Reviewer(s)
alibabacloudlogserviceexporter @shabicheng
awsxrayexporter @kbrockhoff @anuraaga
azuremonitorexporter @pcwiese
carbonexporter @pjanotti
elasticexporter @axw
honeycombexporter @paulosman @lizthegrey
jaegerthrifthttpexporter @jpkrohling @pavolloffay
kinesisexporter @owais
newrelicexporter @MrAlias
sapmexporter @owais @dmitryax
sentryexporter @AbhiPrasad
signalfxexporter @pmcollins @asuresh4
splunkhecexporter @atoulme
stackdriverexporter @nilebox @james-bebbington

Receivers

Receiver Reviewer(s)
awsecscontainermetricsreceiver @kbrockhoff @anuraaga
awsxrayreceiver @kbrockhoff @anuraaga
carbonreceiver @pjanotti
collectdreceiver @owais
k8sclusterreceiver @asuresh4
kubeletstatsreceiver @pmcollins @asuresh4
prometheusexecreceiver @keitwb @james-bebbington
receivercreator @jrcamp
redisreceiver @pmcollins @jrcamp
sapmreceiver @owais
signalfxreceiver @pjanotti @asuresh4
simpleprometheusreceiver @asuresh4
statsdreceiver @keitwb @jmacd
wavefrontreceiver @pjanotti

About

Contrib repository for the OpenTelemetry Collector

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Go 99.2%
  • Other 0.8%