From fd04dc1ec555dfab851ce62170ab5b901db4cbd0 Mon Sep 17 00:00:00 2001 From: Brandon Morelli Date: Wed, 10 Jun 2020 22:32:30 -0700 Subject: [PATCH] docs: OpenTelemetry Elastic exporter (#3845) (#3859) --- .../images/open-telemetry-elastic-arch.png | Bin 0 -> 120143 bytes docs/guide/index.asciidoc | 2 + docs/guide/opentelemetry-elastic.asciidoc | 180 ++++++++++++++++++ 3 files changed, 182 insertions(+) create mode 100644 docs/guide/images/open-telemetry-elastic-arch.png create mode 100644 docs/guide/opentelemetry-elastic.asciidoc diff --git a/docs/guide/images/open-telemetry-elastic-arch.png b/docs/guide/images/open-telemetry-elastic-arch.png new file mode 100644 index 0000000000000000000000000000000000000000..7530deb361852fe8e178ad52fbad20f63fcbc7c6 GIT binary patch literal 120143 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

?wnBX3?}VrOeqd~e2pq)wSAMdNAy>svBqepX;>; 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 literal 0 HcmV?d00001 diff --git a/docs/guide/index.asciidoc b/docs/guide/index.asciidoc index 6d115078ad5..32c99fd21fa 100644 --- a/docs/guide/index.asciidoc +++ b/docs/guide/index.asciidoc @@ -23,6 +23,8 @@ include::./rum.asciidoc[] include::./opentracing.asciidoc[] +include::./opentelemetry-elastic.asciidoc[] + include::./obs-integrations.asciidoc[] include::./cross-cluster-search.asciidoc[] diff --git a/docs/guide/opentelemetry-elastic.asciidoc b/docs/guide/opentelemetry-elastic.asciidoc new file mode 100644 index 00000000000..fe2a2dfa556 --- /dev/null +++ b/docs/guide/opentelemetry-elastic.asciidoc @@ -0,0 +1,180 @@ +[[open-telemetry-elastic]] +== OpenTelemetry integration + +:ot-spec: https://github.com/open-telemetry/opentelemetry-specification/blob/master/README.md +:ot-repo: https://github.com/open-telemetry/opentelemetry-collector +:ot-pipelines: {ot-repo}/blob/master/docs/pipelines.md +:ot-extension: {ot-repo}/blob/master/extension/README.md +:ot-scaling: {ot-repo}/blob/master/docs/performance.md + +:ot-collector: https://opentelemetry.io/docs/collector/about/ +:ot-dockerhub: https://hub.docker.com/r/otel/opentelemetry-collector-contrib-dev + +Elastic's OpenTelemetry integration allows you to reuse your existing OpenTelemetry +instrumentation to quickly analyze distributed traces and metrics with the Elastic Stack. + +[float] +[[what-is-opentelemetry]] +=== What is OpenTelemetry? + +> OpenTelemetry is a set of APIs, SDKs, tooling, and integrations that enable the creation and +management of telemetry data. It formed through a merger of the OpenTracing and OpenCensus projects. + +OpenTelemetry is an open-source project that provides the components necessary to observe your applications and services. +If you're unfamiliar with the project, see the {ot-spec}[spec] for more information. + +[float] +[[open-telemetry-elastic-exporter]] +=== Elastic exporter + +Elastic's integration is designed to drop into your current OpenTelemetry setup. +We've done this by extending the "contrib" OpenTelemetry collector and adding an Elastic exporter. +This exporter translates the OpenTelemetry trace data collected from your services to Elastic's protocol, +before sending the data to the Elastic Stack. +By extending the OpenTelemetry collector, +no changes are needed in your instrumented services in order to begin using the Elastic Stack. + +image::images/open-telemetry-elastic-arch.png[OpenTelemetry Elastic architecture diagram] + +[float] +[[open-telemetry-elastic-works]] +=== How the OpenTelemetry Collector works + +The OpenTelemetry collector uses three different types of components to handle data: `receivers`, `processors`, and `exporters`. + +* `receivers`: Configure how data gets to the collector. At least one receiver must be configured. +* `processors`: Defines optional transformations that occurs between receiving and exporting data. +* `exporters`: Configures how data is sent to its destination--in this case, the Elastic Stack. + +Once a `receiver`, `processor`, and `exporter` is defined, `pipelines` can be configured in the `services` section of your configuration. Specifically, a `traces` pipeline will define the path of trace data through your collector, and bring all three of these components together. + +TIP: More information is available in the +{ot-pipelines}[OpenTelemetry pipeline docs] + +A final note: `extensions` can also be enabled for tasks like monitoring your collectors health. +See the {ot-extension}[OpenTelemetry extension readme] +for a list of supported extensions. + +[[open-telemetry-elastic-get-started]] +=== Get started + +NOTE: This guide assumes you've already instrumented your services with the OpenTelemetry API and/or SDK. +If you haven't, see the Elastic APM <> to get started with Elastic APM Agents instead. + +[[open-telemetry-elastic-deployment-planning]] +==== Plan your deployment + +OpenTelemetry Collectors can be run as an Agent, or as standalone collectors. +They can be deployed as often as necessary and scaled up or out. + +Deployment planning resources are available in OpenTelemetry's {ot-collector}[Getting Started] +documentation, and {ot-scaling}[Collector Performance] research. + +[[open-telemetry-elastic-download]] +==== Download the collector + +The Elastic exporter lives in the {ot-repo}[`opentelemetry-collector-contrib repository`], +and the latest release can be downloaded from {ot-repo}/releases[GitHub releases page]. + +Docker images are available on {ot-dockerhub}[dockerhub]: + +[source,bash] +---- +docker pull otel/opentelemetry-collector-contrib-dev +---- + +You can also build the collector-contrib repository by cloning it and running: + +[source,bash] +---- +make otelcontribcol +---- + +[[open-telemetry-elastic-configure]] +==== Configure the collector + +Create a `yaml` configuration file. + +At a minimum, you must define the URL of the APM Server instance you are sending data to. +For example: + +[source,yml] +---- +exporters: + elastic: + apm_server_url: "https://elasticapm.example.com" +---- + +See the <> for additional configuration options, +like specifying an API key, secret token, or TLS settings. + +The Elastic exporter must also be defined in `service.pipelines.traces.exporters`. +For example: + +[source,yml] +---- +service: + pipelines: + traces: + exporters: [elastic] +---- + +If we put everything together, here's an example configuration file that accepts input from an OpenTelemetry Agent, +processes the data, and sends it to an {ess} instance. + +[source,yml] +---- +receivers: + otlp: + endpoint: localhost:55680 +processors: + batch: + timeout: 1s + send_batch_size: 1024 +exporters: + elastic: + apm_server_url: "https://elasticapm.example.com" + secret_token: "ESS_TOKEN" +service: + pipelines: + traces: + receivers: [otlp] + processors: [batch] + exporters: [elastic] +---- + +NOTE: For more information about getting started with an OpenTelemetry Collector, +see the {ot-collector}[OpenTelemetry collector] docs. + +[[open-telemetry-elastic-config-ref]] +=== Elastic exporter configuration reference + +[[open-telemetry-config-url]] +==== `apm_server_url` +Elastic APM Server URL. (required) + +[[open-telemetry-config-api-key]] +==== `api_key` +Credential for {apm-server-ref-v}/api-key.html[API key authorization]. +Must also be enabled in Elastic APM Server. (optional) + +[[open-telemetry-config-secret-token]] +==== `secret_token` +Credential for {apm-server-ref-v}/secret-token.html[secret token authorization]. +Must also be enabled in Elastic APM Server. (optional) + +[[open-telemetry-config-ca-file]] +==== `ca_file` +Root Certificate Authority (CA) certificate, for verifying the server's identity if TLS is enabled. (optional) + +[[open-telemetry-config-cert-file]] +==== `cert_file` +Client TLS certificate. (optional) + +[[open-telemetry-config-key-file]] +==== `key_file` +Client TLS key. (optional) + +[[open-telemetry-config-insecure]] +==== `insecure` +Disable verification of the server's identity if TLS is enabled. (optional)