docs: upgrade http example (#1932)

* docs: upgrade http example

Fix broken links and use the latest span attributes

* use the semantic conventions package instead of hard-coding attributes

Author: bellvat

examples/http/client.rb

@@ -9,6 +9,8 @@
 require 'faraday'
 # Require otel-ruby
 require 'opentelemetry/sdk'
+require 'opentelemetry/semconv/http'
+require 'opentelemetry/semconv/url'
 
 # Export traces to console by default
 ENV['OTEL_TRACES_EXPORTER'] ||= 'console'
@@ -26,14 +28,14 @@
 url = '/hello'
 
 # For attribute naming, see:
-# https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/trace/semantic_conventions/http.md
+# https://github.com/open-telemetry/semantic-conventions/blob/main/docs/http/http-spans.md#http-client-span
 
 # Span name should be set to URI path value:
 tracer.in_span(
   url,
   attributes: {
-    'component' => 'http',
-    'http.method' => 'GET',
+    OpenTelemetry::SemConv::URL::URL_SCHEME => 'http',
+    OpenTelemetry::SemConv::HTTP::HTTP_REQUEST_METHOD => 'GET',
   },
   kind: :client
 ) do |span|
@@ -42,6 +44,6 @@
     OpenTelemetry.propagation.inject(request.headers)
   end
 
-  span.set_attribute('http.url', response.env.url.to_s)
-  span.set_attribute('http.status_code', response.status)
+  span.set_attribute(OpenTelemetry::SemConv::URL::URL_FULL, response.env.url.to_s)
+  span.set_attribute(OpenTelemetry::SemConv::HTTP::HTTP_RESPONSE_STATUS_CODE, response.status)
 end

examples/http/server.rb

@@ -10,6 +10,8 @@
 require 'sinatra/base'
 # Require otel-ruby
 require 'opentelemetry/sdk'
+require 'opentelemetry/semconv/http'
+require 'opentelemetry/semconv/url'
 
 # Export traces to console by default
 ENV['OTEL_TRACES_EXPORTER'] ||= 'console'
@@ -38,25 +40,25 @@ def call(env)
     span_name = env['PATH_INFO']
 
     # For attribute naming, see
-    # https://github.com/open-telemetry/opentelemetry-specification/blob/master/specification/data-semantic-conventions.md#http-server
+    # https://github.com/open-telemetry/semantic-conventions/blob/main/docs/http/http-spans.md#http-server
 
     # Activate the extracted context
     OpenTelemetry::Context.with_current(context) do
       # Span kind MUST be `:server` for a HTTP server span
       @tracer.in_span(
         span_name,
         attributes: {
-          'component' => 'http',
-          'http.method' => env['REQUEST_METHOD'],
-          'http.route' => env['PATH_INFO'],
-          'http.url' => env['REQUEST_URI'],
+          OpenTelemetry::SemConv::URL::URL_SCHEME => 'http',
+          OpenTelemetry::SemConv::HTTP::HTTP_REQUEST_METHOD => env['REQUEST_METHOD'],
+          OpenTelemetry::SemConv::HTTP::HTTP_ROUTE => env['PATH_INFO'],
+          OpenTelemetry::SemConv::URL::URL_PATH => env['REQUEST_URI'],
         },
         kind: :server
       ) do |span|
         # Run application stack
         status, headers, response_body = @app.call(env)
 
-        span.set_attribute('http.status_code', status)
+        span.set_attribute(OpenTelemetry::SemConv::HTTP::HTTP_RESPONSE_STATUS_CODE, status)
       end
     end