@salesforce/cli 2.159.0 → 2.159.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (348) hide show
  1. package/README.md +12 -12
  2. package/node_modules/@oclif/plugin-plugins/README.md +7 -7
  3. package/node_modules/@oclif/plugin-plugins/oclif.manifest.json +1 -1
  4. package/node_modules/@oclif/plugin-plugins/package.json +7 -7
  5. package/node_modules/@opentelemetry/core/dist/common/attributes.cjs +5 -0
  6. package/node_modules/@opentelemetry/core/dist/common/attributes.cjs.map +1 -1
  7. package/node_modules/@opentelemetry/core/dist/common/attributes.mjs +5 -0
  8. package/node_modules/@opentelemetry/core/dist/common/attributes.mjs.map +1 -1
  9. package/node_modules/@opentelemetry/core/dist/version.cjs +1 -1
  10. package/node_modules/@opentelemetry/core/dist/version.cjs.map +1 -1
  11. package/node_modules/@opentelemetry/core/dist/version.mjs +1 -1
  12. package/node_modules/@opentelemetry/core/dist/version.mjs.map +1 -1
  13. package/node_modules/@opentelemetry/core/package.json +2 -2
  14. package/node_modules/@opentelemetry/resources/README.md +21 -2
  15. package/node_modules/@opentelemetry/resources/dist/detectors/EnvDetector.cjs +9 -47
  16. package/node_modules/@opentelemetry/resources/dist/detectors/EnvDetector.cjs.map +1 -1
  17. package/node_modules/@opentelemetry/resources/dist/detectors/EnvDetector.d.cts +10 -24
  18. package/node_modules/@opentelemetry/resources/dist/detectors/EnvDetector.d.cts.map +1 -1
  19. package/node_modules/@opentelemetry/resources/dist/detectors/EnvDetector.d.mts +10 -24
  20. package/node_modules/@opentelemetry/resources/dist/detectors/EnvDetector.d.mts.map +1 -1
  21. package/node_modules/@opentelemetry/resources/dist/detectors/EnvDetector.mjs +9 -47
  22. package/node_modules/@opentelemetry/resources/dist/detectors/EnvDetector.mjs.map +1 -1
  23. package/node_modules/@opentelemetry/resources/dist/detectors/ResourceAttributesEnvDetector.cjs +70 -0
  24. package/node_modules/@opentelemetry/resources/dist/detectors/ResourceAttributesEnvDetector.cjs.map +1 -0
  25. package/node_modules/@opentelemetry/resources/dist/detectors/ResourceAttributesEnvDetector.d.cts +35 -0
  26. package/node_modules/@opentelemetry/resources/dist/detectors/ResourceAttributesEnvDetector.d.cts.map +1 -0
  27. package/node_modules/@opentelemetry/resources/dist/detectors/ResourceAttributesEnvDetector.d.mts +35 -0
  28. package/node_modules/@opentelemetry/resources/dist/detectors/ResourceAttributesEnvDetector.d.mts.map +1 -0
  29. package/node_modules/@opentelemetry/resources/dist/detectors/ResourceAttributesEnvDetector.mjs +69 -0
  30. package/node_modules/@opentelemetry/resources/dist/detectors/ResourceAttributesEnvDetector.mjs.map +1 -0
  31. package/node_modules/@opentelemetry/resources/dist/detectors/ServiceNameEnvDetector.cjs +19 -0
  32. package/node_modules/@opentelemetry/resources/dist/detectors/ServiceNameEnvDetector.cjs.map +1 -0
  33. package/node_modules/@opentelemetry/resources/dist/detectors/ServiceNameEnvDetector.d.cts +12 -0
  34. package/node_modules/@opentelemetry/resources/dist/detectors/ServiceNameEnvDetector.d.cts.map +1 -0
  35. package/node_modules/@opentelemetry/resources/dist/detectors/ServiceNameEnvDetector.d.mts +12 -0
  36. package/node_modules/@opentelemetry/resources/dist/detectors/ServiceNameEnvDetector.d.mts.map +1 -0
  37. package/node_modules/@opentelemetry/resources/dist/detectors/ServiceNameEnvDetector.mjs +19 -0
  38. package/node_modules/@opentelemetry/resources/dist/detectors/ServiceNameEnvDetector.mjs.map +1 -0
  39. package/node_modules/@opentelemetry/resources/dist/detectors/index.d.cts +3 -1
  40. package/node_modules/@opentelemetry/resources/dist/detectors/index.d.mts +3 -1
  41. package/node_modules/@opentelemetry/resources/dist/detectors/index.mjs +3 -1
  42. package/node_modules/@opentelemetry/resources/dist/detectors/platform/node/ServiceInstanceIdDetector.cjs +0 -3
  43. package/node_modules/@opentelemetry/resources/dist/detectors/platform/node/ServiceInstanceIdDetector.cjs.map +1 -1
  44. package/node_modules/@opentelemetry/resources/dist/detectors/platform/node/ServiceInstanceIdDetector.d.cts +0 -3
  45. package/node_modules/@opentelemetry/resources/dist/detectors/platform/node/ServiceInstanceIdDetector.d.cts.map +1 -1
  46. package/node_modules/@opentelemetry/resources/dist/detectors/platform/node/ServiceInstanceIdDetector.d.mts +0 -3
  47. package/node_modules/@opentelemetry/resources/dist/detectors/platform/node/ServiceInstanceIdDetector.d.mts.map +1 -1
  48. package/node_modules/@opentelemetry/resources/dist/detectors/platform/node/ServiceInstanceIdDetector.mjs +0 -3
  49. package/node_modules/@opentelemetry/resources/dist/detectors/platform/node/ServiceInstanceIdDetector.mjs.map +1 -1
  50. package/node_modules/@opentelemetry/resources/dist/index.cjs +4 -0
  51. package/node_modules/@opentelemetry/resources/dist/index.d.cts +3 -1
  52. package/node_modules/@opentelemetry/resources/dist/index.d.mts +3 -1
  53. package/node_modules/@opentelemetry/resources/dist/index.mjs +3 -1
  54. package/node_modules/@opentelemetry/resources/package.json +3 -3
  55. package/node_modules/@opentelemetry/semantic-conventions/dist/experimental_attributes.cjs +1461 -176
  56. package/node_modules/@opentelemetry/semantic-conventions/dist/experimental_attributes.cjs.map +1 -1
  57. package/node_modules/@opentelemetry/semantic-conventions/dist/experimental_attributes.d.cts +1363 -171
  58. package/node_modules/@opentelemetry/semantic-conventions/dist/experimental_attributes.d.cts.map +1 -1
  59. package/node_modules/@opentelemetry/semantic-conventions/dist/experimental_attributes.d.mts +1363 -171
  60. package/node_modules/@opentelemetry/semantic-conventions/dist/experimental_attributes.d.mts.map +1 -1
  61. package/node_modules/@opentelemetry/semantic-conventions/dist/experimental_attributes.mjs +1363 -171
  62. package/node_modules/@opentelemetry/semantic-conventions/dist/experimental_attributes.mjs.map +1 -1
  63. package/node_modules/@opentelemetry/semantic-conventions/dist/experimental_events.cjs +1 -1
  64. package/node_modules/@opentelemetry/semantic-conventions/dist/experimental_events.cjs.map +1 -1
  65. package/node_modules/@opentelemetry/semantic-conventions/dist/experimental_events.d.cts +1 -1
  66. package/node_modules/@opentelemetry/semantic-conventions/dist/experimental_events.d.mts +1 -1
  67. package/node_modules/@opentelemetry/semantic-conventions/dist/experimental_events.mjs +1 -1
  68. package/node_modules/@opentelemetry/semantic-conventions/dist/experimental_events.mjs.map +1 -1
  69. package/node_modules/@opentelemetry/semantic-conventions/dist/experimental_metrics.cjs +382 -95
  70. package/node_modules/@opentelemetry/semantic-conventions/dist/experimental_metrics.cjs.map +1 -1
  71. package/node_modules/@opentelemetry/semantic-conventions/dist/experimental_metrics.d.cts +358 -94
  72. package/node_modules/@opentelemetry/semantic-conventions/dist/experimental_metrics.d.cts.map +1 -1
  73. package/node_modules/@opentelemetry/semantic-conventions/dist/experimental_metrics.d.mts +358 -94
  74. package/node_modules/@opentelemetry/semantic-conventions/dist/experimental_metrics.d.mts.map +1 -1
  75. package/node_modules/@opentelemetry/semantic-conventions/dist/experimental_metrics.mjs +358 -94
  76. package/node_modules/@opentelemetry/semantic-conventions/dist/experimental_metrics.mjs.map +1 -1
  77. package/node_modules/@opentelemetry/semantic-conventions/dist/index-incubating.cjs +132 -8
  78. package/node_modules/@opentelemetry/semantic-conventions/dist/index-incubating.d.cts +5 -5
  79. package/node_modules/@opentelemetry/semantic-conventions/dist/index-incubating.d.mts +5 -5
  80. package/node_modules/@opentelemetry/semantic-conventions/dist/index-incubating.mjs +5 -5
  81. package/node_modules/@opentelemetry/semantic-conventions/dist/index.cjs +8 -0
  82. package/node_modules/@opentelemetry/semantic-conventions/dist/index.d.cts +3 -3
  83. package/node_modules/@opentelemetry/semantic-conventions/dist/index.d.mts +3 -3
  84. package/node_modules/@opentelemetry/semantic-conventions/dist/index.mjs +3 -3
  85. package/node_modules/@opentelemetry/semantic-conventions/dist/stable_attributes.cjs +104 -13
  86. package/node_modules/@opentelemetry/semantic-conventions/dist/stable_attributes.cjs.map +1 -1
  87. package/node_modules/@opentelemetry/semantic-conventions/dist/stable_attributes.d.cts +99 -14
  88. package/node_modules/@opentelemetry/semantic-conventions/dist/stable_attributes.d.cts.map +1 -1
  89. package/node_modules/@opentelemetry/semantic-conventions/dist/stable_attributes.d.mts +99 -14
  90. package/node_modules/@opentelemetry/semantic-conventions/dist/stable_attributes.d.mts.map +1 -1
  91. package/node_modules/@opentelemetry/semantic-conventions/dist/stable_attributes.mjs +99 -14
  92. package/node_modules/@opentelemetry/semantic-conventions/dist/stable_attributes.mjs.map +1 -1
  93. package/node_modules/@opentelemetry/semantic-conventions/dist/stable_metrics.cjs +16 -0
  94. package/node_modules/@opentelemetry/semantic-conventions/dist/stable_metrics.cjs.map +1 -1
  95. package/node_modules/@opentelemetry/semantic-conventions/dist/stable_metrics.d.cts +15 -1
  96. package/node_modules/@opentelemetry/semantic-conventions/dist/stable_metrics.d.cts.map +1 -1
  97. package/node_modules/@opentelemetry/semantic-conventions/dist/stable_metrics.d.mts +15 -1
  98. package/node_modules/@opentelemetry/semantic-conventions/dist/stable_metrics.d.mts.map +1 -1
  99. package/node_modules/@opentelemetry/semantic-conventions/dist/stable_metrics.mjs +15 -1
  100. package/node_modules/@opentelemetry/semantic-conventions/dist/stable_metrics.mjs.map +1 -1
  101. package/node_modules/@opentelemetry/semantic-conventions/package.json +2 -2
  102. package/node_modules/@salesforce/plugin-trust/README.md +14 -30
  103. package/node_modules/@salesforce/plugin-trust/oclif.manifest.json +1 -1
  104. package/node_modules/@salesforce/plugin-trust/package.json +4 -4
  105. package/node_modules/npm/docs/content/commands/npm-ls.md +1 -1
  106. package/node_modules/npm/docs/content/commands/npm.md +1 -1
  107. package/node_modules/npm/docs/output/commands/npm-access.html +2 -2
  108. package/node_modules/npm/docs/output/commands/npm-adduser.html +2 -2
  109. package/node_modules/npm/docs/output/commands/npm-approve-scripts.html +2 -2
  110. package/node_modules/npm/docs/output/commands/npm-audit.html +2 -2
  111. package/node_modules/npm/docs/output/commands/npm-bugs.html +2 -2
  112. package/node_modules/npm/docs/output/commands/npm-cache.html +2 -2
  113. package/node_modules/npm/docs/output/commands/npm-ci.html +2 -2
  114. package/node_modules/npm/docs/output/commands/npm-completion.html +2 -2
  115. package/node_modules/npm/docs/output/commands/npm-config.html +2 -2
  116. package/node_modules/npm/docs/output/commands/npm-dedupe.html +2 -2
  117. package/node_modules/npm/docs/output/commands/npm-deny-scripts.html +2 -2
  118. package/node_modules/npm/docs/output/commands/npm-deprecate.html +2 -2
  119. package/node_modules/npm/docs/output/commands/npm-diff.html +2 -2
  120. package/node_modules/npm/docs/output/commands/npm-dist-tag.html +2 -2
  121. package/node_modules/npm/docs/output/commands/npm-docs.html +2 -2
  122. package/node_modules/npm/docs/output/commands/npm-doctor.html +2 -2
  123. package/node_modules/npm/docs/output/commands/npm-edit.html +2 -2
  124. package/node_modules/npm/docs/output/commands/npm-exec.html +2 -2
  125. package/node_modules/npm/docs/output/commands/npm-explain.html +2 -2
  126. package/node_modules/npm/docs/output/commands/npm-explore.html +2 -2
  127. package/node_modules/npm/docs/output/commands/npm-find-dupes.html +2 -2
  128. package/node_modules/npm/docs/output/commands/npm-fund.html +2 -2
  129. package/node_modules/npm/docs/output/commands/npm-get.html +2 -2
  130. package/node_modules/npm/docs/output/commands/npm-help-search.html +2 -2
  131. package/node_modules/npm/docs/output/commands/npm-help.html +2 -2
  132. package/node_modules/npm/docs/output/commands/npm-init.html +2 -2
  133. package/node_modules/npm/docs/output/commands/npm-install-ci-test.html +2 -2
  134. package/node_modules/npm/docs/output/commands/npm-install-scripts.html +2 -2
  135. package/node_modules/npm/docs/output/commands/npm-install-test.html +2 -2
  136. package/node_modules/npm/docs/output/commands/npm-install.html +2 -2
  137. package/node_modules/npm/docs/output/commands/npm-link.html +2 -2
  138. package/node_modules/npm/docs/output/commands/npm-ll.html +2 -2
  139. package/node_modules/npm/docs/output/commands/npm-login.html +2 -2
  140. package/node_modules/npm/docs/output/commands/npm-logout.html +2 -2
  141. package/node_modules/npm/docs/output/commands/npm-ls.html +3 -3
  142. package/node_modules/npm/docs/output/commands/npm-org.html +2 -2
  143. package/node_modules/npm/docs/output/commands/npm-outdated.html +2 -2
  144. package/node_modules/npm/docs/output/commands/npm-owner.html +2 -2
  145. package/node_modules/npm/docs/output/commands/npm-pack.html +2 -2
  146. package/node_modules/npm/docs/output/commands/npm-ping.html +2 -2
  147. package/node_modules/npm/docs/output/commands/npm-pkg.html +2 -2
  148. package/node_modules/npm/docs/output/commands/npm-prefix.html +2 -2
  149. package/node_modules/npm/docs/output/commands/npm-profile.html +2 -2
  150. package/node_modules/npm/docs/output/commands/npm-prune.html +2 -2
  151. package/node_modules/npm/docs/output/commands/npm-publish.html +2 -2
  152. package/node_modules/npm/docs/output/commands/npm-query.html +2 -2
  153. package/node_modules/npm/docs/output/commands/npm-rebuild.html +2 -2
  154. package/node_modules/npm/docs/output/commands/npm-repo.html +2 -2
  155. package/node_modules/npm/docs/output/commands/npm-restart.html +2 -2
  156. package/node_modules/npm/docs/output/commands/npm-root.html +2 -2
  157. package/node_modules/npm/docs/output/commands/npm-run.html +2 -2
  158. package/node_modules/npm/docs/output/commands/npm-sbom.html +2 -2
  159. package/node_modules/npm/docs/output/commands/npm-search.html +2 -2
  160. package/node_modules/npm/docs/output/commands/npm-set.html +2 -2
  161. package/node_modules/npm/docs/output/commands/npm-shrinkwrap.html +2 -2
  162. package/node_modules/npm/docs/output/commands/npm-stage.html +2 -2
  163. package/node_modules/npm/docs/output/commands/npm-star.html +2 -2
  164. package/node_modules/npm/docs/output/commands/npm-stars.html +2 -2
  165. package/node_modules/npm/docs/output/commands/npm-start.html +2 -2
  166. package/node_modules/npm/docs/output/commands/npm-stop.html +2 -2
  167. package/node_modules/npm/docs/output/commands/npm-team.html +2 -2
  168. package/node_modules/npm/docs/output/commands/npm-test.html +2 -2
  169. package/node_modules/npm/docs/output/commands/npm-token.html +2 -2
  170. package/node_modules/npm/docs/output/commands/npm-trust.html +2 -2
  171. package/node_modules/npm/docs/output/commands/npm-undeprecate.html +2 -2
  172. package/node_modules/npm/docs/output/commands/npm-uninstall.html +2 -2
  173. package/node_modules/npm/docs/output/commands/npm-unpublish.html +2 -2
  174. package/node_modules/npm/docs/output/commands/npm-unstar.html +2 -2
  175. package/node_modules/npm/docs/output/commands/npm-update.html +2 -2
  176. package/node_modules/npm/docs/output/commands/npm-version.html +2 -2
  177. package/node_modules/npm/docs/output/commands/npm-view.html +2 -2
  178. package/node_modules/npm/docs/output/commands/npm-whoami.html +2 -2
  179. package/node_modules/npm/docs/output/commands/npm.html +3 -3
  180. package/node_modules/npm/docs/output/commands/npx.html +2 -2
  181. package/node_modules/npm/docs/output/configuring-npm/folders.html +2 -2
  182. package/node_modules/npm/docs/output/configuring-npm/install.html +2 -2
  183. package/node_modules/npm/docs/output/configuring-npm/npm-global.html +2 -2
  184. package/node_modules/npm/docs/output/configuring-npm/npm-json.html +2 -2
  185. package/node_modules/npm/docs/output/configuring-npm/npm-shrinkwrap-json.html +2 -2
  186. package/node_modules/npm/docs/output/configuring-npm/npmrc.html +2 -2
  187. package/node_modules/npm/docs/output/configuring-npm/package-json.html +2 -2
  188. package/node_modules/npm/docs/output/configuring-npm/package-lock-json.html +2 -2
  189. package/node_modules/npm/docs/output/using-npm/config.html +2 -2
  190. package/node_modules/npm/docs/output/using-npm/dependency-selectors.html +2 -2
  191. package/node_modules/npm/docs/output/using-npm/developers.html +2 -2
  192. package/node_modules/npm/docs/output/using-npm/logging.html +2 -2
  193. package/node_modules/npm/docs/output/using-npm/orgs.html +2 -2
  194. package/node_modules/npm/docs/output/using-npm/package-spec.html +2 -2
  195. package/node_modules/npm/docs/output/using-npm/registry.html +2 -2
  196. package/node_modules/npm/docs/output/using-npm/removal.html +2 -2
  197. package/node_modules/npm/docs/output/using-npm/scope.html +2 -2
  198. package/node_modules/npm/docs/output/using-npm/scripts.html +2 -2
  199. package/node_modules/npm/docs/output/using-npm/workspaces.html +2 -2
  200. package/node_modules/npm/lib/cli/entry.js +1 -1
  201. package/node_modules/npm/man/man1/npm-access.1 +1 -1
  202. package/node_modules/npm/man/man1/npm-adduser.1 +1 -1
  203. package/node_modules/npm/man/man1/npm-approve-scripts.1 +1 -1
  204. package/node_modules/npm/man/man1/npm-audit.1 +1 -1
  205. package/node_modules/npm/man/man1/npm-bugs.1 +1 -1
  206. package/node_modules/npm/man/man1/npm-cache.1 +1 -1
  207. package/node_modules/npm/man/man1/npm-ci.1 +1 -1
  208. package/node_modules/npm/man/man1/npm-completion.1 +1 -1
  209. package/node_modules/npm/man/man1/npm-config.1 +1 -1
  210. package/node_modules/npm/man/man1/npm-dedupe.1 +1 -1
  211. package/node_modules/npm/man/man1/npm-deny-scripts.1 +1 -1
  212. package/node_modules/npm/man/man1/npm-deprecate.1 +1 -1
  213. package/node_modules/npm/man/man1/npm-diff.1 +1 -1
  214. package/node_modules/npm/man/man1/npm-dist-tag.1 +1 -1
  215. package/node_modules/npm/man/man1/npm-docs.1 +1 -1
  216. package/node_modules/npm/man/man1/npm-doctor.1 +1 -1
  217. package/node_modules/npm/man/man1/npm-edit.1 +1 -1
  218. package/node_modules/npm/man/man1/npm-exec.1 +1 -1
  219. package/node_modules/npm/man/man1/npm-explain.1 +1 -1
  220. package/node_modules/npm/man/man1/npm-explore.1 +1 -1
  221. package/node_modules/npm/man/man1/npm-find-dupes.1 +1 -1
  222. package/node_modules/npm/man/man1/npm-fund.1 +1 -1
  223. package/node_modules/npm/man/man1/npm-get.1 +1 -1
  224. package/node_modules/npm/man/man1/npm-help-search.1 +1 -1
  225. package/node_modules/npm/man/man1/npm-help.1 +1 -1
  226. package/node_modules/npm/man/man1/npm-init.1 +1 -1
  227. package/node_modules/npm/man/man1/npm-install-ci-test.1 +1 -1
  228. package/node_modules/npm/man/man1/npm-install-scripts.1 +1 -1
  229. package/node_modules/npm/man/man1/npm-install-test.1 +1 -1
  230. package/node_modules/npm/man/man1/npm-install.1 +1 -1
  231. package/node_modules/npm/man/man1/npm-link.1 +1 -1
  232. package/node_modules/npm/man/man1/npm-ll.1 +1 -1
  233. package/node_modules/npm/man/man1/npm-login.1 +1 -1
  234. package/node_modules/npm/man/man1/npm-logout.1 +1 -1
  235. package/node_modules/npm/man/man1/npm-ls.1 +2 -2
  236. package/node_modules/npm/man/man1/npm-org.1 +1 -1
  237. package/node_modules/npm/man/man1/npm-outdated.1 +1 -1
  238. package/node_modules/npm/man/man1/npm-owner.1 +1 -1
  239. package/node_modules/npm/man/man1/npm-pack.1 +1 -1
  240. package/node_modules/npm/man/man1/npm-ping.1 +1 -1
  241. package/node_modules/npm/man/man1/npm-pkg.1 +1 -1
  242. package/node_modules/npm/man/man1/npm-prefix.1 +1 -1
  243. package/node_modules/npm/man/man1/npm-profile.1 +1 -1
  244. package/node_modules/npm/man/man1/npm-prune.1 +1 -1
  245. package/node_modules/npm/man/man1/npm-publish.1 +1 -1
  246. package/node_modules/npm/man/man1/npm-query.1 +1 -1
  247. package/node_modules/npm/man/man1/npm-rebuild.1 +1 -1
  248. package/node_modules/npm/man/man1/npm-repo.1 +1 -1
  249. package/node_modules/npm/man/man1/npm-restart.1 +1 -1
  250. package/node_modules/npm/man/man1/npm-root.1 +1 -1
  251. package/node_modules/npm/man/man1/npm-run.1 +1 -1
  252. package/node_modules/npm/man/man1/npm-sbom.1 +1 -1
  253. package/node_modules/npm/man/man1/npm-search.1 +1 -1
  254. package/node_modules/npm/man/man1/npm-set.1 +1 -1
  255. package/node_modules/npm/man/man1/npm-shrinkwrap.1 +1 -1
  256. package/node_modules/npm/man/man1/npm-stage.1 +1 -1
  257. package/node_modules/npm/man/man1/npm-star.1 +1 -1
  258. package/node_modules/npm/man/man1/npm-stars.1 +1 -1
  259. package/node_modules/npm/man/man1/npm-start.1 +1 -1
  260. package/node_modules/npm/man/man1/npm-stop.1 +1 -1
  261. package/node_modules/npm/man/man1/npm-team.1 +1 -1
  262. package/node_modules/npm/man/man1/npm-test.1 +1 -1
  263. package/node_modules/npm/man/man1/npm-token.1 +1 -1
  264. package/node_modules/npm/man/man1/npm-trust.1 +1 -1
  265. package/node_modules/npm/man/man1/npm-undeprecate.1 +1 -1
  266. package/node_modules/npm/man/man1/npm-uninstall.1 +1 -1
  267. package/node_modules/npm/man/man1/npm-unpublish.1 +1 -1
  268. package/node_modules/npm/man/man1/npm-unstar.1 +1 -1
  269. package/node_modules/npm/man/man1/npm-update.1 +1 -1
  270. package/node_modules/npm/man/man1/npm-version.1 +1 -1
  271. package/node_modules/npm/man/man1/npm-view.1 +1 -1
  272. package/node_modules/npm/man/man1/npm-whoami.1 +1 -1
  273. package/node_modules/npm/man/man1/npm.1 +2 -2
  274. package/node_modules/npm/man/man1/npx.1 +1 -1
  275. package/node_modules/npm/man/man5/folders.5 +1 -1
  276. package/node_modules/npm/man/man5/install.5 +1 -1
  277. package/node_modules/npm/man/man5/npm-global.5 +1 -1
  278. package/node_modules/npm/man/man5/npm-json.5 +1 -1
  279. package/node_modules/npm/man/man5/npm-shrinkwrap-json.5 +1 -1
  280. package/node_modules/npm/man/man5/npmrc.5 +1 -1
  281. package/node_modules/npm/man/man5/package-json.5 +1 -1
  282. package/node_modules/npm/man/man5/package-lock-json.5 +1 -1
  283. package/node_modules/npm/man/man7/config.7 +1 -1
  284. package/node_modules/npm/man/man7/dependency-selectors.7 +1 -1
  285. package/node_modules/npm/man/man7/developers.7 +1 -1
  286. package/node_modules/npm/man/man7/logging.7 +1 -1
  287. package/node_modules/npm/man/man7/orgs.7 +1 -1
  288. package/node_modules/npm/man/man7/package-spec.7 +1 -1
  289. package/node_modules/npm/man/man7/registry.7 +1 -1
  290. package/node_modules/npm/man/man7/removal.7 +1 -1
  291. package/node_modules/npm/man/man7/scope.7 +1 -1
  292. package/node_modules/npm/man/man7/scripts.7 +1 -1
  293. package/node_modules/npm/man/man7/workspaces.7 +1 -1
  294. package/node_modules/npm/node_modules/@npmcli/promise-spawn/lib/index.js +9 -2
  295. package/node_modules/npm/node_modules/@npmcli/promise-spawn/package.json +3 -2
  296. package/node_modules/npm/node_modules/bin-links/lib/get-paths.js +2 -0
  297. package/node_modules/npm/node_modules/bin-links/package.json +2 -1
  298. package/node_modules/npm/node_modules/ip-address/dist/common.js +2 -2
  299. package/node_modules/npm/node_modules/ip-address/dist/ipv4.js +7 -0
  300. package/node_modules/npm/node_modules/ip-address/dist/ipv6.js +7 -4
  301. package/node_modules/npm/node_modules/ip-address/dist/v6/constants.js +3 -0
  302. package/node_modules/npm/node_modules/ip-address/package.json +3 -2
  303. package/node_modules/npm/node_modules/libnpmexec/README.md +9 -1
  304. package/node_modules/npm/node_modules/libnpmexec/lib/index.js +6 -2
  305. package/node_modules/npm/node_modules/libnpmexec/lib/run-script.js +22 -5
  306. package/node_modules/npm/node_modules/libnpmexec/package.json +1 -1
  307. package/node_modules/npm/node_modules/pacote/lib/registry.js +71 -2
  308. package/node_modules/npm/node_modules/pacote/package.json +3 -2
  309. package/node_modules/npm/node_modules/semver/classes/range.js +2 -2
  310. package/node_modules/npm/node_modules/semver/internal/constants.js +30 -0
  311. package/node_modules/npm/node_modules/semver/internal/trim-comparator-whitespace.js +438 -0
  312. package/node_modules/npm/node_modules/semver/package.json +1 -1
  313. package/node_modules/npm/node_modules/undici/docs/docs/api/Client.md +2 -0
  314. package/node_modules/npm/node_modules/undici/lib/dispatcher/agent.js +6 -2
  315. package/node_modules/npm/node_modules/undici/lib/dispatcher/client-h1.js +0 -2
  316. package/node_modules/npm/node_modules/undici/lib/dispatcher/client-h2.js +0 -4
  317. package/node_modules/npm/node_modules/undici/lib/dispatcher/client.js +3 -2
  318. package/node_modules/npm/node_modules/undici/lib/dispatcher/dispatcher-base.js +9 -0
  319. package/node_modules/npm/node_modules/undici/lib/web/eventsource/eventsource-stream.js +91 -10
  320. package/node_modules/npm/node_modules/undici/lib/web/eventsource/eventsource.js +4 -1
  321. package/node_modules/npm/node_modules/undici/lib/web/fetch/index.js +7 -9
  322. package/node_modules/npm/node_modules/undici/lib/web/websocket/receiver.js +14 -0
  323. package/node_modules/npm/node_modules/undici/package.json +1 -1
  324. package/node_modules/npm/package.json +5 -5
  325. package/node_modules/semver/classes/range.js +2 -2
  326. package/node_modules/semver/internal/constants.js +30 -0
  327. package/node_modules/semver/internal/trim-comparator-whitespace.js +438 -0
  328. package/node_modules/semver/package.json +1 -1
  329. package/oclif.manifest.json +1 -1
  330. package/package.json +6 -6
  331. package/node_modules/npm/node_modules/node-gyp/gyp/pylib/gyp/__pycache__/MSVSUtil.cpython-314.pyc +0 -0
  332. package/node_modules/npm/node_modules/node-gyp/gyp/pylib/gyp/__pycache__/MSVSVersion.cpython-314.pyc +0 -0
  333. package/node_modules/npm/node_modules/node-gyp/gyp/pylib/gyp/__pycache__/__init__.cpython-314.pyc +0 -0
  334. package/node_modules/npm/node_modules/node-gyp/gyp/pylib/gyp/__pycache__/common.cpython-314.pyc +0 -0
  335. package/node_modules/npm/node_modules/node-gyp/gyp/pylib/gyp/__pycache__/input.cpython-314.pyc +0 -0
  336. package/node_modules/npm/node_modules/node-gyp/gyp/pylib/gyp/__pycache__/msvs_emulation.cpython-314.pyc +0 -0
  337. package/node_modules/npm/node_modules/node-gyp/gyp/pylib/gyp/__pycache__/ninja_syntax.cpython-314.pyc +0 -0
  338. package/node_modules/npm/node_modules/node-gyp/gyp/pylib/gyp/__pycache__/simple_copy.cpython-314.pyc +0 -0
  339. package/node_modules/npm/node_modules/node-gyp/gyp/pylib/gyp/__pycache__/xcode_emulation.cpython-314.pyc +0 -0
  340. package/node_modules/npm/node_modules/node-gyp/gyp/pylib/gyp/__pycache__/xcode_ninja.cpython-314.pyc +0 -0
  341. package/node_modules/npm/node_modules/node-gyp/gyp/pylib/gyp/__pycache__/xcodeproj_file.cpython-314.pyc +0 -0
  342. package/node_modules/npm/node_modules/node-gyp/gyp/pylib/gyp/generator/__pycache__/__init__.cpython-314.pyc +0 -0
  343. package/node_modules/npm/node_modules/node-gyp/gyp/pylib/gyp/generator/__pycache__/make.cpython-314.pyc +0 -0
  344. package/node_modules/npm/node_modules/node-gyp/gyp/pylib/gyp/generator/__pycache__/ninja.cpython-314.pyc +0 -0
  345. package/node_modules/npm/node_modules/node-gyp/gyp/pylib/gyp/generator/__pycache__/xcode.cpython-314.pyc +0 -0
  346. package/node_modules/npm/node_modules/node-gyp/gyp/pylib/packaging/__pycache__/__init__.cpython-314.pyc +0 -0
  347. package/node_modules/npm/node_modules/node-gyp/gyp/pylib/packaging/__pycache__/_structures.cpython-314.pyc +0 -0
  348. package/node_modules/npm/node_modules/node-gyp/gyp/pylib/packaging/__pycache__/version.cpython-314.pyc +0 -0
