RubyGems - mmtrix_rpm - Versions diffs - 1.0.0.1 - Mend

mmtrix_rpm 1.0.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1036) hide show

data/test/fixtures/cross_agent_tests/rum_loader_insertion_location/script2.html ADDED Viewed

@@ -0,0 +1,17 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+  <head>EXPECTED_RUM_LOADER_LOCATION
+    <title>Castor</title>
+  </head>
+  <body>
+    <script language="javascript" >
+    var strFrameInfoWrapper = "";
+    strFrameInfoWrapper+= "<body style='overflow-y:hidden;padding: 0px 0px 0px 0px; margin: 0px 0px 0px 0px;' >";
+    strFrameInfoWrapper+= "<div id='communicationsButton' style='display:none; position: absolute; z-index: 9999; right:0px; top:-2px; cursor: hand;'>";
+    strFrameInfoWrapper+= "</div>";
+    strFrameInfoWrapper+= "</body>";
+    </script>
+  </body>
+</html>

data/test/fixtures/cross_agent_tests/rum_loader_insertion_location/x_ua_meta_tag.html ADDED Viewed

@@ -0,0 +1,10 @@
+<html>
+  <head>
+    <title>im a title</title>
+    <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1"/>EXPECTED_RUM_LOADER_LOCATION
+    <script>
+      junk
+    </script>
+  </head>
+  <body>im some body text</body>
+</html>

data/test/fixtures/cross_agent_tests/rum_loader_insertion_location/x_ua_meta_tag_multiline.html ADDED Viewed

@@ -0,0 +1,11 @@
+<html>
+  <head>
+    <title>im a title</title>
+    <META http-equiv='x-ua-compatible'
+          content="IE=edge,chrome=1"  />EXPECTED_RUM_LOADER_LOCATION
+    <script>
+      junk
+    </script>
+  </head>
+  <body>im some body text</body>
+</html>

data/test/fixtures/cross_agent_tests/rum_loader_insertion_location/x_ua_meta_tag_multiple_tags.html ADDED Viewed

@@ -0,0 +1,12 @@
+<html>
+  <head>
+    <title>im a title</title>
+    <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1"/>EXPECTED_RUM_LOADER_LOCATION
+    <meta name="keywords" content="testing,rum,insertion" >
+      <script>
+          junk
+      </script>
+      <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1"/>
+  </head>
+  <body>im some body text</body>
+</html>

data/test/fixtures/cross_agent_tests/rum_loader_insertion_location/x_ua_meta_tag_spaces_around_equals.html ADDED Viewed

@@ -0,0 +1,10 @@
+<html>
+  <head>
+    <title>im a title</title>
+    <meta http-equiv =  "X-UA-Compatible" content="IE=edge,chrome=1"/>EXPECTED_RUM_LOADER_LOCATION
+    <script>
+      junk
+    </script>
+  </head>
+  <body>im some body text</body>
+</html>

data/test/fixtures/cross_agent_tests/rum_loader_insertion_location/x_ua_meta_tag_with_others.html ADDED Viewed

@@ -0,0 +1,11 @@
+<html>
+  <head>
+    <title>im a title</title>
+    <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1"/>EXPECTED_RUM_LOADER_LOCATION
+    <meta name="keywords" content="testing,rum,insertion" >
+    <script>
+      junk
+    </script>
+  </head>
+  <body>im some body text</body>
+</html>

data/test/fixtures/cross_agent_tests/rum_loader_insertion_location/x_ua_meta_tag_with_spaces.html ADDED Viewed

@@ -0,0 +1,10 @@
+<html>
+  <head>
+    <title>im a title</title>
+    <META   http-equiv='x-ua-compatible'   content="IE=edge,chrome=1"  />EXPECTED_RUM_LOADER_LOCATION
+    <script>
+      junk
+    </script>
+  </head>
+  <body>im some body text</body>
+</html>

data/test/fixtures/cross_agent_tests/sql_obfuscation/README.md ADDED Viewed

