Resources
You are viewing the English version of this page because it has not yet been fully translated. Interested in helping out? See Contributing.
リソースは、リソース属性としてテレメトリーを生成するエンティティを表します。 たとえば、Kubernetes上のコンテナで実行されているテレメトリーを生成するプロセスは、プロセス名、ポッド名、ネームスペース、および場合によってはデプロイメント名を持ちます。 これらの4つの属性すべてをリソースに含まれることができます。
オブザーバビリティバックエンドでは、リソース情報を使用して興味深い動作をより詳細に調査できます。 たとえば、トレースまたはメトリクスデータがシステムのレイテンシーを示している場合、それを特定のコンテナ、ポッド、またはKubernetesデプロイメントに絞り込むことができます。
Resource Detection
The PHP SDK detects resources from a variety of sources, and by default will use all available resource detectors:
- environment (
OTEL_RESOURCE_ATTRIBUTES
,OTEL_SERVICE_NAME
) - host information
- host operating system
- current process
- runtime
Disabling resource detection
By default, all SDK resource detectors are used, but you can use the environment
variable OTEL_PHP_RESOURCE_DETECTORS
to enable only certain detectors, or
completely disable them:
env
host
os
process
process_runtime
sdk
sdk_provided
all
- enable all resource detectorsnone
- disable resource detection
For example, to enable only the env
, host
and sdk
detectors:
env OTEL_PHP_RESOURCE_DETECTORS=env,host,sdk \
php example.php
Custom resource detectors
Resource detectors for generic platforms or vendor-specific environments can be installed as composer packages.
For example, to install and enable the container
resource detector:
composer require open-telemetry/detector-container
env OTEL_PHP_RESOURCE_DETECTORS=container \
php example.php
Note that installed detectors are automatically included in the default all
resource detector list.
Adding resources with environment variables
If there is not an SDK detector for the resource you need, you can add arbitrary
resources via the OTEL_RESOURCE_ATTRIBUTES
environment variable, which is
interpreted by the env
detector. This variable takes a comma-separated list of
key=value pairs, for example:
env OTEL_RESOURCE_ATTRIBUTES="service.name=my_service,service.namespace=demo,service.version=1.0,deployment.environment=development" \
php example.php
Adding resources in code
Custom resources can also be configured in your code. Here, the default resources (detected as described above) are merged with custom resources. The resources are then passed to the tracer provider, where they will be associated with all generated spans.
$resource = ResourceInfoFactory::defaultResource()->merge(ResourceInfo::create(Attributes::create([
ResourceAttributes::SERVICE_NAMESPACE => 'foo',
ResourceAttributes::SERVICE_NAME => 'bar',
ResourceAttributes::SERVICE_INSTANCE_ID => 1,
ResourceAttributes::SERVICE_VERSION => '0.1',
ResourceAttributes::DEPLOYMENT_ENVIRONMENT_NAME => 'development',
])));
$tracerProvider = new TracerProvider(
new SimpleSpanProcessor(
(new ConsoleSpanExporterFactory())->create()
),
null,
$resource
);
フィードバック
このページは役に立ちましたか?
Thank you. Your feedback is appreciated!
Please let us know how we can improve this page. Your feedback is appreciated!