appoptics_apm-zearn 4.13.1

data/appoptics_apm.gemspec

@@ -0,0 +1,70 @@
+$:.push File.expand_path("../lib", __FILE__)
+require "appoptics_apm/version"
+
+Gem::Specification.new do |s|
+  s.name = %q{appoptics_apm-zearn}
+  s.version = AppOpticsAPM::Version::STRING
+  s.date = Time.now.strftime('%Y-%m-%d')
+
+  s.license = "Apache-2.0"
+
+  s.authors = ["Maia Engeli", "Peter Giacomo Lombardo", "Spiros Eliopoulos"]
+  s.email = %q{technicalsupport@solarwinds.com}
+  s.homepage = %q{https://www.appoptics.com/}
+  s.summary = %q{AppOptics APM performance instrumentation gem for Ruby}
+  s.description = <<-EOF
+Automatic tracing and metrics for Ruby applications. Get started at appoptics.com. @AppOptics
+  EOF
+
+  s.metadata = {
+      'changelog_uri'     => 'https://github.com/appoptics/appoptics-apm-ruby/releases',
+      'documentation_uri' => 'https://docs.appoptics.com/kb/apm_tracing/ruby/',
+      'homepage_uri'      => 'https://www.appoptics.com/',
+      'source_code_uri'   => 'https://github.com/appoptics/appoptics-apm-ruby',
+  }
+
+  s.extra_rdoc_files = ['LICENSE']
+  s.files = `git ls-files`.split("\n").reject { |f| f.match(%r{^(test|gemfiles)/}) }
+  s.files += ['ext/oboe_metal/src/oboe.h',
+              'ext/oboe_metal/src/oboe_api.cpp',
+              'ext/oboe_metal/src/oboe_api.hpp',
+              'ext/oboe_metal/src/oboe_debug.h',
+              'ext/oboe_metal/src/oboe_swig_wrap.cc',
+              'ext/oboe_metal/src/bson/bson.h',
+              'ext/oboe_metal/src/bson/platform_hacks.h',
+              'ext/oboe_metal/src/VERSION',
+              'ext/oboe_metal/lib/liboboe-1.0-alpine-x86_64.so.0.0.0.sha256',
+              'ext/oboe_metal/lib/liboboe-1.0-x86_64.so.0.0.0.sha256'
+             ]
+  s.files -= ['build_gem.sh',
+              'build_gem_upload_to_packagecloud.sh',
+              'Rakefile']
+
+  # TODO this is commented out util we can actually provide gems for different platforms
+  # it will create a gem that goes into noop on Darwin and other unsupported platforms
+  # s.platform   = defined?(JRUBY_VERSION) ? 'java' : Gem::Platform::CURRENT
+
+  s.extensions = ['ext/oboe_metal/extconf.rb'] unless defined?(JRUBY_VERSION)
+
+  # this still gives a warning, would have to be pinned to a minor version
+  # but that is not necessary and may restrict other gems
+  s.add_runtime_dependency('json', '~> 2.0')
+  s.add_runtime_dependency('no_proxy_fix', '~> 0.1.2', '>= 0.1.2')
+
+  # Development dependencies used in gem development & testing
+  # s.add_development_dependency('rake', '>= 0.9.0')
+  # s.add_development_dependency('simplecov', '>= 0.16.0') if ENV["SIMPLECOV_COVERAGE"]
+  # s.add_development_dependency('simplecov-console', '>= 0.4.0') if ENV["SIMPLECOV_COVERAGE"]
+  # s.add_development_dependency('irb', '>= 1.0.0', '< 1.2.2') if RUBY_VERSION >= '2.6.0'
+  #
+  # unless defined?(JRUBY_VERSION)
+  #   s.add_development_dependency('byebug', '>= 11.0.0')
+  #   s.add_development_dependency('minitest')
+  #   s.add_development_dependency('minitest-hooks', '>= 1.5.0')
+  #   s.add_development_dependency('minitest-focus', '>=1.1.2')
+  #   s.add_development_dependency('benchmark-ips', '>= 2.7.2')
+  # end
+
+  s.required_ruby_version = '>= 2.4.0'
+  s.executables   = s.files.grep(%r{^bin/}) { |f| File.basename(f) }
+end

data/bin/appoptics_apm_config

@@ -0,0 +1,15 @@
+#!/usr/bin/env ruby
+
+##
+# execute this with `bundle exec appoptics_apm_config`
+# copies the configuration template file into the current  directory
+#
+
+puts "Copying the configuration template file to appoptics_apm_config_tmp.rb"
+puts "Edit and save as appoptics_apm_config.rb"
+
+target_file = File.join(Dir.pwd, 'appoptics_apm_config_tmp.rb')
+temp_orig = File.join(File.dirname(File.dirname(__FILE__)),
+                 'lib/rails/generators/appoptics_apm/templates/appoptics_apm_initializer.rb')
+
+FileUtils.copy(temp_orig, target_file)

data/examples/prepend.rb

@@ -0,0 +1,13 @@
+require 'appoptics_apm'
+
+module Measurements
+  def request(*args, &block)
+    req = args.first
+    AppOpticsAPM::SDK.summary_metric("request_size", req.to_hash.to_s.size)
+    resp = super
+    AppOpticsAPM::SDK.summary_metric("response_size", resp.to_hash.to_s.size)
+    return resp
+  end
+end
+
+Net::HTTP.send(:prepend, :Measurements)

data/examples/sdk_examples.rb

@@ -0,0 +1,158 @@
+# Copyright (c) 2020 SolarWinds, LLC.
+# All rights reserved.
+
+###############################################################
+# SDK EXAMPLES
+###############################################################
+# The uses cases of the SDK include:
+# - tracing a piece of your own code
+# - tracing a method call of a gem that is not auto-instrumented
+#   by appoptics_apm
+#
+# SDK documentation:
+# https://rubydoc.info/gems/appoptics_apm/AppOpticsAPM/SDK
+
+###############################################################
+# Prerequisits
+# export APPOPTICS_SERVICE_KEY=<API token>:<service_name>
+# `bundle exec ruby sdk_examples.rb`
+# 5 traced requests will show up at https://my.appoptics.com/
+###############################################################
+
+require 'appoptics_apm'
+
+unless AppOpticsAPM::SDK.appoptics_ready?(10_000)
+  puts "aborting!!! Agent not ready after 10 seconds"
+  exit false
+end
+
+###############################################################
+### ADD A SPAN
+###############################################################
+#
+# AppOpticsAPM::SDK.trace()
+# This method adds a span to a trace that has been started either
+# by the auto-instrumentation of the gem handling incoming requests
+# or the SDK method `start_trace`.
+# If this method is called outside of the context of a started
+# trace no spans will be created.
+#
+# The argument is the name for the span
+
+AppOpticsAPM::SDK.trace('span_name') do
+  [9, 6, 12, 2, 7, 1, 9, 3, 4, 14, 5, 8].sort
+end
+
+###############################################################
+# START A TRACE, ADD A SPAN, AND LOG AN INFO EVENT
+###############################################################
+#
+# AppOpticsAPM::SDK.start_trace()
+# This method starts a trace.  It is handy for background jobs,
+# workers, or scripts, that are not part of a rack application
+
+AppOpticsAPM::SDK.start_trace('outer_span') do
+  AppOpticsAPM::SDK.trace('first_child_span') do
+    [9, 6, 12, 2, 7, 1, 9, 3, 4, 14, 5, 8].sort
+    AppOpticsAPM::SDK.log_info({ some: :fancy, hash: :to, send: 1 })
+  end
+end
+
+###############################################################
+# LOG AN ERROR EVENT
+###############################################################
+#
+# AppOpticsAPM::SDK.log_exception()
+# This method adds an error event to the trace, which will be
+# displayed and counted as exception on the appoptics dashboard.
+
+def do_raise
+  raise StandardError.new("oops")
+end
+
+AppOpticsAPM::SDK.start_trace('with_error') do
+  begin
+    do_raise
+  rescue => e
+    AppOpticsAPM::SDK.log_exception(e)
+  end
+end
+
+###############################################################
+# TRACE A METHOD
+###############################################################
+#
+# AppOpticsAPM::SDK.trace_method()
+# This creates a span every time the defined method is run.
+# The method can be of any (accessible) type (instance,
+# singleton, private, protected etc.).
+
+module ExampleModule
+  def self.do_sum(a, b)
+    a + b
+  end
+end
+
+AppOpticsAPM::SDK.trace_method(ExampleModule,
+                               :do_sum,
+                               { name: 'computation', backtrace: true },
+                               { CustomKey: "some_info"})
+
+AppOpticsAPM::SDK.start_trace('trace_a_method') do
+  ExampleModule.do_sum(1, 2)
+  ExampleModule.do_sum(3, 4)
+end
+
+###############################################################
+# SET A CUSTOM TRANSACTION NAME
+###############################################################
+#
+# AppOpticsAPM::SDK.set_transaction_name()
+#
+# this method can be called anytime after a trace has been started to add a
+# custom name for the whole transaction.
+# In case of a controller the trace is usually started in rack.
+
+class FakeController
+  def create(params)
+    # @fake = fake.new(params.permit(:type, :title))
+    # @fake.save
+    AppOpticsAPM::SDK.set_transaction_name("fake.#{params[:type]}")
+    # redirect_to @fake
+  end
+end
+
+AppOpticsAPM::SDK.start_trace('set_transaction_name') do
+  FakeController.new.create(type: 'news')
+end
+
+###############################################################
+# LOG INJECTION OF TRACE_ID
+###############################################################
+#
+# AppOpticsAPM::SDK.current_trace
+# This method creates an object with the current trace ID and
+# helper methods to add the ID to logs for cross-referencing.
+
+AppOpticsAPM::Config[:log_traceId] = :always
+
+AppOpticsAPM::SDK.start_trace('log_trace_id') do
+  trace = AppOpticsAPM::SDK.current_trace
+  AppOpticsAPM.logger.warn "Some log message #{trace.for_log}"
+end
+
+###############################################################
+# START A TRACE AND PROFILE
+###############################################################
+#
+# AppOpticsAPM::Profiling.run
+# This method adds profiling for the code executed in the block
+
+AppOpticsAPM::SDK.start_trace("#{name}_profiling") do
+  AppOpticsAPM::Profiling.run do
+    10.times do
+      [9, 6, 12, 2, 7, 1, 9, 3, 4, 14, 5, 8].sort
+      sleep 0.2
+    end
+  end
+end

data/ext/oboe_metal/README.md

@@ -0,0 +1,69 @@
+# Debug the c-code with gdb
+
+inspired by: https://dev.to/wataash/how-to-create-and-debug-ruby-gem-with-c-native-extension-3l8b
+
+
+## install ruby with sources
+
+rbenv is your friend ;) -k means keep sources
+
+```
+rbenv install -k 2.6.3
+rbenv shell 2.6.3
+
+# check that ruby is debuggable
+type ruby           # => ruby is /home/wsh/.rbenv/shims/ruby
+rbenv which ruby    # => /home/wsh/.rbenv/versions/2.6.3/bin/ruby
+```
+
+
+##
+## add debug info when compiling appoptics_apm
+add this line to extconf.rb to turn off optimization
+
+```
+CONFIG["optflags"] = "-O0"
+```
+
+
+##
+## start ruby app with gdb
+
+This will run ruby and load the app with a breakpoint in the Reporter::startThread
+c-function.
+
+`bundle exec gdb -q -ex 'set breakpoint pending on' -ex 'b Reporter::startThread' -ex run --args ruby -e 'require "./app"'`
+
+If there is a bug in the ruby code or a ruby byebug binding that halts the 
+script, the debugger will hang without showing any output. 
+So, make sure `bundle exec ruby app.rb` runs.
+
+use the gdb navigation commands to step through the code. If it says:
+
+```
+(gdb) n
+Single stepping until exit from function _ZN8Reporter11startThreadEv@plt,
+which has no line number information.
+```
+
+type `c` and it may end up stopping in the right location.
+
+##
+## make ruby .gdbinit macros available
+
+These macros are pretty elaborate. They are checked in the ruby github 
+repo: https://github.com/ruby/ruby/blob/master/.gdbinit
+The code is nicely formatted and colorized in github and easiest to read there.
+
+installation in the user's home dir:
+```
+wget https://github.com/ruby/ruby/blob/master/.gdbinit
+```
+##
+## examples
+
+Some inspiring examples here:
+
+https://jvns.ca/blog/2016/06/12/a-weird-system-call-process-vm-readv/
+
+https://medium.com/@zanker/finding-a-ruby-bug-with-gdb-56d6b321bc86

