Class MonitorEntry
- java.lang.Object
-
- com.unboundid.ldap.sdk.unboundidds.monitors.MonitorEntry
-
- All Implemented Interfaces:
java.io.Serializable
- Direct Known Subclasses:
ActiveOperationsMonitorEntry,BackendMonitorEntry,ClientConnectionMonitorEntry,ConnectionHandlerMonitorEntry,DiskSpaceUsageMonitorEntry,EntryCacheMonitorEntry,FIFOEntryCacheMonitorEntry,GaugeMonitorEntry,GeneralMonitorEntry,GroupCacheMonitorEntry,HostSystemRecentCPUAndMemoryMonitorEntry,IndexMonitorEntry,JEEnvironmentMonitorEntry,LDAPExternalServerMonitorEntry,LDAPStatisticsMonitorEntry,LoadBalancingAlgorithmMonitorEntry,MemoryUsageMonitorEntry,ProcessingTimeHistogramMonitorEntry,ReplicaMonitorEntry,ReplicationServerMonitorEntry,ReplicationSummaryMonitorEntry,ResultCodeMonitorEntry,StackTraceMonitorEntry,SystemInfoMonitorEntry,TraditionalWorkQueueMonitorEntry,UnboundIDWorkQueueMonitorEntry,VersionMonitorEntry,X509CertificateMonitorEntry
@NotExtensible @ThreadSafety(level=COMPLETELY_THREADSAFE) public class MonitorEntry extends java.lang.Object implements java.io.Serializable
This class defines a generic monitor entry that provides access to monitor information provided by a Ping Identity, UnboundID, or Nokia/Alcatel-Lucent 8661 server instance. Subclasses may provide specific methods for interpreting the information exposed by specific types of monitor entries.
NOTE: This class, and other classes within the
com.unboundid.ldap.sdk.unboundiddspackage structure, are only supported for use against Ping Identity, UnboundID, and Nokia/Alcatel-Lucent 8661 server products. These classes provide support for proprietary functionality or for external specifications that are not considered stable or mature enough to be guaranteed to work in an interoperable way with other types of LDAP servers.
See theMonitorManagerclass for an example that demonstrates the process for retrieving all monitor entries available in the directory server and retrieving the information they provide using the generic API.- See Also:
- Serialized Form
-
-
Constructor Summary
Constructors Constructor Description MonitorEntry(Entry entry)Creates a new monitor entry from the information contained in the provided entry.
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description protected static voidaddMonitorAttribute(java.util.Map<java.lang.String,MonitorAttribute> attrs, java.lang.String name, java.lang.String displayName, java.lang.String description, java.lang.Boolean value)Adds a new monitor attribute to the specified map using the provided information.protected static voidaddMonitorAttribute(java.util.Map<java.lang.String,MonitorAttribute> attrs, java.lang.String name, java.lang.String displayName, java.lang.String description, java.lang.Double value)Adds a new monitor attribute to the specified map using the provided information.protected static voidaddMonitorAttribute(java.util.Map<java.lang.String,MonitorAttribute> attrs, java.lang.String name, java.lang.String displayName, java.lang.String description, java.lang.Integer value)Adds a new monitor attribute to the specified map using the provided information.protected static voidaddMonitorAttribute(java.util.Map<java.lang.String,MonitorAttribute> attrs, java.lang.String name, java.lang.String displayName, java.lang.String description, java.lang.Long value)Adds a new monitor attribute to the specified map using the provided information.protected static voidaddMonitorAttribute(java.util.Map<java.lang.String,MonitorAttribute> attrs, java.lang.String name, java.lang.String displayName, java.lang.String description, java.lang.String value)Adds a new monitor attribute to the specified map using the provided information.protected static voidaddMonitorAttribute(java.util.Map<java.lang.String,MonitorAttribute> attrs, java.lang.String name, java.lang.String displayName, java.lang.String description, java.util.Date value)Adds a new monitor attribute to the specified map using the provided information.protected static voidaddMonitorAttribute(java.util.Map<java.lang.String,MonitorAttribute> attrs, java.lang.String name, java.lang.String displayName, java.lang.String description, java.util.List<java.lang.String> values)Adds a new monitor attribute to the specified map using the provided information.static MonitorEntrydecode(Entry entry)Creates a monitor entry object from the provided entry.protected java.lang.BooleangetBoolean(java.lang.String attributeName)Retrieves the value of the specified attribute as aBooleanobject.protected java.util.DategetDate(java.lang.String attributeName)Retrieves the value of the specified attribute as aDateobject.java.lang.StringgetDN()Retrieves the DN for this monitor entry.protected java.lang.DoublegetDouble(java.lang.String attributeName)Retrieves the value of the specified attribute as aDoubleobject.ReadOnlyEntrygetEntry()Retrieves theEntryused to create this monitor entry.protected java.lang.IntegergetInteger(java.lang.String attributeName)Retrieves the value of the specified attribute as anIntegerobject.protected java.lang.LonggetLong(java.lang.String attributeName)Retrieves the value of the specified attribute as aLongobject.java.util.Map<java.lang.String,MonitorAttribute>getMonitorAttributes()Retrieves the set of parsed monitor attributes for this monitor entry, mapped from a unique identifier (in all lowercase characters) to the corresponding monitor attribute.java.lang.StringgetMonitorClass()Retrieves the name of the structural object class for this monitor entry.java.lang.StringgetMonitorDescription()Retrieves a human-readable description name for this monitor entry.java.lang.StringgetMonitorDisplayName()Retrieves a human-readable display name for this monitor entry.java.lang.StringgetMonitorName()Retrieves the monitor name for this monitor entry.protected java.lang.StringgetString(java.lang.String attributeName)Retrieves the value of the specified attribute as a string.protected java.util.List<java.lang.String>getStrings(java.lang.String attributeName)Retrieves the set of values of the specified attribute as a string list.java.lang.StringtoString()Retrieves a string representation of this monitor entry.voidtoString(java.lang.StringBuilder buffer)Appends a string representation of this monitor entry to the provided buffer.
-
-
-
Constructor Detail
-
MonitorEntry
public MonitorEntry(@NotNull Entry entry)
Creates a new monitor entry from the information contained in the provided entry.- Parameters:
entry- The entry providing information to use for this monitor entry. It must not benull.
-
-
Method Detail
-
getDN
@NotNull public final java.lang.String getDN()
Retrieves the DN for this monitor entry.- Returns:
- The DN for this monitor entry.
-
getEntry
@NotNull public final ReadOnlyEntry getEntry()
Retrieves theEntryused to create this monitor entry.- Returns:
- The
Entryused to create this monitor entry.
-
getMonitorClass
@NotNull public final java.lang.String getMonitorClass()
Retrieves the name of the structural object class for this monitor entry.- Returns:
- The name of the structural object class for this monitor entry, or the generic monitor object class if no appropriate subclass could be identified.
-
getMonitorName
@Nullable public final java.lang.String getMonitorName()
Retrieves the monitor name for this monitor entry.- Returns:
- The monitor name for this monitor entry, or
nullif it was not included in the monitor entry.
-
getMonitorDisplayName
@NotNull public java.lang.String getMonitorDisplayName()
Retrieves a human-readable display name for this monitor entry.- Returns:
- A human-readable display name for this monitor entry.
-
getMonitorDescription
@NotNull public java.lang.String getMonitorDescription()
Retrieves a human-readable description name for this monitor entry.- Returns:
- A human-readable description name for this monitor entry.
-
getMonitorAttributes
@NotNull public java.util.Map<java.lang.String,MonitorAttribute> getMonitorAttributes()
Retrieves the set of parsed monitor attributes for this monitor entry, mapped from a unique identifier (in all lowercase characters) to the corresponding monitor attribute.- Returns:
- The set of parsed monitor attributes for this monitor entry.
-
decode
@NotNull public static MonitorEntry decode(@NotNull Entry entry)
Creates a monitor entry object from the provided entry. An attempt will be made to decode the entry as an instance of the most appropriate subclass, but if that is not possible then it will be parsed as a generic monitor entry.- Parameters:
entry- The entry to be decoded as a monitor entry.- Returns:
- The decoded monitor entry of the appropriate subtype, or a generic monitor entry if no appropriate subclass could be identified.
-
getBoolean
@Nullable protected final java.lang.Boolean getBoolean(@NotNull java.lang.String attributeName)
Retrieves the value of the specified attribute as aBooleanobject.- Parameters:
attributeName- The name of the target attribute.- Returns:
- The
Booleanobject parsed from the specified attribute, ornullif the attribute does not exist in the entry or it cannot be parsed as aBooleanvalue.
-
getDate
@Nullable protected final java.util.Date getDate(@NotNull java.lang.String attributeName)
Retrieves the value of the specified attribute as aDateobject.- Parameters:
attributeName- The name of the target attribute.- Returns:
- The
Dateobject parsed from the specified attribute, ornullif the attribute does not exist in the entry or it cannot be parsed as aDatevalue.
-
getDouble
@Nullable protected final java.lang.Double getDouble(@NotNull java.lang.String attributeName)
Retrieves the value of the specified attribute as aDoubleobject.- Parameters:
attributeName- The name of the target attribute.- Returns:
- The
Doubleobject parsed from the specified attribute, ornullif the attribute does not exist in the entry or it cannot be parsed as aDoublevalue.
-
getInteger
@Nullable protected final java.lang.Integer getInteger(@NotNull java.lang.String attributeName)
Retrieves the value of the specified attribute as anIntegerobject.- Parameters:
attributeName- The name of the target attribute.- Returns:
- The
Integerobject parsed from the specified attribute, ornullif the attribute does not exist in the entry or it cannot be parsed as anIntegervalue.
-
getLong
@Nullable protected final java.lang.Long getLong(@NotNull java.lang.String attributeName)
Retrieves the value of the specified attribute as aLongobject.- Parameters:
attributeName- The name of the target attribute.- Returns:
- The
Longobject parsed from the specified attribute, ornullif the attribute does not exist in the entry or it cannot be parsed as aLongvalue.
-
getString
@Nullable protected final java.lang.String getString(@NotNull java.lang.String attributeName)
Retrieves the value of the specified attribute as a string.- Parameters:
attributeName- The name of the target attribute.- Returns:
- The string value of the specified attribute, or
nullif it does not exist in the entry.
-
getStrings
@NotNull protected final java.util.List<java.lang.String> getStrings(@NotNull java.lang.String attributeName)
Retrieves the set of values of the specified attribute as a string list.- Parameters:
attributeName- The name of the target attribute.- Returns:
- The string values of the specified attribute, or an empty list if the specified attribute does not exist in the entry.
-
addMonitorAttribute
protected static void addMonitorAttribute(@NotNull java.util.Map<java.lang.String,MonitorAttribute> attrs, @NotNull java.lang.String name, @NotNull java.lang.String displayName, @Nullable java.lang.String description, @NotNull java.lang.Boolean value)
Adds a new monitor attribute to the specified map using the provided information.- Parameters:
attrs- The attribute map to which the information should be added.name- The name to use for this monitor attribute. It must be unique among all other monitor attribute names for the associated monitor entry.displayName- The human-readable display name for the monitor attribute.description- The human-readable description for the monitor attribute.value- The value for the monitor attribute.
-
addMonitorAttribute
protected static void addMonitorAttribute(@NotNull java.util.Map<java.lang.String,MonitorAttribute> attrs, @NotNull java.lang.String name, @NotNull java.lang.String displayName, @Nullable java.lang.String description, @NotNull java.util.Date value)
Adds a new monitor attribute to the specified map using the provided information.- Parameters:
attrs- The attribute map to which the information should be added.name- The name to use for this monitor attribute. It must be unique among all other monitor attribute names for the associated monitor entry.displayName- The human-readable display name for the monitor attribute.description- The human-readable description for the monitor attribute.value- The value for the monitor attribute.
-
addMonitorAttribute
protected static void addMonitorAttribute(@NotNull java.util.Map<java.lang.String,MonitorAttribute> attrs, @NotNull java.lang.String name, @NotNull java.lang.String displayName, @Nullable java.lang.String description, @NotNull java.lang.Double value)
Adds a new monitor attribute to the specified map using the provided information.- Parameters:
attrs- The attribute map to which the information should be added.name- The name to use for this monitor attribute. It must be unique among all other monitor attribute names for the associated monitor entry.displayName- The human-readable display name for the monitor attribute.description- The human-readable description for the monitor attribute.value- The value for the monitor attribute.
-
addMonitorAttribute
protected static void addMonitorAttribute(@NotNull java.util.Map<java.lang.String,MonitorAttribute> attrs, @NotNull java.lang.String name, @NotNull java.lang.String displayName, @Nullable java.lang.String description, @NotNull java.lang.Integer value)
Adds a new monitor attribute to the specified map using the provided information.- Parameters:
attrs- The attribute map to which the information should be added.name- The name to use for this monitor attribute. It must be unique among all other monitor attribute names for the associated monitor entry.displayName- The human-readable display name for the monitor attribute.description- The human-readable description for the monitor attribute.value- The value for the monitor attribute.
-
addMonitorAttribute
protected static void addMonitorAttribute(@NotNull java.util.Map<java.lang.String,MonitorAttribute> attrs, @NotNull java.lang.String name, @NotNull java.lang.String displayName, @Nullable java.lang.String description, @NotNull java.lang.Long value)
Adds a new monitor attribute to the specified map using the provided information.- Parameters:
attrs- The attribute map to which the information should be added.name- The name to use for this monitor attribute. It must be unique among all other monitor attribute names for the associated monitor entry.displayName- The human-readable display name for the monitor attribute.description- The human-readable description for the monitor attribute.value- The value for the monitor attribute.
-
addMonitorAttribute
protected static void addMonitorAttribute(@NotNull java.util.Map<java.lang.String,MonitorAttribute> attrs, @NotNull java.lang.String name, @NotNull java.lang.String displayName, @Nullable java.lang.String description, @NotNull java.lang.String value)
Adds a new monitor attribute to the specified map using the provided information.- Parameters:
attrs- The attribute map to which the information should be added.name- The name to use for this monitor attribute. It must be unique among all other monitor attribute names for the associated monitor entry.displayName- The human-readable display name for the monitor attribute.description- The human-readable description for the monitor attribute.value- The value for the monitor attribute.
-
addMonitorAttribute
protected static void addMonitorAttribute(@NotNull java.util.Map<java.lang.String,MonitorAttribute> attrs, @NotNull java.lang.String name, @NotNull java.lang.String displayName, @Nullable java.lang.String description, @NotNull java.util.List<java.lang.String> values)
Adds a new monitor attribute to the specified map using the provided information.- Parameters:
attrs- The attribute map to which the information should be added.name- The name to use for this monitor attribute. It must be unique among all other monitor attribute names for the associated monitor entry.displayName- The human-readable display name for the monitor attribute.description- The human-readable description for the monitor attribute.values- The set of values for the monitor attribute.
-
toString
@NotNull public final java.lang.String toString()
Retrieves a string representation of this monitor entry.- Overrides:
toStringin classjava.lang.Object- Returns:
- A string representation of this monitor entry.
-
-