aws-xray 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 44943f3ac93283072875bfa94985b9aa76828628
-  data.tar.gz: 7c58541a4ba68f4b7968505029229b1f2abb0c76
+  metadata.gz: 7205283919522f3fa51c16bc8e5f11136ba04a9c
+  data.tar.gz: 0fa4f411671929e4c436939d190afa7fd48e181e
 SHA512:
-  metadata.gz: e266ce6f924d71c447e1ca64775efbf55de67523965b3c805eb8fac5e9c99f936590857765156a8a8333ccf4d32a6cbcd0a04519220fcd5a7cd67315ff06f0b4
-  data.tar.gz: 1988b22141c57f19b2bb3963b2f691dbbcd8ecb6a08bdeb3037e4dfee0a20193d28c8f6899a82f7257d762eeb5a89113b382dbf1d97e9b7ab976a2c4a24221d4
+  metadata.gz: 9c4aea978c59e664b39d10ca7df5c57c8537069fff4df2196b7e3213fa71c990a66e05cd6e0c816a95311d03e9ace2614ecddcad036e5b04c892f78ca51b1e1e
+  data.tar.gz: 6519acd350a5c0a6ceddad31bdd54db472466cf35bc4d5e044404e4290475607296e9b820c64e40d1099307b715fb927ccf53c5a029b249f69531ee2cacf9a4d

data/README.md

