{"ref":"artifact:sap-samples-btp-resource-consumption-monitor","page":"/artifacts/sap-samples-btp-resource-consumption-monitor","json":"/artifacts/sap-samples-btp-resource-consumption-monitor.json","generated":"2026-11-15","drafted_with_ai":true,"entity":{"id":"sap-samples-btp-resource-consumption-monitor","name":"SAP-samples/btp-resource-consumption-monitor","artifact_type":"sample","ecosystem":"btp","use_as":"reference","domain":"operations-and-runtime","origin_ring":"sap-official","description":{"one_line":"An application that monitors an SAP BTP global account's CPEA or BTPEA credit consumption, breaking costs down by directory, subaccount and space and alerting daily when costs, usage or forecasts change.","short":"App monitoring SAP BTP credit consumption with alerts on increases","what_it_solves":"A global account on a consumption-based BTP contract spends credits every day and receives one statement a month. The application puts the figures in between: billing verification per service, a cost breakdown across directories, subaccounts and spaces, credit expenditure against the contract, cross-charging by tag, and alerts that fire daily when costs, usage or forecasts change. It installs as three components — a CAP TypeScript backend deployed to the [SAP BTP, Cloud Foundry Runtime](artifact:btp-cloud-foundry-runtime) or [SAP BTP, Kyma runtime](artifact:btp-kyma-runtime), an optional [SAP Analytics Cloud](artifact:btp-analytics-cloud) package, and a content package for [SAP Build Work Zone, standard edition](artifact:btp-build-work-zone-standard) — and creates its own recurring jobs on first start, retrieving the day's consumption every three hours by default.","when_not_to_use":"Never as the figure a billing decision rests on: the repository states that the tool is provided as-is, is not covered by SAP Support, is not a replacement of the official billing documents you receive from SAP, and that the information it provides is purely indicative. Its daily delta is also an approximation over a 24-hour period rather than a hard data point for the consumption on that day, because some services report usage only the day after it happened."},"links":{"repo":"https://github.com/SAP-samples/btp-resource-consumption-monitor"},"identity":{"license":"Apache-2.0"},"source_available":true,"demonstrates":["capability:consumption-monitoring"],"requires":[{"ref":"artifact:btp-hana-cloud","for":"the database the consumption data is stored in, through the HDI container the backend deploys","requirement":"required","sources":[{"url":"https://github.com/SAP-samples/btp-resource-consumption-monitor","title":"SAP-samples/btp-resource-consumption-monitor — README, Requirements","checked":"2026-10-19","quote":"- SAP HANA Cloud (you can re-use an existing instance. **Note**: this instance can sit in *any subaccount within the same region*)"},{"url":"https://github.com/SAP-samples/btp-resource-consumption-monitor","title":"SAP-samples/btp-resource-consumption-monitor — README, Requirements","checked":"2026-10-19","quote":"- SAP HANA Schemas & HDI Continers: hdi-shared"}]},{"ref":"artifact:btp-build-work-zone-standard","for":"the site the frontend content package is uploaded to and the application is opened from","requirement":"required","sources":[{"url":"https://github.com/SAP-samples/btp-resource-consumption-monitor","title":"SAP-samples/btp-resource-consumption-monitor — README, Requirements","checked":"2026-10-19","quote":"- SAP Work Zone (Standard edition is sufficient. **Note**: this subscription should be in the *same subaccount* as where the CF application will be deployed)"},{"url":"https://github.com/SAP-samples/btp-resource-consumption-monitor","title":"SAP-samples/btp-resource-consumption-monitor — README, Download and Installation","checked":"2026-10-19","quote":"3. A frontend package (content package) to be deployed to SAP Work Zone (WZ)"}]},{"ref":"artifact:btp-business-application-studio","for":"the development space the backend is built in, with the Development Tools for SAP Build Work Zone extension enabled","requirement":"conditional","condition":"the backend is built in Business Application Studio; the README also allows Visual Studio Code or another IDE with NodeJs, ts-node, @sap/cds-dk and mbt installed","sources":[{"url":"https://github.com/SAP-samples/btp-resource-consumption-monitor","title":"SAP-samples/btp-resource-consumption-monitor — README, Requirements","checked":"2026-10-19","quote":"- SAP Business Application Studio (**Note**: this subscription can sit in *any subaccount*)"},{"url":"https://github.com/SAP-samples/btp-resource-consumption-monitor","title":"SAP-samples/btp-resource-consumption-monitor — README, 1. Backend Application","checked":"2026-10-19","quote":"Alternatively, you can use Visual Studio Code or any other preferred IDE where NodeJs, [ts-node](https://www.npmjs.com/package/ts-node), [@sap/cds-dk](https://cap.cloud.sap/docs/get-started/jumpstart#_2-install-cap-s-cds-dk) and [mbt](https://github.com/SAP/cloud-mta-build-tool) is installed."}]},{"ref":"artifact:btp-usage-data-management","for":"the APIs the commercial and technical consumption figures are retrieved from","requirement":"required","sources":[{"url":"https://github.com/SAP-samples/btp-resource-consumption-monitor","title":"SAP-samples/btp-resource-consumption-monitor — README, Requirements","checked":"2026-10-19","quote":"- Usage Data Management Service: reporting-ga-admin"}]},{"ref":"artifact:btp-authorization-and-trust-management","for":"the authentication the deployed application runs behind, and the role collections assigned to its users","requirement":"required","sources":[{"url":"https://github.com/SAP-samples/btp-resource-consumption-monitor","title":"SAP-samples/btp-resource-consumption-monitor — README, Requirements","checked":"2026-10-19","quote":"- Authorization and Trust Management Service: application"}]},{"ref":"artifact:btp-destination","for":"the runtime destination the Work Zone content package is mapped to","requirement":"required","sources":[{"url":"https://github.com/SAP-samples/btp-resource-consumption-monitor","title":"SAP-samples/btp-resource-consumption-monitor — README, Requirements","checked":"2026-10-19","quote":"- Destination service: lite"}]},{"ref":"artifact:btp-html5-application-repository","for":"where the Fiori applications of the frontend package are hosted","requirement":"required","sources":[{"url":"https://github.com/SAP-samples/btp-resource-consumption-monitor","title":"SAP-samples/btp-resource-consumption-monitor — README, Requirements","checked":"2026-10-19","quote":"- HTML5 Application Repository Service: app-host"}]},{"ref":"artifact:btp-job-scheduling","for":"the recurring jobs the application creates on first start to retrieve daily, monthly and historic usage","requirement":"required","sources":[{"url":"https://github.com/SAP-samples/btp-resource-consumption-monitor","title":"SAP-samples/btp-resource-consumption-monitor — README, Requirements","checked":"2026-10-19","quote":"- Job Scheduling Service: standard"},{"url":"https://github.com/SAP-samples/btp-resource-consumption-monitor","title":"SAP-samples/btp-resource-consumption-monitor — README, Initial Data and Recurring Jobs","checked":"2026-10-19","quote":"When started for the first time, the application creates multiple jobs in the Job Scheduling Service:"}]},{"ref":"artifact:btp-alert-notification","for":"the channel the configured alerts are sent through, including the initial activation email","requirement":"required","sources":[{"url":"https://github.com/SAP-samples/btp-resource-consumption-monitor","title":"SAP-samples/btp-resource-consumption-monitor — README, Requirements","checked":"2026-10-19","quote":"- Alert Notification: standard"}]},{"ref":"artifact:btp-cloud-foundry-runtime","for":"the space the backend is deployed to in a Cloud Foundry deployment","requirement":"conditional","condition":"the Cloud Foundry deployment; the backend can be deployed to Kyma instead","sources":[{"url":"https://github.com/SAP-samples/btp-resource-consumption-monitor","title":"SAP-samples/btp-resource-consumption-monitor — README, Requirements","checked":"2026-10-19","quote":"You need to have access to a `Sub Account`, in which *Cloud Foundry* is enabled, and you have created a `Space`."}]},{"ref":"artifact:btp-kyma-runtime","for":"the namespace the backend is deployed to in a Kyma deployment, as container images built with pack","requirement":"conditional","condition":"the Kyma deployment, new from v2.1.0 onwards; the backend can be deployed to Cloud Foundry instead","sources":[{"url":"https://github.com/SAP-samples/btp-resource-consumption-monitor","title":"SAP-samples/btp-resource-consumption-monitor — README, Requirements","checked":"2026-10-19","quote":"You need to have access to a `Kyma Namespace`."}]},{"ref":"artifact:btp-analytics-cloud","for":"the tenant the optional analytical package is imported into, connected live to the HDI container","requirement":"conditional","condition":"the SAC content is activated; the README lists it as optional but recommended as an add-on","sources":[{"url":"https://github.com/SAP-samples/btp-resource-consumption-monitor","title":"SAP-samples/btp-resource-consumption-monitor — README, Requirements","checked":"2026-10-19","quote":"The following components are **optional but recommended** as an add-on:\n- SAP Analytics Cloud version 2024.08+ (**Note:** this SAC tenant can reside *anywhere*, it doesn't have to sit in the same global account)"},{"url":"https://github.com/SAP-samples/btp-resource-consumption-monitor","title":"SAP-samples/btp-resource-consumption-monitor — README, 2. SAC Content","checked":"2026-10-19","quote":"This component is optional but provides additional insights."}]}],"connects":[{"ref":"artifact:btp-usage-data-management","kind":"data","direction":"outbound","for":"retrieves the consumption information the dashboards are built from, every three hours in the default configuration","sources":[{"url":"https://github.com/SAP-samples/btp-resource-consumption-monitor","title":"SAP-samples/btp-resource-consumption-monitor — README, Initial Data and Recurring Jobs","checked":"2026-10-19","quote":"`Default_UpdateDailyUsage`: a recurring job to retrieve the consumption information for that day. In its default configuration, this job will run every 3 hours (*/3 UTC). Typically, the Usage Data Management API provides new data points around 6am UTC but this can vary."}]}],"maintainers":["actor:sap-samples"],"provenance":{"discovered_via":[{"source":"source:curator"}],"first_seen":"2026-09-14"},"drafted_with_ai":true,"contributors":["actor:1084565","actor:ajinkyapatil8190","actor:chris-snopud","actor:johannesbrandenburger","actor:mauriciolauffer","actor:willempardaens"]},"effective_normative_relations":[],"readings":{"liveness":[{"label":"Maintenance","tier":"unknown","evidence":"no release data"},{"label":"Continuity","tier":"good","evidence":"9 contributors, org-owned"},{"label":"Repository","tier":"good","evidence":"pushed 2026-11, not archived"}],"compatibility":[{"label":"Declared for","tier":"unknown","evidence":"no BTP release lines in the atlas"},{"label":"Survived majors","tier":"unknown","evidence":"no BTP release lines in the atlas"},{"label":"Maintainer's CI","tier":"fair","evidence":"no CI configured"}],"practice":[{"label":"Tests","tier":"fair","evidence":"none found in the tree"},{"label":"Docs","tier":"good","evidence":"docs/ with 5 pages, README 35 KB"},{"label":"Changelog","tier":"good","evidence":"CHANGELOG in the repo"}],"reach":[{"value":null,"unit":"installs/week"},{"value":84,"unit":"watching"}]},"signals":{"crawled_at":"2026-11-13","npm":"not published under this name","stars":84,"forks":41,"open_issues":7,"archived":false,"pushed_at":"2026-11-03","license_spdx":"Apache-2.0","org_owned":true,"default_branch":"main","created_at":"2024-03-08T09:01:32Z","open_prs":1,"tree_truncated":false,"test_files":0,"workflows":0,"other_ci":false,"readme_bytes":36119,"docs_files":5,"changelog":true,"license_file":true,"dts_files":0,"first_commit":"2024-03-08","last_commit":"2026-11-03","commits":145,"contributors":9,"readme_path":"README.md","readme_sha":"a72bc9c583041e582a55fd2c370486b47fb89918","repo_read":"2026-11-13","language":"CAP CDS"},"release_notes":{"license":"Apache-2.0","quotable":true,"source":{"kind":"repo","path":"CHANGELOG.md","ref":"main","url":"https://github.com/SAP-samples/btp-resource-consumption-monitor/blob/main/CHANGELOG.md"},"format":"keep-a-changelog","releases":[{"version":"2.4.0","heading":"Version 2.4.0 - Future","url":"https://github.com/SAP-samples/btp-resource-consumption-monitor/blob/main/CHANGELOG.md#version-240---future","sections":[{"kind":"feature","heading":"Added","items":0},{"kind":"fix","heading":"Fixed","items":0},{"kind":"change","heading":"Changed","items":1}],"hash":"c7534aeaef346d59"},{"version":"2.3.1","date":"2026-02-05","date_source":"heading","heading":"Version 2.3.1 - 2026-02-05","url":"https://github.com/SAP-samples/btp-resource-consumption-monitor/blob/main/CHANGELOG.md#version-231---2026-02-05","sections":[],"hash":"73b7c8ea99a7fd3f"},{"version":"2.3.0","date":"2025-12-11","date_source":"heading","heading":"Version 2.3.0 - 2025-12-11","url":"https://github.com/SAP-samples/btp-resource-consumption-monitor/blob/main/CHANGELOG.md#version-230---2025-12-11","sections":[{"kind":"feature","heading":"Added","items":0},{"kind":"fix","heading":"Fixed","items":1},{"kind":"change","heading":"Changed","items":2}],"hash":"08a4b4a9810256c3"},{"version":"2.2.0","date":"2025-09-12","date_source":"heading","heading":"Version 2.2.0 - 2025-09-12","url":"https://github.com/SAP-samples/btp-resource-consumption-monitor/blob/main/CHANGELOG.md#version-220---2025-09-12","sections":[{"kind":"feature","heading":"Added","items":6},{"kind":"fix","heading":"Fixed","items":2},{"kind":"change","heading":"Changed","items":6}],"hash":"c4920bf865ebabf8"},{"version":"2.1.0","date":"2024-11-15","date_source":"heading","heading":"Version 2.1.0 - 2024-11-15","url":"https://github.com/SAP-samples/btp-resource-consumption-monitor/blob/main/CHANGELOG.md#version-210---2024-11-15","sections":[{"kind":"feature","heading":"Added","items":3},{"kind":"change","heading":"Changed","items":5},{"kind":"fix","heading":"Fixed","items":1}],"hash":"8905a78d21b1ecc0"},{"version":"2.0.2","date":"2024-07-03","date_source":"heading","heading":"Version 2.0.2 - 2024-07-03","url":"https://github.com/SAP-samples/btp-resource-consumption-monitor/blob/main/CHANGELOG.md#version-202---2024-07-03","sections":[{"kind":"feature","heading":"Added","items":2},{"kind":"change","heading":"Changed","items":4},{"kind":"fix","heading":"Fixed","items":3}],"hash":"42bab217f521788e"},{"version":"2.0.1","date":"2024-06-24","date_source":"heading","heading":"Version 2.0.1 - 2024-06-24","url":"https://github.com/SAP-samples/btp-resource-consumption-monitor/blob/main/CHANGELOG.md#version-201---2024-06-24","sections":[{"kind":"feature","heading":"Added","items":1},{"kind":"change","heading":"Changed","items":1},{"kind":"fix","heading":"Fixed","items":4}],"hash":"3b3c59269d4a78d9"},{"version":"2.0.0","date":"2024-06-20","date_source":"heading","heading":"Version 2.0.0 - 2024-06-20","url":"https://github.com/SAP-samples/btp-resource-consumption-monitor/blob/main/CHANGELOG.md#version-200---2024-06-20","sections":[{"kind":"other","heading":null,"items":1}],"hash":"794699a1d711449a"},{"version":"1.1.0","date":"2024-05-27","date_source":"heading","heading":"Version 1.1.0 - 2024-05-27","url":"https://github.com/SAP-samples/btp-resource-consumption-monitor/blob/main/CHANGELOG.md#version-110---2024-05-27","sections":[{"kind":"feature","heading":"Added","items":1},{"kind":"change","heading":"Changed","items":1}],"hash":"7326f32daae4173a"},{"version":"1.0.2","date":"2024-03-26","date_source":"heading","heading":"Version 1.0.2 - 2024-03-26","url":"https://github.com/SAP-samples/btp-resource-consumption-monitor/blob/main/CHANGELOG.md#version-102---2024-03-26","sections":[{"kind":"fix","heading":"Fixed","items":1}],"hash":"2937e1feeb00521a"},{"version":"1.0.1","date":"2024-03-21","date_source":"heading","heading":"Version 1.0.1 - 2024-03-21","url":"https://github.com/SAP-samples/btp-resource-consumption-monitor/blob/main/CHANGELOG.md#version-101---2024-03-21","sections":[{"kind":"feature","heading":"Added","items":1},{"kind":"fix","heading":"Fixed","items":2}],"hash":"699bf8bf18b21725"},{"version":"1.0.0","date":"2024-03-11","date_source":"heading","heading":"Version 1.0.0 - 2024-03-11","url":"https://github.com/SAP-samples/btp-resource-consumption-monitor/blob/main/CHANGELOG.md#version-100---2024-03-11","sections":[],"hash":"1f397413e4399207"}],"crawled_at":"2026-11-15"},"edges":{"maintainers":[{"ref":"actor:sap-samples","name":"SAP Samples","json":"/actors/sap-samples.json"}],"contributors":[{"ref":"actor:ajinkyapatil8190","name":"Ajinkya Patil","json":"/actors/ajinkyapatil8190.json"},{"ref":"actor:chris-snopud","name":"chris-snopud","json":"/actors/chris-snopud.json"},{"ref":"actor:1084565","name":"Christoph Szymanski","json":"/actors/1084565.json"},{"ref":"actor:johannesbrandenburger","name":"Johannes Brandenburger","json":"/actors/johannesbrandenburger.json"},{"ref":"actor:mauriciolauffer","name":"Mauricio Lauffer","json":"/actors/mauriciolauffer.json"},{"ref":"actor:willempardaens","name":"Willem Pardaens","json":"/actors/willempardaens.json"}],"explained_by":[],"alternative_to_this":[],"needed_by":[],"available_via":[],"parts":[],"add_ons":[],"answered_through_parts":[]}}