class Identity extends AnyRef
General purpose identity for instrumented entities.
Entities can be identified by class (only has a class), instance (has both class and name), or group (only has a name).
Identities belong to a category, for grouping instruments into categories like 'actors' or 'dispatchers'. Expressed in plural form.
Identities have a key, used for tags.
Identities can be organised in hierarchies, where each identity can have a parent identity, for forming full identifier keys.
Identities can be hidden, where they are in the hierarchy but not used.
Identities can be marked as being 'unique', unique to this instance of Cinnamon, such as host name and application identifier.
- Alphabetic
- By Inheritance
- Identity
- AnyRef
- Any
- Hide All
- Show All
- Public
- Protected
Value Members
- final def !=(arg0: Any): Boolean
- Definition Classes
- AnyRef → Any
- final def ##: Int
- Definition Classes
- AnyRef → Any
- final def ==(arg0: Any): Boolean
- Definition Classes
- AnyRef → Any
- final def asInstanceOf[T0]: T0
- Definition Classes
- Any
- def builder(): Builder
Create a new identity builder, based on this identity.
Create a new identity builder, based on this identity.
- returns
new Identity.Builder to create new identity
- def clone(): AnyRef
- Attributes
- protected[lang]
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.CloneNotSupportedException]) @IntrinsicCandidate() @native()
- def copyToBuilder(builder: Builder): Builder
- Attributes
- protected[meta]
- final def eq(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef
- def equals(o: AnyRef): Boolean
- Definition Classes
- Identity → AnyRef → Any
- Annotations
- @Override()
- def getCategory(): String
The category for this identity (used for grouping, expressed in plural form).
The category for this identity (used for grouping, expressed in plural form). May be null.
- returns
String
category for this identity, or null if not present
- final def getClass(): Class[_ <: AnyRef]
- Definition Classes
- AnyRef → Any
- Annotations
- @IntrinsicCandidate() @native()
- def getEntityClass(): Class
The entity class for this identity.
The entity class for this identity. May be null.
- returns
Class
for this identity, or null if not present
- def getEntityName(): String
The entity name for this identity (for instance or group identities).
The entity name for this identity (for instance or group identities). May be null.
- returns
String
name for this identity, or null if not present
- def getKey(): String
The key for this identity (used for tags).
The key for this identity (used for tags). May be null.
- returns
String
key for this identity, or null if not present
- def getName(): String
Get the entity name (for instance or group) otherwise get the entity class name.
Get the entity name (for instance or group) otherwise get the entity class name.
- returns
String
either the name or class name for this identity
- def getParent(): Identity
The enclosing parent identity for this identity.
The enclosing parent identity for this identity. May be null.
- returns
Identity
parent for this identity, or null if not present
- def getTags(): Map[String, String]
The tags for this identity.
The tags for this identity. Used in both the metric key and metric tags.
- returns
Map
of tags.
- def hasCategory(): Boolean
Whether this identity has an associated category (used for grouping, expressed in plural form).
Whether this identity has an associated category (used for grouping, expressed in plural form).
- returns
boolean
whether a category is specified
- def hasEntityClass(): Boolean
Whether this identity has an associated entity class.
Whether this identity has an associated entity class.
- returns
boolean
whether a class is specified
- def hasEntityName(): Boolean
Whether this identity has an associated entity name (for instance or group identities).
Whether this identity has an associated entity name (for instance or group identities).
- returns
boolean
whether a name is specified
- def hasKey(): Boolean
Whether this identity has an associated key (used for tags).
Whether this identity has an associated key (used for tags).
- returns
boolean
whether a key is specified
- def hasName(): Boolean
Whether this identity has an associated name (either entity name or entity class).
Whether this identity has an associated name (either entity name or entity class).
- returns
boolean
whether a name is specified
- def hasParent(): Boolean
Whether this identity has an enclosing parent identity.
Whether this identity has an enclosing parent identity.
- returns
boolean
whether parent identity is specified
- def hashCode(): Int
- Definition Classes
- Identity → AnyRef → Any
- Annotations
- @Override()
- def isDestroyable(): Boolean
Whether instruments for this identity can be destroyed, once the entity for this identity has terminated in some way.
Whether instruments for this identity can be destroyed, once the entity for this identity has terminated in some way.
Instance identities are destroyable, while class and group identities are assumed to be not destroyable given that other instances with the same identity could still continue to exist.
- returns
boolean
whether this identity is destroyable
- final def isInstanceOf[T0]: Boolean
- Definition Classes
- Any
- def isUnique(): Boolean
Whether this identity is unique to this instance of Cinnamon, such as host name or application identifier.
Whether this identity is unique to this instance of Cinnamon, such as host name or application identifier.
- returns
boolean
whether this identity is unique
- def isVisible(): Boolean
Whether this identity is visible, and should be included in metric keys or tags.
Whether this identity is visible, and should be included in metric keys or tags.
- returns
boolean
whether this identity is visible
- final def ne(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef
- final def notify(): Unit
- Definition Classes
- AnyRef
- Annotations
- @IntrinsicCandidate() @native()
- final def notifyAll(): Unit
- Definition Classes
- AnyRef
- Annotations
- @IntrinsicCandidate() @native()
- final def synchronized[T0](arg0: => T0): T0
- Definition Classes
- AnyRef
- def toString(): String
- Definition Classes
- Identity → AnyRef → Any
- Annotations
- @Override()
- final def wait(arg0: Long, arg1: Int): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.InterruptedException])
- final def wait(arg0: Long): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.InterruptedException]) @native()
- final def wait(): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.InterruptedException])
Deprecated Value Members
- def finalize(): Unit
- Attributes
- protected[lang]
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.Throwable]) @Deprecated
- Deprecated
(Since version 9)
This is the public API for Cinnamon.
The com.lightbend.cinnamon package contains the public Cinnamon API.
See the complete list of Cinnamon packages on the right.
Cinnamon Events and Metrics
For the custom events API see
CinnamonEvents
.For the custom metrics API see
CinnamonMetrics
.Stopwatch
For the Stopwatch API see
Stopwatch
.Coda Hale Metrics
For creating custom Coda Hale Metrics reporters see the com.lightbend.cinnamon.chmetrics.reporter package.