mmtrix_rpm 1.0.0.1

data/test/environments/rails31/config/application.rb

@@ -0,0 +1,18 @@
+# encoding: utf-8
+# This file is distributed under Mmtrix's license terms.
+# See https://github.com/mmtrix/rpm/blob/master/LICENSE for complete details.
+
+require File.expand_path('../boot', __FILE__)
+
+require 'rails/all'
+
+Bundler.require(:default, Rails.env) if defined?(Bundler)
+
+module RpmTestApp
+  class Application < Rails::Application
+    config.encoding = "utf-8"
+    config.filter_parameters += [:password]
+    config.assets.enabled = true
+    config.active_support.deprecation = :notify
+  end
+end

data/test/environments/rails31/config/boot.rb

@@ -0,0 +1,10 @@
+# encoding: utf-8
+# This file is distributed under Mmtrix's license terms.
+# See https://github.com/mmtrix/rpm/blob/master/LICENSE for complete details.
+
+require 'rubygems'
+
+# Set up gems listed in the Gemfile.
+ENV['BUNDLE_GEMFILE'] ||= File.expand_path('../../Gemfile', __FILE__)
+
+require 'bundler/setup' if File.exists?(ENV['BUNDLE_GEMFILE'])

data/test/environments/rails31/config/database.yml

@@ -0,0 +1,26 @@
+mysql: &mysql
+  adapter: mysql
+  socket: <%= (`uname -s` =~ /Linux/ ) ? "" :"/tmp/mysql.sock" %>
+  username: root
+  host: localhost
+  database: <%= db = "#{ENV['RUBY_VERSION']}#{ENV['BRANCH']}"; db.empty? ? "rails_blog" : db %>
+
+sqlite3: &sqlite3
+<% if defined?(JRuby) %>
+  adapter: jdbcsqlite3
+<% else %>
+  adapter: sqlite3
+<% end %>
+  database: db/all.sqlite3
+  pool: 5
+  timeout: 5000
+  host: localhost
+
+development:
+  <<: *sqlite3
+
+test:
+  <<: *mysql
+
+production:
+  <<: *mysql

data/test/environments/rails31/config/environment.rb

@@ -0,0 +1,6 @@
+# encoding: utf-8
+# This file is distributed under Mmtrix's license terms.
+# See https://github.com/mmtrix/rpm/blob/master/LICENSE for complete details.
+
+require File.expand_path('../application', __FILE__)
+RpmTestApp::Application.initialize!

data/test/environments/rails31/config/initializers/new_rails_defaults.rb

@@ -0,0 +1,21 @@
+# encoding: utf-8
+# This file is distributed under Mmtrix's license terms.
+# See https://github.com/mmtrix/rpm/blob/master/LICENSE for complete details.
+
+# These settings change the behavior of Rails 2 apps and will be defaults
+# for Rails 3. You can remove this initializer when Rails 3 is released.
+
+if defined?(ActiveRecord)
+  # Include Active Record class name as root for JSON serialized output.
+  ActiveRecord::Base.include_root_in_json = true
+
+  # Store the full class name (including module namespace) in STI type column.
+  ActiveRecord::Base.store_full_sti_class = true
+end
+
+# Use ISO 8601 format for JSON serialized times and dates.
+ActiveSupport.use_standard_json_time_format = true
+
+# Don't escape HTML entities in JSON, leave that for the #json_escape helper.
+# if you're including raw json in an HTML page.
+ActiveSupport.escape_html_entities_in_json = false

data/test/environments/rails31/db/schema.rb

@@ -0,0 +1,5 @@
+# encoding: utf-8
+# This file is distributed under Mmtrix's license terms.
+# See https://github.com/mmtrix/rpm/blob/master/LICENSE for complete details.
+
+# File is required to exist by Rails

data/test/environments/rails32/Gemfile

