open-telemetry · Trending

open-telemetry/opentelemetry-collector-contrib

Contrib repository for the OpenTelemetry Collector

View on GitHub Website / Demo Back to listing

5kstars 4kforks 100+contributors Go

README.md

---

<a href="https://opentelemetry.io/docs/collector/getting-started/">Getting Started</a>
 &nbsp;&nbsp;&bull;&nbsp;&nbsp;
 <a href="https://github.com/open-telemetry/opentelemetry-collector/blob/main/CONTRIBUTING.md">Getting Involved</a>
 &nbsp;&nbsp;&bull;&nbsp;&nbsp;
 <a href="https://cloud-native.slack.com/archives/C01N6P7KR6W">Getting In Touch</a>

<a href="https://github.com/open-telemetry/opentelemetry-collector/blob/main/docs/vision.md">Vision</a>
 &nbsp;&nbsp;&bull;&nbsp;&nbsp;
 <a href="https://github.com/open-telemetry/opentelemetry-collector/blob/main/docs/observability.md">Observability</a>
 &nbsp;&nbsp;&bull;&nbsp;&nbsp;
 <a href="https://github.com/open-telemetry/opentelemetry-collector/blob/main/docs/security-best-practices.md">Security</a>

---

# OpenTelemetry Collector Contrib

This is a repository for OpenTelemetry Collector components that are not suitable for the  [core repository](https://github.com/open-telemetry/opentelemetry-collector) of the collector.

The official distributions, core and contrib, are available as part of the [opentelemetry-collector-releases](https://github.com/open-telemetry/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](https://github.com/open-telemetry/opentelemetry-collector/tree/main/cmd/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](https://github.com/open-telemetry/opentelemetry-collector#stability-levels) 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](https://github.com/open-telemetry/opentelemetry-collector/tree/main/featuregate#feature-lifecycle).

## 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](https://github.com/orgs/open-telemetry/teams/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](CONTRIBUTING.md).

### Maintainers

- [Alex Boten](https://github.com/codeboten), Grafana Labs
- [Andrzej Stencel](https://github.com/andrzej-stencel), Elastic
- [Antoine Toulme](https://github.com/atoulme), Splunk
- [Bogdan Drutu](https://github.com/bogdandrutu), Snowflake
- [Braydon Kains](https://github.com/braydonk), Google
- [Christos Markou](https://github.com/ChrsMark), Elastic
- [Dmitrii Anoshin](https://github.com/dmitryax), Splunk
- [Edmo Vamerlatti Costa](https://github.com/edmocosta), Elastic
- [Evan Bradley](https://github.com/evan-bradley), Dynatrace
- [Pablo Baeyens](https://github.com/mx-psi), DataDog
- [Sean Marciniak](https://github.com/MovieStoreGuy), Splunk
- [Tyler Helmuth](https://github.com/TylerHelmuth), Grafana Labs
- [Yang Song](https://github.com/songy23), DataDog

For more information about the maintainer role, see the [community repository](https://github.com/open-telemetry/community/blob/main/guides/contributor/membership.md#maintainer).

### Approvers

- [Arthur Silva Sens](https://github.com/ArthurSens), Grafana Labs
- [Constança Manteigas](https://github.com/constanca-m), Elastic
- [Curtis Robert](https://github.com/crobert-1), Splunk
- [David Ashpole](https://github.com/dashpole), Google
- [Israel Blancas](https://github.com/iblancasa), Coralogix
- [Joshua MacDonald](https://github.com/jmacd), Microsoft
- [Matt Wear](https://github.com/mwear), Dash0
- [Mike Goldsmith](https://github.com/MikeGoldsmith), Honeycomb
- [Paulo Dias](https://github.com/paulojmdias), Five9
- [Paulo Janotti](https://github.com/pjanotti), Splunk
- [Sam DeHaan](https://github.com/dehaansa), Grafana Labs
- [Vihas Makwana](https://github.com/VihasMakwana), Elastic

For more information about the approver role, see the [community repository](https://github.com/open-telemetry/community/blob/main/guides/contributor/membership.md#approver).

### Triagers

- [Benedikt Bongartz](https://github.com/frzifus), Red Hat
- [Bogdan Stancu](https://github.com/bogdan-st), Adobe
- [Dónal O'Sullivan](https://github.com/osullivandonal), Elastic
- [Douglas Camata](https://github.com/douglascamata), Coralogix
- [Dylan Strohschein](https://github.com/dyl10s), Dynatrace
- [George Krajcsovits](https://github.com/krajorama), Grafana Labs
- [James Moessis](https://github.com/jamesmoessis), Optiver
- [Jared Tan](https://github.com/JaredTan95), DaoCloud
- [Khushi Jain](https://github.com/khushijain21), Elastic
- [Murphy Chen](https://github.com/Frapschen), DaoCloud
- [Ondrej Dubaj](https://github.com/odubajDT), Dynatrace
- [Roger Coll](https://github.com/rogercoll), Elastic
- [Vibhanshu Singh](https://github.com/singhvibhanshu)
- Actively seeking contributors to triage issues

For more information about the triager role, see the [community repository](https://github.com/open-telemetry/community/blob/main/guides/contributor/membership.md#triager).

### Emeritus

- [Alolita Sharma](https://github.com/alolita), Triager
- [Andrew Wilkins](https://github.com/axw), Approver
- [Anthony Mirabella](https://github.com/Aneurysm9), Approver
- [Bryan Aguilar](https://github.com/bryan-aguilar), Approver
- [Daniel Jaglowski](https://github.com/djaglowski), Maintainer
- [Florian Bacher](https://github.com/bacherfl), Triager
- [Gabriel Aszalos](https://github.com/gbbr), Triager
- [Goutham Veeramachaneni](https://github.com/gouthamve), Triager
- [Juraci Paixão Kröhling](https://github.com/jpkrohling), Maintainer
- [Przemek Maciolek](https://github.com/pmm-sumo), Approver
- [Punya Biswal](https://github.com/punya), Triager
- [Ruslan Kovalov](https://github.com/kovrus), Approver
- [Steve Flanders](https://github.com/flands), Triager
- [Tigran Najaryan](https://github.com/tigrannajaryan), Maintainer
- [Ziqi Zhao](https://github.com/fatsheep9146), Approver

For more information about the emeritus role, see the [community repository](https://github.com/open-telemetry/community/blob/main/guides/contributor/membership.md#emeritus-maintainerapprovertriager).

### 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".

## PRs and Reviews

When creating a PR please follow the process [described
here](https://github.com/open-telemetry/opentelemetry-collector/blob/main/CONTRIBUTING.md#how-to-structure-prs-to-get-expedient-reviews).

New PRs will be automatically associated with the reviewers based on
[CODEOWNERS](.github/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.

Repository info

Default branch: main
Latest version: v0.162.0
Created: 2019-07-11
Last activity: 2026-10-13
License: Apache-2.0
Open issues: 1k
Watchers: 68

Topics

open-telemetry opentelemetry

Contributors

renovate[bot]

3k contributions

bogdandrutu

1.9k contributions

dependabot[bot]

1.3k contributions

atoulme

1.1k contributions

djaglowski

842 contributions