@@ -248,10 +248,8 @@ const METRIC_CONTAINER_DISK_IO = "container.disk.io";
248
248
  /**
249
249
  * Container filesystem available bytes.
250
250
  *
251
- * @note In K8s, this metric is derived from the
252
- * [FsStats.AvailableBytes](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#FsStats) field
253
- * of the [ContainerStats.Rootfs](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#ContainerStats)
254
- * of the Kubelet's stats API.
251
+ * @note Available filesystem space for the container's `rootfs`.
252
+ * In K8s, this metric is derived from the [FsStats.AvailableBytes](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#FsStats) field of the [ContainerStats.Rootfs](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#ContainerStats) of the Kubelet's stats API.
255
253
  *
256
254
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
257
255
  */
@@ -259,10 +257,9 @@ const METRIC_CONTAINER_FILESYSTEM_AVAILABLE = "container.filesystem.available";
259
257
  /**
260
258
  * Container filesystem capacity.
261
259
  *
262
- * @note In K8s, this metric is derived from the
263
- * [FsStats.CapacityBytes](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#FsStats) field
264
- * of the [ContainerStats.Rootfs](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#ContainerStats)
265
- * of the Kubelet's stats API.
260
+ * @note Total filesystem capacity for the container's `rootfs`.
261
+ * In general, this metric can be derived from [cadvisor](https://github.com/google/cadvisor/blob/v0.53.0/docs/storage/prometheus.md#prometheus-container-metrics) and specifically the `container_fs_limit_bytes` metric for the container's `rootfs` device.
262
+ * In K8s, this metric is derived from the [FsStats.CapacityBytes](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#FsStats) field of the [ContainerStats.Rootfs](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#ContainerStats) of the Kubelet's stats API.
266
263
  *
267
264
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
268
265
  */