data/ext/oboe_metal/extconf.rb

@@ -0,0 +1,151 @@
+# frozen_string_literal: true
+
+# Copyright (c) 2016 SolarWinds, LLC.
+# All rights reserved.
+
+require 'mkmf'
+require 'rbconfig'
+require 'open-uri'
+require 'no_proxy_fix'
+
+CONFIG['warnflags'] = CONFIG['warnflags'].gsub(/-Wdeclaration-after-statement/, '')
+                        .gsub(/-Wimplicit-function-declaration/, '')
+                        .gsub(/-Wimplicit-int/, '')
+                        .gsub(/-Wno-tautological-compare/, '')
+                        .gsub(/-Wno-self-assign/, '')
+                        .gsub(/-Wno-parentheses-equality/, '')
+                        .gsub(/-Wno-constant-logical-operand/, '')
+                        .gsub(/-Wno-cast-function-type/, '')
+init_mkmf(CONFIG)
+
+ext_dir = File.expand_path(File.dirname(__FILE__))
+
+# Check if we're running in JRuby
+jruby = defined?(JRUBY_VERSION) ? true : false
+# Set the mkmf lib paths so we have no issues linking to
+# the AppOpticsAPM libs.
+ao_lib_dir = File.join(ext_dir, 'lib')
+ao_include = File.join(ext_dir, 'src')
+
+# Download the appropriate liboboe from S3(via rake for testing) or files.appoptics.com (production)
+version = File.read(File.join(ao_include, 'VERSION')).strip
+if ENV['APPOPTICS_FROM_S3'].to_s.downcase == 'true'
+  ao_path = File.join('https://rc-files-t2.s3-us-west-2.amazonaws.com/c-lib/', version)
+  puts 'Fetching c-lib from S3'
+else
+  ao_path = File.join('https://files.appoptics.com/c-lib', version)
+end
+
+ao_arch = 'x86_64'
+if File.exist?('/etc/alpine-release')
+  version = File.read('/etc/alpine-release').strip
+
+  ao_arch =
+    if Gem::Version.new(version) < Gem::Version.new('3.9')
+      'alpine-libressl-x86_64'
+    else # openssl
+      'alpine-x86_64'
+    end
+end
+
+ao_clib = "liboboe-1.0-#{ao_arch}.so.0.0.0"
+ao_item = File.join(ao_path, ao_clib)
+ao_checksum_file = File.join(ao_lib_dir, "#{ao_clib}.sha256")
+clib = File.join(ao_lib_dir, ao_clib)
+
+retries = 3
+success = false
+while retries > 0
+  begin
+    download = RUBY_VERSION < '2.5.0' ? open(ao_item, 'rb') : URI.open(ao_item, 'rb')
+    IO.copy_stream(download, clib)
+
+    clib_checksum = Digest::SHA256.file(clib).hexdigest
+    download.close
+    checksum =  File.read(ao_checksum_file).strip
+
+    # unfortunately these messages only show if the install command is run
+    # with the `--verbose` flag
+    if clib_checksum != checksum
+      $stderr.puts '== ERROR ================================================================='
+      $stderr.puts 'Checksum Verification failed for the c-extension of the appoptics_apm gem'
+      $stderr.puts 'Installation cannot continue'
+      $stderr.puts "\nChecksum packaged with gem:   #{checksum}"
+      $stderr.puts "Checksum calculated from lib: #{clib_checksum}"
+      $stderr.puts 'Contact technicalsupport@solarwinds.com if the problem persists'
+      $stderr.puts '=========================================================================='
+      exit 1
+    else
+      success = true
+      retries = 0
+    end
+  rescue => e
+    File.write(clib, '')
+    retries -= 1
+    if retries == 0
+      $stderr.puts '== ERROR =========================================================='
+      $stderr.puts 'Download of the c-extension for the appoptics_apm gem failed.'
+      $stderr.puts 'appoptics_apm will not instrument the code. No tracing will occur.'
+      $stderr.puts 'Contact technicalsupport@solarwinds.com if the problem persists.'
+      $stderr.puts "error: #{ao_item}\n#{e.message}"
+      $stderr.puts '==================================================================='
+      create_makefile('oboe_noop', 'noop')
+    end
+    sleep 0.5
+  end
+end
+
+if success
+  # Create relative symlinks for the AppOpticsAPM library
+  Dir.chdir(ao_lib_dir) do
+    File.symlink(ao_clib, 'liboboe.so')
+    File.symlink(ao_clib, 'liboboe-1.0.so.0')
+  end
+
+  dir_config('oboe', 'src', 'lib')
+
+  # create Makefile
+  if jruby || ENV.key?('APPOPTICS_URL')
+    # Build the noop extension under JRuby and Heroku.
+    # The oboe-heroku gem builds it's own c extension which links to
+    # libs specific to a Heroku dyno
+    # FIXME: For JRuby we need to remove the c extension entirely
+    create_makefile('oboe_noop', 'noop')
+
+  elsif have_library('oboe', 'oboe_config_get_revision', 'oboe.h')
+    $libs = append_library($libs, 'oboe')
+    $libs = append_library($libs, 'stdc++')
+
+    $CFLAGS << " #{ENV['CFLAGS']}"
+    # $CPPFLAGS << " #{ENV['CPPFLAGS']} -std=c++11"
+    # TODO for debugging: -pg -gdwarf-2, remove for production
+    # -pg does not work on alpine https://www.openwall.com/lists/musl/2014/11/05/2
+    $CPPFLAGS << " #{ENV['CPPFLAGS']} -std=c++11  -gdwarf-2 -I$$ORIGIN/../ext/oboe_metal/include -I$$ORIGIN/../ext/oboe_metal/src"
+    # $CPPFLAGS << " #{ENV['CPPFLAGS']} -std=c++11 -I$$ORIGIN/../ext/oboe_metal/include"
+    $LIBS << " #{ENV['LIBS']}"
+
+    # use "z,defs" to see what happens during linking
+    # $LDFLAGS << " #{ENV['LDFLAGS']} '-Wl,-rpath=$$ORIGIN/../ext/oboe_metal/lib,-z,defs'  -lrt"
+    $LDFLAGS << " #{ENV['LDFLAGS']} '-Wl,-rpath=$$ORIGIN/../ext/oboe_metal/lib' -lrt"
+    $CXXFLAGS += " -std=c++11 "
+
+    # ____ include debug info, comment out when not debugging
+    # ____ -pg -> profiling info for gprof
+    CONFIG["debugflags"] = "-ggdb3 "
+    CONFIG["optflags"] = "-O0"
+
+    create_makefile('libappoptics_apm', 'src')
+
+  else
+    $stderr.puts   '== ERROR ========================================================='
+    if have_library('oboe')
+      $stderr.puts "The c-library either needs to be updated or doesn't match the OS."
+      $stderr.puts 'No tracing will occur.'
+    else
+      $stderr.puts 'Could not find a matching c-library. No tracing will occur.'
+    end
+    $stderr.puts   'Contact technicalsupport@solarwinds.com if the problem persists.'
+    $stderr.puts   '=================================================================='
+    create_makefile('oboe_noop', 'noop')
+  end
+end

