logtide 1.0.0

data/lib/logtide/transport/otlp.rb

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+require "net/http"
+require "uri"
+require "json"
+require "time"
+require "timeout"
+require_relative "http"
+
+module Logtide
+  module Transport
+    # Exports spans as OTLP/JSON to /v1/otlp/traces (spec 005 section 3).
+    # Shares the retryable/network-error contract with the log transport.
+    class Otlp
+      USER_AGENT = "logtide-ruby/#{Logtide::VERSION}".freeze
+
+      def initialize(url:, api_key:, resource:, timeout: 10)
+        @uri = URI.parse(url)
+        @api_key = api_key
+        @resource = resource
+        @timeout = timeout
+      end
+
+      def deliver(spans)
+        body = JSON.generate(payload(spans))
+        response = client.request(build_request(body))
+        Response.new(status: response.code.to_i, retry_after: nil)
+      rescue *HTTP::NETWORK_ERRORS => e
+        raise NetworkError, e.message
+      end
+
+      private
+
+      def payload(spans)
+        {
+          "resourceSpans" => [
+            {
+              "resource" => { "attributes" => resource_attributes },
+              "scopeSpans" => [{ "spans" => spans.map(&:to_otlp) }]
+            }
+          ]
+        }
+      end
+
+      def resource_attributes
+        [
+          string_attribute("service.name", @resource[:service_name]),
+          string_attribute("deployment.environment", @resource[:environment]),
+          string_attribute("service.version", @resource[:service_version])
+        ].compact
+      end
+
+      def string_attribute(key, value)
+        return nil if value.nil?
+
+        { "key" => key, "value" => { "stringValue" => value.to_s } }
+      end
+
+      def client
+        http = Net::HTTP.new(@uri.host, @uri.port)
+        http.use_ssl = @uri.scheme == "https"
+        http.open_timeout = @timeout
+        http.read_timeout = @timeout
+        http.write_timeout = @timeout if http.respond_to?(:write_timeout=)
+        http
+      end
+
+      def build_request(body)
+        request = Net::HTTP::Post.new(@uri.request_uri)
+        request["X-API-Key"] = @api_key
+        request["Content-Type"] = "application/json"
+        request["User-Agent"] = USER_AGENT
+        request.body = body
+        request
+      end
+    end
+  end
+end

data/lib/logtide/version.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Logtide
+  VERSION = "1.0.0"
+
+  # The spec version this SDK implements (see logtide-sdk-spec).
+  SPEC_VERSION = "1.0"
+end

data/lib/logtide.rb

