@ExperimentalApi

Package io.opencensus.resource

API for resource information population.

The resource library primarily defines a type "Resource" that captures information about the entity for which stats or traces are recorded. For example, metrics exposed by a Kubernetes container can be linked to a resource that specifies the cluster, namespace, pod, and container name.

Two environment variables are used to populate resource information:

  • OC_RESOURCE_TYPE: A string that describes the type of the resource prefixed by a domain namespace. Leading and trailing whitespaces are trimmed. e.g. “kubernetes.io/container”.
  • OC_RESOURCE_LABELS: A comma-separated list of labels describing the source in more detail, e.g. “key1=val1,key2=val2”. The allowed character set is appropriately constrained.

Type, label keys, and label values MUST contain only printable ASCII (codes between 32 and 126, inclusive) and less than 256 characters. Type and label keys MUST have a length greater than zero. They SHOULD start with a domain name and separate hierarchies with / characters, e.g. k8s.io/namespace/name.

WARNING: Currently all the public classes under this package are marked as ExperimentalApi. DO NOT USE except for experimental purposes.

Please see https://github.com/census-instrumentation/opencensus-specs/blob/master/resource/Resource.md for more details.