Skip to content

Commit

Permalink
[website_docs] Use console code-block style, and spellcheck
Browse files Browse the repository at this point in the history
  • Loading branch information
chalin committed Nov 19, 2021
1 parent a37637c commit ef5c4bc
Showing 1 changed file with 9 additions and 9 deletions.
18 changes: 9 additions & 9 deletions website_docs/getting_started.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: "Getting Started"
title: Getting Started
weight: 1
---

Expand Down Expand Up @@ -50,23 +50,23 @@ Now that you have setup your application to perform tracing, you'll need to conf

### Exporting Traces

The following section assumes you are new to OpenTelemetry or do not currently use a vendor that supports distributed tracing using OTLP. Please refer to your vendor's product documentation if you would like to export your traces to a vendor for analysis and vizualization.
The following section assumes you are new to OpenTelemetry or do not currently use a vendor that supports distributed tracing using OTLP. Please refer to your vendor's product documentation if you would like to export your traces to a vendor for analysis and visualization.

For the purposes of this tutorial you will configure an OpenTelemetry collector that will receive the traces and vizualize them using Jaeger or Zipkin UI.
For the purposes of this tutorial you will configure an OpenTelemetry collector that will receive the traces and visualize them using Jaeger or Zipkin UI.

First, start up an example system:

```bash
$> git clone git@github.com:open-telemetry/opentelemetry-ruby.git; \
```console
$ git clone git@github.com:open-telemetry/opentelemetry-ruby.git; \
cd open-telemetry-ruby/examples/otel-collector; \
docker-compose up -d
```

Next, you'll have to let the SDK know where the collector endpoint is to receive traces.
Set the [`OTEL_EXPORTER_OTLP_ENDPOINT`][sdk-env] environment variable to `http://0.0.0.0:4318`:

```bash
export OTEL_EXPORTER_OTLP_ENDPOINT=http://0.0.0.0:4318
```console
$ export OTEL_EXPORTER_OTLP_ENDPOINT=http://0.0.0.0:4318
```

Now, start up your application and perform a few operations to generate tracing data, e.g. navigate around your web app or kick off background tasks.
Expand All @@ -75,9 +75,9 @@ Lastly, open a browser and navigate to the [Jaeger UI](http://localhost:16686) o

### Achievement Unlocked: Tracing Enabled

Adding tracing to a single service is a great first step and although auto-instrumenation provides quite a bit of insight on its own, OpenTelemetry provides a few more features that will allow you gain even deeper insights!
Adding tracing to a single service is a great first step and although auto-instrumentation provides quite a bit of insight on its own, OpenTelemetry provides a few more features that will allow you gain even deeper insights!

[Context Propagation][context-propagation] is perhaps one of the most powerful concepts in OpenTelemetry because it will upgrade your single service trace into a _distributed trace_, which makes it possible for OpenTelemetry vendors to visualize a request from end-to-end accross process and network boundaries.
[Context Propagation][context-propagation] is perhaps one of the most powerful concepts in OpenTelemetry because it will upgrade your single service trace into a _distributed trace_, which makes it possible for OpenTelemetry vendors to visualize a request from end-to-end across process and network boundaries.

[Span Events][events] allow you to add a human-readable message on a span that represents "something happening" during its lifetime.

Expand Down

0 comments on commit ef5c4bc

Please sign in to comment.