data/ext/oboe_metal/lib/liboboe-1.0-alpine-x86_64.so.0.0.0.sha256

@@ -0,0 +1 @@
+af7d764a88cec323940fc6040947f2dcf8041c389744bdfc46b7f2fe0a465dab

data/ext/oboe_metal/lib/liboboe-1.0-x86_64.so.0.0.0.sha256

@@ -0,0 +1 @@
+092e232d0e1aa1826b77c98d96f7bb2db39058c9bec3e2c0387cc6fb51b5b83c

data/ext/oboe_metal/noop/noop.c

@@ -0,0 +1,8 @@
+#include <ruby.h>
+
+/* ruby calls this to load the extension */
+void Init_oboe_noop(void) {
+  /* assume we haven't yet defined Hola */
+//  VALUE klass = rb_define_class("OboeNoop", rb_cObject);
+  rb_define_class("OboeNoop", rb_cObject);
+}

data/ext/oboe_metal/src/README.md

@@ -0,0 +1,6 @@
+
+oboe_api.hpp and oboe_api.cpp are copied here from the oboe repo during install
+
+it is best to edit these file in the oboe repo and use the OBOE_WIP=true env
+var to include the development version while they aren't deploy to s3.
+

data/ext/oboe_metal/src/VERSION

@@ -0,0 +1,2 @@
+10.2.0
+