Verzameling prometheus-metrische gegevens van uw Kubernetes-cluster aanpassen met behulp van ConfigMap

Wanneer u verzameling prometheus-metrische gegevens van uw Kubernetes-cluster inschakelt, wordt er een standaardverzameling gebruikt om te bepalen welke metrische gegevens moeten worden verzameld. In dit artikel wordt beschreven hoe u deze verzameling kunt aanpassen aan uw specifieke bewakingsvereisten.

Configuratiekaart

De volgende ConfigMap wordt gebruikt voor het configureren van de scrape-configuratie en andere instellingen voor de invoegtoepassing met metrische gegevens. Deze ConfigMap bestaat niet standaard in het cluster wanneer Managed Prometheus is ingeschakeld.

Wijzig de instellingen in de ConfigMap op basis van de onderstaande richtlijnen en pas deze vervolgens toe met behulp van de volgende opdracht. AMA-Metrics pods zullen ze oppikken en binnen 2-3 minuten opnieuw opstarten om de opgegeven configuratie-instellingen toe te passen.

kubectl apply -f .\ama-metrics-settings-configmap.yaml

Standaarddoelen in- en uitschakelen

De standaardconfiguratie voor metrische prometheus-gegevens in Azure Monitor bevat de standaarddoelen en metrische gegevens die standaard worden verzameld vanuit uw Kubernetes-cluster. Als u scraping van een van deze doelen wilt in- of uitschakelen, werkt u de instelling voor het doel in de default-scrape-settings-enabled sectie van de ConfigMap bij naar true of false.

Bijvoorbeeld, om scraping van coredns, die standaard is uitgeschakeld, in te schakelen, werkt u de instelling als volgt bij:

default-scrape-settings-enabled: |-
    kubelet = true
    coredns = true
    cadvisor = true
    kubeproxy = false
    ...

Intervalinstellingen voor knipsel

Het standaard scrape-interval voor alle standaarddoelen is 30 seconden. Als u dit interval voor een doel wilt wijzigen, kunt u de instelling bijwerken in de default-targets-scrape-interval-settings sectie van de ConfigMap.

Als u bijvoorbeeld het scrape-interval voor kubelet 60 seconden wilt wijzigen, werkt u de instelling als volgt bij:

default-targets-scrape-interval-settings: |-
    kubelet = "60s"
    coredns = "30s"
    cadvisor = "30s"
    ...

Scraping op basis van podannotatie inschakelen

Voeg aantekeningen toe aan de pods in uw cluster om toepassingspods te scrapen zonder een aangepaste Prometheus-configuratie te maken. Als u scraping-pods met specifieke aantekeningen wilt inschakelen, voegt u de regex toe voor de naamruimten van de pods met aantekeningen waarnaar u wilt scrapen podannotationnamespaceregex in de podannotationnamespaceregex sectie van de ConfigMap.

Met de volgende instelling worden bijvoorbeeld pods met aantekeningen alleen in de naamruimten kube-system geschraapt en my-namespace:

pod-annotation-based-scraping: |-
    podannotationnamespaceregex = "kube-system|my-namespace"

Voeg aantekeningen toe aan de metadata sectie van de ConfigMap. prometheus.io/scrape: "true" is vereist voor het uitlezen van de pod, terwijl prometheus.io/path en prometheus.io/port de poort en het pad aangeven waarop de metrics op de pod gehost worden. In het volgende voorbeeld worden aantekeningen gedefinieerd voor een pod waarop metrische gegevens worden gehost.<pod IP>:8080/metrics

metadata:   
  annotations:
    prometheus.io/scrape: 'true'
    prometheus.io/path: '/metrics'
    prometheus.io/port: '8080'

Metrische gegevens aanpassen die standaard door doelen worden verzameld

Er worden alleen minimale metrische gegevens verzameld voor standaarddoelen, zoals beschreven in minimaal opnameprofiel voor metrische prometheus-gegevens in Azure Monitor. Als u alle metrische gegevens van standaarddoelen wilt verzamelen, stelt u deze in minimalingestionprofilefalse de default-targets-metrics-keep-list sectie van de ConfigMap in.

minimalingestionprofile = false

U kunt ook metrische gegevens toevoegen die voor elk standaarddoel moeten worden verzameld door de keep-lists onder default-targets-metrics-keep-listbij te werken.

Bijvoorbeeld, kubelet is de instelling voor het filteren van metrische gegevens voor de standaard kubelet. Gebruik het volgende script om te filteren in metrische gegevens die zijn verzameld voor de standaarddoelen met behulp van filteren op basis van regex.

kubelet = "metricX|metricY"
apiserver = "mymetric.*"

Als u standaarddoelen verder wilt aanpassen om eigenschappen zoals verzamelingsfrequentie of labels te wijzigen, moet u dat doel deactiveren door de waarde in te stellen op false. Maak vervolgens een aangepaste taak voor het doel, zoals beschreven in Aanpassen van het scrapen van Prometheus-gegevens in Azure Monitor.

Clusteralias

Het laatste deel van de resource-id van het cluster wordt toegevoegd aan elke tijdreeks om de gegevens uniek te identificeren. Als de resource-ID bijvoorbeeld /subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/rg-name/providers/Microsoft.ContainerService/managedClusters/myclustername is, is het clusterlabel myclustername. Als u dit clusterlabel wilt overschrijven, werkt u de instelling cluster_alias bij onder prometheus-collector-settings.

  prometheus-collector-settings: |-
    cluster_alias = ""

Foutopsporingsmodus

Als u alle metrische gegevens wilt weergeven die worden opgehaald voor foutopsporingsdoeleinden, kan de metrische gegevens add-on agent worden geconfigureerd om in de foutopsporingsmodus uit te voeren door de instelling enabled naar true te wijzigen onder de debug-mode instelling.

Volgende stappen

Waarschuwingen instellen voor metrische gegevens van Prometheus
Metrische gegevens van Prometheus opvragen
Meer informatie over het verzamelen van metrische prometheus-gegevens