Add readme for spinning up notebooks#53
Conversation
Signed-off-by: shreyagupta30 <shreyagupta3011@gmail.com>
|
I've wanted to compose a similar guide to this one, but got buried in another projects. If it makes sense, that can be merged, and this PR can be easily changed to use that compose. |
yurishkuro
left a comment
There was a problem hiding this comment.
- please add links to the main README
- are the screenshots really critical/necessary? I feel like they can be safely omitted and text can describe what you want them to show.
|
@yurishkuro Thanks for your feedback. I will make the required changes |
Signed-off-by: shreyagupta30 <shreyagupta3011@gmail.com>
|
Hi @jpkrohling and @yurishkuro, I have made the requested changes in the readme. Kindly review it and let me know if any further changes are required. |
jupyter/README.md
Outdated
| 1. For Jaeger UI: | ||
|
|
||
| ``` bash | ||
| docker run --rm -it -p 16686:16686 --name=jaeger jaegertracing/all-in-one:1.17 |
There was a problem hiding this comment.
| docker run --rm -it -p 16686:16686 --name=jaeger jaegertracing/all-in-one:1.17 | |
| docker run --rm -it -p 16686:16686 --name=jaeger jaegertracing/all-in-one:1.20 |
jupyter/README.md
Outdated
|
|
||
| *Note : Add `-v ${PWD}:/home/jovyan/work` to Jupyter notebook if you want to open the notebooks from your current directory.* | ||
|
|
||
| After succesfully running the docker script, you will be able to see a URL in you terminal with unique token. Paste that URL in your browser to start the jupyter notebook. |
There was a problem hiding this comment.
| After succesfully running the docker script, you will be able to see a URL in you terminal with unique token. Paste that URL in your browser to start the jupyter notebook. | |
| After successfully running the `docker` commands, you will be able to see a URL in you terminal with unique token. Paste that URL in your browser to start the Jupyter notebook. |
jupyter/README.md
Outdated
| For the analysis we have to generate some data, so in the HotROD UI click on the blue boxes to order a car that generates nice traces. To verify that the trace reached Jaeger open Jaeger UI and search for traces from the `frontend` service. | ||
| You'll be able to see the generated traces for the services and operation. | ||
|
|
||
| Once we know that the data is stored in Jaeger we can move to Jupyter notebook and load the trace there. Jaeger notebooks are stored in the jupyter directory. This directory can either be opened from the project root directory or from work in case the notebooks from host filesystem are injected into the docker container. |
There was a problem hiding this comment.
| Once we know that the data is stored in Jaeger we can move to Jupyter notebook and load the trace there. Jaeger notebooks are stored in the jupyter directory. This directory can either be opened from the project root directory or from work in case the notebooks from host filesystem are injected into the docker container. | |
| Once we know that the data is stored in Jaeger we can move to Jupyter notebook and load the trace there. Jaeger notebooks are stored in the jupyter directory. This directory can either be opened from the project root directory or from work in case the notebooks from host filesystem are injected into the container. |
jupyter/README.md
Outdated
| For the analysis we have to generate some data, so in the HotROD UI click on the blue boxes to order a car that generates nice traces. To verify that the trace reached Jaeger open Jaeger UI and search for traces from the `frontend` service. | ||
| You'll be able to see the generated traces for the services and operation. | ||
|
|
||
| Once we know that the data is stored in Jaeger we can move to Jupyter notebook and load the trace there. Jaeger notebooks are stored in the jupyter directory. This directory can either be opened from the project root directory or from work in case the notebooks from host filesystem are injected into the docker container. |
There was a problem hiding this comment.
What does "load the trace there" mean? What are the steps? Which notebook should be opened?
|
|
||
| Once we know that the data is stored in Jaeger we can move to Jupyter notebook and load the trace there. Jaeger notebooks are stored in the jupyter directory. This directory can either be opened from the project root directory or from work in case the notebooks from host filesystem are injected into the docker container. | ||
|
|
||
| Before running the analysis we have to load dependencies into the notebook’s classpath. Just click on the dependencies cell to make it active and then on the play icon in the top navigation menu. |
There was a problem hiding this comment.
Interesting, I get the errors you were having some time ago:
TraceTraversal<Vertex, Vertex> traversal = graph.traversal(TraceTraversalSource.class)
cannot find symbol
symbol: class TraceTraversal
Do you remember what was the problem?
There was a problem hiding this comment.
Yes, there were some missing dependencies in pom.xml file somewhere but I wasn't able to understand what was the exact problem.
There was a problem hiding this comment.
It's a problem in the jaegertracing/jaeger-analytics-java project then? @pavolloffay do you know if there's something missing on our setup?
| It should look something like: | ||
| ``` java | ||
| String queryHostPort = "jaeger:16686"; | ||
| String traceIdStr = "2cb1f0c274c3b4a5" |
Signed-off-by: shreyagupta30 <shreyagupta3011@gmail.com>
f21ced4 to
6c92214
Compare
|
Hi @jpkrohling, I have made the requested changes and it's ready for review. :) |
|
I'm unable to review it today, but will take a look soon. |
jpkrohling
left a comment
There was a problem hiding this comment.
Just a couple of minor comments, but it's ready to be merged. @yurishkuro you left a comment earlier on this PR, would you like to take another look?
|
|
||
| 2. For HotROD demo application, run | ||
| ``` bash | ||
| docker run --rm -it -p 8080:8080 --link=jaeger -e JAEGER_ENDPOINT=http://jaeger:14268/api/traces jaegertracing/example-hotrod:1.17 |
There was a problem hiding this comment.
This version should be the same as the all-in-one
|
|
||
|
|
||
| ``` bash | ||
| docker run --rm -it -p 8888:8888 -p 4041:4040 -p 9001:9001 --link=jaeger -e JUPYTER_ENABLE_LAB=yes quay.io/jaegertracing/jaeger-analytics-java:latest |
There was a problem hiding this comment.
-p 4041:4040 -- is it a typo, or should one really be different than the other?
This fixes #51
I have added a readme file that provides instructions on how to spin up the jupyter notebooks for the Data Analytics.
cc: @jpkrohling