Merge branch 'main' into contribute-eks-resource-detector

arielvalentin · web-flow · commit 7a98598cdead · 2025-06-03T10:05:46.000-05:00
diff --git a/.github/workflows/ci-markdownlint.yml b/.github/workflows/ci-markdownlint.yml
@@ -11,7 +11,7 @@ jobs:
 
       # equivalent cli: markdownlint-cli2  "**/*.md" "#**/CHANGELOG.md"  --config .markdownlint.json
       - name: "Markdown Lint Check"
-        uses: DavidAnson/markdownlint-cli2-action@v19
+        uses: DavidAnson/markdownlint-cli2-action@v20
         continue-on-error: true
         with:
           fix: false
diff --git a/.instrumentation_generator/templates/Readme.md.tt b/.instrumentation_generator/templates/Readme.md.tt
@@ -32,7 +32,7 @@ end
 
 ## Examples
 
-Example usage can be seen in the `./example/trace_demonstration.rb` file [here](https://github.com/open-telemetry/opentelemetry-ruby-contrib/blob/main/instrumentation/<%= instrumentation_name %>/example/trace_demonstration.rb)
+Example usage can be seen in the [`./example/trace_demonstration.rb` file](https://github.com/open-telemetry/opentelemetry-ruby-contrib/blob/main/instrumentation/<%= instrumentation_name %>/example/trace_demonstration.rb)
 
 ## How can I get involved?
 
diff --git a/README.md b/README.md
@@ -92,7 +92,7 @@ Consult instrumentation gem's README file and gemspec for details about library
 
 ### Releases
 
-This repository was extracted from the [OpenTelemetry Ruby repository][otel-ruby]. Versions of libraries contained in this repo released prior to 2022-06-13 are available on the [OpenTelemetry Ruby Releases][otel-ruby-releases] page. Newer versions are available [here][otel-ruby-contrib-releases]
+This repository was extracted from the [OpenTelemetry Ruby repository][otel-ruby]. Versions of libraries contained in this repo released prior to 2022-06-13 are available on the [OpenTelemetry Ruby Releases][otel-ruby-releases] page. Newer versions are available [on the opentelemetry-ruby-contrib Releases page][otel-ruby-contrib-releases].
 
 ## Useful links
 
diff --git a/instrumentation/README.md b/instrumentation/README.md
@@ -8,7 +8,7 @@ Instrumentation libraries provide pre-built OpenTelemetry instrumentation for po
 
 Released instrumentations can be found at the [OpenTelemetry registry](https://opentelemetry.io/registry/?language=ruby&component=instrumentation#).  You can also look in this project's Github repository: Individual instrumentation libraries can be found in subdirectories under `/instrumentation`.
 
-In-progress instrumentations can be found [here](https://github.com/open-telemetry/opentelemetry-ruby-contrib/issues?q=is%3Aopen+label%3Ainstrumentation+-label%3A%22help+wanted%22+).
+[In-progress instrumentations can be found here](https://github.com/open-telemetry/opentelemetry-ruby-contrib/issues?q=is%3Aopen+label%3Ainstrumentation+-label%3A%22help+wanted%22+).
 
 ## How do I get started?
 
@@ -49,7 +49,7 @@ Please review the individual instrumentation READMEs for more information about
 
 The source for all OpenTelemetry Ruby instrumentation gems is [on github](https://github.com/open-telemetry/opentelemetry-ruby-contrib/tree/main/instrumentation).
 
-If you are interested in helping out with an instrumentation, you can see instrumentations that have been requested but are not currently in-progress [here](https://github.com/open-telemetry/opentelemetry-ruby-contrib/issues?q=is%3Aopen+label%3Ainstrumentation+label%3A%22help+wanted%22).
+If you are interested in helping out with an instrumentation, check out [instrumentations that have been requested but are not currently in-progress](https://github.com/open-telemetry/opentelemetry-ruby-contrib/issues?q=is%3Aopen+label%3Ainstrumentation+label%3A%22help+wanted%22).
 
 The OpenTelemetry Ruby gems are maintained by the OpenTelemetry Ruby special interest group (SIG). You can get involved by joining us on our [GitHub Discussions][discussions-url], [Slack Channel][slack-channel] or attending our weekly meeting. See the [meeting calendar][community-meetings] for dates and times. For more information on this and other language SIGs, see the OpenTelemetry [community page][ruby-sig].
 
diff --git a/instrumentation/action_mailer/README.md b/instrumentation/action_mailer/README.md
@@ -91,7 +91,7 @@ Internal spans are named using the name of the `ActiveSupport` event that was pr
 
 ## Examples
 
-Example usage can be seen in the `./example/trace_request_demonstration.ru` file [here](https://github.com/open-telemetry/opentelemetry-ruby-contrib/blob/main/instrumentation/action_mailer/example/trace_request_demonstration.ru)
+Example usage can be seen in the [`./example/trace_request_demonstration.ru` file](https://github.com/open-telemetry/opentelemetry-ruby-contrib/blob/main/instrumentation/action_mailer/example/trace_request_demonstration.ru)
 
 ## How can I get involved?
 
diff --git a/instrumentation/action_pack/README.md b/instrumentation/action_pack/README.md
@@ -69,7 +69,7 @@ The error object will be retained within `payload[:exception_object]`. Additiona
 
 ## Examples
 
-Example usage can be seen in the `./example/trace_demonstration.rb` file [here](https://github.com/open-telemetry/opentelemetry-ruby-contrib/blob/main/instrumentation/action_pack/example/trace_demonstration.ru)
+Example usage can be seen in the [`./example/trace_demonstration.rb` file](https://github.com/open-telemetry/opentelemetry-ruby-contrib/blob/main/instrumentation/action_pack/example/trace_demonstration.ru)
 
 ## How can I get involved?
 
diff --git a/instrumentation/action_view/README.md b/instrumentation/action_view/README.md
@@ -34,7 +34,7 @@ end
 
 ## Examples
 
-Example usage can be seen in the `./example/trace_request_demonstration.ru` file [here](https://github.com/open-telemetry/opentelemetry-ruby-contrib/blob/main/instrumentation/action_view/example/trace_request_demonstration.ru)
+Example usage can be seen in the [`./example/trace_request_demonstration.ru` file](https://github.com/open-telemetry/opentelemetry-ruby-contrib/blob/main/instrumentation/action_view/example/trace_request_demonstration.ru)
 
 ## Known issues
 
diff --git a/instrumentation/active_job/README.md b/instrumentation/active_job/README.md
@@ -90,7 +90,7 @@ In order to preserve this behavior you will have to update the span yourself, e.
 
 ## Examples
 
-Example usage can be seen in the `./example/active_job.rb` file [here](https://github.com/open-telemetry/opentelemetry-ruby-contrib/blob/main/instrumentation/active_job/example/active_job.rb)
+Example usage can be seen in the [`./example/active_job.rb` file](https://github.com/open-telemetry/opentelemetry-ruby-contrib/blob/main/instrumentation/active_job/example/active_job.rb)
 
 ## How can I get involved?
 
diff --git a/instrumentation/active_model_serializers/README.md b/instrumentation/active_model_serializers/README.md
@@ -32,7 +32,7 @@ end
 
 ## Examples
 
-Example usage of active_model_serializers can be seen in the `./example/` folder [here](https://github.com/open-telemetry/opentelemetry-ruby-contrib/tree/main/instrumentation/active_model_serializers/example)
+Example usage of active_model_serializers can be seen [in the `./example/` folder](https://github.com/open-telemetry/opentelemetry-ruby-contrib/tree/main/instrumentation/active_model_serializers/example)
 
 ## How can I get involved?
 
diff --git a/instrumentation/active_record/README.md b/instrumentation/active_record/README.md
@@ -32,7 +32,7 @@ end
 
 ## Examples
 
-Example usage can be seen in the `./example/trace_demonstration.rb` file [here](https://github.com/open-telemetry/opentelemetry-ruby-contrib/blob/main/instrumentation/active_record/example/trace_demonstration.rb)
+Example usage can be seen in the [`./example/trace_demonstration.rb` file](https://github.com/open-telemetry/opentelemetry-ruby-contrib/blob/main/instrumentation/active_record/example/trace_demonstration.rb)
 
 ## How can I get involved?
 
diff --git a/instrumentation/active_storage/README.md b/instrumentation/active_storage/README.md
@@ -75,7 +75,7 @@ Attributes attached to each event payload are prefixed with `active_storage.` (e
 
 ## Examples
 
-Example usage can be seen in the `./example/trace_demonstration.rb` file [here](https://github.com/open-telemetry/opentelemetry-ruby-contrib/blob/main/instrumentation/active_storage/example/trace_demonstration.rb)
+Example usage can be seen in the [`./example/trace_demonstration.rb` file](https://github.com/open-telemetry/opentelemetry-ruby-contrib/blob/main/instrumentation/active_storage/example/trace_demonstration.rb)
 
 ## How can I get involved?
 
diff --git a/instrumentation/active_support/README.md b/instrumentation/active_support/README.md
@@ -42,7 +42,7 @@ end
 
 ## Examples
 
-Example usage can be seen in the `./example/trace_demonstration.rb` file [here](https://github.com/open-telemetry/opentelemetry-ruby-contrib/blob/main/instrumentation/active_support/example/trace_demonstration.rb)
+Example usage can be seen in the [`./example/trace_demonstration.rb` file](https://github.com/open-telemetry/opentelemetry-ruby-contrib/blob/main/instrumentation/active_support/example/trace_demonstration.rb)
 
 ## How can I get involved?
 
diff --git a/instrumentation/bunny/README.md b/instrumentation/bunny/README.md
@@ -32,7 +32,7 @@ end
 
 ## Examples
 
-Example usage can be seen in the `./example/bunny.rb` file [here](https://github.com/open-telemetry/opentelemetry-ruby-contrib/blob/main/instrumentation/bunny/example/bunny.rb)
+Example usage can be seen in the [`./example/bunny.rb` file](https://github.com/open-telemetry/opentelemetry-ruby-contrib/blob/main/instrumentation/bunny/example/bunny.rb)
 
 ## How can I get involved?
 
diff --git a/instrumentation/dalli/CHANGELOG.md b/instrumentation/dalli/CHANGELOG.md
@@ -1,5 +1,9 @@
 # Release History: opentelemetry-instrumentation-dalli
 
+### v0.27.3 / 2025-05-27
+
+* FIXED: Compact Dalli attributes
+
 ### v0.27.2 / 2025-04-30
 
 * FIXED: Do not pollute the `OpenTelemetry::Instrumentation` namespace
diff --git a/instrumentation/dalli/lib/opentelemetry/instrumentation/dalli/version.rb b/instrumentation/dalli/lib/opentelemetry/instrumentation/dalli/version.rb
@@ -7,7 +7,7 @@
 module OpenTelemetry
   module Instrumentation
     module Dalli
-      VERSION = '0.27.2'
+      VERSION = '0.27.3'
     end
   end
 end
diff --git a/instrumentation/delayed_job/README.md b/instrumentation/delayed_job/README.md
@@ -32,7 +32,7 @@ end
 
 ## Examples
 
-Example usage of delayed_job can be seen in the `./example/delayed_job.rb` file [here](https://github.com/open-telemetry/opentelemetry-ruby-contrib/blob/main/instrumentation/delayed_job/example/delayed_job.rb)
+Example usage of delayed_job can be seen in the [`./example/delayed_job.rb` file](https://github.com/open-telemetry/opentelemetry-ruby-contrib/blob/main/instrumentation/delayed_job/example/delayed_job.rb)
 
 ## How can I get involved?
 
diff --git a/instrumentation/ethon/README.md b/instrumentation/ethon/README.md
@@ -32,7 +32,7 @@ end
 
 ## Examples
 
-Example usage of faraday can be seen in the `./example/ethon.rb` file [here](https://github.com/open-telemetry/opentelemetry-ruby-contrib/blob/main/instrumentation/ethon/example/ethon.rb)
+Example usage of faraday can be seen in the [`./example/ethon.rb` file](https://github.com/open-telemetry/opentelemetry-ruby-contrib/blob/main/instrumentation/ethon/example/ethon.rb)
 
 ## How can I get involved?
 
diff --git a/instrumentation/faraday/README.md b/instrumentation/faraday/README.md
@@ -18,7 +18,9 @@ To install the instrumentation, call `use` with the name of the instrumentation.
 
 ```ruby
 OpenTelemetry::SDK.configure do |c|
-  c.use 'OpenTelemetry::Instrumentation::Faraday'
+  c.use 'OpenTelemetry::Instrumentation::Faraday', {
+    enable_internal_instrumentation: false
+  }
 end
 ```
 
@@ -30,9 +32,14 @@ OpenTelemetry::SDK.configure do |c|
 end
 ```
 
+### Configuration options
+This instrumentation offers the following configuration options: 
+* `enable_internal_instrumentation` (default: `false`): When set to `true`, any spans with 
+ span kind of `internal` are included in traces.
+
 ## Examples
 
-Example usage of faraday can be seen in the `./example/faraday.rb` file [here](https://github.com/open-telemetry/opentelemetry-ruby-contrib/blob/main/instrumentation/faraday/example/faraday.rb)
+Example usage of faraday can be seen in the [`./example/faraday.rb` file](https://github.com/open-telemetry/opentelemetry-ruby-contrib/blob/main/instrumentation/faraday/example/faraday.rb)
 
 ## How can I get involved?
 
diff --git a/instrumentation/faraday/lib/opentelemetry/instrumentation/faraday/instrumentation.rb b/instrumentation/faraday/lib/opentelemetry/instrumentation/faraday/instrumentation.rb
@@ -28,6 +28,7 @@ class Instrumentation < OpenTelemetry::Instrumentation::Base
 
         option :span_kind, default: :client, validate: %i[client internal]
         option :peer_service, default: nil, validate: :string
+        option :enable_internal_instrumentation, default: false, validate: :boolean
 
         private
 
diff --git a/instrumentation/faraday/lib/opentelemetry/instrumentation/faraday/middlewares/tracer_middleware.rb b/instrumentation/faraday/lib/opentelemetry/instrumentation/faraday/middlewares/tracer_middleware.rb
@@ -40,7 +40,13 @@ def call(env)
               ) do |span|
                 OpenTelemetry.propagation.inject(env.request_headers)
 
-                app.call(env).on_complete { |resp| trace_response(span, resp.status) }
+                if config[:enable_internal_instrumentation] == false
+                  OpenTelemetry::Common::Utilities.untraced do
+                    app.call(env).on_complete { |resp| trace_response(span, resp.status) }
+                  end
+                else
+                  app.call(env).on_complete { |resp| trace_response(span, resp.status) }
+                end
               rescue ::Faraday::Error => e
                 trace_response(span, e.response[:status]) if e.response
 
diff --git a/instrumentation/grape/README.md b/instrumentation/grape/README.md
@@ -2,7 +2,7 @@
 
 The Grape instrumentation is a community-maintained instrumentation for [Grape][grape], a REST-like API framework for Ruby.
 
-It relies on the Grape built-in support for `ActiveSupport::Notifications` (more info [here](https://github.com/ruby-grape/grape#active-support-instrumentation)) and the [OpenTelemetry Rack instrumentation](https://github.com/open-telemetry/opentelemetry-ruby-contrib/tree/opentelemetry-instrumentation-rack/v0.24.6/instrumentation/rack).
+It relies on the [Grape built-in support for `ActiveSupport::Notifications`](https://github.com/ruby-grape/grape#active-support-instrumentation) and the [OpenTelemetry Rack instrumentation](https://github.com/open-telemetry/opentelemetry-ruby-contrib/tree/opentelemetry-instrumentation-rack/v0.24.6/instrumentation/rack).
 
 It currently supports the following events:
 
@@ -69,7 +69,7 @@ end
 
 ## Examples
 
-Example usage can be seen in the `./example/trace_demonstration.rb` file [here](https://github.com/open-telemetry/opentelemetry-ruby-contrib/blob/main/instrumentation/grape/example/trace_demonstration.rb)
+Example usage can be seen in the [`./example/trace_demonstration.rb` file](https://github.com/open-telemetry/opentelemetry-ruby-contrib/blob/main/instrumentation/grape/example/trace_demonstration.rb)
 
 ## How can I get involved?
 
diff --git a/instrumentation/grpc/README.md b/instrumentation/grpc/README.md
@@ -43,7 +43,7 @@ instrumentation.
 
 ## Examples
 
-Example usage can be seen in the `./example/trace_demonstration.rb` file [here](https://github.com/open-telemetry/opentelemetry-ruby-contrib/blob/main/instrumentation/grpc/example/trace_demonstration.rb)
+Example usage can be seen in the [`./example/trace_demonstration.rb` file](https://github.com/open-telemetry/opentelemetry-ruby-contrib/blob/main/instrumentation/grpc/example/trace_demonstration.rb)
 
 ## Development
 
diff --git a/instrumentation/gruf/README.md b/instrumentation/gruf/README.md
@@ -37,7 +37,7 @@ end
 
 ## Examples
 
-Example usage can be seen in the `./example/trace_demonstration.rb` file [here](https://github.com/open-telemetry/opentelemetry-ruby-contrib/blob/main/instrumentation/gruf/example/trace_demonstration.rb)
+Example usage can be seen in the [`./example/trace_demonstration.rb` file](https://github.com/open-telemetry/opentelemetry-ruby-contrib/blob/main/instrumentation/gruf/example/trace_demonstration.rb)
 
 ## How can I get involved?
 
diff --git a/instrumentation/http/README.md b/instrumentation/http/README.md
@@ -44,7 +44,7 @@ end
 
 ## Examples
 
-Example usage can be seen in the `./example/trace_demonstration.rb` file [here](https://github.com/open-telemetry/opentelemetry-ruby-contrib/blob/main/instrumentation/http/example/trace_demonstration.rb)
+Example usage can be seen in the [`./example/trace_demonstration.rb` file](https://github.com/open-telemetry/opentelemetry-ruby-contrib/blob/main/instrumentation/http/example/trace_demonstration.rb)
 
 ## How can I get involved?
 
diff --git a/instrumentation/http_client/README.md b/instrumentation/http_client/README.md
@@ -32,7 +32,7 @@ end
 
 ## Examples
 
-Example usage can be seen in the `./example/trace_demonstration.rb` file [here](https://github.com/open-telemetry/opentelemetry-ruby-contrib/blob/main/instrumentation/http_client/example/trace_demonstration.rb)
+Example usage can be seen in the [`./example/trace_demonstration.rb` file](https://github.com/open-telemetry/opentelemetry-ruby-contrib/blob/main/instrumentation/http_client/example/trace_demonstration.rb)
 
 ## How can I get involved?
 
diff --git a/instrumentation/koala/README.md b/instrumentation/koala/README.md
@@ -33,7 +33,7 @@ end
 
 ## Examples
 
-Example usage can be seen in the `./example/trace_demonstration.rb` file [here](https://github.com/open-telemetry/opentelemetry-ruby-contrib/blob/main/instrumentation/koala/example/trace_demonstration.rb)
+Example usage can be seen in the [`./example/trace_demonstration.rb` file](https://github.com/open-telemetry/opentelemetry-ruby-contrib/blob/main/instrumentation/koala/example/trace_demonstration.rb)
 
 ## How can I get involved?
 
diff --git a/instrumentation/mongo/Appraisals b/instrumentation/mongo/Appraisals
@@ -4,6 +4,6 @@
 #
 # SPDX-License-Identifier: Apache-2.0
 
-appraise 'mongo-2.13' do
-  gem 'mongo', '~> 2.13.0'
+appraise 'mongo-2' do
+  gem 'mongo', '~> 2.13'
 end
diff --git a/instrumentation/mongo/test/opentelemetry/instrumentation/mongo/subscriber_test.rb b/instrumentation/mongo/test/opentelemetry/instrumentation/mongo/subscriber_test.rb
@@ -380,7 +380,7 @@ module MongoTraceTest
       _(span.events[0].name).must_equal 'exception'
       _(span.events[0].timestamp).must_be_kind_of Integer
       _(span.events[0].attributes['exception.type']).must_equal 'CommandFailed'
-      _(span.events[0].attributes['exception.message']).must_equal 'ns not found (26)'
+      _(span.events[0].attributes['exception.message']).must_equal '[26:NamespaceNotFound]: ns not found'
     end
 
     describe 'that triggers #failed before #started' do
@@ -402,7 +402,8 @@ module MongoTraceTest
         database: TestHelper.database,
         auth_mech: :plain,
         user: 'plain_user',
-        password: 'plain_pass'
+        password: 'plain_pass',
+        auth_source: '$external'
       }
     end
 
diff --git a/instrumentation/racecar/README.md b/instrumentation/racecar/README.md
@@ -36,7 +36,7 @@ end
 
 ## Examples
 
-Example usage can be seen in the `./example` directory [here](https://github.com/open-telemetry/opentelemetry-ruby-contrib/blob/main/instrumentation/racecar/example). Run `./trace_demonstration.sh` to see its behaviour.
+Example usage can be seen in the [`./example` directory](https://github.com/open-telemetry/opentelemetry-ruby-contrib/blob/main/instrumentation/racecar/example). Run `./trace_demonstration.sh` to see its behaviour.
 
 ## How can I get involved?
 
diff --git a/instrumentation/rack/README.md b/instrumentation/rack/README.md
@@ -81,7 +81,7 @@ end
 
 ## Examples
 
-Example usage can be seen in the `./example/trace_demonstration.rb` file [here](https://github.com/open-telemetry/opentelemetry-ruby-contrib/blob/main/instrumentation/rack/example/trace_demonstration.rb)
+Example usage can be seen in the [`./example/trace_demonstration.rb` file](https://github.com/open-telemetry/opentelemetry-ruby-contrib/blob/main/instrumentation/rack/example/trace_demonstration.rb)
 
 ## How can I get involved?
 
diff --git a/instrumentation/rails/README.md b/instrumentation/rails/README.md
@@ -64,7 +64,7 @@ end
 
 ## Examples
 
-Example usage can be seen in the `./example/trace_demonstration.rb` file [here](https://github.com/open-telemetry/opentelemetry-ruby-contrib/blob/main/instrumentation/rails/example/trace_request_demonstration.ru)
+Example usage can be seen in the [`./example/trace_demonstration.rb` file](https://github.com/open-telemetry/opentelemetry-ruby-contrib/blob/main/instrumentation/rails/example/trace_request_demonstration.ru)
 
 ## How can I get involved?
 
diff --git a/instrumentation/rake/README.md b/instrumentation/rake/README.md
@@ -32,7 +32,7 @@ end
 
 ## Examples
 
-Example usage can be seen in the `./example/trace_demonstration.rb` file [here](https://github.com/open-telemetry/opentelemetry-ruby-contrib/blob/opentelemetry-instrumentation-rake/v0.2.2/instrumentation/rake/example/trace_demonstration.rb)
+Example usage can be seen in the [`./example/trace_demonstration.rb` file](https://github.com/open-telemetry/opentelemetry-ruby-contrib/blob/opentelemetry-instrumentation-rake/v0.2.2/instrumentation/rake/example/trace_demonstration.rb)
 
 ## How can I get involved?
 
diff --git a/instrumentation/rake/lib/opentelemetry/instrumentation/rake/patches/task.rb b/instrumentation/rake/lib/opentelemetry/instrumentation/rake/patches/task.rb
@@ -29,7 +29,11 @@ def tracer
           end
 
           def force_flush
-            OpenTelemetry.tracer_provider.force_flush if ::Rake.application.top_level_tasks.include?(name)
+            top_level_task_names = ::Rake.application.top_level_tasks.map { |t| t.split('[').first }
+
+            if top_level_task_names.include?(name)
+              OpenTelemetry.tracer_provider.force_flush
+            end
           end
         end
       end
diff --git a/instrumentation/rake/test/opentelemetry/instrumentation/rake/patches/task_test.rb b/instrumentation/rake/test/opentelemetry/instrumentation/rake/patches/task_test.rb
@@ -56,6 +56,25 @@
       _(execute_span.parent_span_id).must_equal(invoke_span.span_id)
     end
 
+    describe 'with a task argument' do
+      it 'should call force_flush on OpenTelemetry.tracer_provider' do
+        mock = Minitest::Mock.new
+        mock.expect(:force_flush, nil)
+        mock.expect(:force_flush, nil)
+
+        Rake::Task.define_task("#{task_name}[:arg]")
+        task_string = "#{task_name}[test_arg]"
+
+        Rake.application.instance_eval { @top_level_tasks = [task_string] }
+
+        OpenTelemetry.stub(:tracer_provider, mock) do
+          Rake.application.invoke_task(task_string)
+        end
+
+        mock.verify
+      end
+    end
+
     describe 'with a prerequisite task' do
       before do
         Rake::Task.define_task(prerequisite_task_name)
diff --git a/instrumentation/rdkafka/README.md b/instrumentation/rdkafka/README.md
@@ -32,7 +32,7 @@ end
 
 ## Examples
 
-Example usage can be seen in the `./example/rdkafka_trace_demonstration.rb` file [here](https://github.com/open-telemetry/opentelemetry-ruby-contrib/blob/main/instrumentation/rdkafka/example/rdkafka_trace_demonstration.rb)
+Example usage can be seen in the [`./example/rdkafka_trace_demonstration.rb` file](https://github.com/open-telemetry/opentelemetry-ruby-contrib/blob/main/instrumentation/rdkafka/example/rdkafka_trace_demonstration.rb)
 
 ## How can I get involved?
 
diff --git a/instrumentation/resque/README.md b/instrumentation/resque/README.md
diff --git a/instrumentation/rspec/README.md b/instrumentation/rspec/README.md
diff --git a/instrumentation/ruby_kafka/README.md b/instrumentation/ruby_kafka/README.md
diff --git a/instrumentation/sidekiq/README.md b/instrumentation/sidekiq/README.md
