| 
									
										
										
										
											2023-05-09 19:19:48 +02:00
										 |  |  | // Copyright The OpenTelemetry Authors | 
					
						
							|  |  |  | // | 
					
						
							|  |  |  | // Licensed under the Apache License, Version 2.0 (the "License"); | 
					
						
							|  |  |  | // you may not use this file except in compliance with the License. | 
					
						
							|  |  |  | // You may obtain a copy of the License at | 
					
						
							|  |  |  | // | 
					
						
							|  |  |  | //     http://www.apache.org/licenses/LICENSE-2.0 | 
					
						
							|  |  |  | // | 
					
						
							|  |  |  | // Unless required by applicable law or agreed to in writing, software | 
					
						
							|  |  |  | // distributed under the License is distributed on an "AS IS" BASIS, | 
					
						
							|  |  |  | // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | 
					
						
							|  |  |  | // See the License for the specific language governing permissions and | 
					
						
							|  |  |  | // limitations under the License. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | package resource // import "go.opentelemetry.io/otel/sdk/resource" | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | import ( | 
					
						
							|  |  |  | 	"context" | 
					
						
							|  |  |  | 	"fmt" | 
					
						
							|  |  |  | 	"net/url" | 
					
						
							|  |  |  | 	"os" | 
					
						
							|  |  |  | 	"strings" | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | 	"go.opentelemetry.io/otel" | 
					
						
							|  |  |  | 	"go.opentelemetry.io/otel/attribute" | 
					
						
							| 
									
										
										
										
											2023-09-07 13:20:37 +02:00
										 |  |  | 	semconv "go.opentelemetry.io/otel/semconv/v1.21.0" | 
					
						
							| 
									
										
										
										
											2023-05-09 19:19:48 +02:00
										 |  |  | ) | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | const ( | 
					
						
							|  |  |  | 	// resourceAttrKey is the environment variable name OpenTelemetry Resource information will be read from. | 
					
						
							| 
									
										
										
										
											2023-11-13 11:08:02 +01:00
										 |  |  | 	resourceAttrKey = "OTEL_RESOURCE_ATTRIBUTES" //nolint:gosec // False positive G101: Potential hardcoded credentials | 
					
						
							| 
									
										
										
										
											2023-05-09 19:19:48 +02:00
										 |  |  | 
 | 
					
						
							|  |  |  | 	// svcNameKey is the environment variable name that Service Name information will be read from. | 
					
						
							|  |  |  | 	svcNameKey = "OTEL_SERVICE_NAME" | 
					
						
							|  |  |  | ) | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2023-11-13 11:08:02 +01:00
										 |  |  | // errMissingValue is returned when a resource value is missing. | 
					
						
							|  |  |  | var errMissingValue = fmt.Errorf("%w: missing value", ErrPartialResource) | 
					
						
							| 
									
										
										
										
											2023-05-09 19:19:48 +02:00
										 |  |  | 
 | 
					
						
							|  |  |  | // fromEnv is a Detector that implements the Detector and collects | 
					
						
							|  |  |  | // resources from environment.  This Detector is included as a | 
					
						
							|  |  |  | // builtin. | 
					
						
							|  |  |  | type fromEnv struct{} | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | // compile time assertion that FromEnv implements Detector interface. | 
					
						
							|  |  |  | var _ Detector = fromEnv{} | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | // Detect collects resources from environment. | 
					
						
							|  |  |  | func (fromEnv) Detect(context.Context) (*Resource, error) { | 
					
						
							|  |  |  | 	attrs := strings.TrimSpace(os.Getenv(resourceAttrKey)) | 
					
						
							|  |  |  | 	svcName := strings.TrimSpace(os.Getenv(svcNameKey)) | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | 	if attrs == "" && svcName == "" { | 
					
						
							|  |  |  | 		return Empty(), nil | 
					
						
							|  |  |  | 	} | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | 	var res *Resource | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | 	if svcName != "" { | 
					
						
							|  |  |  | 		res = NewSchemaless(semconv.ServiceName(svcName)) | 
					
						
							|  |  |  | 	} | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | 	r2, err := constructOTResources(attrs) | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | 	// Ensure that the resource with the service name from OTEL_SERVICE_NAME | 
					
						
							|  |  |  | 	// takes precedence, if it was defined. | 
					
						
							|  |  |  | 	res, err2 := Merge(r2, res) | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | 	if err == nil { | 
					
						
							|  |  |  | 		err = err2 | 
					
						
							|  |  |  | 	} else if err2 != nil { | 
					
						
							|  |  |  | 		err = fmt.Errorf("detecting resources: %s", []string{err.Error(), err2.Error()}) | 
					
						
							|  |  |  | 	} | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | 	return res, err | 
					
						
							|  |  |  | } | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | func constructOTResources(s string) (*Resource, error) { | 
					
						
							|  |  |  | 	if s == "" { | 
					
						
							|  |  |  | 		return Empty(), nil | 
					
						
							|  |  |  | 	} | 
					
						
							|  |  |  | 	pairs := strings.Split(s, ",") | 
					
						
							| 
									
										
										
										
											2023-06-05 10:15:05 +02:00
										 |  |  | 	var attrs []attribute.KeyValue | 
					
						
							| 
									
										
										
										
											2023-05-09 19:19:48 +02:00
										 |  |  | 	var invalid []string | 
					
						
							|  |  |  | 	for _, p := range pairs { | 
					
						
							| 
									
										
										
										
											2023-06-05 10:15:05 +02:00
										 |  |  | 		k, v, found := strings.Cut(p, "=") | 
					
						
							|  |  |  | 		if !found { | 
					
						
							| 
									
										
										
										
											2023-05-09 19:19:48 +02:00
										 |  |  | 			invalid = append(invalid, p) | 
					
						
							|  |  |  | 			continue | 
					
						
							|  |  |  | 		} | 
					
						
							| 
									
										
										
										
											2023-06-05 10:15:05 +02:00
										 |  |  | 		key := strings.TrimSpace(k) | 
					
						
							| 
									
										
										
										
											2023-11-13 11:08:02 +01:00
										 |  |  | 		val, err := url.PathUnescape(strings.TrimSpace(v)) | 
					
						
							| 
									
										
										
										
											2023-05-09 19:19:48 +02:00
										 |  |  | 		if err != nil { | 
					
						
							|  |  |  | 			// Retain original value if decoding fails, otherwise it will be | 
					
						
							|  |  |  | 			// an empty string. | 
					
						
							| 
									
										
										
										
											2023-06-05 10:15:05 +02:00
										 |  |  | 			val = v | 
					
						
							| 
									
										
										
										
											2023-05-09 19:19:48 +02:00
										 |  |  | 			otel.Handle(err) | 
					
						
							|  |  |  | 		} | 
					
						
							| 
									
										
										
										
											2023-06-05 10:15:05 +02:00
										 |  |  | 		attrs = append(attrs, attribute.String(key, val)) | 
					
						
							| 
									
										
										
										
											2023-05-09 19:19:48 +02:00
										 |  |  | 	} | 
					
						
							|  |  |  | 	var err error | 
					
						
							|  |  |  | 	if len(invalid) > 0 { | 
					
						
							|  |  |  | 		err = fmt.Errorf("%w: %v", errMissingValue, invalid) | 
					
						
							|  |  |  | 	} | 
					
						
							|  |  |  | 	return NewSchemaless(attrs...), err | 
					
						
							|  |  |  | } |