🥇პრომეთე: HTTP მონიტორინგი Blackbox-ის ექსპორტიორის მეშვეობით

Სალამი ყველას. მაისში OTUS გამოდის სემინარი მონიტორინგისა და ხეების აღრიცხვის შესახებ, როგორც ინფრასტრუქტურა, ასევე აპლიკაციები Zabbix-ის, Prometheus-ის, Grafana-სა და ELK-ის გამოყენებით. ამ კუთხით, ტრადიციულად ვიზიარებთ სასარგებლო მასალას თემაზე.

Blackbox ექსპორტიორი for Prometheus გაძლევთ საშუალებას განახორციელოთ გარე სერვისების მონიტორინგი HTTP, HTTPS, DNS, TCP, ICMP საშუალებით. ამ სტატიაში მე გაჩვენებთ, თუ როგორ უნდა დააყენოთ HTTP/HTTPS მონიტორინგი Blackbox ექსპორტიორის გამოყენებით. ჩვენ გავაშვებთ Blackbox-ის ექსპორტიორს Kubernetes-ში.

გარემო

დაგვჭირდება შემდეგი:

კუბერნეტები
პრომეთეს ოპერატორი

ექსპორტიორის შავი ყუთის კონფიგურაცია

Blackbox-ის კონფიგურაცია მეშვეობით ConfigMap პარამეტრებისთვის http ვებ სერვისების მონიტორინგის მოდული.

apiVersion: v1
kind: ConfigMap
metadata:
  name: prometheus-blackbox-exporter
  labels:
    app: prometheus-blackbox-exporter
data:
  blackbox.yaml: |
    modules:
      http_2xx:
        http:
          no_follow_redirects: false
          preferred_ip_protocol: ip4
          valid_http_versions:
          - HTTP/1.1
          - HTTP/2
          valid_status_codes: []
        prober: http
        timeout: 5s

მოდული http_2xx გამოიყენება იმის შესამოწმებლად, რომ ვებ სერვისი აბრუნებს HTTP 2xx სტატუსის კოდს. შავი ყუთის ექსპორტიორის კონფიგურაცია უფრო დეტალურად არის აღწერილი დოკუმენტაცია.

შავი ყუთის ექსპორტიორის განლაგება Kubernetes კლასტერში

აღწერეთ Deployment и Service Kubernetes-ში განლაგებისთვის.

---
kind: Service
apiVersion: v1
metadata:
  name: prometheus-blackbox-exporter
  labels:
    app: prometheus-blackbox-exporter
spec:
  type: ClusterIP
  ports:
    - name: http
      port: 9115
      protocol: TCP
  selector:
    app: prometheus-blackbox-exporter

---
apiVersion: apps/v1
kind: Deployment
metadata:
  name: prometheus-blackbox-exporter
  labels:
    app: prometheus-blackbox-exporter
spec:
  replicas: 1
  selector:
    matchLabels:
      app: prometheus-blackbox-exporter
  template:
    metadata:
      labels:
        app: prometheus-blackbox-exporter
    spec:
      restartPolicy: Always
      containers:
        - name: blackbox-exporter
          image: "prom/blackbox-exporter:v0.15.1"
          imagePullPolicy: IfNotPresent
          securityContext:
            readOnlyRootFilesystem: true
            runAsNonRoot: true
            runAsUser: 1000
          args:
            - "--config.file=/config/blackbox.yaml"
          resources:
            {}
          ports:
            - containerPort: 9115
              name: http
          livenessProbe:
            httpGet:
              path: /health
              port: http
          readinessProbe:
            httpGet:
              path: /health
              port: http
          volumeMounts:
            - mountPath: /config
              name: config
        - name: configmap-reload
          image: "jimmidyson/configmap-reload:v0.2.2"
          imagePullPolicy: "IfNotPresent"
          securityContext:
            runAsNonRoot: true
            runAsUser: 65534
          args:
            - --volume-dir=/etc/config
            - --webhook-url=http://localhost:9115/-/reload
          resources:
            {}
          volumeMounts:
            - mountPath: /etc/config
              name: config
              readOnly: true
      volumes:
        - name: config
          configMap:
            name: prometheus-blackbox-exporter

Blackbox ექსპორტიორი შეიძლება განლაგდეს შემდეგი ბრძანების გამოყენებით. სახელთა სივრცე monitoring ეხება პრომეთეს ოპერატორს.

kubectl --namespace=monitoring apply -f blackbox-exporter.yaml

