Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add Getting started documentation for otel-cpp sdk #942

Merged
merged 9 commits into from
Aug 10, 2021

Conversation

lalitb
Copy link
Member

@lalitb lalitb commented Aug 9, 2021

Changes

Currently, the otel-cpp documentation ( https://opentelemetry-cpp.readthedocs.io/en/latest/ ) contains reference api documentation for both sdk and api and Getting started doc for api. But the Getting started doc for sdk is missing.
This PR adds the sdk doc. This is how the sdk doc looks like:
https://labhas-opentelemetry-cpp.readthedocs.io/en/latest/sdk/GettingStarted.html

For significant contributions please make sure you have completed the following items:

  • CHANGELOG.md updated for non-trivial changes
  • Unit tests have been added
  • Changes in public API reviewed

@lalitb lalitb requested a review from a team August 9, 2021 14:58
- In-Memory Exporter: keeps the data in memory, useful for debugging.
- Jaeger Exporter: prepares and sends the collected telemetry data to a Jaeger backend via UDP and HTTP.
- Zipkin Exporter: prepares and sends the collected telemetry data to a Zipkin backend via the Zipkin APIs.
- Logging Exporter: saves the telemetry data into log streams
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit: ending .? The same for line 20.

Copy link
Member Author

@lalitb lalitb Aug 9, 2021

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

thanks, it was missing at few other places, fixed all.

@codecov
Copy link

codecov bot commented Aug 9, 2021

Codecov Report

Merging #942 (a43028d) into main (555f4e8) will not change coverage.
The diff coverage is n/a.

Impacted file tree graph

@@           Coverage Diff           @@
##             main     #942   +/-   ##
=======================================
  Coverage   95.36%   95.36%           
=======================================
  Files         160      160           
  Lines        6780     6780           
=======================================
  Hits         6465     6465           
  Misses        315      315           

opts.server_addr = "localhost";
opts.server_port = 6831;
auto jaeger_udp_exporter =
std::unique_ptr<sdktrace::SpanExporter>(new opentelemetry::exporter::jaeger::JaegerExporter(opts));
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Add Jaeger HTTP example?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes missed that. Added now.

.. code:: cpp

// simple processor
auto simple_processor = std::unique_ptr<sdktrace::SpanProcessor>(
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

List the full definition of stdtrace in the beginning may help the users who follow these example code?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good point. Added it at the beginning.

@lalitb lalitb merged commit f4ff74c into open-telemetry:main Aug 10, 2021
@lalitb lalitb mentioned this pull request Sep 17, 2021
3 tasks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants