Skip to content
This repository has been archived by the owner on Oct 3, 2023. It is now read-only.

content/*: switch tutorial exporters to use open source and free exporters #343

Open
bogdandrutu opened this issue Sep 17, 2018 · 6 comments
Open

content/*: switch tutorial exporters to use open source and free exporters #343

bogdandrutu opened this issue Sep 17, 2018 · 6 comments
Assignees
@odeke-em

Comments

@bogdandrutu
Copy link

Someone sent me the feedback that our QuickStart sections are too GCP centric:

https://opencensus.io/quickstart/java/metrics/ - look at the big "requirements" section.
@odeke-em
Copy link
Member

Thank you for the report @bogdandrutu!

We used Stackdriver because it has both Tracing and Metrics. We happened to be in a crunch: 2 weeks before Cloud Next 2018 which was an important event for OpenCensus so it was easier.

However, great point, we should be using open source exporters that don't require accounts but also to avoid giving the false impression that this is a Google-centric project.

For the choice of open source exporters, I suggest these

Exporter Go Java Python Node.js
Prometheus(Stats) X X X
Zipkin(Tracing) X X X X

To also give credit, @rakyll @saturnism had all suggested this switch too. We've just been too swamped to have the time to do it. Tonight I've got some time and will spend it on this. Thanks y'all.

@odeke-em odeke-em self-assigned this Sep 18, 2018
@odeke-em odeke-em changed the title OpenCensus tutorials look like Google centric content/quickstart: switch tutorial exporters to use open source and free exporters Sep 18, 2018
@odeke-em odeke-em changed the title content/quickstart: switch tutorial exporters to use open source and free exporters content/*: switch tutorial exporters to use open source and free exporters Sep 18, 2018
odeke-em added a commit that referenced this issue Sep 18, 2018
@odeke-em
content/quickstart: use open source exporters for Go quickstarts
1b4891e 
Use free and open source exporters for Go quickstarts:
* Prometheus for Metrics
* Zipkin for Tracing

This change will be replicated across most/all languages that
support the above exporters. It makes the project more attractive,
easier to setup and non-biased towards any company.

Updates #343
@odeke-em odeke-em mentioned this issue Sep 18, 2018
Merged
@odeke-em
Copy link
Member

I've mailed #344 which is the seed for other languages to use after that Go update.

odeke-em added a commit that referenced this issue Sep 18, 2018
@odeke-em
content/quickstart: use open source exporters for Go quickstarts
64bc4b2 
Use free and open source exporters for Go quickstarts:
* Prometheus for Metrics
* Zipkin for Tracing

This change will be replicated across most/all languages that
support the above exporters. It makes the project more attractive,
easier to setup and non-biased towards any company.

Updates #343
odeke-em added a commit that referenced this issue Sep 18, 2018
@odeke-em
content/quickstart: use open source exporters for Java quickstarts
5b9b6c6 
Use free and open source exporters for Java quickstarts:
* Prometheus for stats
* Zipkin for tracing

This change makes the project more attractive with vendor neutrality
and not locking users into paid backends, but also these exporters
are free and easy to setup.

Updates #343
@odeke-em odeke-em mentioned this issue Sep 18, 2018
Merged
odeke-em added a commit that referenced this issue Sep 18, 2018
@odeke-em
content/quickstart: use open source exporters for Java quickstarts
636e81f 
Use free and open source exporters for Java quickstarts:
* Prometheus for stats
* Zipkin for tracing

This change makes the project more attractive with vendor neutrality
and not locking users into paid backends, but also these exporters
are free and easy to setup.

Updates #343
@odeke-em
Copy link
Member

And the Java quickstarts too have been converted to use open source exporters #347

This was referenced Sep 22, 2018
Closed
Closed
@odeke-em
Copy link
Member

Turns out this issue had already been filed in August #218 but I'll close the old one since this issue is being focused on more.

@odeke-em odeke-em mentioned this issue Sep 22, 2018
Closed
PikBot pushed a commit to PikBot/opencensus-website that referenced this issue Sep 24, 2018
@PikkaPikkachu
quickstart/python: use Zipkin exporter for tracing tutorials
c99f9fc 
- Replace Stackdriver exporter with Zipkin exporter in tracing tutorial
- Fixes census-instrumentation#343
@PikBot PikBot mentioned this issue Sep 24, 2018
Merged
PikBot pushed a commit to PikBot/opencensus-website that referenced this issue Sep 24, 2018
@PikkaPikkachu
quickstart/python: use Zipkin exporter for tracing tutorials
1358dfd 
Replace Stackdriver Trace exporter with Zipkin exporter in tracing quickstart
since Zipkin is easy to setup, free, open sourced.

Updates census-instrumentation#343
Updates census-instrumentation#353
odeke-em pushed a commit that referenced this issue Sep 24, 2018
@PikBot
quickstart/python: use Zipkin exporter for tracing tutorials (#356)
d02058a 
Replace Stackdriver Trace exporter with Zipkin exporter in tracing quickstart
since Zipkin is easy to setup, free, open sourced.

Updates #343
Updates #353
@EEmery
Copy link

EEmery commented Sep 27, 2018

OpenCensus Node's exporters have independent READMEs with simple guides trying to explain the usage. Still, I don't think that's enough. I'll try to create some quickstarts and add them to the website as soon as possible 😄

@odeke-em
Copy link
Member

OpenCensus Node's exporters have independent READMEs with simple guides trying to explain the usage. Still, I don't think that's enough.

Please feel free to copy those guides over as PRs to the website: Prometheus and Zipkin, these are all that are needed. The problem we have is that many of those guides are written in Typescript and some of us aren't domain experts so end up being blocked. Thus it is great to hear that you'll work on them :) Thank you!

PikBot pushed a commit to PikBot/opencensus-website that referenced this issue Oct 12, 2018
@PikkaPikkachu
quickstart/python: use Prometheus exporter for metrics tutorials
dbf6819 
quickstart/python: use Prometheus exporter for metrics tutorials

Replace Stackdriver Metrics exporter with Prometheus exporter in metrics quickstart
since Prometheus is easy to setup, free, open sourced.

Updates census-instrumentation#343
fixes census-instrumentation#353
@PikBot PikBot mentioned this issue Oct 12, 2018
Merged
PikBot pushed a commit to PikBot/opencensus-website that referenced this issue Oct 12, 2018
@PikkaPikkachu
quickstart/node.js: use Zipkin exporter for tracing tutorials
80409f2 
quickstart/node.js: use Zipkin exporter for tracing tutorials

Replace Stackdriver exporter with Zipkin exporter in tracing quickstart
since Zipkin is easy to setup, free, open sourced.

Updates census-instrumentation#355
Updates census-instrumentation#343
@PikBot PikBot mentioned this issue Oct 12, 2018
Merged
odeke-em pushed a commit that referenced this issue Oct 15, 2018
@PikBot
quickstart/node.js: use Zipkin exporter for tracing tutorials (#389)
abd77ce 
* quickstart/node.js: use Zipkin exporter for tracing tutorials
quickstart/node.js: use Zipkin exporter for tracing tutorials

Replace Stackdriver exporter with Zipkin exporter in tracing quickstart
since Zipkin is easy to setup, free, open sourced.

Updates #355
Updates #343
odeke-em added a commit that referenced this issue Oct 20, 2018
@odeke-em
quickstarts: add C++ tracing
20f5214 
Added a full quickstart tutorial for C++
tracing with the Zipkin exporter.

Updates #287
Updates #343
@odeke-em odeke-em mentioned this issue Oct 20, 2018
Merged
odeke-em added a commit that referenced this issue Oct 20, 2018
@odeke-em
quickstarts: add C++ tracing
efff890 
Added a full quickstart tutorial for C++
tracing with the Zipkin exporter.

Updates #287
Updates #343
odeke-em added a commit that referenced this issue Oct 20, 2018
@odeke-em
quickstarts: add C++ metrics
3e14e44 
Added a full quickstart tutorial for C++
tracing with the Prometheus exporter.

Updates #287
Updates #343
@odeke-em odeke-em mentioned this issue Oct 20, 2018
Merged
odeke-em added a commit that referenced this issue Oct 20, 2018
@odeke-em
quickstarts: add C++ metrics
750cf53 
Added a full quickstart tutorial for C++
metrics with the Prometheus exporter and
also updates the C++ tracing quickstart
with some grammatical fixes and added
references.

Updates #287
Updates #343
odeke-em added a commit that referenced this issue Oct 22, 2018
@odeke-em
quickstarts: add C++ metrics
3d12272 
Added a full quickstart tutorial for C++
metrics with the Prometheus exporter and
also updates the C++ tracing quickstart
with some grammatical fixes and added
references.

Updates #287
Updates #343
odeke-em pushed a commit that referenced this issue Feb 6, 2019
@PikBot
quickstart/python: use Prometheus exporter for metrics tutorials (#388)
24f50b9 
Replace Stackdriver Metrics exporter with Prometheus exporter in
metrics quickstart since Prometheus is easy to setup, free, open sourced.

This change also finally completes the tutorial TODOs since the
OpenCensus-Python library has recently fixed the bugs that prevented
completion of the tutorials.

Updates #343
Fixes #353
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Assignees

@odeke-em odeke-em

Labels
None yet
Projects
None yet
Milestone
No milestone
Development

No branches or pull requests
3 participants
@bogdandrutu @odeke-em @EEmery