Merge pull request #4 from stackify/SF-6621

darinhoward · web-flow · commit 72da963399a7 · 2017-07-06T09:50:24.000-05:00
SF-6621 - adding 'start' attribute to Trace annotation to support cus…
diff --git a/README.md b/README.md
@@ -37,13 +37,24 @@ file (stackify-apm.json) to your application.
 name can be a `String` and can also include the variables `{{ClassName}}`, `{{MethodName}}` and `{{MethodParameters[#]}}`
 (where `#` is an `int` referencing the parameter index on the annotated method, index starts at 0).
 
+#### Custom Trace Entry Point
+Stackify by default generates traces from web-requests on [supported application servers](http://support.stackify.com/hc/en-us/articles/209709913-What-Java-Application-Containers-and-Frameworks-are-Supported-) 
+and non-web-requests from [supported frameworks](http://support.stackify.com/hc/en-us/articles/209709913-What-Java-Application-Containers-and-Frameworks-are-Supported-).
+You can extend support by using `@Trace(start = true)` on a method; which will start a new trace. 
 
 ```
 import com.stackify.apm.Trace;
 
 @Trace
 public class ClassToBeInstrumented 
 {
+
+    @Trace(start = true)
+    public void methodToStartNewTrace()
+    {
+        ...
+    }
+
     @Trace
     public void methodToBeInstrumented()
     {
@@ -77,7 +88,7 @@ public class ClassToBeInstrumented
 
 ## License
 
-Copyright 2016 Stackify, LLC.
+Copyright 2017 Stackify, LLC.
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
diff --git a/src/main/java/com/stackify/apm/Trace.java b/src/main/java/com/stackify/apm/Trace.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2016 Stackify
+ * Copyright 2017 Stackify
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -35,6 +35,13 @@
  * {@literal @}Trace
  * public class ClassToBeInstrumented
  * {
+ *
+ *     {@literal @}Trace(start = true)
+ *     public void methodToStartNewTrace()
+ *     {
+ *         ...
+ *     }
+ *
  *     {@literal @}Trace
  *     public void methodToBeInstrumented()
  *     {
@@ -90,9 +97,10 @@
     String trackedFunctionName() default "";
 
 	String category() default "Java";
-	
+
 	String subcategory() default "Other";
-	
+
 	boolean action() default false;
-	
+
+    boolean start() default false;
 }
