README

This is a read-only subtree split of https://github.com/open-telemetry/opentelemetry-php-contrib.

OpenTelemetry DigitalOcean resource detector

Please see https://opentelemetry.io/docs/languages/php/resources/#custom-resource-detectors for installation and configuration.

Overview

This package provides an OpenTelemetry ResourceDetector which will detect resource attributes for DigitalOcean Droplets.

The following OpenTelemetry resource attributes will be detected:

Configuration

By default, all installed resource detectors are used, and the attributes they detect will be added to the default resources associated with traces, metrics, and logs.

You can also provide a list of specific detectors via the OTEL_PHP_DETECTORS config (environment variable or php.ini setting):

OTEL_PHP_DETECTORS="host,process,digitalocean"

Footnotes

1. If a DigitalOcean API personal access token, with the listed scope, is available to PHP via the DIGITALOCEAN_ACCESS_TOKEN environment variable, this resource detector will attempt to read the corresponding values from the API. This has no impact on the other attributes. ↩ ↩² ↩³ ↩⁴ ↩⁵

2. These attributes are marked as Opt-In within the OpenTelemetry semantic conventions, meaning they should not be included unless the user configures the instrumentation to do so. It is a future todo for this library to support configuration. ↩ ↩²

3. These attributes should be combined with a resource detector that includes all of the os resource attributes, but if these attributes are known, they will be provided. ↩ ↩²