splunk-otel 1.1.0 → 1.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6549c18607d6e48e41c326820885cdbcf5ed1503ccfa28f10b90b63695608a78
-  data.tar.gz: 6a1a4884c1b09a07cc36348b9d59537972abd9c4024dbc6b1ae13199bb91091c
+  metadata.gz: dcf4dad70d8a6b71b55f6677d0ce9b159593dca24f132450e8c54e68c07c10b2
+  data.tar.gz: c1e39dd47d8db577649ef2c2512d98ff5ff273737c5c07c018704db6f2682cbd
 SHA512:
-  metadata.gz: db4051858076eadc6dcb3cdd6e279dbf80a239a22699f8ad5590694ed1b079c0bc70c579fc3a839c346fa00ceda56b58e6263757a1f9bd516cb938836fc511e8
-  data.tar.gz: f483859be56aa11350c2744e256c918396b0de8bd2ad31311918d889c1f0c86eae5afa69bcd5a995e88ee348a117c6a14c654e9afac1d5bba7d387925157bdde
+  metadata.gz: 449588970f19061697f38f64f4d69d53ce1b05fa29c9d0f73aa34d115b42436b98a6470b9107fabe5ad4269344611773466a09fcb41ca122674c6b059df59cd6
+  data.tar.gz: 1b700291e9eb7708a6015915d73b35c38618d64e5cabd89dce20e4ef179a70b646fb08429ee9a70d3ff8095f325912c73929fcbf26d52787cddbe2a473b779a4

data/.github/workflows/main.yml

@@ -22,13 +22,13 @@ jobs:
         ]
 
     steps:
-      - uses: actions/checkout@v3.0.2
+      - uses: actions/checkout@v3.5.2
 
       - name: Run Collector
         run: docker-compose up -d
 
       - name: Set up Ruby ${{ matrix.rubygems.ruby }}
-        uses: ruby/setup-ruby@v1.134.0
+        uses: ruby/setup-ruby@v1.149.0
         with:
           ruby-version: ${{ matrix.rubygems.ruby }}
       - name: Apply RubyGems fixes
@@ -46,7 +46,7 @@ jobs:
       - name: Run tests
         run: bundle exec appraisal ${{ matrix.rubygems.appraisal }} rake test
       - name: Upload coverage to Codecov
-        uses: codecov/codecov-action@v3.1.1
+        uses: codecov/codecov-action@v3.1.3
       - name: Run basic example e2e test
         run: ruby console.rb
         working-directory: ./examples/basic/
@@ -56,7 +56,7 @@ jobs:
   test-e2e-rails-7-barebones:
     runs-on: ubuntu-20.04
     steps:
-      - uses: actions/checkout@v3.0.2
+      - uses: actions/checkout@v3.5.2
       - name: Run e2e tests via Docker
         working-directory: ./examples/rails-7-barebones
         run: docker-compose up --build --exit-code-from tester
@@ -64,8 +64,8 @@ jobs:
   linkChecker:
     runs-on: ubuntu-20.04
     steps:
-      - uses: actions/checkout@v3.0.2
+      - uses: actions/checkout@v3.5.2
       - name: Link Checker
-        uses: lycheeverse/lychee-action@v1.5.1
+        uses: lycheeverse/lychee-action@v1.7.0
         with:
           fail: true

data/.gitlab-ci.yml

@@ -18,7 +18,8 @@ build:
       - Gemfile.lock
   script: |
     gem update --system
-    bundle install
+    gem install bundler:2.3.26
+    bundle _2.3.26_ install
     bundle exec rubocop
     bundle exec rake test
 

data/.rubocop.yml

@@ -29,3 +29,9 @@ Metrics/MethodLength:
 
 Metrics/ModuleLength:
   Max: 105
+
+Gemspec/DevelopmentDependencies:
+  EnforcedStyle: gemspec
+  Exclude:
+    - 'examples/rails-7-barebones/Gemfile'
+    - 'examples/smart-agent/Gemfile'

data/CHANGELOG.md