@@ -0,0 +1,152 @@
+# frozen_string_literal: true
+
+require_relative "logtide/version"
+require_relative "logtide/error"
+require_relative "logtide/dsn"
+require_relative "logtide/configuration"
+require_relative "logtide/circuit_breaker"
+require_relative "logtide/retry_policy"
+require_relative "logtide/metrics"
+require_relative "logtide/transport/buffer"
+require_relative "logtide/transport/http"
+require_relative "logtide/transport/batcher"
+require_relative "logtide/structured_exception"
+require_relative "logtide/breadcrumb"
+require_relative "logtide/tracing"
+require_relative "logtide/tracing/span"
+require_relative "logtide/transport/otlp"
+require_relative "logtide/scope"
+require_relative "logtide/event"
+require_relative "logtide/client"
+require_relative "logtide/hub"
+require_relative "logtide/logger_bridge"
+require_relative "logtide/rack/middleware"
+require_relative "logtide/rails/railtie" if defined?(Rails::Railtie)
+
+# LogTide SDK for Ruby. The module-level methods are the documented entry point
+# (spec 004 section 1); they delegate to the current Hub.
+module Logtide
+  class << self
+    # Initialise the SDK and bind the global Hub. Returns the Hub.
+    def init(**options)
+      hub = Hub.new(Client.new(Configuration.new(**options)))
+      @main_hub = hub
+      register_shutdown
+      hub
+    end
+
+    def main_hub
+      @main_hub ||= Hub.new(nil)
+    end
+
+    def current_hub
+      Thread.current[:logtide_hub] || main_hub
+    end
+
+    def current_hub=(hub)
+      Thread.current[:logtide_hub] = hub
+    end
+
+    # Run a block with a per-request hub cloned from the main hub, then restore
+    # the previous hub. Used by framework middleware for request isolation.
+    def with_request_hub
+      previous = Thread.current[:logtide_hub]
+      self.current_hub = main_hub.clone
+      yield current_hub
+    ensure
+      Thread.current[:logtide_hub] = previous
+    end
+
+    def capture_log(level, message, metadata = nil, **opts)
+      current_hub.capture_log(level, message, metadata, **opts)
+    end
+
+    def debug(message, metadata = nil, **opts)
+      capture_log("debug", message, metadata, **opts)
+    end
+
+    def info(message, metadata = nil, **opts)
+      capture_log("info", message, metadata, **opts)
+    end
+
+    def warn(message, metadata = nil, **opts)
+      capture_log("warn", message, metadata, **opts)
+    end
+
+    def error(message, metadata_or_exception = nil, **opts)
+      if metadata_or_exception.is_a?(Exception)
+        return capture_exception(metadata_or_exception, message: message, level: "error", **opts)
+      end
+
+      capture_log("error", message, metadata_or_exception, **opts)
+    end
+
+    def critical(message, metadata_or_exception = nil, **opts)
+      if metadata_or_exception.is_a?(Exception)
+        return capture_exception(metadata_or_exception, message: message, level: "critical", **opts)
+      end
+
+      capture_log("critical", message, metadata_or_exception, **opts)
+    end
+
+    def capture_exception(exception, **opts)
+      current_hub.capture_exception(exception, **opts)
+    end
+    alias capture_error capture_exception
+
+    def configure_scope(&)
+      current_hub.configure_scope(&)
+    end
+
+    def with_scope(&)
+      current_hub.with_scope(&)
+    end
+
+    def add_breadcrumb(breadcrumb)
+      current_hub.add_breadcrumb(breadcrumb)
+    end
+
+    def start_span(name, ...)
+      current_hub.start_span(name, ...)
+    end
+
+    def trace_propagation_headers
+      current_hub.trace_propagation_headers
+    end
+
+    def set_user(user)
+      configure_scope { |scope| scope.set_user(user) }
+    end
+
+    def set_tag(key, value)
+      configure_scope { |scope| scope.set_tag(key, value) }
+    end
+
+    def flush(timeout = nil)
+      current_hub.flush(timeout)
+    end
+
+    def close(timeout = nil)
+      current_hub.close(timeout)
+    end
+
+    def get_metrics
+      current_hub.client&.metrics
+    end
+
+    # Test/teardown seam: drop the bound hubs.
+    def reset!
+      Thread.current[:logtide_hub] = nil
+      @main_hub = nil
+    end
+
+    private
+
+    def register_shutdown
+      return if @shutdown_registered
+
+      @shutdown_registered = true
+      at_exit { @main_hub&.close }
+    end
+  end
+end

metadata

@@ -0,0 +1,73 @@
+--- !ruby/object:Gem::Specification
+name: logtide
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- LogTide
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-06-17 00:00:00.000000000 Z
+dependencies: []
+description: Log management, tracing and error tracking for Ruby and Rails. Captures
+  logs, exceptions and spans and ships them to a LogTide instance.
+email:
+- hello@logtide.dev
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- lib/logtide.rb
+- lib/logtide/breadcrumb.rb
+- lib/logtide/circuit_breaker.rb
+- lib/logtide/client.rb
+- lib/logtide/configuration.rb
+- lib/logtide/dsn.rb
+- lib/logtide/error.rb
+- lib/logtide/event.rb
+- lib/logtide/hub.rb
+- lib/logtide/logger_bridge.rb
+- lib/logtide/metrics.rb
+- lib/logtide/rack/middleware.rb
+- lib/logtide/rails/railtie.rb
+- lib/logtide/retry_policy.rb
+- lib/logtide/scope.rb
+- lib/logtide/structured_exception.rb
+- lib/logtide/tracing.rb
+- lib/logtide/tracing/span.rb
+- lib/logtide/transport/batcher.rb
+- lib/logtide/transport/buffer.rb
+- lib/logtide/transport/http.rb
+- lib/logtide/transport/otlp.rb
+- lib/logtide/version.rb
+homepage: https://github.com/logtide-dev/logtide-ruby
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/logtide-dev/logtide-ruby
+  source_code_uri: https://github.com/logtide-dev/logtide-ruby
+  changelog_uri: https://github.com/logtide-dev/logtide-ruby/blob/main/CHANGELOG.md
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: Official LogTide SDK for Ruby
+test_files: []