JMX Fabric Custom Statistics

Fabric provides developers with two Java methods to add customized JMX probes to their implementation and to expose their values as JMX counters.

Fabric Statistics APIs

statsCount

This method can be invoked to count statistics such as events, bytes, counts etc.

public static void statsCount(String entry, String key, long value)

entry - designates the primary key for this statistic implementation

key - designates the sub key for this statistics

value - the measure of the value for this statistic.

The statistic method will use this value to calculate total, last and average values for this measure. In addition this function also counts the number of times the function has been called and will provide a timestamp for the last call.

statsDuration

public static AutoCloseable statsDuration(String entry, String key)

The purpose of this method is to measure the duration of the function's call between the method invocation and the invocation of the .close() function on the return object.

entry - designates the primary key for this statistic

key - designates the sub key for this statistics

This method is returned by calling .close() on this object to indicate the end of the duration measurement

Code Example:

  public static String fnCustomStats() throws Exception { 

    String status= "success";

    Db ci = db("fabric");

    String sql = "SELECT COUNT(*) NO_OF_INVOICES, STATUS FROM INVOICE group by status";

    Db.Rows rows = ci.fetch(sql);

    for (Db.Row row:rows){

        String invStatus = row.cell(1).toString();
        Long noOfInv=  Long.valueOf(row.cell(0).toString()).longValue();


        UserCode.statsCount("NoOfInvoices", invStatus, noOfInv);

        //Alternative syntax
        //CustomStats.count("NoOfInvoices", invStatus, noOfInv);

        AutoCloseable sw = statsDuration("tali", "test");
        sleep(10);
        sw.close();

                     //Alternative syntax
        //Stopwatch sw2 = CustomStats.duration("tali", "test");
        //sleep(10);
        //sw2.close();
    }

    return status;
}