Skip to content

Add Getting started documentation for otel-cpp sdk#942

Merged
lalitb merged 9 commits intoopen-telemetry:mainfrom
lalitb:sdk_docs_impl
Aug 10, 2021
Merged

Add Getting started documentation for otel-cpp sdk#942
lalitb merged 9 commits intoopen-telemetry:mainfrom
lalitb:sdk_docs_impl

Conversation

@lalitb
Copy link
Copy Markdown
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
Comment thread docs/public/sdk/GettingStarted.rst Outdated
- 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
Copy Markdown
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
Copy Markdown
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
Copy Markdown

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
Copy Markdown
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
Copy Markdown
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
Copy Markdown
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
Copy Markdown
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