@@ -0,0 +1,26 @@
+source 'https://rubygems.org'
+
+gem 'rails', '~>3.2.20'
+gem 'i18n', '0.6.11'
+
+gem 'rake', '~>10.1.1'
+gem 'minitest', '~>4.7.5'
+gem 'mocha', :require => false
+gem 'rack'
+gem 'rack-test'
+
+gem "mmtrix_rpm", :path => "../../.."
+
+platforms :jruby do
+  gem "activerecord-jdbcmysql-adapter"
+  gem "activerecord-jdbcsqlite3-adapter"
+  gem "jruby-openssl"
+end
+
+platforms :ruby, :rbx do
+  gem "mysql", "~>2.9.1"
+  gem "sqlite3"
+end
+
+gem 'pry', '~> 0.9.12'
+gem 'hometown', '~> 0.2.5'

data/test/environments/rails32/Rakefile

@@ -0,0 +1,11 @@
+# Add your own tasks in files placed in lib/tasks ending in .rake,
+# for example lib/tasks/capistrano.rake, and they will automatically be available to Rake.
+
+require File.expand_path('../config/application', __FILE__)
+require 'rake'
+
+RpmTestApp::Application.load_tasks
+require 'tasks/all'
+
+Rake::Task["default"].clear
+task :default => [:'test:mmtrix']

data/test/environments/rails32/config/application.rb

@@ -0,0 +1,19 @@
+# encoding: utf-8
+# This file is distributed under Mmtrix's license terms.
+# See https://github.com/mmtrix/rpm/blob/master/LICENSE for complete details.
+
+require File.expand_path('../boot', __FILE__)
+
+require 'rails/all'
+
+Bundler.require(:default, Rails.env) if defined?(Bundler)
+
+module RpmTestApp
+  class Application < Rails::Application
+    config.encoding = "utf-8"
+    config.filter_parameters += [:password]
+    config.secret_key_base = '414fd9af0cc192729b2b6bffe9e7077c9ac8eed5cbb74c8c4cd628906b716770598a2b7e1f328052753a4df72e559969dc05b408de73ce040c93cac7c51a348e'
+    config.active_support.deprecation = :notify
+    config.eager_load = false
+  end
+end

data/test/environments/rails32/config/boot.rb

@@ -0,0 +1,10 @@
+# encoding: utf-8
+# This file is distributed under Mmtrix's license terms.
+# See https://github.com/mmtrix/rpm/blob/master/LICENSE for complete details.
+
+require 'rubygems'
+
+# Set up gems listed in the Gemfile.
+ENV['BUNDLE_GEMFILE'] ||= File.expand_path('../../Gemfile', __FILE__)
+
+require 'bundler/setup' if File.exists?(ENV['BUNDLE_GEMFILE'])

data/test/environments/rails32/config/database.yml

@@ -0,0 +1,31 @@
+# Shared properties for mysql db
+mysql: &mysql
+  adapter: mysql
+  socket: <%= (`uname -s` =~ /Linux/ ) ? "" :"/tmp/mysql.sock" %>
+  username: root
+  host: localhost
+  database: <%= db = "#{ENV['RUBY_VERSION']}#{ENV['BRANCH']}"; db.empty? ? "rails_blog" : db %>
+
+# Shared properties for postgres.  This won't work with our schema but
+# Does work with agent tests
+sqlite3: &sqlite3
+<% if defined?(JRuby) %>
+  adapter: jdbcsqlite3
+<% else %>
+  adapter: sqlite3
+<% end %>
+  database: db/all.sqlite3
+  pool: 5
+  timeout: 5000
+  host: localhost
+  
+# SQLite version 3.x
+#   gem install sqlite3-ruby (not necessary on OS X Leopard)
+development:
+  <<: *sqlite3
+
+test:
+  <<: *mysql
+
+production:
+  <<: *mysql

data/test/environments/rails32/config/environment.rb

@@ -0,0 +1,6 @@
+# encoding: utf-8
+# This file is distributed under Mmtrix's license terms.
+# See https://github.com/mmtrix/rpm/blob/master/LICENSE for complete details.
+
+require File.expand_path('../application', __FILE__)
+RpmTestApp::Application.initialize!

