aboutsummaryrefslogtreecommitdiff
path: root/site
diff options
context:
space:
mode:
authorIvan Topolnak <itopolnak@despegar.com>2014-01-20 16:36:39 -0300
committerIvan Topolnak <itopolnak@despegar.com>2014-01-20 16:36:39 -0300
commit301398a0e89763d2092195cc8e7e3451ef3b8aa9 (patch)
tree6951298f6f230783f8468b47ae6c4bd4c2514e2b /site
parentd065ab93a1fb69a1746d6c725b88f8541361ce74 (diff)
downloadKamon-301398a0e89763d2092195cc8e7e3451ef3b8aa9.tar.gz
Kamon-301398a0e89763d2092195cc8e7e3451ef3b8aa9.tar.bz2
Kamon-301398a0e89763d2092195cc8e7e3451ef3b8aa9.zip
simple getting started page
Diffstat (limited to 'site')
-rw-r--r--site/src/jekyll/get-started.md60
1 files changed, 60 insertions, 0 deletions
diff --git a/site/src/jekyll/get-started.md b/site/src/jekyll/get-started.md
new file mode 100644
index 00000000..a1736841
--- /dev/null
+++ b/site/src/jekyll/get-started.md
@@ -0,0 +1,60 @@
+---
+title: Kamon | Get Started
+layout: default
+---
+
+Get Started with Kamon
+======================
+
+Kamon is distrubuted as a set of libraries that you include in your application classpath. This libraries contain all the
+required pointcuts and advices (yeap, Kamon uses Aspectj!) for instrumenting Akka actors message passing, dispatchers, futures,
+Spray components and much more.
+
+To get started just follow this steps:
+
+
+First: Include the modules you want in your project.
+----------------------------------------------------
+
+All Kamon libraries are available through the official Kamon repository:
+
+```scala
+ "Kamon Repository" at "http://repo.kamon.io"
+```
+
+Then, add the libraries to your project. If you are using SBT this minimal build.sbt file should be helpful:
+
+```scala
+
+resolvers += "Kamon Repository" at "http://repo.kamon.io"
+
+libraryDependencies += "kamon" %% "kamon-core" % "0.0.11"
+
+```
+
+Additionally you can add any modules you want to your app:
+
+- kamon-core
+- kamon-spray
+- kamon-newrelic
+- kamon-dashboard (coming soon)
+
+
+Second: Start your app with the AspectJ Weaver
+----------------------------------------------
+
+Starting your app with the AspectJ weaver is dead simple, just add the `-javaagent` JVM startup parameter pointing to the
+weaver's file location and you are done:
+
+```
+-javaagent:/path-to-newrelic-agent.jar
+```
+
+In case you want to keep the AspectJ related settings in your build and enjoy using `run` from the console, take a look at
+the [sbt-aspectj](https://github.com/sbt/sbt-aspectj/) plugin.
+
+
+Third: Enjoy!
+-------------
+
+Refer to modules documentation (coming soon) to find out what Kamon is doing for you. \ No newline at end of file