Usage

To use the monitoring, include an output module and at least one agent module in your project dependencies for the modules you wish to monitor

##Configuration create META-INF.monitor, containing agent.conf and output.conf ###agent.conf This file paramaterises the pointcutting agent. You need to specify here which output module is being used, and can configure the behaviour of the agent.

Example configuration file for the akka monitoring agent:

org.eigengo.monitor.agent {
    output {
        class: "org.eigengo.monitor.output.datadog.StatsdCounterInterface"
    }  # the class to be used for the output of the pointcut monitoring

    akka {
        includeRoutees: true
        included: [
            "akka:*.com.company.project.module.TypeOfActor"
        ] # This list is currently treated as a conjunction -- i.e. an actor must match all filters to be included. This behaviour may change.
        sampling: [
            {
                rate: 15
                for: [ "akka:*.com.company.project.module.TypeOfActor" ]
            },  # Sample every 15th message received by actor of type 'TypeOfActor' (starting with first message)
            {
                rate: 4
                for: [ "akka://default/user/*" ]
            }   # Sample every 4th message received by actor with path root matching '/default/user/*' 
        ]
        allowExclusions: false # If this is false, we only include 'included' actors
        excluded: [ 
             "akka:*.com.company.project.module.UninterestingActor" 
        ] # If allowExclusions is true, only the actors matched by this filter are excluded
    }
}

##Dependencies ###Output modules

####StatsD output for datadog

For sbt

  "org.eigengo.monitor" % "output-statsd" % "0.1-SNAPSHOT"

For maven

        <dependency>
            <groupId>org.eigengo.monitor</groupId>
            <artifactId>output-statsd</artifactId>
            <version>0.1-SNAPSHOT</version>
        </dependency>

###Monitoring Agent modules

####Akka monitoring #####For sbt

  "org.eigengo.monitor" % "agent-akka" % "0.1-SNAPSHOT"

#####For maven

        <dependency>
            <groupId>org.eigengo.monitor</groupId>
            <artifactId>agent-akka</artifactId>
            <version>0.1-SNAPSHOT</version>
        </dependency>