data/test/environments/rails32/db/schema.rb

@@ -0,0 +1,5 @@
+# encoding: utf-8
+# This file is distributed under Mmtrix's license terms.
+# See https://github.com/mmtrix/rpm/blob/master/LICENSE for complete details.
+
+# File is required to exist by Rails

data/test/environments/rails40/Gemfile

@@ -0,0 +1,43 @@
+source 'https://rubygems.org'
+
+gem 'rake'
+
+gem 'rails', '~>4.0.13'
+
+# Do not automatically require minitest, since this will break with rbx-2.2.5.
+# rbx-2.2.5 helpfully bundles minitest-5.3.0.
+# Our tests don't work with minitest-5.3.0.
+# minitest-4.7.5 is the version we want to use here, but if you just do
+# a require 'minitest' on rbx-2.2.5, you'll get 5.3.0 (since 4.7.5 doesn't
+# actually have a minitest.rb file under lib/). The :require => false prevents
+# us from inadvertently loading minitest 5.3.0 on rbx (we'll require
+# minitest/unit instead via a different path).
+gem 'minitest', '~>4.7.5', :require => false
+gem 'mocha', :require => false
+gem 'rack'
+gem 'rack-test'
+
+platforms :jruby do
+  gem "activerecord-jdbcmysql-adapter", "~>1.3.0"
+  gem "activerecord-jdbcsqlite3-adapter", "~>1.3.0"
+  gem "jruby-openssl"
+end
+
+platforms :ruby do
+  gem "mysql"
+  gem "sqlite3"
+end
+
+platforms :rbx do
+  gem "rubysl"
+  gem "json"
+  # If we don't skip the require here, test-unit tries to install its at_exit
+  # hook and run when we run our rake task to create the test DB.
+  gem "rubysl-test-unit", :require => false
+  gem "racc"  # https://github.com/rubinius/rubinius/issues/2632
+end
+
+gem "mmtrix_rpm", :path => "../../.."
+
+gem 'pry', '~> 0.9.12'
+gem 'hometown', '~> 0.2.5'

data/test/environments/rails40/Rakefile

@@ -0,0 +1,11 @@
+# Add your own tasks in files placed in lib/tasks ending in .rake,
+# for example lib/tasks/capistrano.rake, and they will automatically be available to Rake.
+
+require File.expand_path('../config/application', __FILE__)
+require 'rake'
+
+RpmTestApp::Application.load_tasks
+require 'tasks/all'
+
+Rake::Task["default"].clear
+task :default => [:'test:mmtrix']

data/test/environments/rails40/config/application.rb

@@ -0,0 +1,18 @@
+# encoding: utf-8
+# This file is distributed under Mmtrix's license terms.
+# See https://github.com/mmtrix/rpm/blob/master/LICENSE for complete details.
+
+require File.expand_path('../boot', __FILE__)
+
+require 'rails/all'
+
+Bundler.require(:default, Rails.env) if defined?(Bundler)
+
+module RpmTestApp
+  class Application < Rails::Application
+    config.encoding = "utf-8"
+    config.filter_parameters += [:password]
+    config.secret_key_base = '414fd9af0cc192729b2b6bffe9e7077c9ac8eed5cbb74c8c4cd628906b716770598a2b7e1f328052753a4df72e559969dc05b408de73ce040c93cac7c51a348e'
+    config.eager_load = false
+  end
+end

data/test/environments/rails40/config/boot.rb

@@ -0,0 +1,10 @@
+# encoding: utf-8
+# This file is distributed under Mmtrix's license terms.
+# See https://github.com/mmtrix/rpm/blob/master/LICENSE for complete details.
+
+require 'rubygems'
+
+# Set up gems listed in the Gemfile.
+ENV['BUNDLE_GEMFILE'] ||= File.expand_path('../../Gemfile', __FILE__)
+
+require 'bundler/setup' if File.exists?(ENV['BUNDLE_GEMFILE'])

data/test/environments/rails40/config/database.yml

