org.nuiton.profiling

Class NuitonTrace

java.lang.Object

org.nuiton.profiling.NuitonTrace

public abstract class NuitonTrace
extends Object

Permet de tracer les appels aux methodes.

Mise en place

Il faut mettre dans les dependances Maven le nuiton-profiling

    $lt;dependency$gt;
      $lt;groupId$gt;org.nuiton$lt;/groupId$gt;
      $lt;artifactId$gt;nuiton-profiling$lt;/artifactId$gt;
      $lt;version$gt;2.7$lt;/version$gt;
    $lt;/dependency$gt;
 

Pour l'utiliser il faut définir un fichier XML aop.xml dans le repertoire META-INF ou WEB-INF qui intercepte les methodes souhaiter.

 <!DOCTYPE aspectj PUBLIC "-//AspectJ//DTD//EN" "http://www.eclipse.org/aspectj/dtd/aspectj.dtd"$gt;
$lt;aspectj$gt;
  $lt;weaver options="-verbose"$gt;
    $lt;exclude within="fr.insee..*CGLIB*"/$gt;
  $lt;/weaver$gt;
  $lt;aspects$gt;
    $lt;concrete-aspect name="org.nuiton.profiling.NuitonTraceAppAspect"
                     extends="org.nuiton.profiling.NuitonTrace"$gt;
      $lt;pointcut name="executeMethod"
                expression="
      execution(* org.nuiton..*(..))
   || execution(* org.chorem..*(..))
   || execution(* org.apache..*(..))
   || execution(* ognl..*(..))"/$gt;
    $lt;/concrete-aspect$gt;
  $lt;/aspects$gt;
$lt;/aspectj$gt;
 

Ensuite il faut lancer la JVM avec l'option

 -javaagent:path/to/aspectjweaver-1.7.1.jar
 

normalement il se trouve dans le repo maven dans le repertoire

$MAVEN_REPO/org/aspectj/aspectjweaver/1.7.1/aspectjweaver-1.7.1.jar

Utilisation

Il y a 3 modes: interactif, non interactif et par programmation

Mode non interactif

Il faut mettre le nom d'un fichier dans la variable d'environnnement AUTO_SAVE_FILENAME_OPTION. Dans ce cas lors de l'arrêt de la JVM les statistiques sont ecrites dans ce fichier.

Mode interactif

Il est possible de demander a a NuitonTrace lorsqu'il s'initialise de demarrer un serveur Web qui permet de voir et recuperer les donnees statistiques. Pour cela il faut indique sur quel port le serveur doit attendre via la variable d'environnnement PORT_OPTION

Par programmation

Pour afficher les statistiques dans votre programme log.info(NuitonTrace.getStatisticsAndClear()); NuitonTrace.printStatistiqueAndClear();

Autre mode de fonctionnement

Il doit être possible, plutot que d'écrire un fichier XML, de sous classer NuitonTrace en ajoutant par exemple

 \@Expression( "execution(* fr.ifremer.isisfish.datastore.ResultStorage.*(..))" +
 "|| execution(* fr.ifremer.isisfish.aspect.Cache.*(..))" +
 "|| execution(* fr.ifremer.isisfish.aspect.Trace.*(..))" +
 "|| execution(* org.nuiton.topia..*(..))" +
 "|| execution(* org.nuiton.math.matrix..*(..))" +
 "|| execution(* fr.ifremer.isisfish.types..*(..))" +
 "|| execution(* org.apache.commons.collections..*(..))"
 )
 Pointcut executeMethod;
 

Author:

bpoussin , tchemit