opentelemetry-collector-contrib

---

Getting Started   •   Getting Involved   •   Getting In Touch

Vision   •   Observability   •   Security

---

OpenTelemetry Collector Contrib

This is a repository for OpenTelemetry Collector components that are not suitable for the core repository of the collector.

The official distributions, core and contrib, are available as part of the opentelemetry-collector-releases repository. Some of the components in this repository are part of the “core” distribution, such as the Jaeger and Prometheus components, but most of the components here are only available as part of the “contrib” distribution. Users of the OpenTelemetry Collector are also encouraged to build their own custom distributions with the OpenTelemetry Collector Builder, using the components they need from the core repository, the contrib repository, and possibly third-party or internal repositories.

Each component has its own support levels, as defined in the following sections. For each signal that a component supports, there’s a stability level, setting the right expectations. It is possible then that a component will be Stable for traces but Alpha for metrics and Development for logs.

Stability levels

Stability level for components in this repository follow the definitions from the OpenTelemetry Collector repository.

Gated features

Some features are hidden behind feature gates before they are part of the main code path for the component. Note that the feature gates themselves might be at different lifecycle stages.

Support

Each component is supported either by the community of OpenTelemetry Collector Contrib maintainers, as defined by the GitHub group @open-telemetry/collector-contrib-maintainers, or by specific vendors. See the individual README files for information about the specific components.

The OpenTelemetry Collector Contrib maintainers may at any time downgrade specific components if they are deemed unmaintained or if they pose a risk to the repository and/or binary distribution.

Even though the OpenTelemetry Collector Contrib maintainers are ultimately responsible for the components hosted here, actual support will likely be provided by individual contributors, typically a code owner for the specific component.

Contributing

See CONTRIBUTING.md.

Maintainers

• Alex Boten, Grafana Labs
• Andrzej Stencel, Elastic
• Antoine Toulme, Splunk
• Bogdan Drutu, Snowflake
• Braydon Kains, Google
• Christos Markou, Elastic
• Dmitrii Anoshin, Splunk
• Edmo Vamerlatti Costa, Elastic
• Evan Bradley, Dynatrace
• Pablo Baeyens, DataDog
• Sean Marciniak, Splunk
• Tyler Helmuth, Grafana Labs
• Yang Song, DataDog

For more information about the maintainer role, see the community repository.

Approvers

• Arthur Silva Sens, Grafana Labs
• Constança Manteigas, Elastic
• Curtis Robert, Splunk
• David Ashpole, Google
• Israel Blancas, Coralogix
• Joshua MacDonald, Microsoft
• Matt Wear, Dash0
• Mike Goldsmith, Honeycomb
• Paulo Dias, Five9
• Paulo Janotti, Splunk
• Sam DeHaan, Grafana Labs
• Vihas Makwana, Elastic

For more information about the approver role, see the community repository.

Triagers

• Benedikt Bongartz, Red Hat
• Bogdan Stancu, Adobe
• Dónal O’Sullivan, Elastic
• Douglas Camata, Coralogix
• Dylan Strohschein, Dynatrace
• George Krajcsovits, Grafana Labs
• Himanshu Singh, Sumo Logic
• James Moessis, Optiver
• Jared Tan, DaoCloud
• Khushi Jain, Elastic
• Murphy Chen, DaoCloud
• Ondrej Dubaj, Dynatrace
• Roger Coll, Elastic
• Satoshi Kamiyama, MagicPod
• Vibhanshu Singh
• Actively seeking contributors to triage issues

For more information about the triager role, see the community repository.

Emeritus

• Alolita Sharma, Triager
• Andrew Wilkins, Approver
• Anthony Mirabella, Approver
• Bryan Aguilar, Approver
• Daniel Jaglowski, Maintainer
• Florian Bacher, Triager
• Gabriel Aszalos, Triager
• Goutham Veeramachaneni, Triager
• Juraci Paixão Kröhling, Maintainer
• Przemek Maciolek, Approver
• Punya Biswal, Triager
• Ruslan Kovalov, Approver
• Steve Flanders, Triager
• Tigran Najaryan, Maintainer
• Ziqi Zhao, Approver

For more information about the emeritus role, see the community repository.

No Over-Representation

A community member cannot be promoted to be a Collector contrib maintainer if, after their promotion, the resulting maintainers group has more than one-fourth (25%) of the members affiliated with the same employer. Job changes and similar events might result in over-representation, and no new maintainers from the same company can be promoted until representation is balanced again. In the event of confusion or concern, the OpenTelemetry Collector SIG will defer to the CNCF definition of “same employer”.

SIG Meeting Attendance

Before they can become a Collector contrib approver or maintainer, a community member must have attended at least one Collector SIG meeting on camera. At least one current Collector contrib maintainer must also have attended that meeting.

PRs and Reviews

When creating a PR please follow the process described here.

New PRs will be automatically associated with the reviewers based on CODEOWNERS. PRs will be also automatically assigned to one of the maintainers or approvers for facilitation.

The facilitator is responsible for helping the PR author and reviewers to make progress or if progress cannot be made for closing the PR.

If the reviewers do not have approval rights the facilitator is also responsible for the official approval that is required for the PR to be merged and if the facilitator is a maintainer they are responsible for merging the PR as well.

The facilitator is not required to perform a thorough review, but they are encouraged to enforce Collector best practices and consistency across the codebase and component behavior. The facilitators will typically rely on codeowner’s detailed review of the code when making the final approval decision.

Marking the PR with the ready to merge label should only happen (by triagers/approvers/maintainers) once there is at least one approval from an approver, as per the description above.

Marking the PR with the waiting-for-approvers label can be done (by triagers/code owners/approvers/maintainers) once the PR has been reviewed and approved by code owners, all review comments are addressed, CI is green, and it is only waiting on a review from an approver or maintainer. Use this label instead of pinging @open-telemetry/collector-contrib-approvers. Once an approver approves the PR, replace it with the ready to merge label.