Skip to content

Commit 6e0aa7d

Browse files
committed
docs(enterprise): remove stale helm troubleshooting row and fix scrape-result table header
1 parent 38d99a7 commit 6e0aa7d

1 file changed

Lines changed: 3 additions & 4 deletions

File tree

enterprise/kubernetes/byoc.md

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -276,7 +276,6 @@ Search the operator logs for `managed mode` first — every failure mode below l
276276

277277
| Message contains | Cause and fix |
278278
| ---------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
279-
| `bootstrapToken was replaced by spice.managedMode.enrollmentToken` | The values use the old pre-release key names. Rename `bootstrapToken` → `enrollmentToken` and `bootstrapTokenSecret` → `enrollmentTokenSecret`. |
280279
| `requires either enrollmentToken/enrollmentTokenSecret … or both mtlsSecret and caSecret` | `enabled: true` was set with no identity source. Provide an enrollment token, or a full pre-provisioned identity. |
281280
| `mtlsSecret and caSecret must be set together` | Half of a pre-provisioned identity. Set both, or neither. |
282281
| `instanceId is required with a pre-provisioned identity` | Add `instanceId` (and `endpoint`) when using `mtlsSecret` + `caSecret`. |
@@ -326,15 +325,15 @@ Fix the value named in the message and roll the deployment. If the pod crash-loo
326325

327326
### Container CPU/memory graphs are empty
328327

329-
Check the scrape counter on the operator's Prometheus endpoint (see [Operator Metrics](metrics.md)):
328+
Check the `result` label on the `spiceai_operator_managed_metrics_scrape_total{source="kubelet"}` counter, exposed on the operator's Prometheus endpoint (see [Operator Metrics](metrics.md)):
330329

331330
```bash
332331
kubectl -n spiceai-operator-system port-forward deploy/spiceai-operator 9090:9090
333332
curl -s http://localhost:9090/metrics | grep managed_metrics
334333
```
335334

336-
| `result` label on `…managed_metrics_scrape_total{source="kubelet"}` | Cause and fix |
337-
| -------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
335+
| Scrape `result` label | Cause and fix |
336+
| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
338337
| `tls_error` | The kubelet serving certificate cannot be verified — the common case on EKS/GKE/AKS. Set `kubeletCaSecret` or `kubeletInsecureTls: true` (see [Kubelet TLS verification](#kubelet-tls-verification)). |
339338
| `no_client` | `kubeletCaSecret` points at an unreadable or empty CA. The startup log names the reason. |
340339
| `forbidden` | The token authenticated, but authorization failed — the `spiceai-operator-kubelet-metrics` ClusterRole or binding is missing. Reinstall or repair the chart RBAC. |

0 commit comments

Comments
 (0)