Skip to content

Commit a88943e

Browse files
authored
Add a section for when to use a collector (open-telemetry#1286)
1 parent a0c9c1b commit a88943e

File tree

1 file changed

+17
-1
lines changed

1 file changed

+17
-1
lines changed

Diff for: content/en/docs/collector/_index.md

+17-1
Original file line numberDiff line numberDiff line change
@@ -10,19 +10,35 @@ aliases: [/docs/collector/about]
1010

1111
![OpenTelemetry Collector diagram with Jaeger, OTLP and Prometheus integration](https://raw.github.com/open-telemetry/opentelemetry.io/main/iconography/Otel_Collector.svg)
1212

13+
## Introduction
14+
1315
The OpenTelemetry Collector offers a vendor-agnostic implementation of how to
1416
receive, process and export telemetry data. It removes the need to run,
1517
operate, and maintain multiple agents/collectors. This works with improved scalability and supports
1618
open-source observability data formats (e.g. Jaeger, Prometheus, Fluent Bit,
1719
etc.) sending to one or more open-source or commercial back-ends. The local Collector agent
1820
is the default location to which instrumentation libraries export their telemetry data.
1921

20-
Objectives:
22+
## Objectives
2123

2224
- *Usability*: Reasonable default configuration, supports popular protocols, runs and collects out of the box.
2325
- *Performance*: Highly stable and performant under varying loads and configurations.
2426
- *Observability*: An exemplar of an observable service.
2527
- *Extensibility*: Customizable without touching the core code.
2628
- *Unification*: Single codebase, deployable as an agent or collector with support for traces, metrics, and logs (future).
2729

30+
## When to use a collector
31+
32+
For most language specific instrumentation libraries you have exporters for popular backends and OTLP. You might wonder,
33+
34+
> under what circumstances does one use a collector to send data, as opposed to having each service send directly to the backend?
35+
36+
For trying out and getting started with OpenTelemetry, sending your data directly to a backend is a great way to get value quickly.
37+
Also, in a development or small-scale environment you can get decent results without a collector.
38+
39+
However, in general we recommend using a collector alongside your service, since it allows your service to offload data quickly and the collector
40+
can take care of additional handling like retries, batching, encryption or even sensitive data filtering.
41+
42+
It is also easier to [setup a collector](./getting-started) then you might think: the default OTLP exporters in each language assume a local collector endpoint, so you'd start up a collector and you'd just start getting telemetry.
43+
2844
{{% latest_release "collector-releases" /%}}

0 commit comments

Comments
 (0)