What is the Prometheus alert rule for "Flux Kustomization Failure"?

The {{ $labels.customresource_kind }} '{{ $labels.name }}' in namespace {{ $labels.exported_namespace }} is marked as not ready. PromQL expression: gotk_resource_info{ready="False", customresource_kind="Kustomization"} > 0. Severity: warning. Duration: 15m.

What is the Prometheus alert rule for "Flux HelmRelease Failure"?

The {{ $labels.customresource_kind }} '{{ $labels.name }}' in namespace {{ $labels.exported_namespace }} is marked as not ready. PromQL expression: gotk_resource_info{ready="False", customresource_kind="HelmRelease"} > 0. Severity: warning. Duration: 15m.

⚠️

Alert thresholds depend on the nature of your applications. Some queries may have arbitrary tolerance thresholds. Building an efficient monitoring platform takes time. 😉

FluxCD Prometheus Alert Rules

4 Prometheus alerting rules for FluxCD. Exported via Embedded exporter. These rules cover critical and warning conditions — copy and paste the YAML into your Prometheus configuration.

groups:
- name: EmbeddedExporter
  rules:
    - alert: FluxKustomizationFailure
      expr: gotk_resource_info{ready="False", customresource_kind="Kustomization"} > 0
      for: 15m
      labels:
        severity: warning
      annotations:
        summary: Flux Kustomization Failure (instance {{ $labels.instance }})
        description: "The {{ $labels.customresource_kind }} '{{ $labels.name }}' in namespace {{ $labels.exported_namespace }} is marked as not ready.\n  VALUE = {{ $value }}\n  LABELS = {{ $labels }}"
    
    - alert: FluxHelmReleaseFailure
      expr: gotk_resource_info{ready="False", customresource_kind="HelmRelease"} > 0
      for: 15m
      labels:
        severity: warning
      annotations:
        summary: Flux HelmRelease Failure (instance {{ $labels.instance }})
        description: "The {{ $labels.customresource_kind }} '{{ $labels.name }}' in namespace {{ $labels.exported_namespace }} is marked as not ready.\n  VALUE = {{ $value }}\n  LABELS = {{ $labels }}"
    
    - alert: FluxSourceIssue
      expr: gotk_resource_info{ready="False", customresource_kind=~"GitRepository|HelmRepository|Bucket|OCIRepository"} > 0
      for: 15m
      labels:
        severity: warning
      annotations:
        summary: Flux Source Issue (instance {{ $labels.instance }})
        description: "Flux source {{ $labels.customresource_kind }} '{{ $labels.name }}' has issue(s).\n  VALUE = {{ $value }}\n  LABELS = {{ $labels }}"
    
    - alert: FluxImageIssue
      expr: gotk_resource_info{ready="False", customresource_kind=~"ImagePolicy|ImageRepository|ImageUpdateAutomation"} > 0
      for: 15m
      labels:
        severity: warning
      annotations:
        summary: Flux Image Issue (instance {{ $labels.instance }})
        description: "The {{ $labels.customresource_kind }} '{{ $labels.name }}' is marked as not ready.\n  VALUE = {{ $value }}\n  LABELS = {{ $labels }}"

8.3. Embedded exporter (4 rules)

wget https://raw.githubusercontent.com/samber/awesome-prometheus-alerts/refs/heads/master/dist/rules/fluxcd/embedded-exporter.yml

warning

8.3.1. Flux Kustomization Failure

The {{ $labels.customresource_kind }} '{{ $labels.name }}' in namespace {{ $labels.exported_namespace }} is marked as not ready.

- alert: FluxKustomizationFailure
  expr: gotk_resource_info{ready="False", customresource_kind="Kustomization"} > 0
  for: 15m
  labels:
    severity: warning
  annotations:
    summary: Flux Kustomization Failure (instance {{ $labels.instance }})
    description: "The {{ $labels.customresource_kind }} '{{ $labels.name }}' in namespace {{ $labels.exported_namespace }} is marked as not ready.\n  VALUE = {{ $value }}\n  LABELS = {{ $labels }}"

warning

8.3.2. Flux HelmRelease Failure

The {{ $labels.customresource_kind }} '{{ $labels.name }}' in namespace {{ $labels.exported_namespace }} is marked as not ready.

- alert: FluxHelmReleaseFailure
  expr: gotk_resource_info{ready="False", customresource_kind="HelmRelease"} > 0
  for: 15m
  labels:
    severity: warning
  annotations:
    summary: Flux HelmRelease Failure (instance {{ $labels.instance }})
    description: "The {{ $labels.customresource_kind }} '{{ $labels.name }}' in namespace {{ $labels.exported_namespace }} is marked as not ready.\n  VALUE = {{ $value }}\n  LABELS = {{ $labels }}"

warning

8.3.3. Flux Source Issue

Flux source {{ $labels.customresource_kind }} '{{ $labels.name }}' has issue(s).

- alert: FluxSourceIssue
  expr: gotk_resource_info{ready="False", customresource_kind=~"GitRepository|HelmRepository|Bucket|OCIRepository"} > 0
  for: 15m
  labels:
    severity: warning
  annotations:
    summary: Flux Source Issue (instance {{ $labels.instance }})
    description: "Flux source {{ $labels.customresource_kind }} '{{ $labels.name }}' has issue(s).\n  VALUE = {{ $value }}\n  LABELS = {{ $labels }}"

warning

8.3.4. Flux Image Issue

The {{ $labels.customresource_kind }} '{{ $labels.name }}' is marked as not ready.

- alert: FluxImageIssue
  expr: gotk_resource_info{ready="False", customresource_kind=~"ImagePolicy|ImageRepository|ImageUpdateAutomation"} > 0
  for: 15m
  labels:
    severity: warning
  annotations:
    summary: Flux Image Issue (instance {{ $labels.instance }})
    description: "The {{ $labels.customresource_kind }} '{{ $labels.name }}' is marked as not ready.\n  VALUE = {{ $value }}\n  LABELS = {{ $labels }}"

More in CI/CD

Jenkins ArgoCD GitLab CI Spinnaker