forge_ops_tracker 0.10.1 → 0.10.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8366b59c60be4a6766a7d7775e9eaeed1e184645e620351e81aa97bc88c0cacd
-  data.tar.gz: a971669ad792a6893bdcddb577050883cb3d8f175778d817f02174c9428b5acc
+  metadata.gz: 9b32a031e24fb613c219aee3bf01f0517043b05b4d1788d7ece456096d7561a0
+  data.tar.gz: 39c7f16920425d01862607b6d3f85b957c694ab009ce8ffd010f33714632a3a9
 SHA512:
-  metadata.gz: 03c78e9de07b46238931804ce2743c5ce659efbfdb5ae86151ab64a355c31a9e2fc142f07e22ad15d2e12bff02cb53fddaebd419f3c889ca9bd325adc3205b54
-  data.tar.gz: b882fd3008d11185934f8905ad23261bedf5c5290902da1da0a789042f829f117b9e7d2fa66361a79a8d802a1d8561e700b1af81caec8bf4fb41cbbc974eb180
+  metadata.gz: 315fb4765179a298da43dd2beabe68970f257dee7b4b1f3938bcc6efa72ac403b8dbb0e39b8d16dfcaf19b76696aed961270dc88fd92731b05ae1610b3d4a223
+  data.tar.gz: f2907bae8015b4093346a30369cc3da38c8d36f4198ae4935cb1e2d2cea2e6baed44d5fcab4a8278029f228353d991275316fd54a9e08bd3116519b529f09159

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 0.10.2
+
+- Documentation only: the README and package description now describe ForgeOps as a hosted service, link to getforgeops.net, and show the real host in the connection string example instead of a placeholder. No code changes.
+
 ## 0.10.1
 
 - Sidekiq job failures now report the real error. Sidekiq raises its own control-flow exception

data/README.md

@@ -1,6 +1,6 @@
 # ForgeOpsTracker
 
-Rails exception reporting client for a [ForgeOps](../../) instance.
+Rails exception reporting client for [ForgeOps](https://getforgeops.net).
 
 ## Installation
 
@@ -15,7 +15,7 @@ Set a DSN (from a project's settings page in ForgeOps) via an initializer or env
 ```ruby
 # config/initializers/forge_ops_tracker.rb
 ForgeOpsTracker.configure do |config|
-  config.dsn = ENV["FORGE_OPS_DSN"] # "https://<api_key>@forgeops.example.com/api/v1/events"
+  config.dsn = ENV["FORGE_OPS_DSN"] # "https://<api_key>@getforgeops.net/api/v1/events"
   config.release = ENV["HEROKU_SLUG_COMMIT"] || `git rev-parse HEAD`.strip
   config.enabled_environments = %w[production staging] # default; reporting is a no-op elsewhere
 end
@@ -67,6 +67,25 @@ Bottom line: if an exception would otherwise crash something, you're already cov
 code already catches and handles it, route that specific `rescue` through `Rails.error.handle`/
 `.record` instead of a bare one wherever you want ForgeOps to know about it.
 
+### Sidekiq job failures and renamed job classes
+
+A failing Sidekiq job is reported through `Rails.error` like any other error. Since 0.10.1 the issue
+carries the real error, not Sidekiq's internal `Sidekiq::JobRetry::Handled` retry wrapper (which is
+what every failing job used to arrive as, whatever went wrong inside it).
+
+Renaming or removing a job class breaks every job still queued under the old name, since Sidekiq
+stores the class name as a string, and no test can catch it because those jobs live in Redis. ForgeOps
+recognizes that failure (an Active Job `UnknownJobClassError`, or a plain Sidekiq job's `NameError`
+from constantizing the class), names the class that no longer exists, and shows how soon after which
+release it first appeared. Keep the old name as an alias until the queue, retry set and scheduled set
+have drained:
+
+```ruby
+# app/jobs/send_invoice_job.rb
+# Kept only until jobs queued under the old name have drained, then delete this file.
+SendInvoiceJob = DeliverInvoiceJob
+```
+
 ## Identifying users
 
 If you're using Devise, or any other Warden-based authentication, the currently signed-in user is

data/lib/forge_ops_tracker/version.rb

@@ -1,3 +1,3 @@
 module ForgeOpsTracker
-  VERSION = "0.10.1"
+  VERSION = "0.10.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: forge_ops_tracker
 version: !ruby/object:Gem::Version
-  version: 0.10.1
+  version: 0.10.2
 platform: ruby
 authors:
 - ForgeOps
@@ -79,8 +79,8 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.30'
-description: Hooks Rails' error reporter and reports exceptions to a ForgeOps exception
-  tracker instance over HTTP, without ever raising back into the host application.
+description: Hooks Rails' error reporter and reports exceptions to ForgeOps over HTTP,
+  without ever raising back into the host application.
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -140,5 +140,5 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 4.0.11
 specification_version: 4
-summary: Rails exception reporting client for a ForgeOps tracker
+summary: Rails exception reporting client for ForgeOps
 test_files: []