@@ -270,12 +267,10 @@ const METRIC_CONTAINER_FILESYSTEM_CAPACITY = "container.filesystem.capacity";
270
267
  /**
271
268
  * Container filesystem usage.
272
269
  *
273
- * @note This may not equal capacity - available.
274
- *
275
- * In K8s, this metric is derived from the
276
- * [FsStats.UsedBytes](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#FsStats) field
277
- * of the [ContainerStats.Rootfs](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#ContainerStats)
278
- * of the Kubelet's stats API.
270
+ * @note Filesystem space used by the container's `rootfs`.
271
+ * In general, this metric can be derived from [cadvisor](https://github.com/google/cadvisor/blob/v0.53.0/docs/storage/prometheus.md#prometheus-container-metrics) and specifically the `container_fs_usage_bytes` metric for the container's `rootfs` device.
272
+ * In K8s, this metric is derived from the [FsStats.UsedBytes](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#FsStats) field of the [ContainerStats.Rootfs](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#ContainerStats) of the Kubelet's stats API.
273
+ * Capacity and available are reported for the backing filesystem, which may be shared with other workloads; therefore, usage may not equal `capacity - available`.
279
274
  *
280
275
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
281
276
  */
@@ -323,7 +318,7 @@ const METRIC_CONTAINER_MEMORY_USAGE = "container.memory.usage";
323
318
  /**
324
319
  * Container memory working set.
325
320
  *
326
- * @note In general, this metric can be derived from [cadvisor](https://github.com/google/cadvisor/blob/v0.53.0/docs/storage/prometheus.md#prometheus-container-metrics) and specifically the `container_memory_working_set_bytes` metric.
321
+ * @note In general, this metric can be derived from [cadvisor](https://github.com/google/cadvisor/blob/v0.53.0/docs/storage/prometheus.md#prometheus-container-metrics) and specifically the `container_memory_working_set_bytes` metric. When derived from cAdvisor on Linux, the working set is calculated by excluding inactive file-backed memory from memory usage (`inactive_file` on cgroup v2, `total_inactive_file` on cgroup v1), so active file-backed memory remains included.
327
322
  * In K8s, this metric is derived from the [MemoryStats.WorkingSetBytes](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#MemoryStats) field of the [ContainerStats.Memory](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#ContainerStats) of the Kubelet's stats API.
328
323
  *
329
324
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
@@ -340,8 +335,8 @@ const METRIC_CONTAINER_NETWORK_IO = "container.network.io";
340
335
  /**
341
336
  * Container memory paging faults.
342
337
  *
343
- * @note In general, this metric can be derived from [cadvisor](https://github.com/google/cadvisor/blob/v0.53.0/docs/storage/prometheus.md#prometheus-container-metrics) and specifically the `container_memory_failures_total{failure_type=pgfault, scope=container}` and `container_memory_failures_total{failure_type=pgmajfault, scope=container}`metric.
344
- * In K8s, this metric is derived from the [MemoryStats.PageFaults](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#MemoryStats) and [MemoryStats.MajorPageFaults](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#MemoryStats) field of the [ContainerStats.Memory](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#ContainerStats) of the Kubelet's stats API.
338
+ * @note In general, this metric can be derived from [cadvisor](https://github.com/google/cadvisor/blob/v0.53.0/docs/storage/prometheus.md#prometheus-container-metrics). The `container_memory_failures_total{failure_type=pgfault, scope=container}` counter reports the total page faults (minor + major), while `container_memory_failures_total{failure_type=pgmajfault, scope=container}` reports only major faults. The minor page faults **MUST** be derived as the difference between the two.
339
+ * In K8s, this metric is derived from the [MemoryStats.PageFaults](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#MemoryStats) and [MemoryStats.MajorPageFaults](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#MemoryStats) fields of the [ContainerStats.Memory](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#ContainerStats) of the Kubelet's stats API. `MemoryStats.PageFaults` reports the total number of page faults (equivalent to `pgfault` in the cgroup `memory.stat`), with minor and major combined. The minor page faults **MUST** therefore be derived as `MemoryStats.PageFaults - MemoryStats.MajorPageFaults`, so that summing the metric over `system.paging.fault.type` yields the total number of page faults.
345
340
  *
346
341
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
347
342
  */
