lognexis-ruby 1.0.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: a32cef2c39a5eaa03a633e6b3a84823de252f2fa1112591c37e27e21f146d00b
+  data.tar.gz: 9499d204c073c30dee3f8b2ed0242312cfaccfae91e30fae71178851839966b0
+SHA512:
+  metadata.gz: ba908e63f8cc94f6514f5f2b4a49bf56205180ccbe2d1eeb55b64af39f5bd3756c54bab7d0955894c1d3d8c307d26272fd70edc5b21c047438b42a0c6ad33792
+  data.tar.gz: 14ea6a2452940881633a6f2ac8c4e3823d69e63075dfe90df19755082b1ff6daa13f1b8c8baa33e2eee28e93534c843d1ccb82bef35cdfc0bc7e857efeb46960

data/README.md

@@ -0,0 +1,72 @@
+# LogNexis Ruby SDK
+
+The official Ruby tracking SDK for **LogNexis** — the lightweight, real-time API monitoring, analytics, and observability platform.
+
+**Website:** [https://lognexis.online](https://lognexis.online)  
+**Documentation:** [https://lognexis.online/docs](https://lognexis.online/docs)
+
+## What it does
+Automatically capture API request logs, HTTP errors, latency metrics, and real-world performance without blocking your application threads. It works universally across any Rack-based framework.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'lognexis-ruby', '>= 1.0'
+```
+
+And then execute:
+```bash
+$ bundle install
+```
+
+Or install it yourself via:
+```bash
+$ gem install lognexis-ruby
+```
+
+## Quick Start (Ruby on Rails)
+
+In your `config/application.rb` or inside a new initializer like `config/initializers/lognexis.rb`:
+
+```ruby
+require 'lognexis'
+
+Rails.application.config.middleware.use LogNexis::RackMiddleware, api_key: "YOUR_LOGNEXIS_API_KEY"
+```
+
+## Quick Start (Sinatra / Rack)
+
+In your `config.ru` or main app file:
+
+```ruby
+require 'sinatra'
+require 'lognexis'
+
+use LogNexis::RackMiddleware, api_key: "YOUR_LOGNEXIS_API_KEY"
+
+get '/' do
+  'Hello World'
+end
+```
+
+## Manual Usage (Background Jobs / Services)
+
+If you aren't using a web server or want to log background jobs:
+
+```ruby
+require 'lognexis'
+
+client = LogNexis::Client.new("YOUR_LOGNEXIS_API_KEY")
+
+client.capture({
+  endpoint: "/custom-job/user-sync",
+  method: "POST",
+  statusCode: 200,
+  latency: 145.5
+})
+```
+
+## How it works
+This SDK uses Ruby's built-in `Net::HTTP` inside of a non-blocking `Thread.new` block. It operates in a completely "fire-and-forget" manner, meaning that even if the LogNexis servers were to go down, your application will NEVER crash and your API response times will NEVER be slowed down by this SDK.

data/lib/lognexis/client.rb

@@ -0,0 +1,32 @@
+require 'net/http'
+require 'uri'
+require 'json'
+require 'thread'
+
+module LogNexis
+  class Client
+    DEFAULT_BASE_URL = "https://lognexis-node.onrender.com".freeze
+
+    def initialize(api_key, base_url = DEFAULT_BASE_URL)
+      @api_key = api_key
+      @base_url = base_url.sub(/\/$/, '')
+      @endpoint = URI("#{@base_url}/api/logs/#{@api_key}")
+    end
+
+    def capture(log_data)
+      # Fire and forget in a background thread to prevent blocking
+      Thread.new do
+        begin
+          request = Net::HTTP::Post.new(@endpoint, 'Content-Type' => 'application/json')
+          request.body = log_data.to_json
+
+          Net::HTTP.start(@endpoint.hostname, @endpoint.port, use_ssl: @endpoint.scheme == 'https', open_timeout: 5, read_timeout: 5) do |http|
+            http.request(request)
+          end
+        rescue => e
+          # Silently fail, do not crash the user's application
+        end
+      end
+    end
+  end
+end

data/lib/lognexis/rack_middleware.rb

@@ -0,0 +1,43 @@
+require 'time'
+require 'rack/request'
+
+module LogNexis
+  class RackMiddleware
+    def initialize(app, api_key:, base_url: Client::DEFAULT_BASE_URL)
+      @app = app
+      @client = Client.new(api_key, base_url)
+    end
+
+    def call(env)
+      start_time = Process.clock_gettime(Process::CLOCK_MONOTONIC)
+      
+      status, headers, response = @app.call(env)
+      
+      latency = (Process.clock_gettime(Process::CLOCK_MONOTONIC) - start_time) * 1000.0
+
+      request = Rack::Request.new(env)
+      
+      ip_address = env['HTTP_X_FORWARDED_FOR'] || env['REMOTE_ADDR'] || ''
+      ip_address = ip_address.split(',').first.strip if ip_address.include?(',')
+
+      req_headers = env.select { |k,v| k.start_with?('HTTP_') }
+                       .map { |k,v| [k.sub(/^HTTP_/, '').split('_').map(&:capitalize).join('-'), v] }
+                       .to_h
+
+      log_data = {
+        endpoint: request.path_info,
+        method: request.request_method,
+        statusCode: status.to_i,
+        latency: latency,
+        timestamp: Time.now.utc.strftime('%Y-%m-%dT%H:%M:%S.%L') + 'Z',
+        ipAddress: ip_address,
+        userAgent: request.user_agent || '',
+        requestHeaders: req_headers
+      }
+
+      @client.capture(log_data)
+
+      [status, headers, response]
+    end
+  end
+end

data/lib/lognexis.rb

@@ -0,0 +1,5 @@
+require "lognexis/client"
+require "lognexis/rack_middleware"
+
+module LogNexis
+end

metadata

@@ -0,0 +1,62 @@
+--- !ruby/object:Gem::Specification
+name: lognexis-ruby
+version: !ruby/object:Gem::Version
+  version: 1.0.2
+platform: ruby
+authors:
+- Gopal562004
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-07-13 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rack
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+description: Lightweight middleware for Rails, Sinatra, and Rack applications to automatically
+  capture API request logs, errors, and latencies.
+email:
+- support@lognexis.online
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/lognexis.rb
+- lib/lognexis/client.rb
+- lib/lognexis/rack_middleware.rb
+homepage: https://lognexis.online
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.19
+signing_key:
+specification_version: 4
+summary: Official LogNexis API Monitoring SDK
+test_files: []