Class Node
- All Implemented Interfaces:
Serializable,SdkPojo,ToCopyableBuilder<Node.Builder,Node>
A node in the context graph representing a service, resource, or remote service.
- See Also:
-
Nested Class Summary
Nested Classes -
Method Summary
Modifier and TypeMethodDescriptionOther names this node was observed under.static Node.Builderbuilder()edges()Outbound edges originating from this node.final booleanfinal booleanequalsBySdkFields(Object obj) Indicates whether some other object is "equal to" this one by SDK fields.final InstantWhen this node was first observed (UTC), at minute granularity.final <T> Optional<T> getValueForField(String fieldName, Class<T> clazz) final booleanFor responses, this returns true if the service returned a value for the AlternateNames property.final booleanhasEdges()For responses, this returns true if the service returned a value for the Edges property.final inthashCode()final booleanFor responses, this returns true if the service returned a value for the OperationDetails property.final booleanFor responses, this returns true if the service returned a value for the SignalTypes property.final booleanFor responses, this returns true if the service returned a value for the Sources property.final booleanhasTags()For responses, this returns true if the service returned a value for the Tags property.final booleanFor responses, this returns true if the service returned a value for the TelemetryAttributes property.final InstantWhen this node was most recently observed (UTC), at minute granularity.final Metadatametadata()Descriptive metadata about the node.final Stringname()The primary display name of the node.final StringnodeId()The unique identifier of the node within the context graph.final NodePropertiesIdentity attributes promoted out of the flat attribute map onto typed members.final NodeTypenodeType()Whether the node is a service, a resource, or a remote service.final StringWhether the node is a service, a resource, or a remote service.The operations observed on this node, keyed by operation name.static Class<? extends Node.Builder> The kinds of telemetry signal observed on this node.The kinds of telemetry signal observed on this node.sources()The discovery sources that contributed this node.The discovery sources that contributed this node.tags()The tags observed on the underlying resource.The node's OpenTelemetry (OTel) attributes, as emitted by telemetry — the raw values, as opposed to the normalizednodeProperties.Take this object and create a builder that contains all of the current property values of this object.final StringtoString()Returns a string representation of this object.Methods inherited from interface software.amazon.awssdk.utils.builder.ToCopyableBuilder
copy
-
Method Details
-
nodeId
The unique identifier of the node within the context graph.
- Returns:
- The unique identifier of the node within the context graph.
-
nodeType
Whether the node is a service, a resource, or a remote service.
If the service returns an enum value that is not available in the current SDK version,
nodeTypewill returnNodeType.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromnodeTypeAsString().- Returns:
- Whether the node is a service, a resource, or a remote service.
- See Also:
-
nodeTypeAsString
Whether the node is a service, a resource, or a remote service.
If the service returns an enum value that is not available in the current SDK version,
nodeTypewill returnNodeType.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromnodeTypeAsString().- Returns:
- Whether the node is a service, a resource, or a remote service.
- See Also:
-
name
The primary display name of the node.
- Returns:
- The primary display name of the node.
-
hasAlternateNames
public final boolean hasAlternateNames()For responses, this returns true if the service returned a value for the AlternateNames property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified. -
alternateNames
Other names this node was observed under. A node that merged across sources reports one resolved name, and the names it was merged away from appear here.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasAlternateNames()method.- Returns:
- Other names this node was observed under. A node that merged across sources reports one resolved name, and the names it was merged away from appear here.
-
hasTags
public final boolean hasTags()For responses, this returns true if the service returned a value for the Tags property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified. -
tags
The tags observed on the underlying resource.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasTags()method.- Returns:
- The tags observed on the underlying resource.
-
nodeProperties
Identity attributes promoted out of the flat attribute map onto typed members.
- Returns:
- Identity attributes promoted out of the flat attribute map onto typed members.
-
hasTelemetryAttributes
public final boolean hasTelemetryAttributes()For responses, this returns true if the service returned a value for the TelemetryAttributes property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified. -
telemetryAttributes
The node's OpenTelemetry (OTel) attributes, as emitted by telemetry — the raw values, as opposed to the normalized
nodeProperties. A key promoted onto anodePropertiesmember is removed here, so no value appears twice.Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasTelemetryAttributes()method.- Returns:
- The node's OpenTelemetry (OTel) attributes, as emitted by telemetry — the raw values, as opposed to the
normalized
nodeProperties. A key promoted onto anodePropertiesmember is removed here, so no value appears twice.
-
hasOperationDetails
public final boolean hasOperationDetails()For responses, this returns true if the service returned a value for the OperationDetails property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified. -
operationDetails
The operations observed on this node, keyed by operation name. Each value lists the dimension sets that identify the metric series for that operation.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasOperationDetails()method.- Returns:
- The operations observed on this node, keyed by operation name. Each value lists the dimension sets that identify the metric series for that operation.
-
signalTypes
The kinds of telemetry signal observed on this node.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasSignalTypes()method.- Returns:
- The kinds of telemetry signal observed on this node.
-
hasSignalTypes
public final boolean hasSignalTypes()For responses, this returns true if the service returned a value for the SignalTypes property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified. -
signalTypesAsStrings
The kinds of telemetry signal observed on this node.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasSignalTypes()method.- Returns:
- The kinds of telemetry signal observed on this node.
-
sources
The discovery sources that contributed this node.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasSources()method.- Returns:
- The discovery sources that contributed this node.
-
hasSources
public final boolean hasSources()For responses, this returns true if the service returned a value for the Sources property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified. -
sourcesAsStrings
The discovery sources that contributed this node.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasSources()method.- Returns:
- The discovery sources that contributed this node.
-
metadata
Descriptive metadata about the node. Present only when the request sets includeMetadata.
- Returns:
- Descriptive metadata about the node. Present only when the request sets includeMetadata.
-
firstObservedAt
When this node was first observed (UTC), at minute granularity. For a node that merged across sources, this is the earliest value any source reported.
- Returns:
- When this node was first observed (UTC), at minute granularity. For a node that merged across sources, this is the earliest value any source reported.
-
lastObservedAt
When this node was most recently observed (UTC), at minute granularity. For a node that merged across sources, this is the latest value any source reported.
- Returns:
- When this node was most recently observed (UTC), at minute granularity. For a node that merged across sources, this is the latest value any source reported.
-
hasEdges
public final boolean hasEdges()For responses, this returns true if the service returned a value for the Edges property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified. -
edges
Outbound edges originating from this node. Each edge carries its
from.Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasEdges()method.- Returns:
- Outbound edges originating from this node. Each edge carries its
from.
-
toBuilder
Description copied from interface:ToCopyableBuilderTake this object and create a builder that contains all of the current property values of this object.- Specified by:
toBuilderin interfaceToCopyableBuilder<Node.Builder,Node> - Returns:
- a builder for type T
-
builder
-
serializableBuilderClass
-
hashCode
-
equals
-
equalsBySdkFields
Description copied from interface:SdkPojoIndicates whether some other object is "equal to" this one by SDK fields. An SDK field is a modeled, non-inherited field in anSdkPojoclass, and is generated based on a service model.If an
SdkPojoclass does not have any inherited fields,equalsBySdkFieldsandequalsare essentially the same.- Specified by:
equalsBySdkFieldsin interfaceSdkPojo- Parameters:
obj- the object to be compared with- Returns:
- true if the other object equals to this object by sdk fields, false otherwise.
-
toString
-
getValueForField
-
sdkFields
-
sdkFieldNameToField
- Specified by:
sdkFieldNameToFieldin interfaceSdkPojo- Returns:
- The mapping between the field name and its corresponding field.
-