Annotation Type Timed
-
@Inherited @Documented @InterceptorBinding @Retention(RUNTIME) @Target({TYPE,CONSTRUCTOR,METHOD,ANNOTATION_TYPE}) public @interface Timed
An annotation for marking a method, constructor, or class as timed. The underlyingTimer
metric aggregates timing durations and provides duration statistics, plus throughput statistics. There is a lightweight alternativeSimpleTimer
(@SimplyTimed
) that only tracks elapsed time duration and count. The metric will be registered in the application MetricRegistry.Given a method annotated with @Timed like this:
A timer with the fully qualified class name +@Timed(name = "fancyName") public String fancyName(String name) { return "Sir Captain " + name; }
fancyName
will be created and each time the#fancyName(String)
method is invoked, the method's execution will be timed.Given a class annotated with @Timed like this:
A timer for the defining class will be created for each of the constructors/methods. Each time a constructor/method is invoked, the execution will be timed with the respective timer. This annotation will throw an IllegalStateException if the constructor/method is invoked, but the metric no longer exists in the MetricRegistry.@Timed public class TimedBean { public void timedMethod1() {} public void timedMethod2() {} }
-
-
Optional Element Summary
Optional Elements Modifier and Type Optional Element Description boolean
absolute
Denotes whether to use the absolute name or use the default given name relative to the annotated class.java.lang.String
description
The description of the timer.java.lang.String
displayName
The display name of the timer.java.lang.String
name
The name of the timer.boolean
reusable
Denotes if this metric instance can be reused by multiple registrations.java.lang.String[]
tags
java.lang.String
unit
The unit of the timer.
-
-
-
-
tags
java.lang.String[] tags
- Returns:
- The tags of the timer. Each
String
tag must be in the form of 'key=value'. If the input is empty or does not contain a '=' sign, the entry is ignored. - See Also:
Metadata
- Default:
- {}
-
-
-
absolute
boolean absolute
Denotes whether to use the absolute name or use the default given name relative to the annotated class.- Returns:
- If
true
, use the given name as an absolute name. Iffalse
(default), use the given name relative to the annotated class. When annotating a class, this must befalse
.
- Default:
- false
-
-
-
displayName
java.lang.String displayName
The display name of the timer.- Returns:
- The display name of the timer.
- See Also:
Metadata
- Default:
- ""
-
-
-
description
java.lang.String description
The description of the timer.- Returns:
- The description of the timer.
- See Also:
Metadata
- Default:
- ""
-
-
-
unit
java.lang.String unit
The unit of the timer.- Returns:
- The unit of the timer. By default, the value is
MetricUnits.NANOSECONDS
. - See Also:
Metadata
,MetricUnits
- Default:
- "nanoseconds"
-
-