type Resource … var defaultResource … var defaultResourceOnce … var ErrSchemaURLConflict … // New returns a [Resource] built using opts. // // This may return a partial Resource along with an error containing // [ErrPartialResource] if options that provide a [Detector] are used and that // error is returned from one or more of the Detectors. It may also return a // merge-conflict Resource along with an error containing // [ErrSchemaURLConflict] if merging Resources from the opts results in a // schema URL conflict (see [Resource.Merge] for more information). It is up to // the caller to determine if this returned Resource should be used or not // based on these errors. func New(ctx context.Context, opts ...Option) (*Resource, error) { … } // NewWithAttributes creates a resource from attrs and associates the resource with a // schema URL. If attrs contains duplicate keys, the last value will be used. If attrs // contains any invalid items those items will be dropped. The attrs are assumed to be // in a schema identified by schemaURL. func NewWithAttributes(schemaURL string, attrs ...attribute.KeyValue) *Resource { … } // NewSchemaless creates a resource from attrs. If attrs contains duplicate keys, // the last value will be used. If attrs contains any invalid items those items will // be dropped. The resource will not be associated with a schema URL. If the schema // of the attrs is known use NewWithAttributes instead. func NewSchemaless(attrs ...attribute.KeyValue) *Resource { … } // String implements the Stringer interface and provides a // human-readable form of the resource. // // Avoid using this representation as the key in a map of resources, // use Equivalent() as the key instead. func (r *Resource) String() string { … } // MarshalLog is the marshaling function used by the logging system to represent this Resource. func (r *Resource) MarshalLog() interface{ … } // Attributes returns a copy of attributes from the resource in a sorted order. // To avoid allocating a new slice, use an iterator. func (r *Resource) Attributes() []attribute.KeyValue { … } // SchemaURL returns the schema URL associated with Resource r. func (r *Resource) SchemaURL() string { … } // Iter returns an iterator of the Resource attributes. // This is ideal to use if you do not want a copy of the attributes. func (r *Resource) Iter() attribute.Iterator { … } // Equal returns true when a Resource is equivalent to this Resource. func (r *Resource) Equal(eq *Resource) bool { … } // Merge creates a new [Resource] by merging a and b. // // If there are common keys between a and b, then the value from b will // overwrite the value from a, even if b's value is empty. // // The SchemaURL of the resources will be merged according to the // [OpenTelemetry specification rules]: // // - If a's schema URL is empty then the returned Resource's schema URL will // be set to the schema URL of b, // - Else if b's schema URL is empty then the returned Resource's schema URL // will be set to the schema URL of a, // - Else if the schema URLs of a and b are the same then that will be the // schema URL of the returned Resource, // - Else this is a merging error. If the resources have different, // non-empty, schema URLs an error containing [ErrSchemaURLConflict] will // be returned with the merged Resource. The merged Resource will have an // empty schema URL. It may be the case that some unintended attributes // have been overwritten or old semantic conventions persisted in the // returned Resource. It is up to the caller to determine if this returned // Resource should be used or not. // // [OpenTelemetry specification rules]: https://github.com/open-telemetry/opentelemetry-specification/blob/v1.20.0/specification/resource/sdk.md#merge func Merge(a, b *Resource) (*Resource, error) { … } // Empty returns an instance of Resource with no attributes. It is // equivalent to a `nil` Resource. func Empty() *Resource { … } // Default returns an instance of Resource with a default // "service.name" and OpenTelemetrySDK attributes. func Default() *Resource { … } // Environment returns an instance of Resource with attributes // extracted from the OTEL_RESOURCE_ATTRIBUTES environment variable. func Environment() *Resource { … } // Equivalent returns an object that can be compared for equality // between two resources. This value is suitable for use as a key in // a map. func (r *Resource) Equivalent() attribute.Distinct { … } // Set returns the equivalent *attribute.Set of this resource's attributes. func (r *Resource) Set() *attribute.Set { … } // MarshalJSON encodes the resource attributes as a JSON list of { "Key": // "...", "Value": ... } pairs in order sorted by key. func (r *Resource) MarshalJSON() ([]byte, error) { … } // Len returns the number of unique key-values in this Resource. func (r *Resource) Len() int { … } // Encoded returns an encoded representation of the resource. func (r *Resource) Encoded(enc attribute.Encoder) string { … }
Codebase Browser
kubernetes