documentation icon indicating copy to clipboard operation
documentation copied to clipboard

Add troubleshooting page

Open black-adder opened this issue 7 years ago • 6 comments

Requirement - what kind of business use case are you trying to solve?

We are seeing a lot of “cannot see spans” questions. Internally we have a troubleshooting guide we should make public to assist users with troubleshooting.

Convert blog post linked from https://www.jaegertracing.io/docs/1.13/troubleshooting/ to the actual docs

black-adder avatar Aug 24 '18 15:08 black-adder

cc @pgadige

jpkrohling avatar Sep 07 '18 14:09 jpkrohling

Thank you @jpkrohling ! I've begun working on it. Will get more inputs before making a PR.

pgadige avatar Sep 07 '18 15:09 pgadige

https://medium.com/jaegertracing/help-something-is-wrong-with-my-jaeger-installation-68874395a7a6

@jpkrohling your blog can go into this doc

yurishkuro avatar Jan 21 '19 23:01 yurishkuro

Would a reference to the blog post be better, or do you think that duplicating the content is worth it?

jpkrohling avatar Jan 22 '19 09:01 jpkrohling

Let’s start with the link so that we at least have a page in the docs. Longer term I think it would be better to have the content in the docs directly so that other people could edit it.

yurishkuro avatar Jan 22 '19 15:01 yurishkuro

Looking at the doc, I think one other aspect people often have issues with is why the connections are not succeeding. We obviously cannot write an exhaustive troubleshooting for this, but perhaps there are some common mistakes? I think one of them is people forget that when running in the container, the localhost that spans are sent to is probably not the way to reach the agent.

yurishkuro avatar Jul 17 '19 21:07 yurishkuro