Resource Detection

Description

The resource detection processor can be used to detect resource information from the host, in a format that conforms to the OpenTelemetry resource semantic conventions, and append or override the resource value in telemetry data with this information.

Supported Types

MetricsLogsTracesBindPlane Agent
v1.40.0+

Configuration Table

FieldDescription
DetectorDetector(s) to use for resource detection. Available detectors include aks, azure, consul, ec2, eks, gcp, k8snode, openshift, and system.
OverrideWhether or not to overwrite existing resource attributes.
TimeoutTime duration after which a resource detector request will timeout.
Hostname SourceWhen the system detector is in use, specifies the source used to detect the system hostname. Options include os, dns, cname, and lookup.
EC2 TagsSpecifies a list of regex's to match to EC2 instance tag keys that will be added as resource attributes to processed data.
K8s Node Environment VariableThe K8s node environment variable that has the node name to retrieve metadata for. Defaults to "KUBE_NODE_NAME" because the BindPlane Agent has this automatically set.
Consul AddressThe address of the Consul server. If unset, the environment variable "CONSUL_HTTP_ADDR" will be used if it exists.
Consul AuthenticationThe type of authentication to use with Consul. One of 'Token' or 'Token File' is required if Consul's ACL System is enabled. Options are "None", "Token", or "Token File".
Consul TokenToken is used to provide a per-request ACL token which overrides the agent's default token. If unset, the environment variable "CONSUL_HTTP_TOKEN" will be used if it exists.
Consul Token FileToken File is a file containing the current token to use for this client. If provided, it is read once at startup and never again. If unset, the environment variable "CONSUL_HTTP_TOKEN_FILE" will be used if it exists.
Consul DatacenterOptional Consul Datacenter to use. If not provided, the default agent datacenter is used.
Consul NamespaceOptional namespace to attach to each Consul request. If unset, the environment variable "CONSUL_NAMESPACE" will be used if it exists.
Consul Metadata LabelsAllowlist of Consul Metadata keys to use as resource attributes.

note

Multiple detectors may be selected on a single processor. However, if multiple processors use a common attribute name, the first detector will have precedent. For more info, see this OTel documentation.

Example Configurations

Google Compute Engine (GCE)

In this example, the Resource Detection Processor is configured to use the GCP detector to detect GCE resource attributes.

resource-detection-v2-1 resource-detection-v2-2

Amazon EC2

In this example, the Resource Detection Processor is configured to use the EC2 detector.

resource-detection-v2-3 resource-detection-v2-4

Azure Compute Instance

In this example, the Resource Detection Processor is configured to use the Azure detector to detect Azure Virtual Machine resource attributes.

resource-detection-v2-5 resource-detection-v2-6

Kubernetes

The Resource Detection Processor can detect Kubernetes resources on the following platforms: GKE, Amazon EKS, Azure AKS.

Using the GCP detector, you can detect cloud-based Kubernetes resources.

resource-detection-v2-1 resource-detection-v2-7