octri 1.0.0 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b7710dbc38e8c6678e6e5a38456e0dfdf26ce8098b580e5cad6a00ed7ef210e2
-  data.tar.gz: b3496fdae687f5e386361fa122bf61d80af342a2d22a6cc239cccbc2c74fcb9c
+  metadata.gz: 0bae18c311de3d67d561b38c42c0c32ec50dd6cdbdd69fbb33671658fb0bb1c4
+  data.tar.gz: fb7db736fa76a53ddbf395d2bcc94b539e7cb04b1fb3c4d67103d6b60651e3b3
 SHA512:
-  metadata.gz: cd2be05e16cd704c0e1118dbf477b632e764c3cc5f770f3ce6fbfb821b72d67a97ecf912b2d12ab1e15239fa247ed15947d61e830c1da0d5c7d32abd23f66893
-  data.tar.gz: 6d0783dd74030d6657e45b7c507add769195eeab6d07bf9024e4b2c79e3f4ab9dbc5b58d1228d2cfc38bc2a16790f3780a8b8579729ae46713704f44dcef3556
+  metadata.gz: 76178a0d41df4536d8beb2b7a7a00c007414f618783795dbc9aa511977a037015f531275f5719d8ede4765a9174dc8b587faf5e398a3c379a0dc5ed66f4f066d
+  data.tar.gz: 35cdb51b77150bfe8f23b0e0827b3758d3e327137a85728208fabae9c2e775c5708d483451e67697d4b0919e6f8600c021988e9225eb9df93886349b1c617c29

data/CHANGELOG.md

@@ -0,0 +1,18 @@
+# Changelog
+
+## 1.0.1
+
+- Source context is now read only for frames in your own code, skips files
+  over 512 KB, and keeps a bounded cache, so a deep or unusual stack cannot
+  pull dependency source into a report or grow memory without limit.
+
+## 1.0.0
+
+First public release.
+
+- Error reporting with original source context for each in-app stack frame.
+- Request and sub-span timing, drawn as a waterfall in the dashboard.
+- W3C `traceparent` propagation, so a server error links to the client SDK
+  error for the same request.
+- Standalone events with idempotent, best-effort delivery.
+- Rack middleware for Rack and Rails, plus automatic instrumentation of outbound HTTP.

data/README.md

@@ -4,7 +4,7 @@
 or Rails with original-source context per stack frame, time every request and any
 sub-span you open into a waterfall, and join each server error to the client SDK
 error for the same request through the W3C `traceparent` header. In the
-dashboard you see the full client → server stack under one trace.
+dashboard you see the full client and server stack under one trace.
 
 Octri turns an OpenAPI spec into a documentation site, client SDKs for ten
 languages, an MCP server your AI assistant can call, and monitoring for the
@@ -70,7 +70,7 @@ Octri.instrument(cache, [:get, :set], op: "cache")
 ```
 
 Every instrumented call (and every outbound HTTP request) becomes a sub-span
-under the current request — no per-call code. Calls to your monitoring backend
+under the current request, with no per-call code. Calls to your monitoring backend
 are never traced (no feedback loop).
 
 ## Sub-spans (where time goes)
@@ -86,7 +86,7 @@ value = cache.read(key)
 s.finish
 ```
 
-`op` ("db", "cache", "http", …) color-codes the waterfall; nested `Octri.span`
+`op` ("db", "cache", "http", and so on) color-codes the waterfall; nested `Octri.span`
 calls nest correctly.
 
 ## Manual error capture
@@ -113,19 +113,21 @@ end
 
 ### Monitoring runtimes
 