@@ -0,0 +1,26 @@
+mysql: &mysql
+  adapter: mysql
+  socket: <%= (`uname -s` =~ /Linux/ ) ? "" :"/tmp/mysql.sock" %>
+  username: root
+  host: localhost
+  database: <%= db = "#{ENV['RUBY_VERSION']}#{ENV['BRANCH']}"; db.empty? ? "rails_blog" : db %>
+
+sqlite3: &sqlite3
+<% if defined?(JRuby) %>
+  adapter: jdbcsqlite3
+<% else %>
+  adapter: sqlite3
+<% end %>
+  database: db/all.sqlite3
+  pool: 5
+  timeout: 5000
+  host: localhost
+
+development:
+  <<: *sqlite3
+
+test:
+  <<: *mysql
+
+production:
+  <<: *mysql

data/test/environments/rails40/config/environment.rb

@@ -0,0 +1,6 @@
+# encoding: utf-8
+# This file is distributed under Mmtrix's license terms.
+# See https://github.com/mmtrix/rpm/blob/master/LICENSE for complete details.
+
+require File.expand_path('../application', __FILE__)
+RpmTestApp::Application.initialize!

data/test/environments/rails40/db/schema.rb

@@ -0,0 +1,5 @@
+# encoding: utf-8
+# This file is distributed under Mmtrix's license terms.
+# See https://github.com/mmtrix/rpm/blob/master/LICENSE for complete details.
+
+# File is required to exist by Rails

data/test/environments/rails41/Gemfile

@@ -0,0 +1,35 @@
+source 'https://rubygems.org'
+
+gem 'rake'
+
+gem 'rails', '~>4.1.10'
+
+gem 'minitest', '5.2.3'
+gem 'mocha', :require => false
+gem 'rack'
+gem 'rack-test'
+
+platforms :jruby do
+  gem "activerecord-jdbcmysql-adapter", "~>1.3.0"
+  gem "activerecord-jdbcsqlite3-adapter", "~>1.3.0"
+  gem "jruby-openssl"
+end
+
+platforms :ruby do
+  gem "mysql"
+  gem "sqlite3"
+end
+
+platforms :rbx do
+  gem "rubysl"
+  gem "json"
+  # If we don't skip the require here, test-unit tries to install its at_exit
+  # hook and run when we run our rake task to create the test DB.
+  gem "rubysl-test-unit", :require => false
+  gem "racc"  # https://github.com/rubinius/rubinius/issues/2632
+end
+
+gem "mmtrix_rpm", :path => "../../.."
+
+gem 'pry', '~> 0.9.12'
+gem 'hometown', '~> 0.2.5'

data/test/environments/rails41/Rakefile

@@ -0,0 +1,11 @@
+# Add your own tasks in files placed in lib/tasks ending in .rake,
+# for example lib/tasks/capistrano.rake, and they will automatically be available to Rake.
+
+require File.expand_path('../config/application', __FILE__)
+require 'rake'
+
+RpmTestApp::Application.load_tasks
+require 'tasks/all'
+
+Rake::Task["default"].clear
+task :default => [:'test:mmtrix']

data/test/environments/rails41/config/application.rb

@@ -0,0 +1,18 @@
+# encoding: utf-8
+# This file is distributed under Mmtrix's license terms.
+# See https://github.com/mmtrix/rpm/blob/master/LICENSE for complete details.
+
+require File.expand_path('../boot', __FILE__)
+
+require 'rails/all'
+
+Bundler.require(:default, Rails.env) if defined?(Bundler)
+
+module RpmTestApp
+  class Application < Rails::Application
+    config.encoding = "utf-8"
+    config.filter_parameters += [:password]
+    config.secret_key_base = '414fd9af0cc192729b2b6bffe9e7077c9ac8eed5cbb74c8c4cd628906b716770598a2b7e1f328052753a4df72e559969dc05b408de73ce040c93cac7c51a348e'
+    config.eager_load = false
+  end
+end

data/test/environments/rails41/config/boot.rb

