Package com.atlassian.confluence.util.profiling

Class AtlassianInstrumentationConfluenceMonitoring

java.lang.Object

com.atlassian.confluence.util.profiling.AtlassianInstrumentationConfluenceMonitoring

All Implemented Interfaces:

ConfluenceMonitoring, ConfluenceMonitoringControl

@Internal
@ParametersAreNonnullByDefault
public class AtlassianInstrumentationConfluenceMonitoring
extends Object
implements ConfluenceMonitoring, ConfluenceMonitoringControl

An implementation of the Confluence Monitoring interfaces that's based upon the Atlassian Instrumentation library.

Since:

5.7

Constructor Summary

Constructors

Constructor	Description
AtlassianInstrumentationConfluenceMonitoring(ControllableInstrumentRegistry instrumentRegistry, MutableRegistryConfiguration registryConfiguration, io.micrometer.core.instrument.MeterRegistry micrometerRegistry)

Method Summary

Modifier and Type	Method	Description
void	clear()	Clears the currently held statistics.
void	disableAllMonitoring()
void	disableCpuTiming()	Disable capturing CPU timing.
void	disableHibernateMonitoring()	Disable Hibernate monitoring.
void	disableMonitoring()	Disable monitoring.
void	enableCpuTiming()	Enable capturing CPU timing.
void	enableHibernateMonitoring()	Enables Hibernate monitoring.
void	enableMonitoring()	Enables monitoring.
@NonNull Counter	fetchCounter(String name, String... optional)	Fetches the counter associated with the supplied name details.
@NonNull Counter	fetchCounter(String name, Map<String,String> tags)	Fetches the counter associated with the supplied name details.
boolean	isCpuTimingEnabled()
boolean	isMonitoringEnabled()
@NonNull List<CounterSnapshot>	snapshotCounters()	Returns a snapshot of the counters.
@NonNull List<TimerSnapshot>	snapshotTimers()	Returns a snapshot of the timers.
@NonNull Split	startSplit(String name, String... optional)	Creates and starts a split timer associated with the supplied name details.
@NonNull Split	startSplit(String name, Map<String,String> tags)	Creates and starts a split timer associated with the supplied name details.

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.atlassian.confluence.util.profiling.ConfluenceMonitoring

createName, fetchCounter, startSplit

Constructor Detail

AtlassianInstrumentationConfluenceMonitoring

public AtlassianInstrumentationConfluenceMonitoring(ControllableInstrumentRegistry instrumentRegistry,
                                                    MutableRegistryConfiguration registryConfiguration,
                                                    io.micrometer.core.instrument.MeterRegistry micrometerRegistry)

Method Detail

disableAllMonitoring

public void disableAllMonitoring()
                          throws Exception

Throws:

Exception

fetchCounter

public @NonNull Counter fetchCounter(String name,
                                     String... optional)

Description copied from interface: ConfluenceMonitoring

Fetches the counter associated with the supplied name details. The name is constructed calling ConfluenceMonitoring.createName(String, String...).

Specified by:

fetchCounter in interface ConfluenceMonitoring

Parameters:

name - the mandatory suggested name

optional - the optional parts to concatenate with the mandatory suggestion

Returns:

the counter associated with the name.

fetchCounter

public @NonNull Counter fetchCounter(String name,
                                     Map<String,String> tags)

Description copied from interface: ConfluenceMonitoring

Fetches the counter associated with the supplied name details.

Specified by:

fetchCounter in interface ConfluenceMonitoring

Parameters:

name - the mandatory suggested name

tags - the name-value tags to apply

Returns:

the counter associated with the name.

Since:

7.1

startSplit

public @NonNull Split startSplit(String name,
                                 String... optional)

Description copied from interface: ConfluenceMonitoring

Creates and starts a split timer associated with the supplied name details. The name is constructed calling ConfluenceMonitoring.createName(String, String...).

The typical usage is:

 try (Split split = instance.startSplit("name")) {
     // code to execute
 }
 

Specified by:

startSplit in interface ConfluenceMonitoring

Parameters:

name - the mandatory suggested name

optional - the optional parts to concatenate with the mandatory suggestion

Returns:

the running split timer

startSplit

public @NonNull Split startSplit(String name,
                                 Map<String,String> tags)

Description copied from interface: ConfluenceMonitoring

Creates and starts a split timer associated with the supplied name details.

The typical usage is:

 try (Split split = instance.startSplit("name", singletonMap("tagname", "tagvalue"))) {
     // code to execute
 }
 

Specified by:

startSplit in interface ConfluenceMonitoring

Parameters:

name - the mandatory suggested name

tags - the name-value tags to apply

Returns:

the running split timer

Since:

7.1

isMonitoringEnabled

public boolean isMonitoringEnabled()

Specified by:

isMonitoringEnabled in interface ConfluenceMonitoringControl

Returns:

whether monitoring is enabled.

enableMonitoring

public void enableMonitoring()

Description copied from interface: ConfluenceMonitoringControl

Enables monitoring. It does not effect whether CPU timing is enabled.

Specified by:

enableMonitoring in interface ConfluenceMonitoringControl

disableMonitoring

public void disableMonitoring()

Description copied from interface: ConfluenceMonitoringControl

Disable monitoring. It does not effect whether CPU timing is enabled.

Specified by:

disableMonitoring in interface ConfluenceMonitoringControl

isCpuTimingEnabled

public boolean isCpuTimingEnabled()

Specified by:

isCpuTimingEnabled in interface ConfluenceMonitoringControl

Returns:

whether CPU timing is enabled.

enableCpuTiming

public void enableCpuTiming()

Description copied from interface: ConfluenceMonitoringControl

Enable capturing CPU timing. It does not effect whether monitoring is enabled.

WARNING: turning on CPU timing will adversly impact on system performance. Do not do this on production systems without due consideration.

Specified by:

enableCpuTiming in interface ConfluenceMonitoringControl

disableCpuTiming

public void disableCpuTiming()

Description copied from interface: ConfluenceMonitoringControl

Disable capturing CPU timing. It does not effect whether monitoring is enabled.

Specified by:

disableCpuTiming in interface ConfluenceMonitoringControl

enableHibernateMonitoring

public void enableHibernateMonitoring()

Description copied from interface: ConfluenceMonitoringControl

Enables Hibernate monitoring. It does not effect whether monitoring is enabled.

Specified by:

enableHibernateMonitoring in interface ConfluenceMonitoringControl

disableHibernateMonitoring

public void disableHibernateMonitoring()

Description copied from interface: ConfluenceMonitoringControl

Disable Hibernate monitoring. It does not effect whether monitoring is enabled.

Specified by:

disableHibernateMonitoring in interface ConfluenceMonitoringControl

clear

public void clear()

Description copied from interface: ConfluenceMonitoringControl

Clears the currently held statistics.

Specified by:

clear in interface ConfluenceMonitoringControl

snapshotCounters

public @NonNull List<CounterSnapshot> snapshotCounters()

Description copied from interface: ConfluenceMonitoringControl

Returns a snapshot of the counters.

Specified by:

snapshotCounters in interface ConfluenceMonitoringControl

Returns:

a mutable list of the current counters.

snapshotTimers

public @NonNull List<TimerSnapshot> snapshotTimers()

Description copied from interface: ConfluenceMonitoringControl

Returns a snapshot of the timers.

Specified by:

snapshotTimers in interface ConfluenceMonitoringControl

Returns:

a mutable list of the current timers.