raygun-apm 0.0.3-universal-darwin → 0.0.4-universal-darwin

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c8a352ce53209c88436c6d4e7c35b0a16f41d3ed7993a23edb77ceb72fa5d89b
-  data.tar.gz: ebfc8980395ac3c514197bf13761928234e5cd6811db7f928b69dbf45fb324d1
+  metadata.gz: 5c9faeda4435919e883abfa4bd5649924c41e8d53b7447743df73d0674611067
+  data.tar.gz: d9043e53f6140ed49c7f4df802900eade30cfd233492d11645083134c231894b
 SHA512:
-  metadata.gz: 36b283e1e5cf0196df19d2e0a7d39673e37a7c240113657dadb5c82a3fda17ffb47e949e3cc831e8f672031e7585e50e1ec7dcc03037ae77c9e4708c59520a18
-  data.tar.gz: 0b0b8841464a45965a1fef66bc28f9b03a52aa32d1eba42d62c3b2405d0d75146e6faa4b7a62d0801bea9ff4867ec56c1b2c0ec4f4731e2af58faf7828c64f32
+  metadata.gz: b598343bf5c97a8bf7ddf6e01b8c188d351195eccf0e082492f41b10d80fa8ef6e3365562a4cc9c27b4d3bbadc42b5c80ecba4ed4d81690beab6902a318e2221
+  data.tar.gz: 3ff0b8cad32b0c764b0679157f631813beaed683a03193c5cd490137f590de2725bd721a5603faf7388a208412d79cb6eff6dcb9184aedc5e52c559ae0e8a60b

data/README.rdoc

@@ -0,0 +1,95 @@
+= Raygun Application Performance Monitoring
+
+Ruby Profiler for {Raygun Application Performance Monitoring}[https://raygun.com/platform/apm].
+
+Distributed as a precompiled native gem.
+
+== Supported platforms
+* x86-mingw32
+* x64-mingw32
+* x86-linux
+* x86_64-linux
+* universal-darwin
+
+{Contact us}[https://raygun.com/about/contact] to support other platforms.
+
+== Agent Setup
+
+The Profiler needs to be able to access the Raygun Agent over UDP.
+
+The <code>RAYGUN_AGENT_TOKEN</code> needs to be supplied as an argument and is available under "Application Settings" at the {Raygun Application Performance Monitoring}[https://raygun.com/platform/apm] UI
+
+To launch Raygun Agent using docker
+    docker pull raygunowner/raygun-apm
+    docker run -v raygun-agent:/usr/share/Raygun -e "RAYGUN_AGENT_TOKEN=<token>" -p 2790:2790 -p 2788:2788 -p 2799:2799/udp -it raygunowner/raygun-apm:latest
+
+== Profiler Setup
+
+Include the gem your Gemfile
+
+    gem 'raygun-apm'
+
+Run <code>bundle</code> to install the gem.
+
+Alternatively install using rubygems <code>gem install raygun-apm</code>.
+
+=== Standalone ruby script / custom framework
+
+For standalone scripts, context start-end needs to be marked specifically and optionally extended events can be called.
+
+  #!/usr/bin/env ruby
+  require 'raygun/apm'
+  
+  class Hello
+    def rdoc
+      sleep 0.5
+    end
+  end
+  
+  tracer = Raygun::Apm::Tracer.new
+  tracer.udp_sink!
+  tracer.process_started
+  tracer.start_trace
+  Hello.new.rdoc
+  tracer.end_trace
+  tracer.process_ended
+
+Extended events can be sent where appropiate
+
+<code>HTTP incoming event</code>
+
+  event = Raygun::Apm::Event::HttpIn.new
+  event[:pid] = Process.pid
+  event[:tid] = 0
+  event[:timestamp] = Time.now.to_f*1000000
+  event[:url] = 'https://google.com/'
+  event[:verb] = 'GET'
+  event[:status] = 200
+  event[:duration] = 1000  
+  tracer.emit(event)
+
+<code>SQL query</code>
+
+  event = Raygun::Apm::Event::Sql.new
+  event[:pid] = Process.pid
+  event[:tid] = 0
+  event[:timestamp] = Time.now.to_f*1000000
+  event[:provider] = 'postgres'
+  event[:host] = 'localhost'
+  event[:database] = 'rails'
+  event[:query] = 'SELECT * from FOO;'
+  event[:duration] = 1000
+  tracer.emit(event)
+
+=== Ruby on Rails
+
+For Ruby on Rails integration the following needs to be added to the <code>application.rb</code> file
+
+    require 'raygun/apm/middleware'
+    config.middleware.use Raygun::Apm::Middleware
+
+==== Supported versions
+The gem has been tested with the following Ruby on Rails versions:
+* 5.2.2
+
+Other versions may work as long as the same Active Support Instrumentation interface is being used.

data/lib/raygun/apm/version.rb

@@ -1,5 +1,5 @@
 module Raygun
   module Apm
-    VERSION = "0.0.3"
+    VERSION = "0.0.4"
   end
 end

data/raygun-apm.gemspec

@@ -18,7 +18,13 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib", "ext"]
 
-  spec.platform = Gem::Platform::RUBY
+  if RUBY_PLATFORM =~ /darwin/
+    spec.files << 'lib/raygun/raygun_ext.bundle'
+    spec.platform = 'universal-darwin'
+  else
+    spec.platform = Gem::Platform::RUBY
+  end
+
   spec.extensions = ["ext/raygun/extconf.rb"]
   spec.required_ruby_version = '>= 2.4.0'
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: raygun-apm
 version: !ruby/object:Gem::Version
-  version: 0.0.3
+  version: 0.0.4
 platform: universal-darwin
 authors:
 - Erkki Eilonen
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2019-10-23 00:00:00.000000000 Z
+date: 2019-11-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: debase-ruby_core_source
@@ -118,7 +118,7 @@ extra_rdoc_files: []
 files:
 - Gemfile
 - Gemfile.lock
-- README.md
+- README.rdoc
 - bin/console
 - bin/setup
 - ext/raygun/extconf.rb