@@ -0,0 +1,30 @@
+These test cases cover obfuscation (more properly, masking) of literal values
+from SQL statements captured by agents. SQL statements may be captured and
+attached to transaction trace nodes, or to slow SQL traces.
+`sql_obfuscation.json` contains an array of test cases.  The inputs for each
+test case are in the `sql` property of each object. Each test case also has an
+`obfuscated` property which is an array containing at least one valid output.
+Test cases also have a `dialects` property, which is an array of strings which
+specify which sql dialects the test should apply to. Currently the options are
+`mysql`, `postgres`, or `all`  This is relevant because PostgreSQL uses
+different identifier and string quoting rules than MySQL (most notably,
+double-quoted string literals are not allowed in PostgreSQL, where
+double-quotes are instead used around identifiers).
+Test cases may also contain the following properties:
+  * `malformed`: (boolean) tests who's SQL queries are not valid SQL in any
+  quoting mode. Some agents may choose to attempt to obfuscate these cases,
+  and others may instead just replace the query entirely with a placeholder
+  message.
+  * `pathological`: (boolean) tests which are designed specifically to break
+  specific methods of obfuscation, or contain patterns that are known to be
+  difficult to handle correctly
+  * `comments`: an array of strings that could be usefult for understanding
+  the test.
+The following database documentation may be helpful in understanding these test
+cases:
+* [MySQL String Literals](http://dev.mysql.com/doc/refman/5.5/en/string-literals.html)
+* [PostgreSQL String Constants](http://www.postgresql.org/docs/8.2/static/sql-syntax-lexical.html#SQL-SYNTAX-CONSTANTS)

data/test/fixtures/cross_agent_tests/sql_obfuscation/sql_obfuscation.json ADDED Viewed

@@ -0,0 +1,365 @@
+[
+  {
+    "name": "back_quoted_identifiers.mysql",
+    "obfuscated": [
+      "SELECT `t001`.`c2` FROM `t001` WHERE `t001`.`c2` = ? AND c3=? LIMIT ?"
+    ],
+    "dialects": [
+      "mysql"
+    ],
+    "sql": "SELECT `t001`.`c2` FROM `t001` WHERE `t001`.`c2` = 'value' AND c3=\"othervalue\" LIMIT ?"
+  },
+  {
+    "name": "comment_delimiters_in_double_quoted_strings",
+    "obfuscated": [
+      "SELECT * FROM t WHERE foo=? AND baz=?"
+    ],
+    "dialects": [
+      "mysql"
+    ],
+    "sql": "SELECT * FROM t WHERE foo=\"bar/*\" AND baz=\"whatever */qux\""
+  },
+  {
+    "name": "comment_delimiters_in_single_quoted_strings",
+    "obfuscated": [
+      "SELECT * FROM t WHERE foo=? AND baz=?"
+    ],
+    "dialects": [
+      "mysql",
+      "postgres"
+    ],
+    "sql": "SELECT * FROM t WHERE foo='bar/*' AND baz='whatever */qux'"
+  },
+  {
+    "name": "double_quoted_identifiers.postgres",
+    "obfuscated": [
+      "SELECT \"t001\".\"c2\" FROM \"t001\" WHERE \"t001\".\"c2\" = ? AND c3=? LIMIT ?"
+    ],
+    "dialects": [
+      "postgres"
+    ],
+    "sql": "SELECT \"t001\".\"c2\" FROM \"t001\" WHERE \"t001\".\"c2\" = 'value' AND c3=1234 LIMIT 1"
+  },
+  {
+    "name": "end_of_line_comment_in_double_quoted_string",
+    "obfuscated": [
+      "SELECT * FROM t WHERE foo=? AND\n  baz=?"
+    ],
+    "dialects": [
+      "mysql"
+    ],
+    "sql": "SELECT * FROM t WHERE foo=\"bar--\" AND\n  baz=\"qux--\""
+  },
+  {
+    "name": "end_of_line_comment_in_single_quoted_string",
+    "obfuscated": [
+      "SELECT * FROM t WHERE foo=? AND\n  baz=?"
+    ],
+    "dialects": [
+      "mysql",
+      "postgres"
+    ],
+    "sql": "SELECT * FROM t WHERE foo='bar--' AND\n  baz='qux--'"
+  },
+  {
+    "name": "end_of_query_comment_cstyle",
+    "obfuscated": [
+      "SELECT * FROM foo WHERE bar=? ?"
+    ],
+    "dialects": [
+      "mysql",
+      "postgres"
+    ],
+    "sql": "SELECT * FROM foo WHERE bar='baz' /* Hide Me */"
+  },
+  {
+    "name": "end_of_query_comment_doubledash",
+    "obfuscated": [
+      "SELECT * FROM foobar WHERE password=?\n?"
+    ],
+    "dialects": [
+      "mysql",
+      "postgres"
+    ],
+    "sql": "SELECT * FROM foobar WHERE password='hunter2'\n-- No peeking!"
+  },
+  {
+    "name": "end_of_query_comment_hash",
+    "obfuscated": [
+      "SELECT foo, bar FROM baz WHERE password=? ?"
+    ],
+    "dialects": [
+      "mysql",
+      "postgres"
+    ],
+    "sql": "SELECT foo, bar FROM baz WHERE password='hunter2' # Secret"
+  },
+  {
+    "name": "escape_string_constants.postgres",
+    "obfuscated": [
+      "SELECT \"col1\", \"col2\" from \"table\" WHERE \"col3\"=E? AND country=e?"
+    ],
+    "dialects": [
+      "postgres"
+    ],
+    "sql": "SELECT \"col1\", \"col2\" from \"table\" WHERE \"col3\"=E'foo\\'bar\\\\baz' AND country=e'foo\\'bar\\\\baz'",
+    "comments": [
+      "PostgreSQL supports an alternate string quoting mode where backslash escape",
+      "sequences are interpreted.",
+      "See: http://www.postgresql.org/docs/9.3/static/sql-syntax-lexical.html#SQL-SYNTAX-STRINGS-ESCAPE"
+    ]
+  },
+  {
+    "name": "multiple_literal_types.mysql",
+    "obfuscated": [
+      "INSERT INTO `X` values(?,?, ? , ?, ?)"
+    ],
+    "dialects": [
+      "mysql"
+    ],
+    "sql": "INSERT INTO `X` values(\"test\",0, 1 , 2, 'test')"
+  },
+  {
+    "name": "numbers_in_identifiers",
+    "obfuscated": [
+      "SELECT c11.col1, c22.col2 FROM table c11, table c22 WHERE value=?"
+    ],
+    "dialects": [
+      "mysql",
+      "postgres"
+    ],
+    "sql": "SELECT c11.col1, c22.col2 FROM table c11, table c22 WHERE value='nothing'"
+  },
+  {
+    "name": "numeric_literals",
+    "obfuscated": [
+      "INSERT INTO X VALUES(?, ?, ?.?, ?+?)"
+    ],
+    "dialects": [
+      "mysql",
+      "postgres"
+    ],
+    "sql": "INSERT INTO X VALUES(1, 23456, 123.456, 99+100)"
+  },
+  {
+    "name": "string_double_quoted.mysql",
+    "obfuscated": [
+      "SELECT * FROM table WHERE name=? AND value=?"
+    ],
+    "dialects": [
+      "mysql"
+    ],
+    "sql": "SELECT * FROM table WHERE name=\"foo\" AND value=\"don't\""
+  },
+  {
+    "name": "string_single_quoted",
+    "obfuscated": [
+      "SELECT * FROM table WHERE name=? AND value = ?"
+    ],
+    "dialects": [
+      "mysql",
+      "postgres"
+    ],
+    "sql": "SELECT * FROM table WHERE name='foo' AND value = 'bar'"
+  },
+  {
+    "name": "string_with_backslash_and_twin_single_quotes",
+    "obfuscated": [
+      "SELECT * FROM table WHERE col=?"
+    ],
+    "dialects": [
+      "mysql",
+      "postgres"
+    ],
+    "sql": "SELECT * FROM table WHERE col='foo\\''bar'",
+    "comments": [
+      "If backslashes are being ignored in single-quoted strings",
+      "(standard_conforming_strings=on in PostgreSQL, or NO_BACKSLASH_ESCAPES is on",
+      "in MySQL), then this is valid SQL."
+    ]
+  },
+  {
+    "name": "string_with_embedded_double_quote",
+    "obfuscated": [
+      "SELECT * FROM table WHERE col1=? AND col2=?"
+    ],
+    "dialects": [
+      "mysql",
+      "postgres"
+    ],
+    "sql": "SELECT * FROM table WHERE col1='foo\"bar' AND col2='what\"ever'"
+  },
+  {
+    "name": "string_with_embedded_newline",
+    "obfuscated": [
+      "select * from accounts where accounts.name != ? order by accounts.name"
+    ],
+    "dialects": [
+      "mysql",
+      "postgres"
+    ],
+    "sql": "select * from accounts where accounts.name != 'dude \n newline' order by accounts.name"
+  },
+  {
+    "name": "string_with_embedded_single_quote.mysql",
+    "obfuscated": [
+      "SELECT * FROM table WHERE col1=? AND col2=?"
+    ],
+    "dialects": [
+      "mysql"
+    ],
+    "sql": "SELECT * FROM table WHERE col1=\"don't\" AND col2=\"won't\""
+  },
+  {
+    "name": "string_with_escaped_quotes.mysql",
+    "obfuscated": [
+      "INSERT INTO X values(?, ?,?, ? , ?, ?, ?)"
+    ],
+    "dialects": [
+      "mysql"
+    ],
+    "sql": "INSERT INTO X values('', 'jim''s ssn',0, 1 , 'jim''s son''s son', \"\"\"jim''s\"\" hat\", \"\\\"jim''s secret\\\"\")"
+  },
+  {
+    "name": "string_with_trailing_backslash",
+    "obfuscated": [
+      "SELECT * FROM table WHERE name=? AND color=?"
+    ],
+    "dialects": [
+      "mysql",
+      "postgres"
+    ],
+    "sql": "SELECT * FROM table WHERE name='foo\\' AND color='blue'",
+    "comments": [
+      "If backslashes are being ignored in single-quoted strings",
+      "(standard_conforming_strings=on in PostgreSQL, or NO_BACKSLASH_ESCAPES is on",
+      "in MySQL), then this is valid SQL."
+    ]
+  },
+  {
+    "name": "string_with_trailing_escaped_backslash.mysql",
+    "obfuscated": [
+      "SELECT * FROM table WHERE foo=?"
+    ],
+    "dialects": [
+      "mysql"
+    ],
+    "sql": "SELECT * FROM table WHERE foo=\"this string ends with a backslash\\\\\""
+  },
+  {
+    "name": "string_with_trailing_escaped_backslash_single_quoted",
+    "obfuscated": [
+      "SELECT * FROM table WHERE foo=?"
+    ],
+    "dialects": [
+      "mysql",
+      "postgres"
+    ],
+    "sql": "SELECT * FROM table WHERE foo='this string ends with a backslash\\\\'"
+  },
+  {
+    "name": "string_with_trailing_escaped_quote",
+    "obfuscated": [
+      "SELECT * FROM table WHERE name=? AND color=?"
+    ],
+    "dialects": [
+      "mysql",
+      "postgres"
+    ],
+    "sql": "SELECT * FROM table WHERE name='foo\\'' AND color='blue'"
+  },
+  {
+    "name": "string_with_twin_single_quotes",
+    "obfuscated": [
+      "INSERT INTO X values(?, ?,?, ? , ?)"
+    ],
+    "dialects": [
+      "mysql",
+      "postgres"
+    ],
+    "sql": "INSERT INTO X values('', 'a''b c',0, 1 , 'd''e f''s h')"
+  },
+  {
+    "name": "pathological/end_of_line_comments_with_quotes",
+    "obfuscated": [
+      "SELECT * FROM t WHERE ?"
+    ],
+    "dialects": [
+      "mysql",
+      "postgres"
+    ],
+    "sql": "SELECT * FROM t WHERE -- '\n  bar='baz' -- '",
+    "pathological": true
+  },
+  {
+    "name": "pathological/mixed_comments_and_quotes",
+    "obfuscated": [
+      "SELECT * FROM t WHERE ?"
+    ],
+    "dialects": [
+      "mysql",
+      "postgres"
+    ],
+    "sql": "SELECT * FROM t WHERE /* ' */ \n  bar='baz' -- '",
+    "pathological": true
+  },
+  {
+    "name": "pathological/mixed_quotes_comments_and_newlines",
+    "obfuscated": [
+      "SELECT * FROM t WHERE ?"
+    ],
+    "dialects": [
+      "mysql",
+      "postgres"
+    ],
+    "sql": "SELECT * FROM t WHERE -- '\n  /* ' */ c2='xxx' /* ' */\n  c='x\n  xx' -- '",
+    "pathological": true
+  },
+  {
+    "name": "pathological/mixed_quotes_end_of_line_comments",
+    "obfuscated": [
+      "SELECT * FROM t WHERE ?"
+    ],
+    "dialects": [
+      "mysql",
+      "postgres"
+    ],
+    "sql": "SELECT * FROM t WHERE -- '\n  c='x\n  xx' -- '",
+    "pathological": true
+  },
+  {
+    "name": "pathological/quote_delimiters_in_comments",
+    "obfuscated": [
+      "SELECT * FROM foo WHERE col=? AND ?"
+    ],
+    "dialects": [
+      "mysql",
+      "postgres"
+    ],
+    "sql": "SELECT * FROM foo WHERE col='value1' AND /* don't */ col2='value1' /* won't */",
+    "pathological": true
+  },
+  {
+    "name": "malformed/unterminated_double_quoted_string.mysql",
+    "sql": "SELECT * FROM table WHERE foo='bar' AND baz=\"nothing to see here'",
+    "dialects": [
+      "mysql"
+    ],
+    "obfuscated": [
+      "?"
+    ],
+    "malformed": true
+  },
+  {
+    "name": "malformed/unterminated_single_quoted_string",
+    "sql": "SELECT * FROM table WHERE foo='bar' AND baz='nothing to see here",
+    "dialects": [
+      "mysql",
+      "postgres"
+    ],
+    "obfuscated": [
+      "?"
+    ],
+    "malformed": true
+  }
+]

data/test/fixtures/cross_agent_tests/sql_parsing.json ADDED Viewed

@@ -0,0 +1,55 @@
+[
+  {"input":"SELECT * FROM foobar",                                   "operation":"select", "table":"foobar"},
+  {"input":"SELECT F FROM foobar",                                   "operation":"select", "table":"foobar"},
+  {"input":"SELECT Ff FROM foobar",                                  "operation":"select", "table":"foobar"},
+  {"input":"SELECT I FROM foobar",                                   "operation":"select", "table":"foobar"},
+  {"input":"SELECT FROMM FROM foobar",                               "operation":"select", "table":"foobar"},
+  {"input":"SELECT * FROM foobar WHERE x > y",                       "operation":"select", "table":"foobar"},
+  {"input":"SELECT * FROM `foobar`",                                 "operation":"select", "table":"foobar"},
+  {"input":"SELECT * FROM `foobar` WHERE x > y",                     "operation":"select", "table":"foobar"},
+  {"input":"SELECT * FROM database.foobar",                          "operation":"select", "table":"foobar"},
+  {"input":"SELECT * FROM database.foobar WHERE x > y",              "operation":"select", "table":"foobar"},
+  {"input":"SELECT * FROM `database`.foobar",                        "operation":"select", "table":"foobar"},
+  {"input":"SELECT * FROM `database`.foobar WHERE x > y",            "operation":"select", "table":"foobar"},
+  {"input":"SELECT * FROM database.`foobar`",                        "operation":"select", "table":"foobar"},
+  {"input":"SELECT * FROM database.`foobar` WHERE x > y",            "operation":"select", "table":"foobar"},
+  {"input":"SELECT * FROM (foobar)",                                 "operation":"select", "table":"foobar"},
+  {"input":"SELECT * FROM(foobar)",                                  "operation":"select", "table":"foobar"},
+  {"input":"SELECT * FROM (foobar) WHERE x > y",                     "operation":"select", "table":"foobar"},
+  {"input":"SELECT * FROM (`foobar`)",                               "operation":"select", "table":"foobar"},
+  {"input":"SELECT * FROM (`foobar`) WHERE x > y",                   "operation":"select", "table":"foobar"},
+  {"input":"SELECT * FROM (SELECT * FROM foobar)",                   "operation":"select", "table":"(subquery)"},
+  {"input":"SELECT * FROM (SELECT * FROM foobar) WHERE x > y",       "operation":"select", "table":"(subquery)"},
+  {"input":"SELECT xy,zz,y FROM foobar",                             "operation":"select", "table":"foobar"},
+  {"input":"SELECT xy,zz,y FROM foobar ORDER BY zy",                 "operation":"select", "table":"foobar"},
+  {"input":"SELECT xy,zz,y FROM `foobar`",                           "operation":"select", "table":"foobar"},
+  {"input":"SELECT xy,zz,y FROM `foobar` ORDER BY zy",               "operation":"select", "table":"foobar"},
+  {"input":"SELECT `xy`,`zz`,y FROM foobar",                         "operation":"select", "table":"foobar"},
+  {"input":"SELECT Name FROM `world`.`City` WHERE Population > ?",   "operation":"select", "table":"City"},
+  {"input":"SELECT frok FROM `world`.`City` WHERE Population > ?",   "operation":"select", "table":"City"},
+  {"input":"SELECT irom FROM `world`.`City` WHERE Population > ?",   "operation":"select", "table":"City"},
+  {"input":"SELECT fromm FROM `world`.`City` WHERE Population > ?",  "operation":"select", "table":"City"},
+  {"input":"SELECT * FROM foo,bar",                                  "operation":"select", "table":"foo"},
+  {"input":"  \tSELECT * from \"foo\" WHERE a = b",                  "operation":"select", "table":"foo"},
+  {"input":"  \tSELECT     *     \t from \"bar\" WHERE a = b",       "operation":"select", "table":"bar"},
+  {"input":"SELECT * FROM(SELECT * FROM foobar) WHERE x > y",        "operation":"select", "table":"(subquery)"},
+  {"input":"SELECT FROM_UNIXTIME() from \"bar\"",                    "operation":"select", "table":"bar"},
+  {"input":"SELECT ffrom from \"frome\"",                            "operation":"select", "table":"frome"},
+  {"input":"SELECT ffrom from (\"frome\")",                          "operation":"select", "table":"frome"},
+  {"input":"UPDATE abc SET x=1, y=2",                                "operation":"update", "table":"abc"},
+  {"input":"    \tUPDATE abc SET ffrom='iinto'",                     "operation":"update", "table":"abc"},
+  {"input":"    \tUPDATE 'abc' SET ffrom='iinto'",                   "operation":"update", "table":"abc"},
+  {"input":"    \tUPDATE `abc` SET ffrom='iinto'",                   "operation":"update", "table":"abc"},
+  {"input":"    \tUPDATE \"abc\" SET ffrom='iinto'",                 "operation":"update", "table":"abc"},
+  {"input":"    \tUPDATE\r\tabc SET ffrom='iinto'",                  "operation":"update", "table":"abc"},
+  {"input":"INSERT INTO foobar (x,y) VALUES (1,2)",                  "operation":"insert", "table":"foobar"},
+  {"input":"INSERT INTO foobar(x,y) VALUES (1,2)",                   "operation":"insert", "table":"foobar"},
+  {"input":" /* a */ SELECT * FROM alpha",                           "operation":"select", "table":"alpha"},
+  {"input":"SELECT /* a */ * FROM alpha",                            "operation":"select", "table":"alpha"},
+  {"input":"SELECT * /* a */ FROM alpha",                            "operation":"select", "table":"alpha"},
+  {"input":"SELECT * FROM /* a */ alpha",                            "operation":"select", "table":"alpha"},
+  {"input":"/* X */ SELECT /* Y */ foo/**/ FROM /**/alpha/**/",      "operation":"select", "table":"alpha"}
+]

data/test/fixtures/cross_agent_tests/synthetics/README.md ADDED Viewed

@@ -0,0 +1,65 @@
+# Synthetics Tests
+The Synthetics tests are designed to verify that the agent handles valid and invalid Synthetics requests.
+Each test should run a simulated web transaction. A Synthetics HTTP request header is added to the incoming request at the beginning of a web transaction. During the course of the web transaction, an external request is made. And, at the completion of the web transaction, both a Transaction Trace and Transaction Event are recorded.
+Each test then verifies that the correct attributes are added to the Transaction Trace and Transaction Event, and the proper request header is added to the external request when required. Or, in the case of an invalid Synthetics request, that the attributes and request header are **not** added.
+## Name
+| Name | Meaning |
+| ---- | ------- |
+| `name` | A human-meaningful name for the test case. |
+## Settings
+The `settings` hash contains a number of key-value pairs that the agent will need to use for configuration for the test.
+| Name | Meaning |
+| ---- | ------- |
+| `agentEncodingKey`| The encoding key used by the agent for deobfuscation of the Synthetics request header. |
+| `syntheticsEncodingKey` | The encoding key used by Synthetics to obfuscate the Synthetics request header. In most tests, `encodingKey` and `syntheticsEncodingKey` are the same. |
+| `transactionGuid` | The GUID of the simulated transaction. In a non-simulated transaction, this will be randomly generated. But, for testing purposes, you should assign this value as the GUID, since the tests will check for this value to be set in the `nr.guid` attribute of the Transaction Event. |
+| `trustedAccountIds` | A list of accounts ids that the agent trusts. If the Synthetics request contains a non-trusted account id, it is an invalid request.|
+## Inputs
+The input for each test is a Synthetics request header. The test fixture file shows both the de-obfuscated version of the payload, as well as the resulting obfuscated version.
+| Name | Meaning |
+| ---- | ------- |
+| `inputHeaderPayload` | A decoded form of the contents of the `X-Mmtrix-Synthetics` request header. |
+| `inputObfuscatedHeader` | An obfuscated form of the `X-Mmtrix-Synthetics` request header. If you obfuscate `syntheticsHeaderPayload` using the CAT obfuscation algorithm, this should be the output. |
+## Outputs
+There are three different outputs that are tested for: Transaction Trace, Transaction Event, and External Request Header.
+### outputTransactionTrace
+The `outputTransactionTrace` hash contains three objects:
+| Name | Meaning |
+| ---- | ------- |
+| `header` | The last field of the transaction sample array should be set to the Synthetics Resource ID for a Synthetics request, and should be set to `null` if it isn't. (The last field in the array is the 10th element in the header array, but is `header[9]` in zero-based array notation, so the key name is `field_9`.) |
+| `expectedIntrinsics` | A set of key-value pairs that represent the attributes that should be set in the intrinsics section of the Transaction Trace. **Note**: If the agent has not implemented the Agent Attributes spec, then the agent should save the attributes in the `Custom` section, and the attribute names should have 'nr.' prepended to them. Read the spec for details. For agents in this situation, they will need to adjust the expected output of the tests accordingly. |
+| `nonExpectedIntrinsics` | An array of names that represent the attributes that should **not** be set in the intrinsics section of the Transaction Trace.|
+### outputTransactionEvent
+The `outputTransactionEvent` hash contains two objects:
+| Name | Meaning |
+| ---- | ------- |
+| `expectedAttributes` | A set of key-value pairs that represent the attributes that should be set in the `Intrinsic` hash of the Transaction Event. |
+| `nonExpectedAttributes` | An array of names that represent the attributes that should **not** be set in the `Intrinsic` hash of the Transaction Event. |
+### outputExternalRequestHeader
+The `outputExternalRequestHeader` hash contains two objects:
+| Name | Meaning |
+| ---- | ------- |
+| `expectedHeader` | The outbound header that should be added to external requests (similar to the CAT header), when the original request was made from a valid Synthetics request. |
+| `nonExpectedHeader` | The outbound header that should **not** be added to external requests, when the original request was made from a non-Synthetics request. |