-[Node](https://github.com/octridev/octri-node) ·
-[Python](https://github.com/octridev/octri-python) ·
-[Go](https://github.com/octridev/octri-go) ·
-[Ruby](https://github.com/octridev/octri-ruby) ·
-[Rust](https://github.com/octridev/octri-rust) ·
-[PHP](https://github.com/octridev/octri-php) ·
-[Java](https://github.com/octridev/octri-java) ·
-[Kotlin](https://github.com/octridev/octri-kotlin) ·
-[Swift](https://github.com/octridev/octri-swift) ·
-[Dart](https://github.com/octridev/octri-dart)
-
-[Documentation](https://docs.octri.dev/docs) ·
-[Pricing](https://octri.dev/pricing) ·
-[Changelog](https://docs.octri.dev/changelog)
+- [Node](https://github.com/octridev/octri-node)
+- [Python](https://github.com/octridev/octri-python)
+- [Go](https://github.com/octridev/octri-go)
+- [Ruby](https://github.com/octridev/octri-ruby)
+- [Rust](https://github.com/octridev/octri-rust)
+- [PHP](https://github.com/octridev/octri-php)
+- [Java](https://github.com/octridev/octri-java)
+- [Kotlin](https://github.com/octridev/octri-kotlin)
+- [Swift](https://github.com/octridev/octri-swift)
+- [Dart](https://github.com/octridev/octri-dart)
+
+### More
+
+- [Documentation](https://docs.octri.dev/docs)
+- [Pricing](https://octri.dev/pricing)
+- [Changelog](https://docs.octri.dev/changelog)
 
 MIT licensed.

data/lib/octri.rb

@@ -1,10 +1,10 @@
 # frozen_string_literal: true
 
-# Octri — server-side error monitoring for Ruby backends.
+# Octri: server-side error monitoring for Ruby backends.
 #
 # Add it to your live API; it reports backend errors to your Octri monitoring
 # project (with original-source context per stack frame) and links each one to
-# the client SDK error for the same request via the W3C `traceparent` header —
+# the client SDK error for the same request via the W3C `traceparent` header,
 # so the dashboard shows the full client -> server stack under one trace. It also
 # times requests (and any sub-spans you open) into the request waterfall.
 #
@@ -24,6 +24,8 @@ module Octri
   Trace = Struct.new(:trace_id, :parent_span_id)
 
   CONTEXT_LINES = 5
+  MAX_SOURCE_BYTES = 512 * 1024
+  MAX_CACHED_SOURCES = 256
   REQUEST_TIMEOUT_SECONDS = 5
   MAX_IDEMPOTENCY_KEY_LENGTH = 256
   TRACEPARENT_RE = /\A00-([0-9a-f]{32})-([0-9a-f]{16})-[0-9a-f]{2}\z/i.freeze
@@ -224,7 +226,7 @@ module Octri
       Time.now.utc.iso8601(3)
     end
 
-    # True when host:port is the monitoring backend — used to avoid tracing our
+    # True when host:port is the monitoring backend, used to avoid tracing our
     # own reporting requests (which would recurse).
     def monitoring_endpoint?(host, port)
       return false if @config.nil? || @config.url.nil?
@@ -292,7 +294,8 @@ module Octri
         path = loc.absolute_path || loc.path
         lineno = loc.lineno
         frame = { function: loc.label, filename: path, lineno: lineno, colno: 0, inApp: in_app?(path) }
-        lines = read_source(path)
+        # Only your own files: the dashboard shows them, gem source is noise.
+        lines = frame[:inApp] ? read_source(path) : nil
         if lines && lineno >= 1 && lineno <= lines.length
           idx = lineno - 1
           frame[:contextLine] = lines[idx]
@@ -319,10 +322,13 @@ module Octri
       return @source_cache[path] if @source_cache.key?(path)
 
       lines = begin
-        File.readlines(path, chomp: true)
+        # Big files are skipped, not truncated, so line numbers keep lining up.
+        File.size(path) <= MAX_SOURCE_BYTES ? File.readlines(path, chomp: true) : nil
       rescue StandardError
         nil
       end
+      # A stack can name any number of files, so the cache is bounded too.
+      @source_cache.shift if @source_cache.size >= MAX_CACHED_SOURCES
       @source_cache[path] = lines
       lines
     end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: octri
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.1
 platform: ruby
 authors:
 - Octri
@@ -16,6 +16,7 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- CHANGELOG.md
 - LICENSE
 - README.md
 - lib/octri.rb