@@ -7,6 +7,18 @@ and this repository adheres to [Semantic Versioning](https://semver.org/spec/v2.
 
 ## Unreleased
 
+## v1.1.3 - 2023-05-24
+
+- No changes.
+
+## v1.1.1 - 2023-05-24
+
+- No significant changes.
+
+## v1.1.0 - 2023-01-30
+
+- fix handling of SPLUNK_ACCESS_TOKEN to check for empty string [#114](https://github.com/signalfx/splunk-otel-ruby/pull/114)
+
 ## v1.0.0 - 2022-09-29
 
 ## v0.3.0 - 2022-09-28

data/CONTRIBUTING.md

@@ -33,14 +33,17 @@ See [SECURITY.md](SECURITY.md#reporting-security-issues) for instructions.
 
 ## Documentation
 
-The Splunk Observability documentation is hosted on https://docs.splunk.com/Observability,
-which contains all the prescriptive guidance for Splunk Observability products. 
-Prescriptive guidance consists of step-by-step instructions, conceptual material,
-and decision support for customers. Reference documentation and development 
-documentation is hosted on this repository.
-
-You can send feedback about Splunk Observability docs by clicking the Feedback 
-button on any of our documentation pages.
+The Splunk Observability documentation is hosted on the [Splunk Observability
+Cloud docs site](https://docs.splunk.com/Observability), which contains all the
+prescriptive guidance for Splunk Observability products. Prescriptive guidance
+consists of step-by-step instructions, conceptual material, and decision support
+for customers. Reference documentation and development documentation is still
+hosted on this repository.
+
+To contribute documentation for this project, open a pull request in the
+[public-o11y-docs](https://github.com/splunk/public-o11y-docs) repository. See
+the [CONTRIBUTING.md](https://github.com/splunk/public-o11y-docs/blob/main/CONTRIBUTING.md)
+guide of the Splunk Observability Cloud documentation for more information.
 
 ## Contributing via Pull Requests
 

data/README.md

@@ -11,8 +11,8 @@
 
 The Splunk Distribution of [OpenTelemetry Instrumentation for
 Ruby](https://github.com/open-telemetry/opentelemetry-ruby) provides a gem for
-setup of OpenTelemetry SDK for reporting distributed traces to [Splunk
-APM](https://docs.splunk.com/Observability/apm/intro-to-apm.html).
+setup of OpenTelemetry SDK for reporting distributed traces to Splunk
+APM.
 
 This distribution comes with the following defaults:
 
@@ -24,221 +24,39 @@ This distribution comes with the following defaults:
 - Unlimited default limits for [configuration options](#trace-configuration) to
   support full-fidelity traces.
 
+If you're using the SignalFx Tracing Library for Ruby and want to migrate to the Splunk Distribution of OpenTelemetry Ruby, see [Migrate from the SignalFx Tracing Library for Ruby](https://quickdraw.splunk.com/redirect/?product=Observability&version=current&location=ruby.migrate) in the official documentation.
+
 ## Requirements
 
-- Ruby 2.6+
+This distribution requires Ruby version 2.6 or higher.
 
 ## Get started
 
-This Splunk distribution comes with the following defaults:
-
-- [W3C tracecontext](https://www.w3.org/TR/trace-context/) and [W3C
-  baggage](https://www.w3.org/TR/baggage/) context propagation.
-- OTLP over HTTP exporter configured to send spans to a locally running [Splunk
-  OpenTelemetry Connector](https://github.com/signalfx/splunk-otel-collector)
-  at http://localhost:4318.
-- Unlimited default limits for configuration options to support full-fidelity
-  traces.
-
-Install the gem by adding it to your project's `Gemfile`:
-
-``` ruby
-gem "splunk-otel", "~> 1.0"
-```
-
-or
-
-```shell
-bundle add splunk-otel --version "~> 1.0"
-```
-
-Configure OpenTelemetry using the `Splunk::Otel` module from `splunk/otel`:
-
-``` ruby
-require "splunk/otel"
-...
-Splunk::Otel.configure
-```
-
-## Basic configuration
-
-The `service.name` resource attribute is the only configuration option that
-needs to be specified, using either the environment variable `OTEL_SERVICE_NAME`
-or passing as an argument to `configure`:
-
-``` ruby
-Splunk::Otel.configure(service_name: "my-service")
-```
-
-Other resource attributes are not strictly required, but
-`deployment.environment` and `service.version` are recommended to be set if they
-are available. These can be set through the environment variable
-`OTEL_RESOURCE_ATTRIBUTES`:
-
-```
-OTEL_RESOURCE_ATTRIBUTES="service.version=1.2.3,deployment.environment=production"
-```
-
-alternatively, if needed, more attributes can be added in code using:
-
-```ruby
-Splunk::Otel.configure(service_name: "my-service") do |c|
-  c.resource = OpenTelemetry::SDK::Resources::Resource.create(
-    "key" => "value"
-  )
-end
-```
+For complete instructions on how to get started with the Splunk Distribution of OpenTelemetry Ruby, see [Instrument a Ruby application for Splunk Observability Cloud](https://quickdraw.splunk.com/redirect/?product=Observability&version=current&location=ruby.application) in the official documentation.
 
 ## Advanced configuration
 
-See [advanced-config.md](docs/advanced-config.md) for information on how to
-configure the instrumentation.
+See [Configure the Ruby agent for Splunk Observability Cloud](https://quickdraw.splunk.com/redirect/?product=Observability&version=current&location=ruby.configuration) in the official documentation.
 
 ## Correlate traces and logs
 
 You can add trace metadata to logs using the OpenTelemetry trace API. Trace
 metadata lets you explore logs in Splunk Observability Cloud.
 
-See [Correlating traces and logs](docs/correlating-traces-and-logs.md) for more information.
+See [Connect Ruby trace data with logs for Splunk Observability Cloud](https://quickdraw.splunk.com/redirect/?product=Observability&version=current&location=ruby.trace.logs) in the official documentation.
 
 ## Library instrumentation
 
 Supported libraries are listed
 [here](https://github.com/open-telemetry/opentelemetry-ruby-contrib/tree/main/instrumentation).
-The corresponding gems for the instrumentation libraries can be found under the
+You can find the corresponding gems for the instrumentation libraries under the
 [opentelemetry-ruby](https://rubygems.org/profiles/opentelemetry-ruby) profile
 on [rubygems.org](https://rubygems.org).
 
-### Automatic instrumentation
-
-You can enable automatic instrumentation of all libraries used in your project
-that have corresponding [OpenTelemetry Ruby
-gems](https://rubygems.org/profiles/opentelemetry-ruby) libraries by installing
-the
-[opentelemetry-instrumentation-all](https://rubygems.org/gems/opentelemetry-instrumentation-all)
-gem in your Gemfile:
-
-``` ruby
-gem "opentelemetry-instrumentation-all", "~> 0.27"
-```
-
-Enable the instrumentations from the gem by passing `auto_instrument:true` to
-the `configure` method of `Splunk::Otel`. For example:
-
-``` ruby
-require "splunk/otel"
-
-Splunk::Otel.configure(auto_instrument: true)
-```
-
-The gem fetches all instrumentation libraries but only enables those that
-instrument a dependency in your project. For example, it will fetch
-`opentelemetry-instrumentation-rack` but only if the `rack` gem is included and
-used in your project will the instrumentation be enabled.
-
-`auto_instrument: true` also works if individual instrumentation libraries are
-installed, like the `opentelemetry-instrumentation-sinatra` gem.
-
-To set configuration of one or more instrumentation libraries a config hash
-can be passed to `use_all`:
-
-``` ruby
-OpenTelemetry::SDK.configure do |c|
-  config = {'OpenTelemetry::Instrumentation::Redis' => { opt: "value" }}
-  c.use_all(config)
-end
-```
-
-The option `enabled` can be used to disable individual instrumentation libraries
-when using `opentelemetry-instrumentation-all`:
-
-``` ruby
-OpenTelemetry::SDK.configure do |c|
-  config = {'OpenTelemetry::Instrumentation::Redis' => { enabled: false }}
-  c.use_all(config)
-end
-```
-
-To enable instrumentation libraries manually, see [Manual library instrumentation](#manual-library-instrumentation).
-
-### Manual instrumentation
-
-Documentation on how to manually instrument a Ruby application is available in the 
-[OpenTelemetry official documentation](https://opentelemetry.io/docs/instrumentation/ruby/manual/).
-
-To extend the instrumentation with the OpenTelemetry Instrumentation for Ruby,
-you have to use a compatible API version.
-
-The Splunk Distribution of OpenTelemetry Ruby is compatible with:
-
-- OpenTelemetry API version 1.0.0
-- OpenTelemetry SDK version 1.0.0
-
-### Manual library instrumentation
-
-Instrumentation gems can also be installed and enabled individually. This may be
-preferred in order to control exactly which gems are fetched when building your project.
-
-Install the instrumentation library by including it in
-the project's `Gemfile`. For example, to install the
-[Sinatra](https://rubygems.org/gems/opentelemetry-instrumentation-sinatra)
-instrumentation:
-
-```
-gem "opentelemetry-instrumentation-sinatra", "~> 0.21"
-```
-
-In a block passed to `Splunk::Otel.configure` configure the SDK to use
-each of the instrumentation libraries. In the case of the Sinatra instrumentation,
-the block would look like the following example:
-
-``` ruby
-require "splunk/otel"
-
-Splunk::Otel.configure do |c|
-  c.use "OpenTelemetry::Instrumentation::Sinatra", { opt: "value" }
-end
-```
-
-### Real User Monitoring
-
-For [Real User Monitoring
-(RUM)](https://www.splunk.com/en_us/products/real-user-monitoring.html) a
-[Rack](https://github.com/rack/rack) middleware is provided which will add trace
-context to the `Server-Timing` header in the response if there is an active
-Span. To use the middleware configure `Splunk::Otel` to use the `Rack`
-instrumentation:
-
-``` ruby
-Splunk::Otel.configure do |c|
-    c.use "OpenTelemetry::Instrumentation::Rack"
-end
-```
-
-And add the middleware in `Rack::Builder`:
-
-``` ruby
-Rack::Builder.app do
-    use OpenTelemetry::Instrumentation::Rack::Middlewares::TracerMiddleware
-    use Splunk::Otel::Rack::RumMiddleware
-    run ->(_env) { [200, { "content-type" => "text/plain" }, ["OK"]] }
-end
-```
-
-When using [ActionPack](https://rubygems.org/gems/actionpack/), which Rails
-does, the middleware will be added automatically if the Instrumentation Library
-for ActionPack, "Splunk::Otel::Instrumentation::ActionPack", is used:
 
-``` ruby
-Splunk::Otel.configure do |c|
-    c.use "OpenTelemetry::Instrumentation::ActionPack"
-    c.use "Splunk::Otel::Instrumentation::ActionPack"
-end
-```
+## Manual instrumentation
 
-To disable the response headers being added the environment variable
-`SPLUNK_TRACE_RESPONSE_HEADER_ENABLED` can be set to `false`, or pass
-`trace_response_header_enabled: false` to `Splunk::Otel.configure`.
+See [Manually instrument Ruby applications for Splunk Observability Cloud](https://quickdraw.splunk.com/redirect/?product=Observability&version=current&location=ruby.manual.instrumentation) for instructions on how to manually instrument Ruby applications.
 
 ## Configure for use with Smart Agent
 
@@ -250,7 +68,7 @@ If the `SPLUNK_REALM` or the `OTEL_EXPORTER_JAEGER_ENDPOINT` environmental varia
 
 ## Troubleshooting
 
-For troubleshooting information, see the [Troubleshooting](docs/troubleshooting.md) documentation.
+For troubleshooting information, see the [Troubleshoot Ruby instrumentation for Splunk Observability Cloud](https://quickdraw.splunk.com/redirect/?product=Observability&version=current&location=ruby.troubleshooting) in the official documentation.
 
 # License
 
@@ -266,4 +84,3 @@ file](./LICENSE).
 >
 > Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
 
->ℹ️  SignalFx was acquired by Splunk in October 2019. See [Splunk SignalFx](https://www.splunk.com/en_us/investor-relations/acquisitions/signalfx.html) for more information.

data/RELEASING.md

@@ -0,0 +1,19 @@
+# Release Process
+
+## Requirements
+
+Releases to https://rubygems.org are done through Gitlab CI.
+
+Scripts for performing the release can be found in `scripts/`. The scripts will
+both create a draft Github Release and push a Gem.
+
+## Steps
+
+- Update `CHANGELOG.md`
+- Bump version in `lib/splunk/otel/version.rb`
+- Create PR
+- Once PR is approved and merged created a tag with the same version as
+  `version.rb` prefixed with `v` and push the tag
+- Watch Gitlab CI for the `release` job to complete
+- Update the newly created Github Release notes with the contents of
+  `CHANGELOG.md`

data/docs/README.md

@@ -1,3 +1 @@
-The official documentation for this distribution can be found here:
-
-https://docs.splunk.com/Observability/gdi/get-data-in/application/ruby/get-started.html
+The documentation for this distribution can be found in the [Splunk Observability Cloud official documentation](https://quickdraw.splunk.com/redirect/?product=Observability&version=current&location=ruby.application).

data/docs/advanced-config.md

@@ -1,3 +1,7 @@
+> The official Splunk documentation for this page is [Configure the Splunk Distribution of OTel Ruby](https://quickdraw.splunk.com/redirect/?product=Observability&version=current&location=ruby.configuration). 
+> 
+> For instructions on how to contribute to the docs, see [CONTRIBUTING.md](../CONTRIBUTING.md#documentation).
+
 # Advanced configuration
 
 ## Trace exporters

data/examples/rails-7-barebones/Dockerfile

@@ -1,7 +1,7 @@
 FROM ruby:3.1.2-buster
 RUN apt-get update -qq
 RUN apt-get install -y \
-    nodejs="10.24.0~dfsg-1~deb10u2" \
+    nodejs="10.24.0~dfsg-1~deb10u3" \
     netcat=1.10-41.1
 
 # ruby comes with older versions of bundler sometimes

data/lib/splunk/otel/version.rb

@@ -2,6 +2,6 @@
 
 module Splunk
   module Otel
-    VERSION = "1.1.0"
+    VERSION = "1.1.3"
   end
 end

data/scripts/install-release-deps.sh

@@ -15,4 +15,4 @@ curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | gpg -
 echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | tee /etc/apt/sources.list.d/github-cli.list > /dev/null
 
 apt-get update
-apt-get -y install gh="2.16.1"
+apt-get -y install gh

data/scripts/release.sh

@@ -31,8 +31,10 @@ create_gh_release() {
     --title "Release $release_tag"
 }
 
-create_gh_release
-
+# the gem publish for the tag is the most important so do that first
 bundle install
 bundle exec rake build
 bundle exec gem push pkg/splunk-otel-${release_version}.gem
+
+create_gh_release
+

data/splunk-otel.gemspec

@@ -36,16 +36,16 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "appraisal", "2.4.1"
   spec.add_development_dependency "bundler", "2.3.26"
   spec.add_development_dependency "rake", "13.0.6"
-  spec.add_development_dependency "rubocop", "1.36.0"
+  spec.add_development_dependency "rubocop", "1.50.2"
   spec.add_development_dependency "rubocop-rake", "0.6.0"
-  spec.add_development_dependency "simplecov", "0.21.2"
+  spec.add_development_dependency "simplecov", "0.22.0"
   spec.add_development_dependency "simplecov-cobertura", "2.1.0"
-  spec.add_development_dependency "test-unit", "3.5.3"
-  spec.add_development_dependency "tzinfo-data", "1.2022.7"
+  spec.add_development_dependency "test-unit", "3.5.8"
+  spec.add_development_dependency "tzinfo-data", "1.2023.3"
 
   # development dependencies for integration testing
-  spec.add_development_dependency "opentelemetry-instrumentation-action_pack", "~> 0.2.0"
-  spec.add_development_dependency "opentelemetry-instrumentation-rack", "~> 0.21.0"
+  spec.add_development_dependency "opentelemetry-instrumentation-action_pack", "~> 0.5.0"
+  spec.add_development_dependency "opentelemetry-instrumentation-rack", "~> 0.22.1"
   spec.add_development_dependency "rack", "~> 2.2"
   spec.add_development_dependency "rack-test", "~> 2.0"
   spec.add_development_dependency "rails"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: splunk-otel
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.1.3
 platform: ruby
 authors:
 - Splunk
-autorequire:
+autorequire: 
 bindir: exe
 cert_chain: []
-date: 2023-01-30 00:00:00.000000000 Z
+date: 2023-05-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: opentelemetry-api
@@ -160,14 +160,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.36.0
+        version: 1.50.2
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.36.0
+        version: 1.50.2
 - !ruby/object:Gem::Dependency
   name: rubocop-rake
   requirement: !ruby/object:Gem::Requirement
@@ -188,14 +188,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.21.2
+        version: 0.22.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.21.2
+        version: 0.22.0
 - !ruby/object:Gem::Dependency
   name: simplecov-cobertura
   requirement: !ruby/object:Gem::Requirement
@@ -216,56 +216,56 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 3.5.3
+        version: 3.5.8
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 3.5.3
+        version: 3.5.8
 - !ruby/object:Gem::Dependency
   name: tzinfo-data
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.2022.7
+        version: 1.2023.3
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.2022.7
+        version: 1.2023.3
 - !ruby/object:Gem::Dependency
   name: opentelemetry-instrumentation-action_pack
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.2.0
+        version: 0.5.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.2.0
+        version: 0.5.0
 - !ruby/object:Gem::Dependency
   name: opentelemetry-instrumentation-rack
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.21.0
+        version: 0.22.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.21.0
+        version: 0.22.1
 - !ruby/object:Gem::Dependency
   name: rack
   requirement: !ruby/object:Gem::Requirement
@@ -308,7 +308,7 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description:
+description: 
 email:
 - splunk-oss@splunk.com
 executables: []
@@ -328,17 +328,14 @@ files:
 - CONTRIBUTING.md
 - Gemfile
 - LICENSE
-- MIGRATING.md
 - README.md
+- RELEASING.md
 - Rakefile
 - SECURITY.md
 - conf/otel-collector-config.yaml
 - docker-compose.yml
 - docs/README.md
 - docs/advanced-config.md
-- docs/correlating-traces-and-logs.md
-- docs/instrumenting-rails.md
-- docs/troubleshooting.md
 - examples/basic/README.md
 - examples/basic/collector_trace.png
 - examples/basic/console.rb
@@ -389,7 +386,7 @@ homepage: https://github.com/signalfx/splunk-otel-ruby
 licenses: []
 metadata:
   rubygems_mfa_required: 'true'
-post_install_message:
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -404,8 +401,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.22
-signing_key:
+rubygems_version: 3.3.7
+signing_key: 
 specification_version: 4
 summary: Splunk OpenTelemetry Ruby distribution
 test_files: []

data/MIGRATING.md

@@ -1,148 +0,0 @@
-# Migrate from the SignalFx Tracing Library for Ruby
-
-The SignalFx Tracing Library for Ruby is scheduled to be deprecated by the end of 2022.
-Replace it with the Splunk Distribution of OpenTelemetry Ruby.
-
-Splunk Distribution of OpenTelemetry Ruby is based on and compatible with
-the OpenTelemetry Instrumentation for Ruby,
-an open-source project that uses the OpenTelemetry API.
-
-## Compatibility and requirements
-
-The Splunk Distribution of OpenTelemetry Ruby requires Ruby 2.6 and
-higher.
-
-## Known limitations compared to SignalFx Tracing for Ruby
-
-- Different subset of supported Ruby versions, see previous section
-- Currently no auto-instrumentation for:
-    - `elasticsearch` (<https://github.com/elastic/elasticsearch-ruby>)
-    - `grape` (<https://github.com/ruby-grape/grape>)
-    - `sequel` (<https://github.com/jeremyevans/sequel>)
-
-More details in [OTel instrumentation equivalents](#signalfx-instrumentations-equivalents).
-
-## Migrate to the Splunk Distribution of OpenTelemetry Ruby
-
-To migrate from the SignalFx Tracing Library for Ruby to the Splunk
-Distribution of OpenTelemetry Ruby, follow these steps:
-
-1.  Remove the tracing library packages.
-2.  Deploy the Splunk Distribution of OpenTelemetry Ruby.
-3.  Migrate your existing configuration.
-
-> Semantic conventions for span names and attributes change when you
-migrate.
-
-### Remove the SignalFx Tracing Library for Ruby
-
-Follow these steps to remove the tracing library and its dependencies:
-
-1.  Uninstall `signalfx`:
-
-    ``` bash
-    gem uninstall signalfx
-    ```
-
-1.  Remove `signalfx` from your Gemfile.
-
-## Migrate to the Splunk Distribution of OpenTelemetry Ruby
-
-We're currently only testing installation using Bundler with RubyGems as a source.
-[Contact us](mailto:ssg-observability-instrumentals-ruby@splunk.com) if you require a different way of installation.
-
-If you installed
-[Smart Agent](https://github.com/signalfx/signalfx-agent)
-to serve as a gateway (traces/metrics data proxy)
-migrate to
-[OpenTelemetry Collector](https://docs.splunk.com/Observability/gdi/opentelemetry/resources.html)
-first, as soon as (if) possible.
-
-### Deploy the Splunk Distribution of OpenTelemetry Ruby
-
-To install the Splunk Distribution of OpenTelemetry Ruby, see the [README.md](README.md).
-
-### Replace SignalFx / OpenTracing gems with OTel equivalents
-
-1.  Make a list of all `signalfx-*` instrumentation gems from your Gemfile, see
-    [this table](https://github.com/signalfx/signalfx-ruby-tracing#supported-libraries)
-    for a complete list.
-
-1.  Replace them with OpenTelemetry, as per the table below.
-
-1.  Replace any other OpenTracing instrumentation packages you might have installed yourself.
-
-<a name="signalfx-instrumentations-equivalents"></a>
-#### OTel equivalents of SignalFx instrumentation gems
-
-| SignalFx instrumentation name | OTel instrumentation name | notes |
-| ----------------------------- | ------------------------- | ----- |
-| signalfx-activerecord-opentracing | opentelemetry-instrumentation-active_record | |
-| signalfx-elasticsearch-instrumentation | no known equivalents | [open issue in OTel](https://github.com/open-telemetry/opentelemetry-ruby-contrib/issues/8) |
-| signalfx-faraday-instrumentation       | opentelemetry-instrumentation-faraday | |
-| signalfx-grape-instrumentation         | no known equivalents | [open issue in OTel](https://github.com/open-telemetry/opentelemetry-ruby-contrib/issues/9) |
-| signalfgx-mongodb-instrumentation      | opentelemetry-instrumentation-mongo | |
-| signalfx-mysql2-instrumentation        | opentelemetry-instrumentation-mysql2 | |
-| signalfx-nethttp-instrumentation       | opentelemetry-instrumentation-net_http | |
-| signalfx-pg-instrumentation            | opentelemetry-instrumentation-pg | |
-| signalfx-rack-tracer                   | opentelemetry-instrumentation-rack | |
-| signalfx-rails-instrumentation         | opentelemetry-instrumentation-rails | |
-| signalfx-redis-instrumentation         | opentelemetry-instrumentation-redis | |
-| signalfx-restclient-instrumentation    | opentelemetry-instrumentation-restclient | |
-| signalfx-sequel-instrumentation        | no known equivalents | [open issue in OTel](https://github.com/open-telemetry/opentelemetry-ruby-contrib/issues/11) |
-| signalfx-sidekiq-opentracing           | opentelemetry-instrumentation-sidekiq | |
-| signalfx-sinatra-instrumentation       | opentelemetry-instrumentation-sinatra | |
-
-#### OTel equivalents of other Open Tracing instrumentation gems
-
-See the
-[list of all known OTel Ruby instrumentations](https://opentelemetry.io/registry/?language=ruby&component=instrumentation)
-in OpenTelemetry registry.
-
-### Migrate settings for the Splunk Distribution of OpenTelemetry Ruby
-
-1. `SIGNALFX_ENDPOINT_URL` or `ingest_url` configuration parameter
-    - if you installed Smart Agent and can migrate to OpenTelemetry Collector, do that first, then see the point below
-    - if you have OpenTelemetry Collector available up as a sidecar (via `localhost`),
-      and it accepts OTLP on default ports, just remove this setting, we export OTLP to OTel Collector by default
-    - if you need to keep using Smart Agent, you have to set up a jaeger exporter yourself
-    - if you export directly to our backend (without OTel Collector as a proxy),
-      just set `SPLUNK_REALM` to your realm
-      (it's part of the URL, ie. `https://app.<realm>.signalfx.com/`, or `us0` if it's missing)
-
-1. `SIGNALFX_SERVICE_NAME` or `service_name` configuration parameter
-    - to set in environment, use `OTEL_SERVICE_NAME`
-    - to set in code, use `Splunk::Otel.configure(service_name: 'your service name', ...`
-
-1. `SIGNALFX_ACCESS_TOKEN` or `access_token` configuration parameter
-    - to set in environment, use `SPLUNK_ACCESS_TOKEN`
-
-1. `SIGNALFX_SPAN_TAGS` or `span_tags` configuration parameter
-    - to set in environment:
-        - first, you need to rewrite the existing value to the,
-          which has a syntax of comma-separated `<key>=<value>` pairs (e.g. `key1=value1,key2=value2`)
-        - set `OTEL_RESOURCE_ATTRIBUTES` to the new value
-    - to set in code:
-        - call `OpenTelemetry::SDK::Resources::Resource.create` with a `Hash`
-          consisting of your existing key-value pairs
-        - pass the newly created `Resource` to the `resource=` attribute in configuration
-        - for example:
-           ```ruby
-           Splunk::Otel.configure(other_args) do |c|
-             c.resource = OpenTelemetry::SDK::Resources::Resource.create(
-               "key" => "value"
-             )
-             # ...
-           end
-           ```
-
-1. `SIGNALFX_RECORDED_VALUE_MAX_LENGTH`
-    - can be set in environment using `OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT`
-    - see
-      [the list of span limits settings](https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/sdk-environment-variables.md#span-limits)
-      to learn more
-
-1. `tracer` configuration parameter
-    - if you need to set its equivalent, open an issue, and tell us about your use case
-
-For more information about Splunk Ruby OTel settings, see [advanced-config.md](docs/advanced-config.md).

data/docs/correlating-traces-and-logs.md

@@ -1,23 +0,0 @@
-# Correlating trace and logs
-
-## Standard Ruby logger
-
-To add trace metadata of the current trace to logs, use the
-`Splunk::Otel::Logging.format_correlation` function of the 
-[Ruby standard logger](https://ruby-doc.org/stdlib-3.1.1/libdoc/logger/rdoc/Logger.html)
-to set the formatter, as in the following example:
-
-``` ruby
-require "splunk/otel"
-
-logger.formatter = proc do |severity, datetime, progname, msg|  
-  "#{Splunk::Otel::Logging.format_correlation} : #{msg}\n"
-end
-```
-
-This adds `service.name=<ServiceName> trace_id=<TraceId> span_id=<SpanId>` to each log line.
-
-```
-service.name=basic-service trace_id=789b159aaee2b389a8771b2588278bcf
-span_id=6d26eba14a81f3fa : show log correlation
-```

data/docs/instrumenting-rails.md

@@ -1,46 +0,0 @@
-# Instrumenting Rails
-
-Install the instrumentation library by adding it to your project's `Gemfile`:
-
-``` ruby
-gem "opentelemetry-instrumentation-rails", "~> 0.24"
-```
-
-or install the gem using `bundle`:
-
-```shell
-bundle add opentelemetry-instrumentation-rails --version "~> 0.24"
-```
-
-Configure OpenTelemetry to use all available instrumentation libraries by adding the
-`Splunk::Otel` module from `splunk/otel` and `use_all()` method to a Rails initializer:
-
-``` ruby
-# config/initializers/opentelemetry.rb
-require "splunk/otel"
-...
-Splunk::Otel.configure do |c|
-  c.use_all()
-end
-```
-
-You can disable individual components' instrumentation as options to
-`use_all`. For example to disable Active Record instrumentation:
-
-``` ruby
-Splunk::Otel.configure do |c|
-  c.use_all({ 'OpenTelemetry::Instrumentation::ActiveRecord' => { enabled: false } })
-end
-```
-
-To enable only Rails, you can use an individual `c.use`:
-
-```ruby
-Splunk::Otel.configure do |c|
-  c.use 'OpenTelemetry::Instrumentation::Rails'
-end
-```
-
-## Example
-
-See the [readme for Rails 7 barebones example](../examples/rails-7-barebones/README.md).

data/docs/troubleshooting.md

@@ -1,14 +0,0 @@
-# Troubleshooting
-
-## Enable debug logging
-
-When things are not working, a good first step is to restart the program with
-debug logging enabled. Do this by setting the `OTEL_LOG_LEVEL` environment
-variable to `debug`.
-
-```sh
-export OTEL_LOG_LEVEL="debug"
-```
-
-Make sure to unset the environment variable after the issue is resolved, as its
-output might overload systems if left on indefinitely.