@opentelemetry/resource-detector-gcp
v0.30.0
Published
OpenTelemetry SDK resource detector for GCP
Downloads
3,684,922
Readme
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.