Package io.opentelemetry.sdk.resources

Class Resource

java.lang.Object

io.opentelemetry.sdk.resources.Resource

@Immutable
public abstract class Resource
extends Object

Resource represents a resource, which capture identifying information about the entities for which signals (stats or traces) are reported.

Method Summary

Modifier and Type	Method	Description
static ResourceBuilder	builder()	Returns a new ResourceBuilder instance for creating arbitrary Resource.
static Resource	create(io.opentelemetry.api.common.Attributes attributes)	Returns a Resource.
static Resource	empty()	Returns an empty Resource.
abstract io.opentelemetry.api.common.Attributes	getAttributes()	Returns a map of attributes that describe the resource.
static Resource	getDefault()	Returns the default Resource.
abstract int	hashCode()
Resource	merge(Resource other)	Returns a new, merged Resource by merging the current Resource with the other Resource.
ResourceBuilder	toBuilder()	Returns a new ResourceBuilder instance populated with the data of this Resource.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Method Detail

getDefault

public static Resource getDefault()

Returns the default Resource. This resource contains the default attributes provided by the SDK.

Returns:

a Resource.

empty

public static Resource empty()

Returns an empty Resource. When creating a Resource, it is strongly recommended to start with getDefault() instead of this method to include SDK required attributes.

Returns:

an empty Resource.

create

public static Resource create(io.opentelemetry.api.common.Attributes attributes)

Returns a Resource.

Parameters:

attributes - a map of attributes that describe the resource.

Returns:

a Resource.

Throws:

NullPointerException - if attributes is null.

IllegalArgumentException - if attribute key or attribute value is not a valid printable ASCII string or exceed MAX_LENGTH characters.

getAttributes

public abstract io.opentelemetry.api.common.Attributes getAttributes()

Returns a map of attributes that describe the resource.

Returns:

a map of attributes.

hashCode

@Memoized
public abstract int hashCode()

Overrides:

hashCode in class Object

merge

public Resource merge(@Nullable
                      Resource other)

Returns a new, merged Resource by merging the current Resource with the other Resource. In case of a collision, the "other" Resource takes precedence.

Parameters:

other - the Resource that will be merged with this.

Returns:

the newly merged Resource.

builder

public static ResourceBuilder builder()

Returns a new ResourceBuilder instance for creating arbitrary Resource.

Since:

1.1.0

toBuilder

public ResourceBuilder toBuilder()

Returns a new ResourceBuilder instance populated with the data of this Resource.

Since:

1.1.0