139a990ebc
vmagent's k8s service discovery has been silently broken for 17+ days
because k3s's NetworkPolicy controller evaluates egress AFTER kube-proxy's
DNAT (contrary to the k8s spec). Pod → ClusterIP 10.43.0.1:443 was
DNAT'd to <node_public_ip>:6443, and the resulting :6443 destination
matched none of vmagent's egress rules → TCP RST → "connection refused"
on every SD watch attempt. Grafana panels using kube_* or up{} metrics
returned empty as a result.
Changes:
- network-policies.yaml: commit the previously-cluster-only NetPols
(allow-egress-from-vmagent, allow-vmagent-to-api) so a fresh deploy
produces a working cluster. The vmagent egress rule now includes :6443
to public IPs (the post-DNAT path) and :8080 to the pod CIDR (for
scraping kube-state-metrics).
- observability/kube-state-metrics.yaml: new manifest. Provides the
kube_pod_*, kube_deployment_*, kube_service_* metrics that Grafana
panels need to count pods, replicas, etc. Runs in kube-system with
cluster-scoped RBAC.
- observability/vmagent.yaml:
* add kube-state-metrics scrape job to the ConfigMap
* add vmagent-kube-system Role+RoleBinding so cross-namespace SD works
* replace the misleading liveness probe (was /-/healthy, which lies
while SD is broken) with an exec probe that checks /api/v1/targets
for at least one healthy target — automatic recovery from future
stale-SD incidents
- scripts/03-deploy.sh: actually apply network-policies.yaml (was
committed but never applied) and apply kube-state-metrics.yaml.
- RUNBOOK.md (new): documents the post-DNAT gotcha, the liveness probe
trap, bearer-token recovery procedure, drift-detection diff, and a
post-redeploy verification checklist.
- .gitignore: cover kubeconfig.tunnel (created during SSH-tunnelled
kubectl sessions) so admin client cert can't be committed by accident.
Verified via kubectl --dry-run on all three modified manifests.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
251 lines
7.2 KiB
YAML
251 lines
7.2 KiB
YAML
# vmagent — scrapes Prometheus /metrics from in-cluster services and
|
|
# remote-writes them to https://obs.88oakapps.com/api/v1/write
|
|
# (VictoriaMetrics on 88oakappsUpdate, fronted by Cloudflare + nginx
|
|
# bearer-token auth). Single replica is fine — vmagent buffers locally
|
|
# during transient remote outages.
|
|
|
|
---
|
|
apiVersion: v1
|
|
kind: ConfigMap
|
|
metadata:
|
|
name: vmagent-config
|
|
namespace: honeydue
|
|
labels:
|
|
app.kubernetes.io/name: vmagent
|
|
app.kubernetes.io/part-of: honeydue
|
|
data:
|
|
scrape.yaml: |
|
|
global:
|
|
scrape_interval: 15s
|
|
external_labels:
|
|
cluster: honeydue-k3s
|
|
environment: prod
|
|
|
|
scrape_configs:
|
|
# honeyDue Go API — exposes /metrics on :8000
|
|
- job_name: api
|
|
kubernetes_sd_configs:
|
|
- role: pod
|
|
namespaces:
|
|
names: [honeydue]
|
|
relabel_configs:
|
|
- source_labels: [__meta_kubernetes_pod_label_app_kubernetes_io_name]
|
|
action: keep
|
|
regex: api
|
|
- source_labels: [__meta_kubernetes_pod_container_port_number]
|
|
action: keep
|
|
regex: "8000"
|
|
- source_labels: [__meta_kubernetes_pod_name]
|
|
target_label: pod
|
|
- source_labels: [__meta_kubernetes_pod_node_name]
|
|
target_label: node
|
|
- target_label: service
|
|
replacement: api
|
|
|
|
# kube-state-metrics — cluster object state (kube_pod_*, kube_deployment_*,
|
|
# etc.) needed for Grafana panels that count pods/replicas/etc.
|
|
- job_name: kube-state-metrics
|
|
kubernetes_sd_configs:
|
|
- role: endpoints
|
|
namespaces:
|
|
names: [kube-system]
|
|
relabel_configs:
|
|
- source_labels: [__meta_kubernetes_service_label_app_kubernetes_io_name]
|
|
action: keep
|
|
regex: kube-state-metrics
|
|
- source_labels: [__meta_kubernetes_endpoint_port_name]
|
|
action: keep
|
|
regex: http-metrics
|
|
|
|
# honeyDue worker — also exposes /metrics if/when we add it.
|
|
# Keep this stanza commented until the worker has a /metrics endpoint;
|
|
# uncommented form drops scrapes silently.
|
|
# - job_name: worker
|
|
# kubernetes_sd_configs:
|
|
# - role: pod
|
|
# namespaces:
|
|
# names: [honeydue]
|
|
# relabel_configs:
|
|
# - source_labels: [__meta_kubernetes_pod_label_app_kubernetes_io_name]
|
|
# action: keep
|
|
# regex: worker
|
|
|
|
---
|
|
apiVersion: v1
|
|
kind: Secret
|
|
metadata:
|
|
name: vmagent-remote-write
|
|
namespace: honeydue
|
|
labels:
|
|
app.kubernetes.io/name: vmagent
|
|
app.kubernetes.io/part-of: honeydue
|
|
type: Opaque
|
|
stringData:
|
|
# Bearer token for obs.88oakapps.com. Provisioned at deploy time from
|
|
# deploy/prod.env (OBS_INGEST_TOKEN). The cluster-side token must match
|
|
# the token in /etc/honeydue-obs/ingest_token on 88oakappsUpdate.
|
|
bearer_token: TOKEN_PLACEHOLDER
|
|
|
|
---
|
|
apiVersion: rbac.authorization.k8s.io/v1
|
|
kind: Role
|
|
metadata:
|
|
name: vmagent
|
|
namespace: honeydue
|
|
rules:
|
|
- apiGroups: [""]
|
|
resources: [pods, services, endpoints]
|
|
verbs: [get, list, watch]
|
|
|
|
---
|
|
apiVersion: v1
|
|
kind: ServiceAccount
|
|
metadata:
|
|
name: vmagent
|
|
namespace: honeydue
|
|
|
|
---
|
|
apiVersion: rbac.authorization.k8s.io/v1
|
|
kind: RoleBinding
|
|
metadata:
|
|
name: vmagent
|
|
namespace: honeydue
|
|
subjects:
|
|
- kind: ServiceAccount
|
|
name: vmagent
|
|
namespace: honeydue
|
|
roleRef:
|
|
kind: Role
|
|
name: vmagent
|
|
apiGroup: rbac.authorization.k8s.io
|
|
|
|
---
|
|
# Allow vmagent to discover the kube-state-metrics Service/Endpoints in
|
|
# kube-system so the kube-state-metrics scrape job can find its target.
|
|
# Cross-namespace SD needs an explicit RoleBinding here.
|
|
apiVersion: rbac.authorization.k8s.io/v1
|
|
kind: Role
|
|
metadata:
|
|
name: vmagent-kube-system
|
|
namespace: kube-system
|
|
rules:
|
|
- apiGroups: [""]
|
|
resources: [services, endpoints, pods]
|
|
verbs: [get, list, watch]
|
|
|
|
---
|
|
apiVersion: rbac.authorization.k8s.io/v1
|
|
kind: RoleBinding
|
|
metadata:
|
|
name: vmagent-kube-system
|
|
namespace: kube-system
|
|
subjects:
|
|
- kind: ServiceAccount
|
|
name: vmagent
|
|
namespace: honeydue
|
|
roleRef:
|
|
kind: Role
|
|
name: vmagent-kube-system
|
|
apiGroup: rbac.authorization.k8s.io
|
|
|
|
---
|
|
apiVersion: apps/v1
|
|
kind: Deployment
|
|
metadata:
|
|
name: vmagent
|
|
namespace: honeydue
|
|
labels:
|
|
app.kubernetes.io/name: vmagent
|
|
app.kubernetes.io/part-of: honeydue
|
|
spec:
|
|
replicas: 1
|
|
strategy:
|
|
type: Recreate
|
|
selector:
|
|
matchLabels:
|
|
app.kubernetes.io/name: vmagent
|
|
template:
|
|
metadata:
|
|
labels:
|
|
app.kubernetes.io/name: vmagent
|
|
app.kubernetes.io/part-of: honeydue
|
|
spec:
|
|
serviceAccountName: vmagent
|
|
securityContext:
|
|
runAsNonRoot: true
|
|
runAsUser: 1000
|
|
fsGroup: 1000
|
|
seccompProfile:
|
|
type: RuntimeDefault
|
|
containers:
|
|
- name: vmagent
|
|
image: victoriametrics/vmagent:v1.106.1
|
|
args:
|
|
- "-promscrape.config=/etc/vmagent/scrape.yaml"
|
|
- "-remoteWrite.url=https://obs.88oakapps.com/api/v1/write"
|
|
- "-remoteWrite.bearerTokenFile=/etc/vmagent-secrets/bearer_token"
|
|
- "-remoteWrite.tmpDataPath=/tmp/vmagent"
|
|
- "-remoteWrite.maxDiskUsagePerURL=512MB"
|
|
- "-loggerLevel=INFO"
|
|
ports:
|
|
- containerPort: 8429
|
|
name: http
|
|
resources:
|
|
requests:
|
|
cpu: 25m
|
|
memory: 64Mi
|
|
limits:
|
|
cpu: 200m
|
|
memory: 256Mi
|
|
volumeMounts:
|
|
- name: config
|
|
mountPath: /etc/vmagent
|
|
readOnly: true
|
|
- name: secrets
|
|
mountPath: /etc/vmagent-secrets
|
|
readOnly: true
|
|
- name: buffer
|
|
mountPath: /tmp/vmagent
|
|
# Process startup gate. /-/healthy returns 200 once vmagent has
|
|
# parsed config — gives the agent up to 2 min to come up before
|
|
# liveness starts evaluating.
|
|
startupProbe:
|
|
httpGet:
|
|
path: /-/healthy
|
|
port: http
|
|
initialDelaySeconds: 5
|
|
periodSeconds: 5
|
|
failureThreshold: 24
|
|
# Real liveness check: are scrapes actually succeeding?
|
|
# /-/healthy was the old probe and returned 200 for 17 days even
|
|
# while vmagent had zero healthy targets (stale k8s SD watch).
|
|
# This exec probe queries vmagent's own targets API and fails if
|
|
# NO target is in state "up". Three consecutive failures (3 min)
|
|
# → kubelet kills the pod → fresh SD watch.
|
|
livenessProbe:
|
|
exec:
|
|
command:
|
|
- sh
|
|
- -c
|
|
- 'n=$(wget -qO- http://localhost:8429/api/v1/targets 2>/dev/null | grep -c ''"health":"up"''); [ "$n" -gt 0 ]'
|
|
initialDelaySeconds: 120
|
|
periodSeconds: 60
|
|
failureThreshold: 3
|
|
readinessProbe:
|
|
httpGet:
|
|
path: /-/healthy
|
|
port: http
|
|
initialDelaySeconds: 5
|
|
periodSeconds: 10
|
|
volumes:
|
|
- name: config
|
|
configMap:
|
|
name: vmagent-config
|
|
- name: secrets
|
|
secret:
|
|
secretName: vmagent-remote-write
|
|
defaultMode: 0400
|
|
- name: buffer
|
|
emptyDir:
|
|
sizeLimit: 512Mi
|