Skip to content

DOCS-3160: Complete the operator metrics docs - #3188

Draft
ctauchen wants to merge 1 commit into
tigera:mainfrom
ctauchen:docs-3160-operator-metrics
Draft

ctauchen wants to merge 1 commit into
tigera:mainfrom
ctauchen:docs-3160-operator-metrics

Conversation

@ctauchen

@ctauchen ctauchen commented Nov 6, 2026 •

Copy link
Copy Markdown
Collaborator

Completes the operator metrics docs for Calico Enterprise 3.24: release note, upgrade note for METRICS_SCHEME, the package label on the license metrics, component values, an example alert rule, and mTLS and network policy guidance for bring-your-own Prometheus.

Jira: https://tigera.atlassian.net/browse/DOCS-3160

Preview

To do

  • SME to confirm the component names that appear on a Calico Enterprise cluster and whether the sample network policy is the one to recommend.
  • Port the label fix, component values, example rule and BYO text to the 3.24-1, 3.24-2 and Calico Cloud trees in a follow-up.

Flags

  • The sample network policy and the example alert were not tested on a cluster.
  • The bring-your-own Prometheus tabs never say where to mount the copied secret and CA bundle, and the ServiceMonitor expects a different CA file name. That predates this change and needs its own ticket.
  • Two other open PRs add release note bullets at the same spot. Whichever merges later rebases.

Copilot AI lite review requested due to automatic review settings November 6, 2026 12:04
@netlify

netlify Bot commented Nov 6, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for calico-docs-preview-next ready!

Name Link
🔨 Latest commit 8b943ea
🔍 Latest deploy log https://app.netlify.com/projects/calico-docs-preview-next/deploys/6aedc2640964502533bf7c1b
😎 Deploy Preview https://deploy-preview-3188--calico-docs-preview-next.netlify.app
📱 Preview on mobile
Toggle QR Code...

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.

@netlify

netlify Bot commented Nov 6, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview succeeded!

Built without sensitive environment variables

Name Link
🔨 Latest commit 8b943ea
🔍 Latest deploy log https://app.netlify.com/projects/tigera/deploys/6aedc26467db112ace2045d9
😎 Deploy Preview https://deploy-preview-3188--tigera.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
Lighthouse
Lighthouse
1 paths audited
Performance: 94 (🟢 up 5 from production)
Accessibility: 98 (no change from production)
Best Practices: 92 (no change from production)
SEO: 100 (no change from production)
PWA: -
View the detailed breakdown and full score reports
🤖 Make changes Run an agent on this branch

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

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 Changes recommended

Two active documentation issues remain: the possible component values omit the valid secrets value, and the Prometheus manifest leaves an unreplaced namespace placeholder that would fail validation.

2 open issues
What changed in this PR

Completes the Calico Enterprise 3.24 operator metrics documentation, including release and upgrade guidance, metric references, alerting examples, and BYO Prometheus configuration.

Changes:

  • Adds operator metrics release notes and METRICS_SCHEME upgrade guidance.
  • Documents component values, license metric labels, certificate alert timing, and a custom alert rule.
  • Adds mTLS and network policy guidance for scraping operator metrics with BYO Prometheus.
File Summary Review notes
calico-enterprise/​release-notes/​index.mdx Adds operator metrics release and upgrade notes. No findings.
calico-enterprise/​operations/​monitor/​prometheus/​byo-prometheus.mdx Adds operator mTLS requirements and an example egress policy for BYO Prometheus. The example should instruct readers to replace the namespace placeholder as well as the pod selector.
calico-enterprise/​operations/​monitor/​metrics/​operator-metrics.mdx Expands the metrics reference with component values, license labels, alert details, and a custom alert example. Clarify that the component values are examples or include secrets; correct the certificate-management guidance to reflect the operator’s behavior with CSR-based certificate management.

Review effort: Lite

- Logs: `log-collector`, `log-collector-otel`, `log-storage`, `log-storage-access`, `log-storage-dashboards`, `log-storage-elastic`, `log-storage-esmetrics`, `log-storage-kubecontrollers`, `log-storage-secrets`, `log-storage-users`
- Threat defense and policy: `intrusion-detection`, `policy-recommendation`, `packet-capture`
- Traffic features: `applicationlayer`, `egressgateway`, `gatewayapi`, `istio`
- Hosts and clusters: `non-cluster-hosts`, `management-cluster-connection`
Comment on lines +396 to +397
The following example allows this traffic.
Replace the selector with one that matches your Prometheus pods.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants