com.microsoft.applicationinsights.internal.perfcounter

Class JniPCConnector

java.lang.Object

com.microsoft.applicationinsights.internal.perfcounter.JniPCConnector

public final class JniPCConnector
extends java.lang.Object

This class serves as the connection to the native code that does the work with Windows. Created by gupele on 3/30/2015.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	AI_BASE_FOLDER
static java.lang.String	AI_NATIVE_FOLDER
static java.lang.String	PROCESS_SELF_INSTANCE_NAME

Constructor Summary

Constructors

Constructor and Description
JniPCConnector()

Method Summary

Modifier and Type	Method and Description
static java.lang.String	addPerformanceCounter(java.lang.String category, java.lang.String counter, java.lang.String instance) Adding a performance counter
static double	getValueOfPerformanceCounter(java.lang.String name) This method will delegate the call to the native code after the proper sanity checks.
static boolean	initialize() This method must be called before any other method.
static java.lang.String	translateInstanceName(java.lang.String instanceName) Process instance name is only known at runtime, therefore process level performance counters should use the 'PROCESS_SELF_INSTANCE_NAME' as the requested process name and then call this method to translate that logical name into the actual name that is fetched from the native code.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

AI_BASE_FOLDER

public static final java.lang.String AI_BASE_FOLDER

See Also:

Constant Field Values

AI_NATIVE_FOLDER

public static final java.lang.String AI_NATIVE_FOLDER

See Also:

Constant Field Values

PROCESS_SELF_INSTANCE_NAME

public static final java.lang.String PROCESS_SELF_INSTANCE_NAME

See Also:

Constant Field Values

Constructor Detail

JniPCConnector

public JniPCConnector()

Method Detail

initialize

public static boolean initialize()

This method must be called before any other method. All other methods are relevant only if this method was successful. Note that the method should not throw and should gracefully return the boolean value.

Returns:

True on success.

addPerformanceCounter

public static java.lang.String addPerformanceCounter(java.lang.String category,
                                                     java.lang.String counter,
                                                     java.lang.String instance)

Adding a performance counter

Parameters:

category - The category must be non null non empty value.

counter - The counter must be non null non empty value.

instance - The instance.

Returns:

True on success.

translateInstanceName

public static java.lang.String translateInstanceName(java.lang.String instanceName)
                                              throws java.lang.Exception

Process instance name is only known at runtime, therefore process level performance counters should use the 'PROCESS_SELF_INSTANCE_NAME' as the requested process name and then call this method to translate that logical name into the actual name that is fetched from the native code.

Parameters:

instanceName - The raw instance name

Returns:

The actual instance name.

Throws:

java.lang.Exception - If instanceName equals PROCESS_SELF_INSTANCE_NAME but the actual instance name is unknown.

getValueOfPerformanceCounter

public static double getValueOfPerformanceCounter(java.lang.String name)

This method will delegate the call to the native code after the proper sanity checks.

Parameters:

name - The logical name of the performance counter as was fetched during the 'addPerformanceCounter' call.

Returns:

The current value.