Skip to content

Commit

Permalink
Update docs for jaeger-query host binary, prow jobs, and screenshot
Browse files Browse the repository at this point in the history
  • Loading branch information
rifelpet committed Jan 5, 2024
1 parent 8000ce5 commit 2336025
Show file tree
Hide file tree
Showing 2 changed files with 36 additions and 1 deletion.
Binary file added docs/img/jaeger-query.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
37 changes: 36 additions & 1 deletion docs/opentelemetry.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,12 +12,47 @@ To try this out:

You should now see that the /tmp/trace file is created.

Then we have an experimental tool to serve the trace file to jaeger:
Then we have an experimental tool to serve the trace file to jaeger. First ensure `jaeger-query` is in your PATH, available [here](https://www.jaegertracing.io/download/#binaries)

```
cd tools/otel/traceserver
go run . --src /tmp/trace --run jaeger
```

Alternatively you can use the jaeger docker image with:

```
go run . --src /tmp/trace --run docker-jaeger
```

This will open your local jaeger-query's frontend in a web browser:

![Jaeger UI](./img/jaeger-query.png)

Not everything is instrumented yet, and not all the traces are fully joined up (we need to thread more contexts through more methods),
but you should be able to start to explore the operations that we run and their performance.

## Prow Jobs

Tracing is enabled in the kops prow jobs. `.otel` files are created during job execution and included as job artifacts in the `otlp` subdirectory.

Example:

```
https://gcsweb.k8s.io/gcs/kubernetes-jenkins/pr-logs/pull/kops/16204/presubmit-kops-aws-scale-amazonvpc-using-cl2/1742962895290896384/artifacts/otlp/
```

Download these files to a local directory, either with `gsutil` or through a web browser

```
mkdir /tmp/job-traces
gsutil cp -r gs://kubernetes-jenkins/pr-logs/pull/kops/16204/presubmit-kops-aws-scale-amazonvpc-using-cl2/1742962895290896384/artifacts/otlp/ /tmp/job-traces
```

Then run the trace server as normal:

```sh
cd tools/otel/traceserver
go run . --src /tmp/traces --run jaeger
```

0 comments on commit 2336025

Please sign in to comment.