Redis

Questo documento descrive come configurare il tuo deployment Google Kubernetes Engine in modo da utilizzare Google Cloud Managed Service per Prometheus per raccogliere metriche da Redis. Questo documento illustra come procedere nel seguente modo:

• Configura l'esportatore per Redis per generare report sulle metriche.
• Configura una risorsa PodMonitoring per Managed Service per Prometheus per raccogliere le metriche esportate.
• Accedi a una dashboard in Cloud Monitoring per visualizzare le metriche.
• Configura le regole di avviso per monitorare le metriche.

Queste istruzioni si applicano solo se utilizzi la raccolta gestita con Managed Service per Prometheus. Se invece utilizzi una raccolta di cui è stato eseguito il deployment autonomo, consulta il repository del repository di origine per l'esportatore Redis per le informazioni sull'installazione.

Per informazioni su Redis, consulta la sezione Redis.

Prerequisiti

Per raccogliere metriche da Redis utilizzando Managed Service per Prometheus e la raccolta gestita, il tuo deployment deve soddisfare i seguenti requisiti:

• Il cluster deve eseguire Google Kubernetes Engine versione 1.21.4-gke.300 o successive.
• Devi eseguire Managed Service per Prometheus con la raccolta gestita abilitata. Per maggiori informazioni, consulta la Guida introduttiva alla raccolta gestita.

• Per utilizzare le dashboard disponibili in Cloud Monitoring per l'integrazione Redis, devi utilizzare la versione 1.43.1 o successive di redis_exporter.

  Per scoprire di più sulle dashboard disponibili, consulta Visualizzare le dashboard.

Installare l'esportatore Redis

Ti consigliamo di installare l'esportatore Redis, redis_exporter, come sidecar al tuo carico di lavoro Redis. Per informazioni sull'utilizzo delle sidecar, consulta Applicazioni estese su Kubernetes con pod multi-container.

Per installare redis_exporter come sidecar per Redis, modifica la tua configurazione Redis come mostrato nell'esempio seguente:

Visualizza su GitHub

# Copyright 2022 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#     https:#www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

apiVersion: apps/v1
kind: StatefulSet
metadata:
  name: redis
  labels:
    app.kubernetes.io/name: redis
spec:
  selector:
    matchLabels:
+     app.kubernetes.io/name: redis
  template:
    metadata:
      labels:
+       app.kubernetes.io/name: redis
    spec:
      containers:
      - name: redis
        image: "redis:6.2"
        ...
+     - name: redis-exporter
+       image: oliver006/redis_exporter:v1.43.1
+       args: [--include-system-metrics]
+       resources:
+         requests:
+           cpu: 100m
+           memory: 100Mi
+       ports:
+       - containerPort: 9121
    ...

Devi aggiungere alla configurazione le righe precedute dal simbolo +.

Queste istruzioni presuppongono che tu abbia già un'installazione Redis funzionante e vuoi modificarla per includere un esportatore. Se devi configurare anche Redis, puoi configurare e applicare il grafico Helm di Bitnami. Trasmetti i seguenti valori di configurazione:

• metrics.enabled = true
• metrics.podLabels = {app.kubernetes.io/name: redis}

Per applicare le modifiche alla configurazione da un file locale, esegui questo comando:

kubectl apply -n NAMESPACE_NAME -f FILE_NAME

Puoi anche utilizzare Terraform per gestire le configurazioni.

Definisci una risorsa PodMonitoring

Per il rilevamento dei target, l'operatore Managed Service per Prometheus richiede una risorsa PodMonitoring che corrisponde all'esportatore Redis nello stesso spazio dei nomi.

Puoi utilizzare la seguente configurazione di PodMonitoring:

Visualizza su GitHub

# Copyright 2022 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#     https://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

apiVersion: monitoring.googleapis.com/v1
kind: PodMonitoring
metadata:
  name: redis
  labels:
    app.kubernetes.io/name: redis
    app.kubernetes.io/part-of: google-cloud-managed-prometheus
spec:
  selector:
    matchLabels:
      app.kubernetes.io/name: redis
  endpoints:
  - port: 9121
    interval: 30s

Assicurati che i selettori delle etichette e la porta corrispondano ai selettori e alla porta utilizzati in Installare l'esportatore Redis.

Per applicare le modifiche alla configurazione da un file locale, esegui questo comando:

kubectl apply -n NAMESPACE_NAME -f FILE_NAME

Puoi anche utilizzare Terraform per gestire le configurazioni.

Definisci regole e avvisi

Puoi utilizzare la seguente configurazione Rules per definire gli avvisi sulle metriche Redis:

Visualizza su GitHub

# Copyright 2022 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#     https://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

apiVersion: monitoring.googleapis.com/v1
kind: Rules
metadata:
  name: redis-rules
  labels:
    app.kubernetes.io/component: rules
    app.kubernetes.io/name: redis-rules
    app.kubernetes.io/part-of: google-cloud-managed-prometheus