@@ -349,8 +344,8 @@ const METRIC_CONTAINER_PAGING_FAULTS = "container.paging.faults";
349
344
  /**
350
345
  * The time the container has been running.
351
346
  *
352
- * @note Instrumentations **SHOULD** use a gauge with type `double` and measure uptime in seconds as a floating point number with the highest precision available.
353
- * The actual accuracy would depend on the instrumentation and operating system.
347
+ * @note Instrumentations **SHOULD** use a gauge with type `double` and measure uptime in seconds as a floating point number with the highest precision available. The actual accuracy would depend on the instrumentation and operating system.
348
+ * In K8s environments, this metric can be derived from Kubelet's stats API and specifically from the [ContainerStats.StartTime](https://github.com/kubernetes/kubelet/blob/v0.35.2/pkg/apis/stats/v1alpha1/types.go#L161) field, where `StartTime` represents the container creation time as [noted in the Kubelet source](https://github.com/kubernetes/kubernetes/blob/v1.36.3/pkg/kubelet/stats/cri_stats_provider.go#L776). This value resets on every container restart and aligns with [ContainerStateRunning.startedAt](https://kubernetes.io/docs/reference/kubernetes-api/workload-resources/pod-v1/#ContainerStateRunning) from the K8s API.
354
349
  *
355
350
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
356
351
  */
@@ -432,6 +427,14 @@ const METRIC_DB_CLIENT_CONNECTION_IDLE_MIN = "db.client.connection.idle.min";
432
427
  *
433
428
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
434
429
  */
430
+ const METRIC_DB_CLIENT_CONNECTION_LIMIT = "db.client.connection.limit";
431
+ /**
432
+ * Deprecated, use `db.client.connection.limit` instead.
433
+ *
434
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
435
+ *
436
+ * @deprecated Replaced by `db.client.connection.limit`.
437
+ */
435
438
  const METRIC_DB_CLIENT_CONNECTION_MAX = "db.client.connection.max";
436
439
  /**
437
440
  * The number of current pending requests for an open connection.
@@ -482,11 +485,11 @@ const METRIC_DB_CLIENT_CONNECTIONS_IDLE_MAX = "db.client.connections.idle.max";
482
485
  */
483
486
  const METRIC_DB_CLIENT_CONNECTIONS_IDLE_MIN = "db.client.connections.idle.min";
484
487
  /**
485
- * Deprecated, use `db.client.connection.max` instead.
488
+ * Deprecated, use `db.client.connection.limit` instead.
486
489
  *
487
490
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
488
491
  *
489
- * @deprecated Replaced by `db.client.connection.max`.
492
+ * @deprecated Replaced by `db.client.connection.limit`.
490
493
  */
491
494
  const METRIC_DB_CLIENT_CONNECTIONS_MAX = "db.client.connections.max";
492
495
  /**
@@ -1110,6 +1113,56 @@ const METRIC_JVM_BUFFER_MEMORY_USAGE = "jvm.buffer.memory.usage";
1110
1113
  */
1111
1114
  const METRIC_JVM_BUFFER_MEMORY_USED = "jvm.buffer.memory.used";
1112
1115
  /**
1116
+ * The maximum number of tasks the executor queue can hold.
1117
+ *
1118
+ * @note Instrumentations **SHOULD** emit this metric only when the queue has a finite capacity that represents a meaningful operational limit. This metric **SHOULD NOT** be emitted for unbounded or effectively unbounded queues.
1119
+ *
1120
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
1121
+ */
1122
+ const METRIC_JVM_EXECUTOR_QUEUE_CAPACITY = "jvm.executor.queue.capacity";
1123
+ /**
1124
+ * The number of tasks currently queued for execution.
1125
+ *
1126
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
1127
+ */
1128
+ const METRIC_JVM_EXECUTOR_QUEUE_SIZE = "jvm.executor.queue.size";
1129
+ /**
1130
+ * The number of tasks completed by the executor.
1131
+ *
1132
+ * @note A task **SHOULD** be counted as completed when the executor has finished processing it, regardless of whether it returns normally, terminates with an exception, or is canceled. Cancellation during processing does not complete the task until processing ends. A task that never begins processing on the executor **SHOULD NOT** be counted. A task initially rejected but subsequently resubmitted to and processed by the executor **SHOULD** be counted when processing ends.
1133
+ *
1134
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
1135
+ */
1136
+ const METRIC_JVM_EXECUTOR_TASK_COMPLETED = "jvm.executor.task.completed";
1137
+ /**
1138
+ * The number of task submissions rejected by the executor.
1139
+ *
1140
+ * @note A task submission **SHOULD** be counted as rejected when the executor invokes its rejection handler, regardless of whether the handler subsequently executes the task in the caller (for example, `CallerRunsPolicy`) or discards or replaces a queued task (for example, `DiscardOldestPolicy`). This metric counts rejected submissions, not tasks ultimately discarded from the queue.
1141
+ *
1142
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
1143
+ */
1144
+ const METRIC_JVM_EXECUTOR_TASK_REJECTED = "jvm.executor.task.rejected";
1145
+ /**
1146
+ * The number of core threads configured for the executor.
1147
+ *
1148
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
1149
+ */
1150
+ const METRIC_JVM_EXECUTOR_THREAD_CORE = "jvm.executor.thread.core";
1151
+ /**
1152
+ * The number of executor threads that are currently in the state described by the `jvm.executor.thread.state` attribute.
1153
+ *
1154
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
1155
+ */
1156
+ const METRIC_JVM_EXECUTOR_THREAD_COUNT = "jvm.executor.thread.count";
1157
+ /**
1158
+ * The maximum number of threads allowed for the executor.
1159
+ *
1160
+ * @note Instrumentations **SHOULD** emit this metric only when the maximum thread count is finite and represents a meaningful operational limit. This metric **SHOULD NOT** be emitted for unbounded or effectively unbounded executors. For example, an executor with a maximum thread count of `Integer.MAX_VALUE` is effectively unbounded.
1161
+ *
1162
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
1163
+ */
1164
+ const METRIC_JVM_EXECUTOR_THREAD_LIMIT = "jvm.executor.thread.limit";
1165
+ /**
1113
1166
  * Number of open file descriptors as reported by the JVM.
1114
1167
  *
1115
1168
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
@@ -1223,8 +1276,9 @@ const METRIC_K8S_CONTAINER_CPU_REQUEST_DESIRED = "k8s.container.cpu.request.desi
1223
1276
  *
1224
1277
  * @note The current CPU request reflects the request applied to the running container, as reported by
1225
1278
  * [ContainerStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.34/#containerstatus-v1-core).
1226
- * The value range is [0.0,1.0]. A value of 1.0 means the container is using 100% of its actual CPU request.
1227
- * If the CPU request is not set, this metric **SHOULD NOT** be emitted for that container.
1279
+ * A value of 1.0 means the container is using exactly its CPU request. Since a CPU request is a scheduling
1280
+ * reservation and not a hard cap, values above 1.0 are possible and indicate the container is using more CPU
1281
+ * than requested. If the CPU request is not set, this metric **SHOULD NOT** be emitted for that container.
1228
1282
  *
1229
1283
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
1230
1284
  */
@@ -1232,7 +1286,7 @@ const METRIC_K8S_CONTAINER_CPU_REQUEST_UTILIZATION = "k8s.container.cpu.request.
1232
1286
  /**
1233
1287
  * Maximum ephemeral storage resource limit set for the container.
1234
1288
  *
1235
- * @note See https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.34/#resourcerequirements-v1-core for details.
1289
+ * @note See the [Kubernetes ResourceRequirements API](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.34/#resourcerequirements-v1-core) for details.
1236
1290
  *
1237
1291
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
1238
1292
  */
@@ -1240,7 +1294,7 @@ const METRIC_K8S_CONTAINER_EPHEMERAL_STORAGE_LIMIT = "k8s.container.ephemeral_st
1240
1294
  /**
1241
1295
  * Ephemeral storage resource requested for the container.
1242
1296
  *
1243
- * @note See https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.34/#resourcerequirements-v1-core for details.
1297
+ * @note See the [Kubernetes ResourceRequirements API](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.34/#resourcerequirements-v1-core) for details.
1244
1298
  *
1245
1299
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
1246
1300
  */
@@ -1286,6 +1340,18 @@ const METRIC_K8S_CONTAINER_MEMORY_LIMIT_CURRENT = "k8s.container.memory.limit.cu
1286
1340
  */
1287
1341
  const METRIC_K8S_CONTAINER_MEMORY_LIMIT_DESIRED = "k8s.container.memory.limit.desired";
1288
1342
  /**
1343
+ * The ratio of container memory working set to its current memory limit.
1344
+ *
1345
+ * @note The numerator is the container memory working set, as reported by `container.memory.working_set`. The current memory limit
1346
+ * reflects the actual resources applied to the container, as reported by
1347
+ * [ContainerStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.34/#containerstatus-v1-core).
1348
+ * A value of 1.0 means the container is using 100% of its actual memory limit. Values above 1.0 can occur transiently, since memory usage can briefly exceed the limit.
1349
+ * If the memory limit is not set, this metric **SHOULD NOT** be emitted for that container.
1350
+ *
1351
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
1352
+ */
1353
+ const METRIC_K8S_CONTAINER_MEMORY_LIMIT_UTILIZATION = "k8s.container.memory.limit.utilization";
1354
+ /**
1289
1355
  * Deprecated, use `k8s.container.memory.request.desired` and `k8s.container.memory.request.current` instead.
1290
1356
  *
1291
1357
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
@@ -1318,6 +1384,20 @@ const METRIC_K8S_CONTAINER_MEMORY_REQUEST_CURRENT = "k8s.container.memory.reques
1318
1384
  */
1319
1385
  const METRIC_K8S_CONTAINER_MEMORY_REQUEST_DESIRED = "k8s.container.memory.request.desired";
1320
1386
  /**
1387
+ * The ratio of container memory working set to its current memory request.
1388
+ *
1389
+ * @note The numerator is the container memory working set, as reported by `container.memory.working_set`. The current memory request
1390
+ * reflects the request applied to the running container, as reported by
1391
+ * [ContainerStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.34/#containerstatus-v1-core).
1392
+ * A value of 1.0 means the container is using exactly its memory request. Since a memory request is a
1393
+ * scheduling reservation and not a hard cap, values above 1.0 are possible and indicate the container is
1394
+ * using more memory than requested. If the memory request is not set, this metric **SHOULD NOT** be emitted for
1395
+ * that container.
1396
+ *
1397
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
1398
+ */
1399
+ const METRIC_K8S_CONTAINER_MEMORY_REQUEST_UTILIZATION = "k8s.container.memory.request.utilization";
1400
+ /**
1321
1401
  * Indicates whether the container is currently marked as ready to accept traffic, based on its readiness probe (1 = ready, 0 = not ready).
1322
1402
  *
1323
1403
  * @note This metric **SHOULD** reflect the value of the `ready` field in the
@@ -1359,7 +1439,7 @@ const METRIC_K8S_CONTAINER_STATUS_STATE = "k8s.container.status.state";
1359
1439
  /**
1360
1440
  * Maximum storage resource limit set for the container.
1361
1441
  *
1362
- * @note See https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.34/#resourcerequirements-v1-core for details.
1442
+ * @note See the [Kubernetes ResourceRequirements API](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.34/#resourcerequirements-v1-core) for details.
1363
1443
  *
1364
1444
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
1365
1445
  */
@@ -1367,7 +1447,7 @@ const METRIC_K8S_CONTAINER_STORAGE_LIMIT = "k8s.container.storage.limit";
1367
1447
  /**
1368
1448
  * Storage resource requested for the container.
1369
1449
  *
1370
- * @note See https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.34/#resourcerequirements-v1-core for details.
1450
+ * @note See the [Kubernetes ResourceRequirements API](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.34/#resourcerequirements-v1-core) for details.
1371
1451
  *
1372
1452
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
1373
1453
  */