დარწმუნდით, რომ ყველა სერვისი მუშაობს შემდეგი ბრძანების გამოყენებით:

kubectl --namespace=monitoring get all --selector=app=prometheus-blackbox-exporter

შავი ყუთის შემოწმება

შეგიძლიათ Blackbox-ის ექსპორტიორის ვებ ინტერფეისის წვდომა port-forward:

kubectl --namespace=monitoring port-forward svc/prometheus-blackbox-exporter 9115:9115

დაუკავშირდით Blackbox-ის ექსპორტიორის ვებ ინტერფეისს ვებ ბრაუზერის მეშვეობით მისამართზე localhost: 9115.

თუ მიდიხარ მისამართზე http://localhost:9115/probe?module=http_2xx&target=https://www.google.com, დაინახავთ მითითებული URL-ის შემოწმების შედეგს (https://www.google.com).

მეტრული მნიშვნელობა probe_success 1-ის ტოლი ნიშნავს წარმატებულ შემოწმებას. მნიშვნელობა 0 მიუთითებს შეცდომაზე.

პრომეთეს დაყენება

BlackBox ექსპორტიორის განლაგების შემდეგ, ჩვენ ვაკონფიგურირებთ პრომეთეს შიგნით prometheus-additional.yaml.

- job_name: 'kube-api-blackbox'
  scrape_interval: 1w
  metrics_path: /probe
  params:
    module: [http_2xx]
  static_configs:
   - targets:
      - https://www.google.com
      - http://www.example.com
      - https://prometheus.io
  relabel_configs:
   - source_labels: [__address__]
     target_label: __param_target
   - source_labels: [__param_target]
     target_label: instance
   - target_label: __address__
     replacement: prometheus-blackbox-exporter:9115 # The blackbox exporter.

ჩვენ ვაწარმოებთ Secretშემდეგი ბრძანების გამოყენებით.

PROMETHEUS_ADD_CONFIG=$(cat prometheus-additional.yaml | base64)
cat << EOF | kubectl --namespace=monitoring apply -f -
apiVersion: v1
kind: Secret
metadata:
  name: additional-scrape-configs
type: Opaque
data:
  prometheus-additional.yaml: $PROMETHEUS_ADD_CONFIG
EOF

ჩვენ მივუთითებთ additional-scrape-configs პრომეთეს ოპერატორის გამოყენებით additionalScrapeConfigs.

kubectl --namespace=monitoring edit prometheuses k8s
...
spec:
  additionalScrapeConfigs:
    key: prometheus-additional.yaml
    name: additional-scrape-configs

ჩვენ მივდივართ პრომეთეს ვებ ინტერფეისზე და ვამოწმებთ მეტრიკასა და მიზნებს.

kubectl --namespace=monitoring port-forward svc/prometheus-k8s 9090:9090

ჩვენ ვხედავთ Blackbox-ის მეტრიკასა და მიზნებს.

შეტყობინებების წესების დამატება (გაფრთხილება)

Blackbox-ის ექსპორტიორისგან შეტყობინებების მისაღებად, პრომეთეს ოპერატორს დავამატებთ წესებს.

