org.springframework.integration.config

Annotation Type EnableIntegrationManagement

@Target(value=TYPE)
 @Retention(value=RUNTIME)
 @Documented
 @Import(value=IntegrationManagementConfiguration.class)
public @interface EnableIntegrationManagement

Enables default configuring of management in Spring Integration components in an existing application.

The resulting IntegrationManagementConfigurer bean is defined under the name integrationManagementConfigurer.

Since:

4.2

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
java.lang.String[]	countsEnabled A list of simple patterns for component names for which message counts will be enabled (defaults to '*').
java.lang.String	defaultCountsEnabled The default setting for enabling counts when a bean name is not matched by countsEnabled.
java.lang.String	defaultLoggingEnabled Use to disable all logging in the main message flow in framework components.
java.lang.String	defaultStatsEnabled The default setting for enabling statistics when a bean name is not matched by statsEnabled.
java.lang.String	metricsFactory The bean name of a MetricsFactory.
java.lang.String[]	statsEnabled A list of simple patterns for component names for which message statistics will be enabled (response times, rates etc), as well as counts (a positive match here overrides countsEnabled, you can't have statistics without counts).

Element Detail

countsEnabled

public abstract java.lang.String[] countsEnabled

A list of simple patterns for component names for which message counts will be enabled (defaults to '*'). Enables message counting (`sendCount`, `errorCount`, `receiveCount`) for those components that support counters (channels, message handlers, etc). This is the initial setting only, individual components can have counts enabled/disabled at runtime. May be overridden by an entry in statsEnabled which is additional functionality over simple counts. If a pattern starts with `!`, counts are disabled for matches. For components that match multiple patterns, the first pattern wins. Disabling counts at runtime also disables stats. Defaults to no components, unless JMX is enabled in which case, defaults to all components. Overrides defaultCountsEnabled() for matching bean names.

Returns:

the patterns.

Default:

"*"

statsEnabled

public abstract java.lang.String[] statsEnabled

A list of simple patterns for component names for which message statistics will be enabled (response times, rates etc), as well as counts (a positive match here overrides countsEnabled, you can't have statistics without counts). (defaults to '*'). Enables statistics for those components that support statistics (channels - when sending, message handlers, etc). This is the initial setting only, individual components can have stats enabled/disabled at runtime. If a pattern starts with `!`, stats (and counts) are disabled for matches. Note: this means that '!foo' here will disable stats and counts for 'foo' even if counts are enabled for 'foo' in countsEnabled. For components that match multiple patterns, the first pattern wins. Enabling stats at runtime also enables counts. Defaults to no components, unless JMX is enabled in which case, defaults to all components.

Returns:

the patterns.

Default:

"*"

defaultCountsEnabled

public abstract java.lang.String defaultCountsEnabled

The default setting for enabling counts when a bean name is not matched by countsEnabled.

Returns:

the value; false by default, or true when JMX is enabled.

Default:

"false"

defaultStatsEnabled

public abstract java.lang.String defaultStatsEnabled

The default setting for enabling statistics when a bean name is not matched by statsEnabled.

Returns:

the value; false by default, or true when JMX is enabled.

Default:

"false"

defaultLoggingEnabled

public abstract java.lang.String defaultLoggingEnabled

Use to disable all logging in the main message flow in framework components. When 'false', such logging will be skipped, regardless of logging level. When 'true', the logging is controlled as normal by the logging subsystem log level configuration.

It has been found that in high-volume messaging environments, calls to methods such as logger.isDebuggingEnabled() can be quite expensive and account for an inordinate amount of CPU time.

Set this to false to disable logging by default in all framework components that implement IntegrationManagement (channels, message handlers etc). This turns off logging such as "PreSend on channel", "Received message" etc.

After the context is initialized, individual components can have their setting changed by invoking IntegrationManagement.setLoggingEnabled(boolean).

Returns:

the value; true by default.

Default:

"true"

metricsFactory

public abstract java.lang.String metricsFactory

The bean name of a MetricsFactory. The DefaultMetricsFactory is used if omitted.

Returns:

the bean name.

Default:

""