@@ -1,4 +1,4 @@
-# Aws::Xray
+# aws-xray
 [![Build Status](https://travis-ci.org/taiki45/aws-xray.svg?branch=master)](https://travis-ci.org/taiki45/aws-xray)
 [![Gem Version](https://badge.fury.io/rb/aws-xray.svg)](https://badge.fury.io/rb/aws-xray)
 
@@ -7,18 +7,13 @@ It enables you to capture in-coming HTTP requests and out-going HTTP requests an
 
 AWS X-Ray is a ditributed tracing system. See more detail about AWS X-Ray at [official document](http://docs.aws.amazon.com/xray/latest/devguide/aws-xray.html).
 
-## Current status
-Implemented:
-
+## Features
 - Rack middleware.
 - Faraday middleware.
 - Propagatin support limited in single thread environment.
-
-Not yet:
-
 - Tracing HTTP request/response.
-- Multi thread support.
 - Tracing errors.
+- Annotation and metadata support.
 
 ## Installation
 
@@ -33,10 +28,32 @@ And then execute:
     $ bundle
 
 ## Usage
+### Rails app
+Insert Rack middleware by yourself:
+
+```
+# config/initializers/aws_xray.rb
+Aws::Xray.config.name = 'my-app'
+Rails.application.config.middleware.use Aws::Xray::Rack
+```
+
+Or just require `aws/xray/rails`:
+
+```ruby
+# Gemfile
+gem 'aws-xray', require: 'aws/xray/rails'
+
+# config/initializers/aws_xray.rb
+Aws::Xray.config.name = 'my-app'
+```
+
+To trace out-going HTTP requests, see below.
+
 ### Rack app
 ```ruby
 # config.ru
 require 'aws-xray'
+Aws::Xray.config.name = 'my-app'
 use Aws::Xray::Rack
 ```
 
@@ -62,6 +79,9 @@ end
 
 ### non-Rack app (like background jobs)
 ```ruby
+require 'aws-xray'
+Aws::Xray.config.name = 'my-app'
+
 # Build HTTP client with Faraday builder.
 # You can set the down stream app id to Host header as well.
 client = Faraday.new('...') do |builder|
@@ -81,6 +101,35 @@ Aws::Xray::Context.with_new_context('test-app', xray_client, trace_header) do
 end
 ```
 
+## Configurations
+### Recording pplication version
+aws-xray automatically tries to set application version by reading `app_root/REVISION` file.
+If you want to set another version, set it with:
+
+```ruby
+# In initialization phase.
+Aws::Xray.config.version = 'deadbeef'
+```
+
+### Default annotation and metadata
+aws-xray records hostname by default.
+
+If you want to record specific annotation in all of your segments, configure like:
+
+```ruby
+Aws::Xray.config.default_annotation = Aws::Xray.config.default_annotation.merge(key: 'value')
+```
+
+Keys must be alphanumeric characters with underscore and values must be one of String or Integer or Boolean values.
+
+For meta data:
+
+```ruby
+Aws::Xray.config.default_metadata = Aws::Xray.config.default_metadata.merge(key: ['some', 'meaningful', 'value'])
+```
+
+Note: See official document to know what annotation and metadata are in AWS X-Ray.
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. You can also run `bin/console` for an interactive prompt that will allow you to experiment.

data/TODO.md

@@ -0,0 +1,25 @@
+Enbed user information to segment:
+
+```ruby
+# In configuration phase
+use Aws::Xray::Rack, capture_user_data: ->(env) { env['X-User-Id'] }
+
+# Implementation image:
+class Rack
+  def call(env)
+    @app.call(env)
+    capture_user_data.call(env)
+  end
+```
+
+---
+
+`aws` field. Especially EC2 and ECS field.
+
+---
+
+Send in_progress segment.
+
+---
+
+`precursor_ids`.

data/example/Gemfile

@@ -5,3 +5,4 @@ gem 'rack'
 gem 'aws-xray', path: File.expand_path('../', __dir__)
 
 gem 'foreman'
+gem 'pry-byebug'

data/example/REVISION

@@ -0,0 +1 @@
+deadbeef

data/example/campain_app_config.ru

@@ -1,7 +1,18 @@
+require 'pry'
 require 'aws-xray'
 
 use Aws::Xray::Rack, name: 'campain-app'
 
+class DbConnectionError < StandardError
+  def initialize
+    super('Could not connect to DB')
+  end
+end
+
 run Proc.new {|env|
-  ['200', {'Content-Type' => 'text/plain'}, ['0']]
+  if rand(0..1) == 0
+    raise DbConnectionError
+  else
+    ['200', {'Content-Type' => 'text/plain'}, ['0']]
+  end
 }

data/example/fron_app_config.ru

@@ -1,3 +1,4 @@
+require 'pry'
 require 'faraday'
 require 'aws-xray'
 

data/example/recipe_app_config.ru

@@ -1,3 +1,4 @@
+require 'pry'
 require 'faraday'
 require 'aws-xray'
 

data/example/user_app_config.ru

@@ -1,3 +1,4 @@
+require 'pry'
 require 'aws-xray'
 
 use Aws::Xray::Rack, name: 'user-app'

data/lib/aws/xray/annotation_validator.rb

@@ -0,0 +1,16 @@
+module Aws
+  module Xray
+    module AnnotationValidator
+      extend self
+
+      # @param [Hash] h annotation hash.
+      # @raise RuntimeError
+      def call(h)
+        invalid_keys = h.keys.reject {|k| k.to_s.match(/\A[A-Za-z0-9_]+\z/) }
+        raise 'Keys must be alphanumeric and underscore string' unless invalid_keys.empty?
+        invalid_values = h.values.reject {|v| v.is_a?(String) || v.is_a?(Integer) || (v == true || v == false) }
+        raise 'Values must be one of String or Integer or Boolean values' unless invalid_values.empty?
+      end
+    end
+  end
+end

data/lib/aws/xray/cause.rb

@@ -0,0 +1,46 @@
+module Aws
+  module Xray
+    class Cause
+      MAX_BACKTRACE_SIZE = 10
+
+      def initialize(stack: [], message: nil, type: nil)
+        @id = SecureRandom.hex(8)
+        @working_directory = Dir.pwd
+        @stack = stack
+        @message = message
+        @type = type
+      end
+
+      def to_h(remote: false)
+        truncated, stack = build_stack(@stack, @working_directory)
+        {
+          working_directory: @working_directory,
+          paths: [],
+          exceptions: [
+            {
+              id: @id,
+              message: @message,
+              type: @type,
+              remote: remote,
+              truncated: truncated,
+              stack: stack,
+            },
+        ],
+        }
+      end
+
+      def build_stack(stack, dir)
+        truncated = [stack.size - MAX_BACKTRACE_SIZE, 0].max
+        stack = stack[0..MAX_BACKTRACE_SIZE - 1].map do |s|
+          file, line, method_name = s.split(':')
+          {
+            path: file.sub(dir, ''),
+            line: line,
+            label: method_name,
+          }
+        end
+        return truncated, stack
+      end
+    end
+  end
+end

data/lib/aws/xray/client.rb

@@ -7,15 +7,15 @@ module Aws
       #
       # XXX: keep options for implmenting copying later.
       def initialize(host: '127.0.0.1', port: 2000, sock: nil)
-        @options = { host: host, port: port }
-        @sock = sock || Addrinfo.udp(host, port).connect
+        @host, @port = host, port
+        @sock = sock || UDPSocket.new
       end
 
       # @param [Aws::Xray::Segment] segment
       def send_segment(segment)
         segment.finish
         payload = %!{"format": "json", "version": 1}\n#{segment.to_json}\n!
-        len = @sock.send(payload, 0)
+        len = @sock.send(payload, 0, @host, @port)
         # TODO: retry
         if payload.size != len
           $stderr.puts("Can not send all bytes: #{len} sent")

data/lib/aws/xray/configuration.rb

@@ -0,0 +1,57 @@
+require 'socket'
+require 'aws/xray/annotation_validator'
+
+module Aws
+  module Xray
+    # thread-unsafe, suppose to be used only in initialization phase.
+    class Configuration
+      # @return [String] name Logical service name for this application.
+      attr_accessor :name
+
+      # @return [Hash] client_options For xray-agent client.
+      #   - host: e.g. '127.0.0.1'
+      #   - port: e.g. 2000
+      #   - sock: test purpose.
+      def client_options
+        @client_options ||= { host: '127.0.0.1', port: 2000 }
+      end
+      attr_writer :client_options
+
+      # @return [String]
+      def version
+        @version ||= VersionDetector.new.call
+      end
+      # @param [String,Proc] version A String or callable object which returns application version.
+      #   Default version detection tries to solve with `app_root/REVISION` file.
+      def version=(v)
+        @version = v.respond_to?(:call) ? v.call : v
+      end
+
+      DEFAULT_ANNOTATION = {
+        hostname: Socket.gethostname,
+      }.freeze
+      # @return [Hash] default annotation with key-value format.
+      def default_annotation
+        @default_annotation ||= DEFAULT_ANNOTATION
+      end
+      # @param [Hash] h default annotation Hash.
+      def default_annotation=(annotation)
+        AnnotationValidator.call(annotation)
+        @default_annotation = annotation
+      end
+
+      DEFAULT_METADATA = {
+        tracing_sdk: {
+          name: 'aws-xray',
+          version: Aws::Xray::VERSION,
+        }
+      }.freeze
+      # @return [Hash] Default metadata.
+      def default_metadata
+        @default_metadata ||= DEFAULT_METADATA
+      end
+      # @param [Hash] metadata Default metadata.
+      attr_writer :default_metadata
+    end
+  end
+end

data/lib/aws/xray/context.rb

@@ -14,7 +14,7 @@ module Aws
         end
 
         def current
-          Thread.current[VAR_NAME] || raise(NotSetError)
+          Thread.current.thread_variable_get(VAR_NAME) || raise(NotSetError)
         end
 
         def with_new_context(name, client, trace_header)
@@ -27,12 +27,11 @@ module Aws
         private
 
         def build_current(name, client, trace_header)
-          Thread.current[VAR_NAME] = Context.new(name, client, trace_header)
+          Thread.current.thread_variable_set(VAR_NAME, Context.new(name, client, trace_header))
         end
 
-        # XXX: Use delete API if exists
         def remove_current
-          Thread.current[VAR_NAME] = nil
+          Thread.current.thread_variable_set(VAR_NAME, nil)
         end
       end
 
@@ -45,25 +44,35 @@ module Aws
         @base_segment = Segment.build(@name, trace_header)
       end
 
+      # Rescue standard errors and record the error to the segment.
+      # Then re-raise the error.
+      #
+      # @yield [Aws::Xray::Segment]
+      # @return [Object] A value which given block returns.
       def base_trace
-        res = yield
+        res = yield @base_segment
         @client.send_segment(@base_segment)
         res
       rescue => e
-        @base_segment.set_error(e)
+        @base_segment.set_error(fault: true, e: e)
         @client.send_segment(@base_segment)
         raise e
       end
 
+      # Rescue standard errors and record the error to the sub segment.
+      # Then re-raise the error.
+      #
       # @param [Boolean] remote
+      # @param [String] name Arbitrary name of the sub segment. e.g. "funccall_f".
       # @yield [Aws::Xray::SubSegment]
+      # @return [Object] A value which given block returns.
       def child_trace(remote:, name:)
         sub = SubSegment.build(@trace_header, @base_segment, remote: remote, name: name)
         res = yield sub
         @client.send_segment(sub)
         res
       rescue => e
-        sub.set_error(e)
+        sub.set_error(fault: true, e: e)
         @client.send_segment(sub)
         raise e
       end

data/lib/aws/xray/error.rb

@@ -0,0 +1,60 @@
+require 'aws/xray/cause'
+
+module Aws
+  module Xray
+    class Error < Struct.new(:error, :throttle, :fault, :e, :remote, :cause)
+      MAX_BACKTRACE_SIZE = 10
+
+      def to_h
+        h = {
+          error: error,
+          throttle: throttle,
+          fault: fault
+        }
+        if cause
+          h[:cause] = cause.to_h(remote: remote)
+        end
+        # Overwrite cause because recording exception is more important.
+        if e
+          h[:cause] = build_cause_from_exception(e, remote)
+        end
+        h
+      end
+
+      private
+
+      # TODO: Setting cause API. Downstream API's exception?
+      # TODO: paths.
+      def build_cause_from_exception(e, remote)
+        truncated, stack = build_stack(e, Dir.pwd + '/')
+        {
+          working_directory: Dir.pwd,
+          paths: [],
+          exceptions: [
+            id: SecureRandom.hex(8),
+            message: e.message,
+            type: e.class.to_s,
+            remote: remote,
+            truncated: truncated,
+            skipped: 0,
+            cause: nil,
+            stack: stack,
+          ],
+        }
+      end
+
+      def build_stack(e, dir)
+        truncated = [e.backtrace.size - MAX_BACKTRACE_SIZE, 0].max
+        stack = e.backtrace[0..MAX_BACKTRACE_SIZE - 1].map do |b|
+          file, line, method_name = b.split(':')
+          {
+            path: file.sub(dir, ''),
+            line: line,
+            label: method_name,
+          }
+        end
+        return truncated, stack
+      end
+    end
+  end
+end

data/lib/aws/xray/faraday.rb

@@ -3,22 +3,36 @@ require 'faraday'
 module Aws
   module Xray
     class Faraday < ::Faraday::Middleware
+      # @param [Object] app Faraday app.
+      # @param [String] name Logical service name for downstream API.
       def initialize(app, name = nil)
         super(app)
         @name = name
       end
 
-      # XXX: use host header?
       def call(req_env)
         name = @name || req_env.request_headers['Host'] || "unknown-request-from-#{Context.current.name}"
 
         Context.current.child_trace(remote: true, name: name) do |sub|
           propagate_trace_header = sub.generate_trace_header
           req_env.request_headers[TRACE_HEADER] = propagate_trace_header.to_header_value
-          sub.set_http_request(req_env)
+          sub.set_http_request(Request.build_from_faraday_env(req_env))
 
           @app.call(req_env).on_complete do |res_env|
-            sub.set_http_response(res_env)
+            sub.set_http_response(res_env.status, res_env.response_headers['Content-Length'])
+            case res_env.status
+            when 499
+              cause = Cause.new(stack: caller, message: 'Got 499', type: 'http_request_error')
+              sub.set_error(error: true, throttle: true, cause: cause)
+            when 400..498
+              cause = Cause.new(stack: caller, message: 'Got 4xx', type: 'http_request_error')
+              sub.set_error(error: true, cause: cause)
+            when 500..599
+              cause = Cause.new(stack: caller, message: 'Got 5xx', type: 'http_request_error')
+              sub.set_error(fault: true, remote: true, cause: cause)
+            else
+              # pass
+            end
           end
         end
       end

data/lib/aws/xray/rack.rb

@@ -1,18 +1,29 @@
 require 'aws/xray/trace_header'
 require 'aws/xray/client'
 require 'aws/xray/context'
+require 'aws/xray/version_detector'
 
 module Aws
   module Xray
     class Rack
       TRACE_ENV = 'HTTP_X_AMZN_TRACE_ID'.freeze
 
-      # XXX: excluded_paths, included_paths
-      # XXX: document about client_options
-      def initialize(app, name:, client_options: {})
+      class MissingNameError < ::StandardError
+        def initialize
+          super("`name` is empty. Configure this with `Aws::Xray.config.name = 'my-app'`.")
+        end
+      end
+
+      # TODO: excluded_paths, included_paths
+      #
+      # @param  [Hash] client_options For xray-agent client.
+      #   - host: e.g. '127.0.0.1'
+      #   - port: e.g. 2000
+      #   - sock: test purpose.
+      def initialize(app, client_options: {})
         @app = app
-        @name = name
-        @client = Client.new(client_options)
+        @name = Aws::Xray.config.name || raise(MissingNameError)
+        @client = Client.new(Aws::Xray.config.client_options.merge(client_options))
       end
 
       def call(env)
@@ -24,8 +35,10 @@ module Aws
                        end
 
         Context.with_new_context(@name, @client, trace_header) do
-          Context.current.base_trace do
+          Context.current.base_trace do |seg|
+            seg.set_http_request(Request.build_from_rack_env(env))
             status, headers, body = @app.call(env)
+            seg.set_http_response(status, headers['Content-Length'])
             headers[TRACE_HEADER] = trace_header.to_header_value
             [status, headers, body]
           end

data/lib/aws/xray/rails.rb

@@ -0,0 +1,11 @@
+require 'aws/xray'
+
+module Aws
+  module Xray
+    class Railtie < ::Rails::Railtie
+      initializer 'aws-xray.rack_middleware' do |app|
+        app.middleware.use Aws::Xray::Rack
+      end
+    end
+  end
+end

data/lib/aws/xray/request.rb

@@ -0,0 +1,28 @@
+module Aws
+  module Xray
+    attrs = [:method, :url, :user_agent, :client_ip, :x_forwarded_for, :traced]
+    class Request < Struct.new(*attrs)
+      def self.build_from_rack_env(env)
+        new(
+          env['REQUEST_METHOD'], # method
+          env['REQUEST_URI'], # url
+          env['HTTP_USER_AGENT'], # user_agent
+          env['X-Forwarded-For'], # client_ip
+          !!env['X-Forwarded-For'], # x_forwarded_for
+          false, # traced
+        )
+      end
+
+      def self.build_from_faraday_env(env)
+        new(
+          env.method.to_s.upcase, # method
+          env.url.to_s, # url
+          env.request_headers['User-Agent'], # user_agent
+          nil, # client_ip
+          false, # x_forwarded_for
+          false, # traced
+        )
+      end
+    end
+  end
+end

data/lib/aws/xray/response.rb

@@ -0,0 +1,6 @@
+module Aws
+  module Xray
+    class Response < Struct.new(:status, :length)
+    end
+  end
+end

data/lib/aws/xray/segment.rb

@@ -1,5 +1,9 @@
 require 'json'
 require 'securerandom'
+require 'aws/xray/request'
+require 'aws/xray/response'
+require 'aws/xray/error'
+require 'aws/xray/annotation_validator'
 
 module Aws
   module Xray
@@ -19,23 +23,45 @@ module Aws
         @id = SecureRandom.hex(8)
         @trace_id = trace_id
         @parent_id = parent_id
+        @version = Aws::Xray.config.version
         start
         @end_time = nil
         @http_request = nil
         @http_response = nil
         @error = nil
+        @annotation = Aws::Xray.config.default_annotation
+        @metadata = Aws::Xray.config.default_metadata
       end
 
-      # @param [Hash] env A Rack env
-      def set_http_request(env)
+      # @param [Aws::Xray::Request] request
+      def set_http_request(request)
+        @http_request = request
       end
 
-      # @param [Array] res A Rack response
-      def set_http_response(res)
+      # @param [Integer] status HTTP status
+      # @param [Integer] length Size of HTTP response body
+      def set_http_response(status, length)
+        @http_response = Response.new(status, length)
       end
 
-      def set_error(e)
-        # TODO: Set error object
+      # @param [Boolean] error Indicating that a client error occurred (response status code was 4XX Client Error).
+      # @param [Boolean] throttle Indicating that a request was throttled (response status code was 429 Too Many Requests).
+      # @param [Boolean] fault Indicating that a server error occurred (response status code was 5XX Server Error).
+      # @param [Exception] e An Exception object
+      def set_error(error: false, throttle: false, fault: false, e: nil, remote: false, cause: nil)
+        @error = Error.new(error, throttle, fault, e, remote, cause)
+      end
+
+      # @param [Hash] annotation Keys must consist of only alphabets and underscore.
+      #   Values must be one of String or Integer or Boolean values.
+      def set_annotation(annotation)
+        AnnotationValidator.call(h)
+        @annotation = @annotation.merge(annotation)
+      end
+
+      # @param [Hash] metadata
+      def set_metadata(metadata)
+        @metadata = @metadata.merge(metadata)
       end
 
       def finish(now = Time.now)
@@ -52,12 +78,30 @@ module Aws
           id: @id,
           trace_id: @trace_id,
           start_time: @start_time,
+          annotation: @annotation,
+          metadata: @metadata,
         }
+        if @version
+          h[:service] = { version: @version }
+        end
+        if @http_request
+          request_hash = @http_request.to_h
+          # traced is SubSegment only
+          request_hash.delete(:traced)
+          h[:http] = { request:  request_hash }
+        end
+        if @http_response
+          h[:http] ||= {}
+          h[:http][:response] = @http_response.to_h
+        end
         if @end_time.nil?
           h[:in_progress] = true
         else
           h[:end_time] = @end_time
         end
+        if @error
+          h.merge!(@error.to_h)
+        end
         h[:parent_id] = @parent_id if @parent_id
         h
       end

data/lib/aws/xray/sub_segment.rb

@@ -17,8 +17,21 @@ module Aws
         @remote = !!remote
       end
 
+      # Set traced=false if the downstream call is not traced app.
+      # e.g. Third-party Web API call.
+      # http://docs.aws.amazon.com/xray/latest/devguide/xray-api-segmentdocuments.html
+      def set_http_request(env, traced: false)
+        super(env)
+        @http_request.traced = traced
+      end
+
       def to_h
         h = super
+        # x_forwarded_for is Segment only.
+        if h[:http] && h[:http][:request]
+          h[:http][:request].delete(:x_forwarded_for)
+          h[:http][:request][:traced] = @http_request.traced
+        end
         h[:type] = TYPE_NAME
         h[:namespace] = 'remote' if @remote
         h

data/lib/aws/xray/trace_header.rb

@@ -45,8 +45,7 @@ module Aws
         !!@parent
       end
 
-      def copy(parent: nil)
-        parent = parent.nil? ? @parent : parent
+      def copy(parent:)
         self.class.new(root: @root, sampled: @sampled, parent: parent)
       end
     end

data/lib/aws/xray/version.rb

@@ -1,5 +1,5 @@
 module Aws
   module Xray
-    VERSION = "0.2.0"
+    VERSION = "0.3.0"
   end
 end

data/lib/aws/xray/version_detector.rb

@@ -0,0 +1,13 @@
+module Aws
+  module Xray
+    class VersionDetector
+      REVISION_PATH = 'REVISION'
+
+      def call
+        if File.exist?(REVISION_PATH)
+          File.read(REVISION_PATH)
+        end
+      end
+    end
+  end
+end

data/lib/aws/xray.rb

@@ -1,9 +1,15 @@
 require 'aws/xray/version'
 require 'aws/xray/rack'
 require 'aws/xray/faraday'
+require 'aws/xray/configuration'
 
 module Aws
   module Xray
     TRACE_HEADER = 'X-Amzn-Trace-Id'.freeze
+
+    @config = Configuration.new
+    class << self
+      attr_reader :config
+    end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aws-xray
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Taiki Ono
@@ -94,27 +94,37 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
+- TODO.md
 - aws-xray.gemspec
 - bin/console
 - bin/setup
 - example/Gemfile
 - example/Procfile
 - example/README.md
+- example/REVISION
 - example/campain_app_config.ru
 - example/fron_app_config.ru
 - example/recipe_app_config.ru
 - example/user_app_config.ru
 - lib/aws-xray.rb
 - lib/aws/xray.rb
+- lib/aws/xray/annotation_validator.rb
+- lib/aws/xray/cause.rb
 - lib/aws/xray/client.rb
+- lib/aws/xray/configuration.rb
 - lib/aws/xray/context.rb
+- lib/aws/xray/error.rb
 - lib/aws/xray/faraday.rb
 - lib/aws/xray/header_parser.rb
 - lib/aws/xray/rack.rb
+- lib/aws/xray/rails.rb
+- lib/aws/xray/request.rb
+- lib/aws/xray/response.rb
 - lib/aws/xray/segment.rb
 - lib/aws/xray/sub_segment.rb
 - lib/aws/xray/trace_header.rb
 - lib/aws/xray/version.rb
+- lib/aws/xray/version_detector.rb
 homepage: https://github.com/taiki45/aws-xray
 licenses:
 - MIT