kubectl --namespace=monitoring edit prometheusrules prometheus-k8s-rules
...
  - name: blackbox-exporter
    rules:
    - alert: ProbeFailed
      expr: probe_success == 0
      for: 5m
      labels:
        severity: error
      annotations:
        summary: "Probe failed (instance {{ $labels.instance }})"
        description: "Probe failedn  VALUE = {{ $value }}n  LABELS: {{ $labels }}"
    - alert: SlowProbe
      expr: avg_over_time(probe_duration_seconds[1m]) > 1
      for: 5m
      labels:
        severity: warning
      annotations:
        summary: "Slow probe (instance {{ $labels.instance }})"
        description: "Blackbox probe took more than 1s to completen  VALUE = {{ $value }}n  LABELS: {{ $labels }}"
    - alert: HttpStatusCode
      expr: probe_http_status_code <= 199 OR probe_http_status_code >= 400
      for: 5m
      labels:
        severity: error
      annotations:
        summary: "HTTP Status Code (instance {{ $labels.instance }})"
        description: "HTTP status code is not 200-399n  VALUE = {{ $value }}n  LABELS: {{ $labels }}"
    - alert: SslCertificateWillExpireSoon
      expr: probe_ssl_earliest_cert_expiry - time() < 86400 * 30
      for: 5m
      labels:
        severity: warning
      annotations:
        summary: "SSL certificate will expire soon (instance {{ $labels.instance }})"
        description: "SSL certificate expires in 30 daysn  VALUE = {{ $value }}n  LABELS: {{ $labels }}"
    - alert: SslCertificateHasExpired
      expr: probe_ssl_earliest_cert_expiry - time()  <= 0
      for: 5m
      labels:
        severity: error
      annotations:
        summary: "SSL certificate has expired (instance {{ $labels.instance }})"
        description: "SSL certificate has expired alreadyn  VALUE = {{ $value }}n  LABELS: {{ $labels }}"
    - alert: HttpSlowRequests
      expr: avg_over_time(probe_http_duration_seconds[1m]) > 1
      for: 5m
      labels:
        severity: warning
      annotations:
        summary: "HTTP slow requests (instance {{ $labels.instance }})"
        description: "HTTP request took more than 1sn  VALUE = {{ $value }}n  LABELS: {{ $labels }}"
    - alert: SlowPing
      expr: avg_over_time(probe_icmp_duration_seconds[1m]) > 1
      for: 5m
      labels:
        severity: warning
      annotations:
        summary: "Slow ping (instance {{ $labels.instance }})"
        description: "Blackbox ping took more than 1sn  VALUE = {{ $value }}n  LABELS: {{ $labels }}"

პრომეთეს ვებ ინტერფეისში გადადით Status => Rules და იპოვეთ გაფრთხილების წესები blackbox-exporter-ისთვის.

მიმდინარეობს Kubernetes API სერვერის SSL სერთიფიკატის ვადის გასვლის შეტყობინებების კონფიგურაცია

მოდით დავაკონფიგურიროთ Kubernetes API Server SSL სერტიფიკატის ვადის გასვლის მონიტორინგი. ის აგზავნის შეტყობინებებს კვირაში ერთხელ.

შავი ყუთის ექსპორტიორის მოდულის დამატება Kubernetes API სერვერის ავთენტიფიკაციისთვის.

kubectl --namespace=monitoring edit configmap prometheus-blackbox-exporter
...
      kube-api:
        http:
          method: GET
          no_follow_redirects: false
          preferred_ip_protocol: ip4
          tls_config:
            insecure_skip_verify: false
            ca_file: /var/run/secrets/kubernetes.io/serviceaccount/ca.crt
          bearer_token_file: /var/run/secrets/kubernetes.io/serviceaccount/token
          valid_http_versions:
          - HTTP/1.1
          - HTTP/2
          valid_status_codes: []
        prober: http
        timeout: 5s

Prometheus scrape-ის კონფიგურაციის დამატება

- job_name: 'kube-api-blackbox'
  metrics_path: /probe
  params:
    module: [kube-api]
  static_configs:
   - targets:
      - https://kubernetes.default.svc/api
  relabel_configs:
   - source_labels: [__address__]
     target_label: __param_target
   - source_labels: [__param_target]
     target_label: instance
   - target_label: __address__
     replacement: prometheus-blackbox-exporter:9115 # The blackbox exporter.

პრომეთეს საიდუმლოს გამოყენება

PROMETHEUS_ADD_CONFIG=$(cat prometheus-additional.yaml | base64)
cat << EOF | kubectl --namespace=monitoring apply -f -
apiVersion: v1
kind: Secret
metadata:
  name: additional-scrape-configs
type: Opaque
data:
  prometheus-additional.yaml: $PROMETHEUS_ADD_CONFIG
EOF

გაფრთხილების წესების დამატება

kubectl --namespace=monitoring edit prometheusrules prometheus-k8s-rules
...
  - name: k8s-api-server-cert-expiry
    rules:
    - alert: K8sAPIServerSSLCertExpiringAfterThreeMonths
      expr: probe_ssl_earliest_cert_expiry{job="kube-api-blackbox"} - time() < 86400 * 90 
      for: 1w
      labels:
        severity: warning
      annotations:
        summary: "Kubernetes API Server SSL certificate will expire after three months (instance {{ $labels.instance }})"
        description: "Kubernetes API Server SSL certificate expires in 90 daysn  VALUE = {{ $value }}n  LABELS: {{ $labels }}"

სასარგებლო ბმულები

მონიტორინგი და შესვლა Docker-ში

წყარო: www.habr.com

პრომეთე: HTTP მონიტორინგი Blackbox ექსპორტიორის მეშვეობით