Prometheus Builders

Prometheus Builders - Prometheus Operator CRD Constructors

The prometheus package provides strongly-typed constructor functions for creating Prometheus Operator Kubernetes resources. These are the low-level building blocks used by Kure’s higher-level stack and workflow packages.

Overview

Each function takes a configuration struct and returns a fully initialized Prometheus Operator custom resource. The builders handle API version and kind metadata, letting you focus on the resource specification.

Supported Resources

ServiceMonitor

import "github.com/go-kure/kure/pkg/kubernetes/prometheus"

sm := prometheus.ServiceMonitor(&prometheus.ServiceMonitorConfig{
    Name:      "my-app",
    Namespace: "monitoring",
    Selector:  metav1.LabelSelector{
        MatchLabels: map[string]string{"app": "my-app"},
    },
    Endpoints: []monitoringv1.Endpoint{
        {Path: "/metrics", Port: "http", Interval: "30s"},
    },
    JobLabel:     "app",
    TargetLabels: []string{"app", "version"},
})

Field	Type	Description
`Name`	`string`	Resource name
`Namespace`	`string`	Resource namespace
`Selector`	`metav1.LabelSelector`	Label selector for target Services
`Endpoints`	`[]monitoringv1.Endpoint`	Scrape endpoint configurations
`JobLabel`	`string`	Label to use as the Prometheus `job` label
`TargetLabels`	`[]string`	Service labels to transfer to scraped metrics
`NamespaceSelector`	`*monitoringv1.NamespaceSelector`	Namespaces to select Services from
`SampleLimit`	`*uint64`	Per-scrape sample limit
`Labels`	`map[string]string`	Additional labels for the resource

PodMonitor

pm := prometheus.PodMonitor(&prometheus.PodMonitorConfig{
    Name:      "my-app",
    Namespace: "monitoring",
    Selector:  metav1.LabelSelector{
        MatchLabels: map[string]string{"app": "my-app"},
    },
    PodMetricsEndpoints: []monitoringv1.PodMetricsEndpoint{
        {Path: "/metrics", Port: "http", Interval: "30s"},
    },
})

Field	Type	Description
`Name`	`string`	Resource name
`Namespace`	`string`	Resource namespace
`Selector`	`metav1.LabelSelector`	Label selector for target Pods
`PodMetricsEndpoints`	`[]monitoringv1.PodMetricsEndpoint`	Scrape endpoint configurations
`JobLabel`	`string`	Label to use as the Prometheus `job` label
`PodTargetLabels`	`[]string`	Pod labels to transfer to scraped metrics
`NamespaceSelector`	`*monitoringv1.NamespaceSelector`	Namespaces to select Pods from
`SampleLimit`	`*uint64`	Per-scrape sample limit
`Labels`	`map[string]string`	Additional labels for the resource

PrometheusRule

rule := prometheus.PrometheusRule(&prometheus.PrometheusRuleConfig{
    Name:      "alerts",
    Namespace: "monitoring",
    Labels:    map[string]string{"role": "alert-rules"},
    Groups: []monitoringv1.RuleGroup{
        {
            Name: "my-app.rules",
            Rules: []monitoringv1.Rule{
                {
                    Alert: "HighErrorRate",
                    Expr:  intstr.FromString(`rate(http_requests_total{code=~"5.."}[5m]) > 0.1`),
                    For:   (*monitoringv1.Duration)(ptr("5m")),
                },
            },
        },
    },
})

Field	Type	Description
`Name`	`string`	Resource name
`Namespace`	`string`	Resource namespace
`Groups`	`[]monitoringv1.RuleGroup`	Rule groups containing alert and recording rules
`Labels`	`map[string]string`	Additional labels for the resource

Modifier Functions

Update existing resources after construction:

// ServiceMonitor modifiers
prometheus.AddServiceMonitorEndpoint(sm, monitoringv1.Endpoint{Path: "/metrics", Port: "http"})
prometheus.SetServiceMonitorJobLabel(sm, "app")
prometheus.AddServiceMonitorTargetLabel(sm, "version")
prometheus.SetServiceMonitorNamespaceSelector(sm, monitoringv1.NamespaceSelector{Any: true})
prometheus.SetServiceMonitorSampleLimit(sm, 10000)

// PodMonitor modifiers
prometheus.AddPodMonitorEndpoint(pm, monitoringv1.PodMetricsEndpoint{Path: "/metrics", Port: "http"})
prometheus.SetPodMonitorJobLabel(pm, "app")
prometheus.AddPodMonitorPodTargetLabel(pm, "version")
prometheus.SetPodMonitorNamespaceSelector(pm, monitoringv1.NamespaceSelector{Any: true})
prometheus.SetPodMonitorSampleLimit(pm, 10000)

// PrometheusRule modifiers
prometheus.AddPrometheusRuleGroup(rule, monitoringv1.RuleGroup{Name: "extra.rules"})

kubernetes-builders - Core Kubernetes resource constructors