@@ -0,0 +1,10 @@
+# encoding: utf-8
+# This file is distributed under Mmtrix's license terms.
+# See https://github.com/mmtrix/rpm/blob/master/LICENSE for complete details.
+
+require 'rubygems'
+
+# Set up gems listed in the Gemfile.
+ENV['BUNDLE_GEMFILE'] ||= File.expand_path('../../Gemfile', __FILE__)
+
+require 'bundler/setup' if File.exists?(ENV['BUNDLE_GEMFILE'])

data/test/environments/rails41/config/database.yml

@@ -0,0 +1,26 @@
+mysql: &mysql
+  adapter: mysql
+  socket: <%= (`uname -s` =~ /Linux/ ) ? "" :"/tmp/mysql.sock" %>
+  username: root
+  host: localhost
+  database: <%= db = "#{ENV['RUBY_VERSION']}#{ENV['BRANCH']}"; db.empty? ? "rails_blog" : db %>
+
+sqlite3: &sqlite3
+<% if defined?(JRuby) %>
+  adapter: jdbcsqlite3
+<% else %>
+  adapter: sqlite3
+<% end %>
+  database: db/all.sqlite3
+  pool: 5
+  timeout: 5000
+  host: localhost
+
+development:
+  <<: *sqlite3
+
+test:
+  <<: *mysql
+
+production:
+  <<: *mysql

data/test/environments/rails41/config/environment.rb

@@ -0,0 +1,6 @@
+# encoding: utf-8
+# This file is distributed under Mmtrix's license terms.
+# See https://github.com/mmtrix/rpm/blob/master/LICENSE for complete details.
+
+require File.expand_path('../application', __FILE__)
+RpmTestApp::Application.initialize!

data/test/environments/rails41/db/schema.rb

@@ -0,0 +1,5 @@
+# encoding: utf-8
+# This file is distributed under Mmtrix's license terms.
+# See https://github.com/mmtrix/rpm/blob/master/LICENSE for complete details.
+
+# File is required to exist by Rails

data/test/environments/rails42/Gemfile

@@ -0,0 +1,39 @@
+source 'https://rubygems.org'
+
+gem 'rake'
+
+gem 'rails', '~>4.2.1'
+
+gem 'minitest', '5.2.3'
+gem 'mocha', :require => false
+gem 'rack'
+gem 'rack-test'
+
+platforms :jruby do
+  gem "activerecord-jdbcmysql-adapter", "~>1.3.0"
+  gem "activerecord-jdbcsqlite3-adapter", "~>1.3.0"
+  gem "jruby-openssl"
+end
+
+platforms :ruby do
+  gem "mysql"
+  gem "sqlite3"
+end
+
+platforms :rbx do
+  gem "rubysl"
+  gem "json"
+  # If we don't skip the require here, test-unit tries to install its at_exit
+  # hook and run when we run our rake task to create the test DB.
+  gem "rubysl-test-unit", :require => false
+  gem "racc"  # https://github.com/rubinius/rubinius/issues/2632
+
+  # Compilation issues with rubysl-openssl 2.2.1, lock at 2.1.0 for now.
+  # https://github.com/rubysl/rubysl-openssl/issues/11
+  gem "rubysl-openssl", "2.1.0"
+end
+
+gem "mmtrix_rpm", :path => "../../.."
+
+gem 'pry', '~> 0.9.12'
+gem 'hometown', '~> 0.2.5'

data/test/environments/rails42/Rakefile

@@ -0,0 +1,11 @@
+# Add your own tasks in files placed in lib/tasks ending in .rake,
+# for example lib/tasks/capistrano.rake, and they will automatically be available to Rake.
+
+require File.expand_path('../config/application', __FILE__)
+require 'rake'
+
+RpmTestApp::Application.load_tasks
+require 'tasks/all'
+
+Rake::Task["default"].clear
+task :default => [:'test:mmtrix']

data/test/environments/rails42/config/application.rb

