@opentelemetry/resource-detector-gcp
v0.29.12 opentelemetry nodejs resources stats profiling
OpenTelemetry Resource Detector for GCP
Resource detector for Google Cloud Platform.
Compatible with OpenTelemetry JS API and SDK 1.0+.
Installation
The GCP resource detector requires Node.JS 10+ due to a dependency on gcp-metadata which uses features only available in Node.JS 10+.
npm install --save @opentelemetry/resource-detector-gcp
Usage
import { detectResources } from '@opentelemetry/resources';
import { gcpDetector } from '@opentelemetry/resource-detector-gcp'
const resource = await detectResources({
detectors: [gcpDetector],
})
const tracerProvider = new NodeTracerProvider({ resource });
Available detectors
This package uses @opentelemetry/semantic-conventions version 1.22+, which implements Semantic Convention Version 1.7.0
GCP Detector
| Resource Attribute | Description |
|---|---|
| cloud.account.id | Value of project-id from GCP Metadata project |
| cloud.availability_zone | Value of zone from GCP Metadata instance |
| cloud.provider | The cloud provider. In this context, it's always "gcp" |
| container.name | Value of Environment Variable CONTAINER_NAME |
| host.id | Value of id from GCP Metadata instance |
| host.name | Value of hostname from GCP Metadata instance |
| k8s.cluster.name | Value of attributes/cluster-name from GCP Metadata instance |
| k8s.namespace.name | Value of Environment Variable NAMESPACE |
| k8s.pod.name | Value of Environment Variable HOSTNAME |
Useful links
- GCP Metadata Documentation
- For more information on OpenTelemetry, visit: https://opentelemetry.io/
- For more about OpenTelemetry JavaScript: https://github.com/open-telemetry/opentelemetry-js
- For help or feedback on this project, join us in GitHub Discussions
License
Apache 2.0 - See LICENSE for more information.
npm i @opentelemetry/resource-detector-gcp
Metadata
- Apache-2.0
- >=14
- OpenTelemetry Authors
- released 10/8/2024
