[JamesMcDermott]

Description

• What changed:
  • New time-series panel to the "Porch API" Grafana dashboard for the porch_in_flight_api_operations metric
  • Updated OpenTelemetry metrics documentation to document:
    • new attributes added to porch_api_call_duration_seconds (added operation, operation_outcome, lifecycle_after, namespace, repository, package, and workspace_name)
      • and clarified the verb attribute as an HTTP-style operation name
    • the new porch_in_flight_api_operations up/down counter and its attributes
  • Added to the resources-and-operations table to reflect additional GET support on PackageRevision (porch-controllers, v1alpha2) and a new PackageRevisionApproval row (porch-controllers, UPDATE, v1alpha2)
    • additional operations driven from controllers and not metric'ed in initial v1alpha2 implementation
• Why it’s needed:
  • Documentation and dashboard updates to accompany PR Add in-flight and richer duration Prometheus metrics on all Porch API operations #1198, providing visibility into currently in-progress Porch API operations and accurately documenting the emitted metrics and their attributes.

---

Related Issue(s)

• Documentation impacts for Add in-flight and richer duration Prometheus metrics on all Porch API operations #1198

---

Type of Change

• Bug fix
• New feature
• Enhancement
• Refactor
• Documentation
• Tests
• Other: Observability / Grafana dashboard

---

Checklist

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

---

Testing Instructions (Optional)

1. Deploy the local monitoring stack with make deploy-monitoring
2. Access the "Porch API" dashboard in Grafana
3. Observe the new "All Resources — In-Flight Operation Count by Resource, Operation & User" panel renders and queries porch_in_flight_api_operations
4. Render the updated opentelemetry.md docs page with hugo serve; verify the new "Request Counts - In Flight" section and expanded attribute tables display correctly.

---

AI Disclosure

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

If so, please describe how:

• Kiro to review dashboard and documentation changes
• Kiro to generate this pull request description from Git diffs

[netlify]

✅ Deploy Preview for kpt-porch ready!

Name	Link
🔨 Latest commit	85a2b03
🔍 Latest deploy log	https://app.netlify.com/projects/kpt-porch/deploys/6ae1ba0f349cd52a8fafdfac
😎 Deploy Preview	https://deploy-preview-1281--kpt-porch.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.
🤖 Make changes	Run an agent on this branch

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[Copilot]

🟡 Changes recommended

The new Grafana panel occupies the same grid position as an existing full-width panel.

2 open findings

• Panel layout collision with panel 503 · New
• Misleading request terminology for API operations · New

What changed in this PR

Updates observability documentation and Grafana visualization for metrics introduced by #1198.

Changes:

• Documents expanded API duration and in-flight operation metrics.
• Adds an in-flight operations Grafana panel.
• Updates documented resource-operation mappings.

File	Description
docs/​content/​en/​docs/​6_configuration_and_deployments/​configurations/​opentelemetry.md	Documents metric attributes, names, and operations.
deployments/​metrics-resources/​grafana-porch-server-dashboard.json	Adds the in-flight operations panel.

🧠 Review effort: Balanced

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[efiacor]

@netlify rebuild

[Catalin-Stratulat-Ericsson]

just a few minor nitpicks. will review in conjunction with #1198 later as one unit.

[Catalin-Stratulat-Ericsson]

good stuff