@@ -0,0 +1,18 @@
+# encoding: utf-8
+# This file is distributed under Mmtrix's license terms.
+# See https://github.com/mmtrix/rpm/blob/master/LICENSE for complete details.
+
+require File.expand_path('../boot', __FILE__)
+
+require 'rails/all'
+
+Bundler.require(:default, Rails.env) if defined?(Bundler)
+
+module RpmTestApp
+  class Application < Rails::Application
+    config.encoding = "utf-8"
+    config.filter_parameters += [:password]
+    config.secret_key_base = '414fd9af0cc192729b2b6bffe9e7077c9ac8eed5cbb74c8c4cd628906b716770598a2b7e1f328052753a4df72e559969dc05b408de73ce040c93cac7c51a348e'
+    config.eager_load = false
+  end
+end

data/test/environments/rails42/config/boot.rb

@@ -0,0 +1,10 @@
+# encoding: utf-8
+# This file is distributed under Mmtrix's license terms.
+# See https://github.com/mmtrix/rpm/blob/master/LICENSE for complete details.
+
+require 'rubygems'
+
+# Set up gems listed in the Gemfile.
+ENV['BUNDLE_GEMFILE'] ||= File.expand_path('../../Gemfile', __FILE__)
+
+require 'bundler/setup' if File.exists?(ENV['BUNDLE_GEMFILE'])

data/test/environments/rails42/config/database.yml

@@ -0,0 +1,26 @@
+mysql: &mysql
+  adapter: mysql
+  socket: <%= (`uname -s` =~ /Linux/ ) ? "" :"/tmp/mysql.sock" %>
+  username: root
+  host: localhost
+  database: <%= db = "#{ENV['RUBY_VERSION']}#{ENV['BRANCH']}"; db.empty? ? "rails_blog" : db %>
+
+sqlite3: &sqlite3
+<% if defined?(JRuby) %>
+  adapter: jdbcsqlite3
+<% else %>
+  adapter: sqlite3
+<% end %>
+  database: db/all.sqlite3
+  pool: 5
+  timeout: 5000
+  host: localhost
+
+development:
+  <<: *sqlite3
+
+test:
+  <<: *mysql
+
+production:
+  <<: *mysql

data/test/environments/rails42/config/environment.rb

@@ -0,0 +1,6 @@
+# encoding: utf-8
+# This file is distributed under Mmtrix's license terms.
+# See https://github.com/mmtrix/rpm/blob/master/LICENSE for complete details.
+
+require File.expand_path('../application', __FILE__)
+RpmTestApp::Application.initialize!

data/test/environments/rails42/db/schema.rb

@@ -0,0 +1,5 @@
+# encoding: utf-8
+# This file is distributed under Mmtrix's license terms.
+# See https://github.com/mmtrix/rpm/blob/master/LICENSE for complete details.
+
+# File is required to exist by Rails

data/test/fixtures/cross_agent_tests/README.md