spec:
  groups:
  - name: redis
    interval: 30s
    rules:
    - alert: RedisDown
      annotations:
        description: |-
          Redis instance is down
            VALUE = {{ $value }}
            LABELS: {{ $labels }}
        summary: Redis down (instance {{ $labels.instance }})
      expr: redis_up{job="redis"} == 0
      for: 5m
      labels:
        severity: critical
    - alert: RedisOutOfMemory
      annotations:
        description: |-
          Redis is running out of memory (> 90%)
            VALUE = {{ $value }}
            LABELS: {{ $labels }}
        summary: Redis out of memory (instance {{ $labels.instance }})
      expr: redis_memory_used_bytes{job="redis"} / redis_total_system_memory_bytes{job="redis"}
        * 100 > 90
      for: 5m
      labels:
        severity: warning
    - alert: RedisTooManyConnections
      annotations:
        description: |-
          Redis instance has too many connections
            VALUE = {{ $value }}
            LABELS: {{ $labels }}
        summary: Redis too many connections (instance {{ $labels.instance }})
      expr: redis_connected_clients{job="redis"} > 100
      for: 5m
      labels:
        severity: warning
    - alert: RedisClusterSlotFail
      annotations:
        description: |-
          Redis cluster has slots fail
            VALUE = {{ $value }}
            LABELS: {{ $labels }}
        summary: Number of hash slots mapping to a node in FAIL state (instance {{ $labels.instance }})
      expr: redis_cluster_slots_fail{job="redis"} > 0
      for: 5m
      labels:
        severity: warning
    - alert: RedisClusterSlotPfail
      annotations:
        description: |-
          Redis cluster has slots pfail
            VALUE = {{ $value }}
            LABELS: {{ $labels }}
        summary: Number of hash slots mapping to a node in PFAIL state (instance {{ $labels.instance }})
      expr: redis_cluster_slots_pfail{job="redis"} > 0
      for: 5m
      labels:
        severity: warning
    - alert: RedisClusterStateNotOk
      annotations:
        description: |-
          Redis cluster is not ok
            VALUE = {{ $value }}
            LABELS: {{ $labels }}
        summary: Redis cluster state is not ok (instance {{ $labels.instance }})
      expr: redis_cluster_state{job="redis"} == 0
      for: 5m
      labels:
        severity: critical
    - expr: redis_memory_used_rss_bytes{job="redis"} / redis_memory_used_bytes{job="redis"}
      record: redis_memory_fragmentation_ratio

Per applicare le modifiche alla configurazione da un file locale, esegui questo comando:

kubectl apply -n NAMESPACE_NAME -f FILE_NAME

Puoi anche utilizzare Terraform per gestire le configurazioni.

Per maggiori informazioni sull'applicazione di regole al tuo cluster, consulta Avvisi e valutazione delle regole gestite.

Questa configurazione Rules è stata adattata dalle regole e dagli avvisi che hanno contribuito al repository redis_exporter.

Verificare la configurazione

Puoi utilizzare Metrics Explorer per verificare di aver configurato correttamente l'esportatore Redis. Cloud Monitoring potrebbe impiegare uno o due minuti per importare le metriche.

Per verificare se le metriche sono state importate, procedi nel seguente modo:

1. Nella console Google Cloud, seleziona Monitoring o fai clic sul pulsante seguente:
   Vai a Monitoring
2. Nel riquadro di navigazione, seleziona Metrics Explorer.
3. Seleziona la scheda PromQL ed esegui la seguente query:
   

   up{job="redis", cluster="CLUSTER_NAME", namespace="NAMESPACE_NAME"}
   

Visualizza dashboard

L'integrazione di Cloud Monitoring include la dashboard Panoramica di Redis Prometheus. Le dashboard vengono installate automaticamente quando configuri l'integrazione. Puoi anche visualizzare le anteprime statiche delle dashboard senza installare l'integrazione.

Per visualizzare una dashboard installata, procedi come segue:

1. Nella console Google Cloud, seleziona Monitoring o fai clic sul pulsante seguente:
   Vai a Monitoring
2. Nel pannello di navigazione, seleziona Dashboard.
3. Seleziona la scheda Elenco dashboard.
4. Scegli la categoria Integrazioni.
5. Fai clic sul nome della dashboard, ad esempio Panoramica di Redis Prometheus.

Per visualizzare un'anteprima statica della dashboard:

1. Nella console Google Cloud, seleziona Monitoring o fai clic sul pulsante seguente:
   Vai a Monitoring
2. Nel riquadro di navigazione, seleziona Integrazioni.
3. Fai clic sul filtro della piattaforma di deployment Kubernetes Engine.
4. Individua l'integrazione Redis e fai clic su Visualizza dettagli.
5. Seleziona la scheda Dashboard.

Risolvere i problemi

Per informazioni sulla risoluzione dei problemi di importazione delle metriche, consulta la sezione Problemi con la raccolta dagli esportatori in Risolvere i problemi lato importazione.