Examples of SAMHelper

jade.core.sam.SAMHelper

Helper interface for the System Activity Monitoring (SAM) Service.
The SAM Service allows collecting system activity information such as the average time to perform a given operations or the number of events of a given type. When activated, the SAM service is used internally by the JADE runtime to monitor entities related to JADE specific activities such as the average message delivery time or the number of posted messages, but can be used by application agents as well to monitor entities related to application specific activities. In order to do that an agent must retrieve the SAMHelper by means of the getHelper() method of the Agent class and register providers of measures for the entities that have to be monitored. The underlying SAM Service periodically invokes such providers and collects all retrieved information in the Main Container aggregating them properly. Many providers can be registered (possibly in different containers) for the same entity. In general measures of the same entity generated by different providers are mediated to compute an average measure. Counters of events are treated differently: contributions from different providers associated to the same counter are summed to compute a total value. @see jade.core.Agent#getHelper(String)

  private void initializeSAM() {
    //#J2ME_EXCLUDE_BEGIN
    try {
      Service sam = myContainer.getServiceFinder().findService(SAMHelper.SERVICE_NAME);
      if (sam != null) {
        SAMHelper samHelper = (SAMHelper) sam.getHelper(null);
        samActive = true;
        
        // DELIVERY TIME
        deliveryTimeMeasurementRate = DELIVERY_TIME_MEASUREMENT_RATE_DEFAULT;
        try {
          deliveryTimeMeasurementRate = Integer.parseInt(myProfile.getParameter(DELIVERY_TIME_MEASUREMENT_RATE, null));
        }
        catch (Exception e) {
          // Keep default
        }
        if (deliveryTimeMeasurementRate > 0) {
          deliveryTimeMeasureProvider = new AverageMeasureProviderImpl();
          samHelper.addEntityMeasureProvider("Message-Delivery-Time", deliveryTimeMeasureProvider);
        }
        
        // MESSAGE COUNT
        boolean enablePostedMessageCount = "true".equalsIgnoreCase(myProfile.getParameter(ENABLE_POSTED_MESSAGE_COUNT, "false"));
        if (enablePostedMessageCount) {
          samHelper.addCounterValueProvider("Posted-Message-Count", new CounterValueProvider() {
            public long getValue() {
              return postedMessageCounter;
            }
            public boolean isDifferential() {
              return false;

All source code are property of their respective owners. Java is a trademark of Sun Microsystems, Inc and owned by ORACLE Inc. Contact coftware#gmail.com.

Examples of SAMHelper

Examples of jade.core.sam.SAMHelper