@@ -1803,8 +1883,8 @@ const METRIC_K8S_NODE_EPHEMERAL_STORAGE_ALLOCATABLE = "k8s.node.ephemeral_storag
1803
1883
  * Node filesystem available bytes.
1804
1884
  *
1805
1885
  * @note This metric is derived from the
1806
- * [FsStats.AvailableBytes](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#FsStats) field
1807
- * of the [NodeStats.Fs](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#NodeStats)
1886
+ * [FsStats.AvailableBytes](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#FsStats) field
1887
+ * of the [NodeStats.Fs](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#NodeStats)
1808
1888
  * of the Kubelet's stats API.
1809
1889
  *
1810
1890
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
@@ -1814,8 +1894,8 @@ const METRIC_K8S_NODE_FILESYSTEM_AVAILABLE = "k8s.node.filesystem.available";
1814
1894
  * Node filesystem capacity.
1815
1895
  *
1816
1896
  * @note This metric is derived from the
1817
- * [FsStats.CapacityBytes](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#FsStats) field
1818
- * of the [NodeStats.Fs](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#NodeStats)
1897
+ * [FsStats.CapacityBytes](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#FsStats) field
1898
+ * of the [NodeStats.Fs](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#NodeStats)
1819
1899
  * of the Kubelet's stats API.
1820
1900
  *
1821
1901
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
@@ -1825,8 +1905,8 @@ const METRIC_K8S_NODE_FILESYSTEM_CAPACITY = "k8s.node.filesystem.capacity";
1825
1905
  * The total inodes in the node's root filesystem.
1826
1906
  *
1827
1907
  * @note This metric is derived from the
1828
- * [FsStats.Inodes](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#FsStats) field
1829
- * of the [NodeStats.Fs](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#NodeStats)
1908
+ * [FsStats.Inodes](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#FsStats) field
1909
+ * of the [NodeStats.Fs](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#NodeStats)
1830
1910
  * of the Kubelet's stats API.
1831
1911
  *
1832
1912
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
@@ -1836,8 +1916,8 @@ const METRIC_K8S_NODE_FILESYSTEM_INODE_COUNT = "k8s.node.filesystem.inode.count"
1836
1916
  * The free inodes in the node's root filesystem.
1837
1917
  *
1838
1918
  * @note This metric is derived from the
1839
- * [FsStats.InodesFree](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#FsStats) field
1840
- * of the [NodeStats.Fs](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#NodeStats)
1919
+ * [FsStats.InodesFree](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#FsStats) field
1920
+ * of the [NodeStats.Fs](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#NodeStats)
1841
1921
  * of the Kubelet's stats API.
1842
1922
  *
1843
1923
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
@@ -1846,13 +1926,15 @@ const METRIC_K8S_NODE_FILESYSTEM_INODE_FREE = "k8s.node.filesystem.inode.free";
1846
1926
  /**
1847
1927
  * Node filesystem usage.
1848
1928
  *
1849
- * @note This may not equal capacity - available.
1850
- *
1851
- * This metric is derived from the
1852
- * [FsStats.UsedBytes](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#FsStats) field
1853
- * of the [NodeStats.Fs](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#NodeStats)
1929
+ * @note This metric is derived from the
1930
+ * [FsStats.UsedBytes](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#FsStats) field
1931
+ * of the [NodeStats.Fs](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#NodeStats)
1854
1932
  * of the Kubelet's stats API.
1855
1933
  *
1934
+ * Capacity and available are reported for the backing filesystem,
1935
+ * which may be shared with other workloads; therefore,
1936
+ * usage may not equal `capacity - available`.
1937
+ *
1856
1938
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
1857
1939
  */
1858
1940
  const METRIC_K8S_NODE_FILESYSTEM_USAGE = "k8s.node.filesystem.usage";
@@ -1903,7 +1985,7 @@ const METRIC_K8S_NODE_MEMORY_USAGE = "k8s.node.memory.usage";
1903
1985
  /**
1904
1986
  * Node memory working set.
1905
1987
  *
1906
- * @note The amount of working set memory. This includes recently accessed memory, dirty memory, and kernel memory. WorkingSetBytes is <= UsageBytes.
1988
+ * @note The amount of working set memory. This includes recently accessed memory, dirty memory, and kernel memory. On Linux, the working set is calculated by excluding inactive file-backed memory from memory usage (`inactive_file` on cgroup v2, `total_inactive_file` on cgroup v1), so active file-backed memory remains included. On Linux, the kubelet uses the node working set when determining memory availability for the `memory.available` eviction signal. `WorkingSetBytes` is less than or equal to `UsageBytes`.
1907
1989
  * This metric is derived from the [MemoryStats.WorkingSetBytes](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#MemoryStats) field of the [NodeStats.Memory](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#NodeStats) of the Kubelet's stats API.
1908
1990
  *
1909
1991
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
@@ -1924,13 +2006,36 @@ const METRIC_K8S_NODE_NETWORK_IO = "k8s.node.network.io";
1924
2006
  /**
1925
2007
  * Node memory paging faults.
1926
2008
  *
1927
- * @note Cumulative number of major/minor page faults.
1928
- * This metric is derived from the [MemoryStats.PageFaults](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#MemoryStats) and [MemoryStats.MajorPageFaults](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#MemoryStats) fields of the [NodeStats.Memory](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#NodeStats) of the Kubelet's stats API.
2009
+ * @note Cumulative number of major and minor page faults.
2010
+ * The [MemoryStats.MajorPageFaults](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#MemoryStats) field of the [NodeStats.Memory](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#NodeStats) of the Kubelet's stats API maps directly to `system.paging.fault.type=major`.
2011
+ * The [MemoryStats.PageFaults](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#MemoryStats) field reports the total number of page faults (equivalent to `pgfault` in the cgroup `memory.stat`), with minor and major combined. The minor page faults **MUST** therefore be derived as `MemoryStats.PageFaults - MemoryStats.MajorPageFaults`, so that summing the metric over `system.paging.fault.type` yields the total number of page faults.
1929
2012
  *
1930
2013
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
1931
2014
  */
1932
2015
  const METRIC_K8S_NODE_PAGING_FAULTS = "k8s.node.paging.faults";
1933
2016
  /**
2017
+ * Total number of processes/threads allowed by the operating system on the node.
2018
+ *
2019
+ * @note Derived from the Kubelet Summary API
2020
+ * ([RlimitStats.MaxPID](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#RlimitStats))
2021
+ * field of the [NodeStats.Rlimit](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#NodeStats),
2022
+ * representing the system-wide task limit (the lower of `kernel.pid_max` and `kernel.threads-max`).
2023
+ *
2024
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
2025
+ */
2026
+ const METRIC_K8S_NODE_PID_LIMIT = "k8s.node.pid.limit";
2027
+ /**
2028
+ * Total number of existing processes and threads on the node.
2029
+ *
2030
+ * @note Derived from the Kubelet Summary API
2031
+ * ([RlimitStats.NumOfRunningProcesses](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#RlimitStats))
2032
+ * field of the [NodeStats.Rlimit](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#NodeStats),
2033
+ * which reads the total count of scheduling entities (threads/processes across all states) from `/proc/loadavg`.
2034
+ *
2035
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
2036
+ */
2037
+ const METRIC_K8S_NODE_PID_USAGE = "k8s.node.pid.usage";
2038
+ /**
1934
2039
  * Amount of pods allocatable on the node.
1935
2040
  *
1936
2041
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
@@ -1971,8 +2076,8 @@ const METRIC_K8S_NODE_SYSTEM_CONTAINER_MEMORY_WORKING_SET = "k8s.node.system_con
1971
2076
  /**
1972
2077
  * The time the Node has been running.
1973
2078
  *
1974
- * @note Instrumentations **SHOULD** use a gauge with type `double` and measure uptime in seconds as a floating point number with the highest precision available.
1975
- * The actual accuracy would depend on the instrumentation and operating system.
2079
+ * @note Instrumentations **SHOULD** use a gauge with type `double` and measure uptime in seconds as a floating point number with the highest precision available. The actual accuracy would depend on the instrumentation and operating system.
2080
+ * This metric is derived from the [NodeStats.StartTime](https://github.com/kubernetes/kubelet/blob/v0.35.2/pkg/apis/stats/v1alpha1/types.go#L42) field of Kubelet's stats API, which is set to the [system boot time](https://github.com/kubernetes/kubernetes/blob/v1.36.3/pkg/kubelet/server/stats/summary.go#L113). This value resets when the node reboots.
1976
2081
  *
1977
2082
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
1978
2083
  */
@@ -2024,6 +2129,83 @@ const METRIC_K8S_PERSISTENTVOLUMECLAIM_STORAGE_CAPACITY = "k8s.persistentvolumec
2024
2129
  */
2025
2130
  const METRIC_K8S_PERSISTENTVOLUMECLAIM_STORAGE_REQUEST = "k8s.persistentvolumeclaim.storage.request";
2026
2131
  /**
2132
+ * Maximum CPU resource limit currently configured for a running Pod.
2133
+ *
2134
+ * @note This metric aligns with the limit in the
2135
+ * [`resources`](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.35/#resourcerequirements-v1-core) field of
2136
+ * [K8s PodStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.35/#podstatus-v1-core)
2137
+ * (status.resources). Also see `Actual Resources` in
2138
+ * [https://kubernetes.io/docs/tasks/configure-pod-container/resize-container-resources/](https://kubernetes.io/docs/tasks/configure-pod-container/resize-container-resources/) for more details.
2139
+ *
2140
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
2141
+ */
2142
+ const METRIC_K8S_POD_CPU_LIMIT_CURRENT = "k8s.pod.cpu.limit.current";
2143
+ /**
2144
+ * Maximum CPU resource limit as defined by the Pod spec.
2145
+ *
2146
+ * @note This metric aligns with the limit in the
2147
+ * [`resources`](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.35/#resourcerequirements-v1-core) field of
2148
+ * [K8s PodSpec](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.35/#podspec-v1-core)
2149
+ * (spec.resources). See
2150
+ * [https://kubernetes.io/docs/tasks/configure-pod-container/assign-pod-level-resources/](https://kubernetes.io/docs/tasks/configure-pod-container/assign-pod-level-resources/)
2151
+ * for more details on Pod level resources. Note that Kubernetes can default unset Pod level limits
2152
+ * based on the aggregated limits of the Pod's containers. Also see `Desired Resources` in
2153
+ * [https://kubernetes.io/docs/tasks/configure-pod-container/resize-container-resources/](https://kubernetes.io/docs/tasks/configure-pod-container/resize-container-resources/).
2154
+ *
2155
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
2156
+ */
2157
+ const METRIC_K8S_POD_CPU_LIMIT_DESIRED = "k8s.pod.cpu.limit.desired";
2158
+ /**
2159
+ * The ratio of Pod CPU usage to its current CPU limit.
2160
+ *
2161
+ * @note The current CPU limit reflects the actual resources applied at the Pod level, as reported by
2162
+ * [PodStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.35/#podstatus-v1-core).
2163
+ * The value range is [0.0,1.0]. A value of 1.0 means the Pod is using 100% of its actual CPU limit.
2164
+ * If the CPU limit is not set, this metric **SHOULD NOT** be emitted for that Pod.
2165
+ *
2166
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
2167
+ */
2168
+ const METRIC_K8S_POD_CPU_LIMIT_UTILIZATION = "k8s.pod.cpu.limit.utilization";
2169
+ /**
2170
+ * CPU resource requested currently configured for a running Pod.
2171
+ *
2172
+ * @note This metric aligns with the request in the
2173
+ * [`resources`](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.35/#resourcerequirements-v1-core) field of
2174
+ * [K8s PodStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.35/#podstatus-v1-core)
2175
+ * (status.resources). Also see `Actual Resources` in
2176
+ * [https://kubernetes.io/docs/tasks/configure-pod-container/resize-container-resources/](https://kubernetes.io/docs/tasks/configure-pod-container/resize-container-resources/) for more details.
2177
+ *
2178
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
2179
+ */
2180
+ const METRIC_K8S_POD_CPU_REQUEST_CURRENT = "k8s.pod.cpu.request.current";
2181
+ /**
2182
+ * CPU resource requested as defined by the Pod spec.
2183
+ *
2184
+ * @note This metric aligns with the request in the
2185
+ * [`resources`](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.35/#resourcerequirements-v1-core) field of
2186
+ * [K8s PodSpec](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.35/#podspec-v1-core)
2187
+ * (spec.resources). See
2188
+ * [https://kubernetes.io/docs/tasks/configure-pod-container/assign-pod-level-resources/](https://kubernetes.io/docs/tasks/configure-pod-container/assign-pod-level-resources/)
2189
+ * for more details on Pod level resources. Note that Kubernetes can default unset Pod level requests
2190
+ * based on the aggregated requests of the Pod's containers. Also see `Desired Resources` in
2191
+ * [https://kubernetes.io/docs/tasks/configure-pod-container/resize-container-resources/](https://kubernetes.io/docs/tasks/configure-pod-container/resize-container-resources/).
2192
+ *
2193
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
2194
+ */
2195
+ const METRIC_K8S_POD_CPU_REQUEST_DESIRED = "k8s.pod.cpu.request.desired";
2196
+ /**
2197
+ * The ratio of Pod CPU usage to its current CPU request.
2198
+ *
2199
+ * @note The current CPU request reflects the request applied at the Pod level, as reported by
2200
+ * [PodStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.35/#podstatus-v1-core).
2201
+ * A value of 1.0 means the Pod is using exactly its CPU request. Since a CPU request is a scheduling
2202
+ * reservation and not a hard cap, values above 1.0 are possible and indicate the Pod is using more CPU
2203
+ * than requested. If the CPU request is not set, this metric **SHOULD NOT** be emitted for that Pod.
2204
+ *
2205
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
2206
+ */
2207
+ const METRIC_K8S_POD_CPU_REQUEST_UTILIZATION = "k8s.pod.cpu.request.utilization";
2208
+ /**
2027
2209
  * Total CPU time consumed.
2028
2210
  *
2029
2211
  * @note Total CPU time consumed by the specific Pod on all available CPU cores
@@ -2043,8 +2225,8 @@ const METRIC_K8S_POD_CPU_USAGE = "k8s.pod.cpu.usage";
2043
2225
  * Pod filesystem available bytes.
2044
2226
  *
2045
2227
  * @note This metric is derived from the
2046
- * [FsStats.AvailableBytes](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#FsStats) field
2047
- * of the [PodStats.EphemeralStorage](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#PodStats)
2228
+ * [FsStats.AvailableBytes](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#FsStats) field
2229
+ * of the [PodStats.EphemeralStorage](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#PodStats)
2048
2230
  * of the Kubelet's stats API.
2049
2231
  *
2050
2232
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
@@ -2054,8 +2236,8 @@ const METRIC_K8S_POD_FILESYSTEM_AVAILABLE = "k8s.pod.filesystem.available";
2054
2236
  * Pod filesystem capacity.
2055
2237
  *
2056
2238
  * @note This metric is derived from the
2057
- * [FsStats.CapacityBytes](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#FsStats) field
2058
- * of the [PodStats.EphemeralStorage](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#PodStats)
2239
+ * [FsStats.CapacityBytes](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#FsStats) field
2240
+ * of the [PodStats.EphemeralStorage](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#PodStats)
2059
2241
  * of the Kubelet's stats API.
2060
2242
  *
2061
2243
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
@@ -2064,13 +2246,14 @@ const METRIC_K8S_POD_FILESYSTEM_CAPACITY = "k8s.pod.filesystem.capacity";
2064
2246
  /**
2065
2247
  * Pod filesystem usage.
2066
2248
  *
2067
- * @note This may not equal capacity - available.
2068
- *
2069
- * This metric is derived from the
2070
- * [FsStats.UsedBytes](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#FsStats) field
2071
- * of the [PodStats.EphemeralStorage](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#PodStats)
2249
+ * @note This metric is derived from the
2250
+ * [FsStats.UsedBytes](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#FsStats) field
2251
+ * of the [PodStats.EphemeralStorage](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#PodStats)
2072
2252
  * of the Kubelet's stats API.
2073
2253
  *
2254
+ * Capacity and available are reported for the backing filesystem, which may be shared
2255
+ * with other workloads; therefore, usage may not equal `capacity - available`.
2256
+ *
2074
2257
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
2075
2258
  */
2076
2259
  const METRIC_K8S_POD_FILESYSTEM_USAGE = "k8s.pod.filesystem.usage";
@@ -2084,6 +2267,45 @@ const METRIC_K8S_POD_FILESYSTEM_USAGE = "k8s.pod.filesystem.usage";
2084
2267
  */
2085
2268
  const METRIC_K8S_POD_MEMORY_AVAILABLE = "k8s.pod.memory.available";
2086
2269
  /**
2270
+ * Maximum memory resource limit currently configured for a running Pod.
2271
+ *
2272
+ * @note This metric aligns with the limit in the
2273
+ * [`resources`](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.35/#resourcerequirements-v1-core) field of
2274
+ * [K8s PodStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.35/#podstatus-v1-core)
2275
+ * (status.resources). Also see `Actual Resources` in
2276
+ * [https://kubernetes.io/docs/tasks/configure-pod-container/resize-container-resources/](https://kubernetes.io/docs/tasks/configure-pod-container/resize-container-resources/) for more details.
2277
+ *
2278
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
2279
+ */
2280
+ const METRIC_K8S_POD_MEMORY_LIMIT_CURRENT = "k8s.pod.memory.limit.current";
2281
+ /**
2282
+ * Maximum memory resource limit as defined by the Pod spec.
2283
+ *
2284
+ * @note This metric aligns with the limit in the
2285
+ * [`resources`](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.35/#resourcerequirements-v1-core) field of
2286
+ * [K8s PodSpec](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.35/#podspec-v1-core)
2287
+ * (spec.resources). See
2288
+ * [https://kubernetes.io/docs/tasks/configure-pod-container/assign-pod-level-resources/](https://kubernetes.io/docs/tasks/configure-pod-container/assign-pod-level-resources/)
2289
+ * for more details on Pod level resources. Note that Kubernetes can default unset Pod level limits
2290
+ * based on the aggregated limits of the Pod's containers. Also see `Desired Resources` in
2291
+ * [https://kubernetes.io/docs/tasks/configure-pod-container/resize-container-resources/](https://kubernetes.io/docs/tasks/configure-pod-container/resize-container-resources/).
2292
+ *
2293
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
2294
+ */
2295
+ const METRIC_K8S_POD_MEMORY_LIMIT_DESIRED = "k8s.pod.memory.limit.desired";
2296
+ /**
2297
+ * The ratio of Pod memory working set to its current memory limit.
2298
+ *
2299
+ * @note The numerator is the Pod memory working set, as reported by `k8s.pod.memory.working_set`. The current memory limit
2300
+ * reflects the actual resources applied at the Pod level, as reported by
2301
+ * [PodStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.35/#podstatus-v1-core).
2302
+ * A value of 1.0 means the Pod is using 100% of its actual memory limit. Values above 1.0 can occur transiently, since memory usage can briefly exceed the limit.
2303
+ * If the memory limit is not set, this metric **SHOULD NOT** be emitted for that Pod.
2304
+ *
2305
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
2306
+ */
2307
+ const METRIC_K8S_POD_MEMORY_LIMIT_UTILIZATION = "k8s.pod.memory.limit.utilization";
2308
+ /**
2087
2309
  * Deprecated, use `k8s.pod.paging.faults` instead.
2088
2310
  *
2089
2311
  * @note Cumulative number of major/minor page faults.
@@ -2095,6 +2317,46 @@ const METRIC_K8S_POD_MEMORY_AVAILABLE = "k8s.pod.memory.available";
2095
2317
  */
2096
2318
  const METRIC_K8S_POD_MEMORY_PAGING_FAULTS = "k8s.pod.memory.paging.faults";
2097
2319
  /**
2320
+ * Memory resource request currently configured for a running Pod.
2321
+ *
2322
+ * @note This metric aligns with the request in the
2323
+ * [`resources`](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.35/#resourcerequirements-v1-core) field of
2324
+ * [K8s PodStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.35/#podstatus-v1-core)
2325
+ * (status.resources). Also see `Actual Resources` in
2326
+ * [https://kubernetes.io/docs/tasks/configure-pod-container/resize-container-resources/](https://kubernetes.io/docs/tasks/configure-pod-container/resize-container-resources/) for more details.
2327
+ *
2328
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
2329
+ */
2330
+ const METRIC_K8S_POD_MEMORY_REQUEST_CURRENT = "k8s.pod.memory.request.current";
2331
+ /**
2332
+ * Memory resource requested as defined by the Pod spec.
2333
+ *
2334
+ * @note This metric aligns with the request in the
2335
+ * [`resources`](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.35/#resourcerequirements-v1-core) field of
2336
+ * [K8s PodSpec](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.35/#podspec-v1-core)
2337
+ * (spec.resources). See
2338
+ * [https://kubernetes.io/docs/tasks/configure-pod-container/assign-pod-level-resources/](https://kubernetes.io/docs/tasks/configure-pod-container/assign-pod-level-resources/)
2339
+ * for more details on Pod level resources. Note that Kubernetes can default unset Pod level requests
2340
+ * based on the aggregated requests of the Pod's containers. Also see `Desired Resources` in
2341
+ * [https://kubernetes.io/docs/tasks/configure-pod-container/resize-container-resources/](https://kubernetes.io/docs/tasks/configure-pod-container/resize-container-resources/).
2342
+ *
2343
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
2344
+ */
2345
+ const METRIC_K8S_POD_MEMORY_REQUEST_DESIRED = "k8s.pod.memory.request.desired";
2346
+ /**
2347
+ * The ratio of Pod memory working set to its current memory request.
2348
+ *
2349
+ * @note The numerator is the Pod memory working set, as reported by `k8s.pod.memory.working_set`. The current memory request
2350
+ * reflects the request applied at the Pod level, as reported by
2351
+ * [PodStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.35/#podstatus-v1-core).
2352
+ * A value of 1.0 means the Pod is using exactly its memory request. Since a memory request is a
2353
+ * scheduling reservation and not a hard cap, values above 1.0 are possible and indicate the Pod is using
2354
+ * more memory than requested. If the memory request is not set, this metric **SHOULD NOT** be emitted for that Pod.
2355
+ *
2356
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
2357
+ */
2358
+ const METRIC_K8S_POD_MEMORY_REQUEST_UTILIZATION = "k8s.pod.memory.request.utilization";
2359
+ /**
2098
2360
  * Pod memory RSS.
2099
2361
  *
2100
2362
  * @note The amount of anonymous and swap cache memory (includes transparent hugepages).
@@ -2115,7 +2377,7 @@ const METRIC_K8S_POD_MEMORY_USAGE = "k8s.pod.memory.usage";
2115
2377
  /**
2116
2378
  * Pod memory working set.
2117
2379
  *
2118
- * @note The amount of working set memory. This includes recently accessed memory, dirty memory, and kernel memory. WorkingSetBytes is <= UsageBytes.
2380
+ * @note The amount of working set memory. This includes recently accessed memory, dirty memory, and kernel memory. On Linux, the working set is calculated by excluding inactive file-backed memory from memory usage (`inactive_file` on cgroup v2, `total_inactive_file` on cgroup v1), so active file-backed memory remains included. The kubelet uses the Pod working set when ranking Pods for eviction under memory pressure. `WorkingSetBytes` is less than or equal to `UsageBytes`.
2119
2381
  * This metric is derived from the [MemoryStats.WorkingSetBytes](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#MemoryStats) field of the [PodStats.Memory](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#PodStats) of the Kubelet's stats API.
2120
2382
  *
2121
2383
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
@@ -2136,8 +2398,9 @@ const METRIC_K8S_POD_NETWORK_IO = "k8s.pod.network.io";
2136
2398
  /**
2137
2399
  * Pod memory paging faults.
2138
2400
  *
2139
- * @note Cumulative number of major/minor page faults.
2140
- * This metric is derived from the [MemoryStats.PageFaults](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#MemoryStats) and [MemoryStats.MajorPageFaults](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#MemoryStats) field of the [PodStats.Memory](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#PodStats) of the Kubelet's stats API.
2401
+ * @note Cumulative number of major and minor page faults.
2402
+ * The [MemoryStats.MajorPageFaults](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#MemoryStats) field of the [PodStats.Memory](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#PodStats) of the Kubelet's stats API maps directly to `system.paging.fault.type=major`.
2403
+ * The [MemoryStats.PageFaults](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#MemoryStats) field reports the total number of page faults (equivalent to `pgfault` in the cgroup `memory.stat`), with minor and major combined. The minor page faults **MUST** therefore be derived as `MemoryStats.PageFaults - MemoryStats.MajorPageFaults`, so that summing the metric over `system.paging.fault.type` yields the total number of page faults.
2141
2404
  *
2142
2405
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
2143
2406
  */
@@ -2163,8 +2426,8 @@ const METRIC_K8S_POD_STATUS_REASON = "k8s.pod.status.reason";
2163
2426
  /**
2164
2427
  * The time the Pod has been running.
2165
2428
  *
2166
- * @note Instrumentations **SHOULD** use a gauge with type `double` and measure uptime in seconds as a floating point number with the highest precision available.
2167
- * The actual accuracy would depend on the instrumentation and operating system.
2429
+ * @note Instrumentations **SHOULD** use a gauge with type `double` and measure uptime in seconds as a floating point number with the highest precision available. The actual accuracy would depend on the instrumentation and operating system.
2430
+ * This metric is derived from the [PodStats.StartTime](https://github.com/kubernetes/kubelet/blob/v0.35.2/pkg/apis/stats/v1alpha1/types.go#L122) field of Kubelet's stats API, where `StartTime` represents the pod sandbox creation time as [noted in the Kubelet source](https://github.com/kubernetes/kubernetes/blob/v1.36.3/pkg/kubelet/stats/cri_stats_provider.go#L299). This value resets when the node restarts, as the pod sandbox is recreated.
2168
2431
  *
2169
2432
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
2170
2433
  */
@@ -2173,8 +2436,8 @@ const METRIC_K8S_POD_UPTIME = "k8s.pod.uptime";
2173
2436
  * Pod volume storage space available.
2174
2437
  *
2175
2438
  * @note This metric is derived from the
2176
- * [VolumeStats.AvailableBytes](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#VolumeStats) field
2177
- * of the [PodStats](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#PodStats) of the
2439
+ * [VolumeStats.AvailableBytes](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#VolumeStats) field
2440
+ * of the [PodStats](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#PodStats) of the
2178
2441
  * Kubelet's stats API.
2179
2442
  *
2180
2443
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
@@ -2184,8 +2447,8 @@ const METRIC_K8S_POD_VOLUME_AVAILABLE = "k8s.pod.volume.available";
2184
2447
  * Pod volume total capacity.
2185
2448
  *
2186
2449
  * @note This metric is derived from the
2187
- * [VolumeStats.CapacityBytes](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#VolumeStats) field
2188
- * of the [PodStats](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#PodStats) of the
2450
+ * [VolumeStats.CapacityBytes](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#VolumeStats) field
2451
+ * of the [PodStats](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#PodStats) of the
2189
2452
  * Kubelet's stats API.
2190
2453
  *
2191
2454
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
@@ -2195,8 +2458,8 @@ const METRIC_K8S_POD_VOLUME_CAPACITY = "k8s.pod.volume.capacity";
2195
2458
  * The total inodes in the filesystem of the Pod's volume.
2196
2459
  *
2197
2460
  * @note This metric is derived from the
2198
- * [VolumeStats.Inodes](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#VolumeStats) field
2199
- * of the [PodStats](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#PodStats) of the
2461
+ * [VolumeStats.Inodes](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#VolumeStats) field
2462
+ * of the [PodStats](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#PodStats) of the
2200
2463
  * Kubelet's stats API.
2201
2464
  *
2202
2465
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
@@ -2206,8 +2469,8 @@ const METRIC_K8S_POD_VOLUME_INODE_COUNT = "k8s.pod.volume.inode.count";
2206
2469
  * The free inodes in the filesystem of the Pod's volume.
2207
2470
  *
2208
2471
  * @note This metric is derived from the
2209
- * [VolumeStats.InodesFree](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#VolumeStats) field
2210
- * of the [PodStats](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#PodStats) of the
2472
+ * [VolumeStats.InodesFree](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#VolumeStats) field
2473
+ * of the [PodStats](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#PodStats) of the
2211
2474
  * Kubelet's stats API.
2212
2475
  *
2213
2476
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
@@ -2217,8 +2480,8 @@ const METRIC_K8S_POD_VOLUME_INODE_FREE = "k8s.pod.volume.inode.free";
2217
2480
  * The inodes used by the filesystem of the Pod's volume.
2218
2481
  *
2219
2482
  * @note This metric is derived from the
2220
- * [VolumeStats.InodesUsed](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#VolumeStats) field
2221
- * of the [PodStats](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#PodStats) of the
2483
+ * [VolumeStats.InodesUsed](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#VolumeStats) field
2484
+ * of the [PodStats](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#PodStats) of the
2222
2485
  * Kubelet's stats API.
2223
2486
  *
2224
2487
  * This may not be equal to `inodes - free` because filesystem may share inodes with other filesystems.
@@ -2232,8 +2495,8 @@ const METRIC_K8S_POD_VOLUME_INODE_USED = "k8s.pod.volume.inode.used";
2232
2495
  * @note This may not equal capacity - available.
2233
2496
  *
2234
2497
  * This metric is derived from the
2235
- * [VolumeStats.UsedBytes](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#VolumeStats) field
2236
- * of the [PodStats](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#PodStats) of the
2498
+ * [VolumeStats.UsedBytes](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#VolumeStats) field
2499
+ * of the [PodStats](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#PodStats) of the
2237
2500
  * Kubelet's stats API.
2238
2501
  *
2239
2502
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
@@ -2609,6 +2872,15 @@ const METRIC_K8S_STATEFULSET_CURRENT_PODS = "k8s.statefulset.current_pods";
2609
2872
  */
2610
2873
  const METRIC_K8S_STATEFULSET_DESIRED_PODS = "k8s.statefulset.desired_pods";
2611
2874
  /**
2875
+ * Total number of available replica pods (ready for at least minReadySeconds) targeted by this statefulset.
2876
+ *
2877
+ * @note This metric aligns with the `availableReplicas` field of the
2878
+ * [K8s StatefulSetStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.34/#statefulsetstatus-v1-apps).
2879
+ *
2880
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
2881
+ */
2882
+ const METRIC_K8S_STATEFULSET_POD_AVAILABLE = "k8s.statefulset.pod.available";
2883
+ /**
2612
2884
  * The number of replica pods created by the statefulset controller from the statefulset version indicated by currentRevision.
2613
2885
  *
2614
2886
  * @note This metric aligns with the `currentReplicas` field of the
@@ -3298,7 +3570,13 @@ const METRIC_OTEL_SDK_EXPORTER_SPAN_INFLIGHT = "otel.sdk.exporter.span.inflight"
3298
3570
  */
3299
3571
  const METRIC_OTEL_SDK_EXPORTER_SPAN_INFLIGHT_COUNT = "otel.sdk.exporter.span.inflight.count";
3300
3572
  /**
3301
- * The number of logs submitted to enabled SDK Loggers.
3573
+ * The number of log records submitted to an enabled `Logger`.
3574
+ *
3575
+ * @note In OpenTelemetry SDKs a `Logger` is enabled by default, and can be disabled via configuration i.e. `LoggerConfig.enabled` = `false` when supported;
3576
+ * a disabled `Logger` is a No-op: emitting to it has no effect, so its records are not counted.
3577
+ * Every log record submitted to an enabled `Logger` is counted, even if it is later filtered or dropped within the SDK
3578
+ * (e.g. by minimum severity or trace-based rules, or by a processor or the export pipeline), making this metric the top of the log delivery funnel.
3579
+ * Records not submitted to the SDK are not counted (e.g. a caller that skips calling `Emit()` based on an `Enabled()` check, or an upstream logging library that filters first).
3302
3580
  *
3303
3581
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
3304
3582
  */
@@ -3528,15 +3806,6 @@ const METRIC_PROCESS_UPTIME = "process.uptime";
3528
3806
  */
3529
3807
  const METRIC_PROCESS_WINDOWS_HANDLE_COUNT = "process.windows.handle.count";
3530
3808
  /**
3531
- * Measures the duration of an outgoing Remote Procedure Call (RPC).
3532
- *
3533
- * @note When this metric is reported alongside an RPC client span, the metric value
3534
- * **SHOULD** be the same as the RPC client span duration.
3535
- *
3536
- * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
3537
- */
3538
- const METRIC_RPC_CLIENT_CALL_DURATION = "rpc.client.call.duration";
3539
- /**
3540
3809
  * Deprecated, use `rpc.client.call.duration` instead. Note: the unit also changed from `ms` to `s`.
3541
3810
  *
3542
3811
  * @note While streaming RPCs may record this metric as start-of-batch
@@ -3594,15 +3863,6 @@ const METRIC_RPC_CLIENT_RESPONSE_SIZE = "rpc.client.response.size";
3594
3863
  */
3595
3864
  const METRIC_RPC_CLIENT_RESPONSES_PER_RPC = "rpc.client.responses_per_rpc";
3596
3865
  /**
3597
- * Measures the duration of an incoming Remote Procedure Call (RPC).
3598
- *
3599
- * @note When this metric is reported alongside an RPC server span, the metric value
3600
- * **SHOULD** be the same as the RPC server span duration.
3601
- *
3602
- * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
3603
- */
3604
- const METRIC_RPC_SERVER_CALL_DURATION = "rpc.server.call.duration";
3605
- /**
3606
3866
  * Deprecated, use `rpc.server.call.duration` instead. Note: the unit also changed from `ms` to `s`.
3607
3867
  *
3608
3868
  * @note While streaming RPCs may record this metric as start-of-batch
@@ -3791,7 +4051,7 @@ const METRIC_SYSTEM_MEMORY_LIMIT = "system.memory.limit";
3791
4051
  /**
3792
4052
  * An estimate of how much memory is available for starting new applications, without causing swapping.
3793
4053
  *
3794
- * @note This is an alternative to `system.memory.usage` metric with `state=free`.
4054
+ * @note This is equivalent to the `system.memory.usage` metric with `state=available`.
3795
4055
  * Linux starting from 3.14 exports "available" memory. It takes "free" memory as a baseline, and then factors in kernel-specific values.
3796
4056
  * This is supposed to be more accurate than just "free" memory.
3797
4057
  * For reference, see the calculations [here](https://superuser.com/a/980821).
@@ -3872,13 +4132,17 @@ const METRIC_SYSTEM_MEMORY_LINUX_SLAB_USAGE = "system.memory.linux.slab.usage";
3872
4132
  */
3873
4133
  const METRIC_SYSTEM_MEMORY_SHARED = "system.memory.shared";
3874
4134
  /**
3875
- * Reports memory in use by state.
4135
+ * Reports memory by state.
4136
+ *
4137
+ * @note The sum of the `used` and `available` state values **SHOULD** be equal to `system.memory.limit`.
3876
4138
  *
3877
4139
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
3878
4140
  */
3879
4141
  const METRIC_SYSTEM_MEMORY_USAGE = "system.memory.usage";
3880
4142
  /**
3881
- * Percentage of memory bytes in use.
4143
+ * Fraction of memory bytes by state.
4144
+ *
4145
+ * @note The sum of the `used` and `available` state values **SHOULD** be equal to 1.
3882
4146
  *
3883
4147
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
3884
4148
  */
@@ -4212,6 +4476,7 @@ exports.METRIC_DB_CLIENT_CONNECTION_COUNT = METRIC_DB_CLIENT_CONNECTION_COUNT;
4212
4476
  exports.METRIC_DB_CLIENT_CONNECTION_CREATE_TIME = METRIC_DB_CLIENT_CONNECTION_CREATE_TIME;
4213
4477
  exports.METRIC_DB_CLIENT_CONNECTION_IDLE_MAX = METRIC_DB_CLIENT_CONNECTION_IDLE_MAX;
4214
4478
  exports.METRIC_DB_CLIENT_CONNECTION_IDLE_MIN = METRIC_DB_CLIENT_CONNECTION_IDLE_MIN;
4479
+ exports.METRIC_DB_CLIENT_CONNECTION_LIMIT = METRIC_DB_CLIENT_CONNECTION_LIMIT;
4215
4480
  exports.METRIC_DB_CLIENT_CONNECTION_MAX = METRIC_DB_CLIENT_CONNECTION_MAX;
4216
4481
  exports.METRIC_DB_CLIENT_CONNECTION_PENDING_REQUESTS = METRIC_DB_CLIENT_CONNECTION_PENDING_REQUESTS;
4217
4482
  exports.METRIC_DB_CLIENT_CONNECTION_TIMEOUTS = METRIC_DB_CLIENT_CONNECTION_TIMEOUTS;
@@ -4303,6 +4568,13 @@ exports.METRIC_JVM_BUFFER_COUNT = METRIC_JVM_BUFFER_COUNT;
4303
4568
  exports.METRIC_JVM_BUFFER_MEMORY_LIMIT = METRIC_JVM_BUFFER_MEMORY_LIMIT;
4304
4569
  exports.METRIC_JVM_BUFFER_MEMORY_USAGE = METRIC_JVM_BUFFER_MEMORY_USAGE;
4305
4570
  exports.METRIC_JVM_BUFFER_MEMORY_USED = METRIC_JVM_BUFFER_MEMORY_USED;
4571
+ exports.METRIC_JVM_EXECUTOR_QUEUE_CAPACITY = METRIC_JVM_EXECUTOR_QUEUE_CAPACITY;
4572
+ exports.METRIC_JVM_EXECUTOR_QUEUE_SIZE = METRIC_JVM_EXECUTOR_QUEUE_SIZE;
4573
+ exports.METRIC_JVM_EXECUTOR_TASK_COMPLETED = METRIC_JVM_EXECUTOR_TASK_COMPLETED;
4574
+ exports.METRIC_JVM_EXECUTOR_TASK_REJECTED = METRIC_JVM_EXECUTOR_TASK_REJECTED;
4575
+ exports.METRIC_JVM_EXECUTOR_THREAD_CORE = METRIC_JVM_EXECUTOR_THREAD_CORE;
4576
+ exports.METRIC_JVM_EXECUTOR_THREAD_COUNT = METRIC_JVM_EXECUTOR_THREAD_COUNT;
4577
+ exports.METRIC_JVM_EXECUTOR_THREAD_LIMIT = METRIC_JVM_EXECUTOR_THREAD_LIMIT;
4306
4578
  exports.METRIC_JVM_FILE_DESCRIPTOR_COUNT = METRIC_JVM_FILE_DESCRIPTOR_COUNT;
4307
4579
  exports.METRIC_JVM_FILE_DESCRIPTOR_LIMIT = METRIC_JVM_FILE_DESCRIPTOR_LIMIT;
4308
4580
  exports.METRIC_JVM_MEMORY_INIT = METRIC_JVM_MEMORY_INIT;
@@ -4322,9 +4594,11 @@ exports.METRIC_K8S_CONTAINER_EPHEMERAL_STORAGE_USAGE = METRIC_K8S_CONTAINER_EPHE
4322
4594
  exports.METRIC_K8S_CONTAINER_MEMORY_LIMIT = METRIC_K8S_CONTAINER_MEMORY_LIMIT;
4323
4595
  exports.METRIC_K8S_CONTAINER_MEMORY_LIMIT_CURRENT = METRIC_K8S_CONTAINER_MEMORY_LIMIT_CURRENT;
4324
4596
  exports.METRIC_K8S_CONTAINER_MEMORY_LIMIT_DESIRED = METRIC_K8S_CONTAINER_MEMORY_LIMIT_DESIRED;
4597
+ exports.METRIC_K8S_CONTAINER_MEMORY_LIMIT_UTILIZATION = METRIC_K8S_CONTAINER_MEMORY_LIMIT_UTILIZATION;
4325
4598
  exports.METRIC_K8S_CONTAINER_MEMORY_REQUEST = METRIC_K8S_CONTAINER_MEMORY_REQUEST;
4326
4599
  exports.METRIC_K8S_CONTAINER_MEMORY_REQUEST_CURRENT = METRIC_K8S_CONTAINER_MEMORY_REQUEST_CURRENT;
4327
4600
  exports.METRIC_K8S_CONTAINER_MEMORY_REQUEST_DESIRED = METRIC_K8S_CONTAINER_MEMORY_REQUEST_DESIRED;
4601
+ exports.METRIC_K8S_CONTAINER_MEMORY_REQUEST_UTILIZATION = METRIC_K8S_CONTAINER_MEMORY_REQUEST_UTILIZATION;
4328
4602
  exports.METRIC_K8S_CONTAINER_READY = METRIC_K8S_CONTAINER_READY;
4329
4603
  exports.METRIC_K8S_CONTAINER_RESTART_COUNT = METRIC_K8S_CONTAINER_RESTART_COUNT;
4330
4604
  exports.METRIC_K8S_CONTAINER_STATUS_REASON = METRIC_K8S_CONTAINER_STATUS_REASON;
@@ -4390,6 +4664,8 @@ exports.METRIC_K8S_NODE_MEMORY_WORKING_SET = METRIC_K8S_NODE_MEMORY_WORKING_SET;
4390
4664
  exports.METRIC_K8S_NODE_NETWORK_ERRORS = METRIC_K8S_NODE_NETWORK_ERRORS;
4391
4665
  exports.METRIC_K8S_NODE_NETWORK_IO = METRIC_K8S_NODE_NETWORK_IO;
4392
4666
  exports.METRIC_K8S_NODE_PAGING_FAULTS = METRIC_K8S_NODE_PAGING_FAULTS;
4667
+ exports.METRIC_K8S_NODE_PID_LIMIT = METRIC_K8S_NODE_PID_LIMIT;
4668
+ exports.METRIC_K8S_NODE_PID_USAGE = METRIC_K8S_NODE_PID_USAGE;
4393
4669
  exports.METRIC_K8S_NODE_POD_ALLOCATABLE = METRIC_K8S_NODE_POD_ALLOCATABLE;
4394
4670
  exports.METRIC_K8S_NODE_SYSTEM_CONTAINER_CPU_TIME = METRIC_K8S_NODE_SYSTEM_CONTAINER_CPU_TIME;
4395
4671
  exports.METRIC_K8S_NODE_SYSTEM_CONTAINER_CPU_USAGE = METRIC_K8S_NODE_SYSTEM_CONTAINER_CPU_USAGE;
@@ -4401,13 +4677,25 @@ exports.METRIC_K8S_PERSISTENTVOLUMECLAIM_STORAGE_CAPACITY = METRIC_K8S_PERSISTEN
4401
4677
  exports.METRIC_K8S_PERSISTENTVOLUMECLAIM_STORAGE_REQUEST = METRIC_K8S_PERSISTENTVOLUMECLAIM_STORAGE_REQUEST;
4402
4678
  exports.METRIC_K8S_PERSISTENTVOLUME_STATUS_PHASE = METRIC_K8S_PERSISTENTVOLUME_STATUS_PHASE;
4403
4679
  exports.METRIC_K8S_PERSISTENTVOLUME_STORAGE_CAPACITY = METRIC_K8S_PERSISTENTVOLUME_STORAGE_CAPACITY;
4680
+ exports.METRIC_K8S_POD_CPU_LIMIT_CURRENT = METRIC_K8S_POD_CPU_LIMIT_CURRENT;
4681
+ exports.METRIC_K8S_POD_CPU_LIMIT_DESIRED = METRIC_K8S_POD_CPU_LIMIT_DESIRED;
4682
+ exports.METRIC_K8S_POD_CPU_LIMIT_UTILIZATION = METRIC_K8S_POD_CPU_LIMIT_UTILIZATION;
4683
+ exports.METRIC_K8S_POD_CPU_REQUEST_CURRENT = METRIC_K8S_POD_CPU_REQUEST_CURRENT;
4684
+ exports.METRIC_K8S_POD_CPU_REQUEST_DESIRED = METRIC_K8S_POD_CPU_REQUEST_DESIRED;
4685
+ exports.METRIC_K8S_POD_CPU_REQUEST_UTILIZATION = METRIC_K8S_POD_CPU_REQUEST_UTILIZATION;
4404
4686
  exports.METRIC_K8S_POD_CPU_TIME = METRIC_K8S_POD_CPU_TIME;
4405
4687
  exports.METRIC_K8S_POD_CPU_USAGE = METRIC_K8S_POD_CPU_USAGE;
4406
4688
  exports.METRIC_K8S_POD_FILESYSTEM_AVAILABLE = METRIC_K8S_POD_FILESYSTEM_AVAILABLE;
4407
4689
  exports.METRIC_K8S_POD_FILESYSTEM_CAPACITY = METRIC_K8S_POD_FILESYSTEM_CAPACITY;
4408
4690
  exports.METRIC_K8S_POD_FILESYSTEM_USAGE = METRIC_K8S_POD_FILESYSTEM_USAGE;
4409
4691
  exports.METRIC_K8S_POD_MEMORY_AVAILABLE = METRIC_K8S_POD_MEMORY_AVAILABLE;
4692
+ exports.METRIC_K8S_POD_MEMORY_LIMIT_CURRENT = METRIC_K8S_POD_MEMORY_LIMIT_CURRENT;
4693
+ exports.METRIC_K8S_POD_MEMORY_LIMIT_DESIRED = METRIC_K8S_POD_MEMORY_LIMIT_DESIRED;
4694
+ exports.METRIC_K8S_POD_MEMORY_LIMIT_UTILIZATION = METRIC_K8S_POD_MEMORY_LIMIT_UTILIZATION;
4410
4695
  exports.METRIC_K8S_POD_MEMORY_PAGING_FAULTS = METRIC_K8S_POD_MEMORY_PAGING_FAULTS;
4696
+ exports.METRIC_K8S_POD_MEMORY_REQUEST_CURRENT = METRIC_K8S_POD_MEMORY_REQUEST_CURRENT;
4697
+ exports.METRIC_K8S_POD_MEMORY_REQUEST_DESIRED = METRIC_K8S_POD_MEMORY_REQUEST_DESIRED;
4698
+ exports.METRIC_K8S_POD_MEMORY_REQUEST_UTILIZATION = METRIC_K8S_POD_MEMORY_REQUEST_UTILIZATION;
4411
4699
  exports.METRIC_K8S_POD_MEMORY_RSS = METRIC_K8S_POD_MEMORY_RSS;
4412
4700
  exports.METRIC_K8S_POD_MEMORY_USAGE = METRIC_K8S_POD_MEMORY_USAGE;
4413
4701
  exports.METRIC_K8S_POD_MEMORY_WORKING_SET = METRIC_K8S_POD_MEMORY_WORKING_SET;
@@ -4457,6 +4745,7 @@ exports.METRIC_K8S_SERVICE_ENDPOINT_COUNT = METRIC_K8S_SERVICE_ENDPOINT_COUNT;
4457
4745
  exports.METRIC_K8S_SERVICE_LOAD_BALANCER_INGRESS_COUNT = METRIC_K8S_SERVICE_LOAD_BALANCER_INGRESS_COUNT;
4458
4746
  exports.METRIC_K8S_STATEFULSET_CURRENT_PODS = METRIC_K8S_STATEFULSET_CURRENT_PODS;
4459
4747
  exports.METRIC_K8S_STATEFULSET_DESIRED_PODS = METRIC_K8S_STATEFULSET_DESIRED_PODS;
4748
+ exports.METRIC_K8S_STATEFULSET_POD_AVAILABLE = METRIC_K8S_STATEFULSET_POD_AVAILABLE;
4460
4749
  exports.METRIC_K8S_STATEFULSET_POD_CURRENT = METRIC_K8S_STATEFULSET_POD_CURRENT;
4461
4750
  exports.METRIC_K8S_STATEFULSET_POD_DESIRED = METRIC_K8S_STATEFULSET_POD_DESIRED;
4462
4751
  exports.METRIC_K8S_STATEFULSET_POD_READY = METRIC_K8S_STATEFULSET_POD_READY;
@@ -4561,13 +4850,11 @@ exports.METRIC_PROCESS_THREAD_COUNT = METRIC_PROCESS_THREAD_COUNT;
4561
4850
  exports.METRIC_PROCESS_UNIX_FILE_DESCRIPTOR_COUNT = METRIC_PROCESS_UNIX_FILE_DESCRIPTOR_COUNT;
4562
4851
  exports.METRIC_PROCESS_UPTIME = METRIC_PROCESS_UPTIME;
4563
4852
  exports.METRIC_PROCESS_WINDOWS_HANDLE_COUNT = METRIC_PROCESS_WINDOWS_HANDLE_COUNT;
4564
- exports.METRIC_RPC_CLIENT_CALL_DURATION = METRIC_RPC_CLIENT_CALL_DURATION;
4565
4853
  exports.METRIC_RPC_CLIENT_DURATION = METRIC_RPC_CLIENT_DURATION;
4566
4854
  exports.METRIC_RPC_CLIENT_REQUESTS_PER_RPC = METRIC_RPC_CLIENT_REQUESTS_PER_RPC;
4567
4855
  exports.METRIC_RPC_CLIENT_REQUEST_SIZE = METRIC_RPC_CLIENT_REQUEST_SIZE;
4568
4856
  exports.METRIC_RPC_CLIENT_RESPONSES_PER_RPC = METRIC_RPC_CLIENT_RESPONSES_PER_RPC;
4569
4857
  exports.METRIC_RPC_CLIENT_RESPONSE_SIZE = METRIC_RPC_CLIENT_RESPONSE_SIZE;
4570
- exports.METRIC_RPC_SERVER_CALL_DURATION = METRIC_RPC_SERVER_CALL_DURATION;
4571
4858
  exports.METRIC_RPC_SERVER_DURATION = METRIC_RPC_SERVER_DURATION;
4572
4859
  exports.METRIC_RPC_SERVER_REQUESTS_PER_RPC = METRIC_RPC_SERVER_REQUESTS_PER_RPC;
4573
4860
  exports.METRIC_RPC_SERVER_REQUEST_SIZE = METRIC_RPC_SERVER_REQUEST_SIZE;