You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert

12
12
13
+
## Introduction
14
+
13
15
The OpenTelemetry Collector offers a vendor-agnostic implementation of how to
14
16
receive, process and export telemetry data. It removes the need to run,
15
17
operate, and maintain multiple agents/collectors. This works with improved scalability and supports
16
18
open-source observability data formats (e.g. Jaeger, Prometheus, Fluent Bit,
17
19
etc.) sending to one or more open-source or commercial back-ends. The local Collector agent
18
20
is the default location to which instrumentation libraries export their telemetry data.
19
21
20
-
Objectives:
22
+
## Objectives
21
23
22
24
-*Usability*: Reasonable default configuration, supports popular protocols, runs and collects out of the box.
23
25
-*Performance*: Highly stable and performant under varying loads and configurations.
24
26
-*Observability*: An exemplar of an observable service.
25
27
-*Extensibility*: Customizable without touching the core code.
26
28
-*Unification*: Single codebase, deployable as an agent or collector with support for traces, metrics, and logs (future).
27
29
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.
0 commit comments