feat: custom resource attributes (#394)

Author: sjvans

CHANGELOG.md

@@ -4,7 +4,11 @@ All notable changes to this project will be documented in this file.
 This project adheres to [Semantic Versioning](http://semver.org/).
 The format is based on [Keep a Changelog](http://keepachangelog.com/).
 
-## Version 1.5.5 - 2025-11-XX
+## Version 1.6.0 - 2025-11-XX
+
+### Added
+
+- Provide custom resource attributes via `cds.requires.telemetry.resource.attributes`
 
 ### Fixed
 

README.md

@@ -34,6 +34,7 @@ Documentation can be found at [cap.cloud.sap](https://cap.cloud.sap/docs) and [o
   - [`telemetry-to-otlp`](#telemetry-to-otlp)
 - [Detailed Configuration Options](#detailed-configuration-options)
   - [Configuration Pass Through](#configuration-pass-through)
+  - [Resource Attributes](#resource-attributes)
   - [Instrumentations](#instrumentations)
   - [Sampler](#sampler)
   - [Propagators](#propagators)
@@ -367,6 +368,23 @@ For example, it is possible to specify the `temporalityPreference` setting of th
 ```
 
 
+### Resource Attributes
+
+Resource attributes describe the entity producing telemetry.
+See [Resources](https://opentelemetry.io/docs/concepts/resources) and [Resource semantic conventions](https://opentelemetry.io/docs/specs/semconv/resource) for more details.
+
+`@cap-js/telemetry` automatically derives resource attributes from the app's info (`package.json`) as well as the app's environment ().
+You can configure additional attributes or also overwrite the derived attributes via `cds.requires.telemetry.resource.attributes = { <key>: <value>, ... }`
+
+Example:
+```json
+{
+  "service.version": "1.2.3",
+  "my.custom.attribute": "foo"
+}
+```
+
+
 ### Instrumentations
 
 Configure via `cds.requires.telemetry.instrumentations = { <name>: { module, class, config? } }`

lib/utils.js

@@ -72,6 +72,9 @@ function getResource() {
     attributes['sap.cf.process.type'] = VCAP_APPLICATION.process_type
   }
 
+  if (cds.env.requires.telemetry?.resource?.attributes)
+    Object.assign(attributes, cds.env.requires.telemetry.resource.attributes)
+
   return new Resource(attributes)
 }