opencensus-website icon indicating copy to clipboard operation
opencensus-website copied to clipboard

advanced-topics/troubleshooting: add section "Diagnosing problems with tracing"

Open odeke-em opened this issue 6 years ago • 1 comments

Borrowing an idea from the MySQL website "Performance schema quickstart" https://dev.mysql.com/doc/refman/8.0/en/performance-schema-quick-start.html I just saw the value of having a direct advisory of how to use a solution to diagnose and solve problems.

It would be useful for us to make a section titled "Diagnosing problems with tracing" and link to that in the same fashion at the top of the "Tracing" introduction page. This ensures that the practicalities of using tracing will be properly communicated and prescriptive, thereby creating a direct use for the content on the website

/cc @hvent90 @bogdandrutu @rakyll @shahprit

odeke-em avatar Nov 24 '18 07:11 odeke-em

Similar sentiments as https://github.com/census-instrumentation/opencensus-website/issues/473#issuecomment-442956969

If someone who has the real-world experience of using [tracing] in a site-reliability capacity is able to afford the time to detail a high-level real-world implementation, then I can go in and write the guide.

Context: I am familiar with the API accross java/go/node/python, however I haven't used it in a real-world scenario -- so my implementation isn't battle tested and would be flawed.

Another scenario is I could just write the section to get it out the door and then a more knowledgable individual polishes it up later.

hvent90 avatar Nov 29 '18 19:11 hvent90