@@ -0,0 +1,56 @@
+# Cross Agent Tests
+
+### Data Policy
+
+None of these tests should contain customer data such as SQL strings.
+Please be careful when adding new tests from real world failures.
+
+### Tests
+
+| Test Files    | Description   |
+| ------------- |-------------|
+| [rum_loader_insertion_location](rum_loader_insertion_location) | Describe where the RUM loader (formerly known as header) should be inserted. |
+| [rum_footer_insertion_location](rum_footer_insertion_location) | Describe where the RUM footer (aka "client config") should be inserted.  These tests do not apply to agents which insert the footer directly after the loader. |
+| [rules.json](rules.json) | Describe how url/metric/txn-name rules should be applied. |
+| [rum_client_config.json](rum_client_config.json) | These tests dictate the format and contents of the browser monitoring client configuration.  For more information see: [SPEC](https://mmtrix.atlassian.net/wiki/display/eng/JavaScript+Agent+Auto-Instrumentation) |
+| [sql_parsing.json](sql_parsing.json) | These tests show how an SQL string should be parsed for the operation and table name. |
+| [url_clean.json](url_clean.json) | These tests show how URLs should be cleaned before putting them into a trace segment's parameter hash (under the key 'uri'). |
+| [url_domain_extraction.json](url_domain_extraction.json) | These tests show how the domain of a URL should be extracted (for the purpose of creating external metrics). |
+| [postgres_explain_obfuscation](postgres_explain_obfuscation) | These tests show how plain-text explain plan output from PostgreSQL should be obfuscated when SQL obfuscation is enabled. |
+| [sql_obfuscation](sql_obfuscation) | Describe how agents should obfuscate SQL queries before transmission to the collector. |
+| [attribute_configuration](attribute_configuration.json) | These tests show how agents should respond to the various attribute configuration settings.  For more information see: [Attributes SPEC](https://mmtrix.atlassian.net/wiki/display/eng/Agent+Attributes) |
+| [cat_map](cat_map.json) | These tests cover the new Dirac attributes that are added for the CAT Map project. See the [CAT Map Spec](https://mmtrix.jiveon.com/docs/DOC-1798) and the section below for details.|
+| [labels](labels.json) | These tests cover the Labels for Language Agents project. See the [Labels for Language Agents Spec](https://mmtrix.atlassian.net/wiki/display/eng/Labels+for+Language+Agents) for details.|
+| [proc_cpuinfo](proc_cpuinfo) | These test correct processing of `/proc/cpuinfo` output on Linux hosts. |
+| [proc_meminfo](proc_meminfo) | These test correct processing of `/proc/meminfo` output on Linux hosts. |
+| [transaction_segment_terms.json](transaction_segment_terms.json) | These tests cover agent implementations of the `transaction_segment_terms` transaction renaming rules introduced in collector protocol 14. See [the spec](https://mmtrix.atlassian.net/wiki/display/eng/Language+agent+transaction+segment+terms+rules) for details. |
+| [docker_container_id](docker_container_id) | These tests cover parsing of Docker container IDs from `/proc/*/cgroup` on Linux hosts. |
+
+### CAT Map test details
+
+The CAT map test cases in `cat_map.json` are meant to be used to verify the
+attributes that agents collect and attach to analytics transaction events for
+the CAT map project.
+
+**NOTE** currently `nr.apdexPerfZone` is not covered by these tests, make sure you test for this yourself until it is added to these tests.
+
+Each test case should correspond to a simulated transaction in the agent under
+test. Here's what the various fields in each test case mean:
+
+| Name | Meaning |
+| ---- | ------- |
+| `name` | A human-meaningful name for the test case. |
+| `appName` | The name of the Mmtrix application for the simulated transaction. |
+| `transactionName` | The final name of the simulated transaction. |
+| `transactionGuid` | The GUID of the simulated transaction. |
+| `inboundPayload` | The (non-serialized) contents of the `X-Mmtrix-Transaction` HTTP request header on the simulated transaction. Note that this value should be serialized to JSON, obfuscated using the CAT obfuscation algorithm, and Base64-encoded before being used in the header value. Note also that the `X-Mmtrix-ID` header should be set on the simulated transaction, though its value is not specified in these tests. |
+| `expectedIntrinsicFields` | A set of key-value pairs that are expected to be present in the analytics event generated for the simulated transaction. These fields should be present in the first hash of the analytic event payload (built-in agent-supplied fields). |
+| `nonExpectedIntrinsicFields` | An array of attribute names that should *not* be present in the analytics event generated for the simulated transaction. |
+| `outboundRequests` | An array of objects representing outbound requests that should be made in the context of the simulated transaction. See the table below for details. Only present if the test case involves making outgoing requests from the simulated transaction. |
+
+Here's what the fields of each entry in the `outboundRequests` array mean:
+
+| Name | Meaning |
+| ---- | ------- |
+| `outboundTxnName` | The name of the simulated transaction at the time this outbound request is made. Your test driver should set the transaction name to this value prior to simulating the outbound request. |
+| `expectedOutboundPayload` | The expected (un-obfuscated) content of the outbound `X-Mmtrix-Transaction` request header for this request. |