README.md in opentelemetry-exporter-otlp-0.23.0 vs README.md in opentelemetry-exporter-otlp-0.24.0
- old
+ new
@@ -44,11 +44,12 @@
# ENV['OTEL_EXPORTER_OTLP_COMPRESSION'] = 'gzip'
OpenTelemetry::SDK.configure
# To start a trace you need to get a Tracer from the TracerProvider
-tracer = OpenTelemetry.tracer_provider.tracer('my_app_or_gem', '0.1.0')
+tracer_provider = OpenTelemetry.tracer_provider
+tracer = tracer_provider.tracer('my_app_or_gem', '0.1.0')
# create a span
tracer.in_span('foo') do |span|
# set an attribute
span.set_attribute('platform', 'osx')
@@ -58,10 +59,12 @@
tracer.in_span('bar') do |child_span|
# inspect the span
pp child_span
end
end
+
+tracer_provider.shutdown
```
For additional examples, see the [examples on github][examples-github].
## How can I configure the OTLP exporter?
@@ -71,10 +74,10 @@
| Parameter | Environment variable | Default |
| ------------------- | -------------------------------------------- | ----------------------------------- |
| `endpoint:` | `OTEL_EXPORTER_OTLP_ENDPOINT` | `"http://localhost:4318/v1/traces"` |
| `certificate_file: `| `OTEL_EXPORTER_OTLP_CERTIFICATE` | |
| `headers:` | `OTEL_EXPORTER_OTLP_HEADERS` | |
-| `compression:` | `OTEL_EXPORTER_OTLP_COMPRESSION` | |
+| `compression:` | `OTEL_EXPORTER_OTLP_COMPRESSION` | `"gzip"` |
| `timeout:` | `OTEL_EXPORTER_OTLP_TIMEOUT` | `10` |
| `ssl_verify_mode:` | `OTEL_RUBY_EXPORTER_OTLP_SSL_VERIFY_PEER` or | `OpenSSL::SSL:VERIFY_PEER` |
| | `OTEL_RUBY_EXPORTER_OTLP_SSL_VERIFY_NONE` | |
`ssl_verify_mode:` parameter values should be flags for server certificate verification: `OpenSSL::SSL:VERIFY_PEER` and `OpenSSL::SSL:VERIFY_NONE` are acceptable. These values can also be set using the appropriately named environment variables as shown where `VERIFY_PEER` will take precedence over `VERIFY_NONE`. Please see [the Net::HTTP docs](https://ruby-doc.org/stdlib-2.7.6/libdoc/net/http/rdoc/Net/HTTP.html#verify_mode) for more information about these flags.