summaryrefslogtreecommitdiff
path: root/vendor/open-telemetry/sdk/Resource/ResourceInfo.php
diff options
context:
space:
mode:
Diffstat (limited to 'vendor/open-telemetry/sdk/Resource/ResourceInfo.php')
-rw-r--r--vendor/open-telemetry/sdk/Resource/ResourceInfo.php125
1 files changed, 0 insertions, 125 deletions
diff --git a/vendor/open-telemetry/sdk/Resource/ResourceInfo.php b/vendor/open-telemetry/sdk/Resource/ResourceInfo.php
deleted file mode 100644
index 4210a6142..000000000
--- a/vendor/open-telemetry/sdk/Resource/ResourceInfo.php
+++ /dev/null
@@ -1,125 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace OpenTelemetry\SDK\Resource;
-
-use OpenTelemetry\API\Behavior\LogsMessagesTrait;
-use OpenTelemetry\SDK\Common\Attribute\Attributes;
-use OpenTelemetry\SDK\Common\Attribute\AttributesInterface;
-
-use OpenTelemetry\SDK\Common\Dev\Compatibility\Util as BcUtil;
-
-/**
- * A Resource is an immutable representation of the entity producing telemetry. For example, a process producing telemetry
- * that is running in a container on Kubernetes has a Pod name, it is in a namespace and possibly is part of a Deployment
- * which also has a name. All three of these attributes can be included in the Resource.
- *
- * The class named as ResourceInfo due to `resource` is the soft reserved word in PHP.
- */
-class ResourceInfo
-{
- use LogsMessagesTrait;
-
- private AttributesInterface $attributes;
- private ?string $schemaUrl;
-
- private function __construct(AttributesInterface $attributes, ?string $schemaUrl = null)
- {
- $this->attributes = $attributes;
- $this->schemaUrl = $schemaUrl;
- }
-
- public static function create(AttributesInterface $attributes, ?string $schemaUrl = null): self
- {
- return new ResourceInfo($attributes, $schemaUrl);
- }
-
- public function getAttributes(): AttributesInterface
- {
- return $this->attributes;
- }
-
- public function getSchemaUrl(): ?string
- {
- return $this->schemaUrl;
- }
-
- public function serialize(): string
- {
- $copyOfAttributesAsArray = array_slice($this->attributes->toArray(), 0); //This may be overly cautious (in trying to avoid mutating the source array)
- ksort($copyOfAttributesAsArray); //sort the associative array by keys since the serializer will consider equal arrays different otherwise
-
- //The exact return value doesn't matter, as long as it can distingusih between instances that represent the same/different resources
- return serialize([
- 'schemaUrl' => $this->schemaUrl,
- 'attributes' => $copyOfAttributesAsArray,
- ]);
- }
-
- /**
- * Merge current resource with an updating resource, combining all attributes. If a key exists on both the old and updating
- * resource, the value of the updating resource MUST be picked (even if the updated value is empty)
- *
- * @see https://github.com/open-telemetry/opentelemetry-specification/blob/v1.20.0/specification/resource/sdk.md#merge
- */
- public function merge(ResourceInfo $updating): ResourceInfo
- {
- $schemaUrl = self::mergeSchemaUrl($this->getSchemaUrl(), $updating->getSchemaUrl());
- $attributes = $updating->getAttributes()->toArray() + $this->getAttributes()->toArray();
-
- return ResourceInfo::create(Attributes::create($attributes), $schemaUrl);
- }
-
- /**
- * Merge the schema URLs from the old and updating resource.
- * @see https://github.com/open-telemetry/opentelemetry-specification/blob/v1.20.0/specification/resource/sdk.md#merge
- */
- private static function mergeSchemaUrl(?string $old, ?string $updating): ?string
- {
- if (empty($old)) {
- return $updating;
- }
- if (empty($updating)) {
- return $old;
- }
- if ($old === $updating) {
- return $old;
- }
-
- self::logWarning('Merging resources with different schema URLs', [
- 'old' => $old,
- 'updating' => $updating,
- ]);
-
- return null;
- }
-
- /**
- * @codeCoverageIgnore
- */
- public static function defaultResource(): ResourceInfo
- {
- BcUtil::triggerMethodDeprecationNotice(
- __METHOD__,
- 'defaultResource',
- ResourceInfoFactory::class
- );
-
- return ResourceInfoFactory::defaultResource();
- }
-
- /**
- * @codeCoverageIgnore
- */
- public static function emptyResource(): ResourceInfo
- {
- BcUtil::triggerMethodDeprecationNotice(
- __METHOD__,
- 'emptyResource',
- ResourceInfoFactory::class
- );
-
- return ResourceInfoFactory::emptyResource();
- }
-}