Cherry-pick: Add OpenTelemetry metrics for package resources size (#1018)

[JamesMcDermott]

Title

Cherry-pick to 1.5:

• Add OpenTelemetry metrics for package resources size (Add OpenTelemetry metrics for package resources size #1018)
• Skip TestPackageSizeMetric, TestPackageSizeMetricValues when running against CR cache (Skip TestPackageSizeMetric, TestPackageSizeMetricValues when running against CR cache #1050)

---

Description

• What changed:
• Why it’s needed:
• How it works:

---

Related Issue(s)

• Closes/Fixes #

---

Type of Change

• Cherry-pick
• Bug fix
• New feature
• Enhancement
• Refactor
• Documentation
• Tests
• Other: ________

---

Checklist

• Code follows project style guidelines
• Self-reviewed changes
• Tests added/updated
• Documentation added/updated
• All tests and gating checks pass

---

Testing Instructions (Optional)

---

Additional Notes (Optional)

• Known issues:
• Further improvements:
• Review notes:

---

AI Disclosure

• I have used AI in the creation of this PR.

[Copilot]

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

Adds OpenTelemetry-based telemetry and a Prometheus/Grafana monitoring stack, including new package-size metrics and E2E validations.

Changes:

• Introduces internal/telemetry for OTel setup, Prometheus scraping endpoint, and package-size metric instruments.
• Records package revision resource-size metrics from DB cache flows and updates E2E tests to assert presence/values.
• Adds monitoring deployment assets (Prometheus, Grafana, dashboards) plus a helper script to deploy them.

Reviewed changes

Copilot reviewed 28 out of 28 changed files in this pull request and generated 6 comments.

Show a summary per file

File	Description
test/e2e/suiteutils/suite_utils.go	Adds Prometheus text parsing utilities for collected metrics so tests can assert specific label/value pairs.
test/e2e/suiteutils/suite.go	Simplifies DB cache env detection and makes delete ignore NotFound.
test/e2e/api/metrics_test.go	Updates metrics endpoint assertions and adds new tests for package-size metrics and values.
scripts/deploy-monitoring.sh	New helper to render/apply monitoring manifests and port-forward Prometheus/Grafana.
pkg/cli/commands/rpkg/docs/docs.go	Fixes grammar in CLI docs strings.
pkg/cli/commands/rpkg/approve/command_test.go	Clarifies test comment casing.
pkg/cache/dbcache/dbreposync.go	Records package resource-size metrics during external PR caching.
pkg/cache/dbcache/dbrepository.go	Records package resource-size metrics after closing a draft.
pkg/cache/dbcache/dbpackagerevisionresourcessql.go	Records resource-size=0 metric on successful resource deletion.
internal/telemetry/otel.go	New unified OTel setup with optional Prometheus HTTP server and lifecycle management.
internal/telemetry/metrics.go	New OTel instruments + recording helper for package revision resource size.
internal/telemetry/metrics_test.go	Unit tests for metric recording behavior and nil-instrument safety.
internal/otel/otel_test.go	Updates tests for new OTel behavior, but file location/package appear inconsistent with new code location.
internal/otel/otel.go	Removes old OTel setup implementation.
go.mod	Promotes OTel prometheus exporter + metric module to direct deps.
func/wrapper-server/main.go	Switches to new telemetry setup and ensures graceful shutdown.
func/server/server.go	Switches to new telemetry setup and ensures graceful shutdown.
controllers/main.go	Switches to new telemetry setup and ensures graceful shutdown.
cmd/porch/main.go	Switches to new telemetry setup and ensures graceful shutdown.
docs/content/en/docs/6_configuration_and_deployments/configurations/opentelemetry.md	Documents new metrics and their Prometheus names/labels.
deployments/porch/9-controllers.yaml	Adds a Service to expose controller metrics on 9464; trims trailing whitespace.
deployments/porch/3-porch-server.yaml	Exposes metrics port and adds a startup probe; adds service port for metrics.
deployments/porch/2-function-runner.yaml	Exposes metrics port via Service.
deployments/metrics/prometheus-deployment.yaml	Adds prometheus deployment + RBAC + service for monitoring stack.
deployments/metrics/grafana-deployment.yaml	Adds grafana deployment + provisioning config + admin secret for monitoring stack.
deployments/metrics-resources/prometheus-config.yaml	Prometheus scrape config for Porch components.
deployments/metrics-resources/grafana-package-sizes-dashboard.json	Grafana dashboard for package resource size gauge.
deployments/function-pods/deployment.yaml	Enables Prometheus exporter env + exposes metrics port for wrapper-server function pods.

[Copilot]

Pull request overview

Copilot reviewed 28 out of 28 changed files in this pull request and generated 8 comments.

[sonarqubecloud]

Quality Gate passed

Issues
1 New issue
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.1% Duplication on New Code

See analysis details on SonarQube Cloud