Cette page explique comment surveiller l'état des ressources personnalisées de l'opérateur Kubernetes AlloyDB Omni à l'aide de kube-state-metrics (KSM).
L'exécution de KSM avec l'opérateur Kubernetes vous permet d'effectuer les opérations suivantes:
- Surveillez l'état des ressources personnalisées en temps réel dans votre pile d'observabilité compatible avec Prometheus, ainsi que les métriques AlloyDB Omni.
- Créez des tableaux de bord et des alertes en plus des métriques de ressources personnalisées pour une meilleure visibilité opérationnelle et une détection proactive des problèmes.
Pour en savoir plus sur kube-state-metrics, consultez la section Présentation. Pour découvrir comment kube-state-metrics surveille les ressources personnalisées Kubernetes, consultez la section Métriques d'état des ressources personnalisées.
Fonctionnement des ressources personnalisées de l'opérateur Kubernetes AlloyDB Omni
Par défaut, les métriques de ressources personnalisées ne sont pas activées. Vous pouvez activer les métriques de ressources personnalisées à l'aide du chart Helm de l'opérateur Kubernetes AlloyDB Omni. Lorsque vous activez les métriques de ressources personnalisées, un déploiement KSM est créé avec un configmap
qui définit les métriques de ressources personnalisées et un service de type ClusterIP pour exposer le point de terminaison des métriques du déploiement KSM. Votre collecteur Prometheus peut collecter les métriques, et vous pouvez les visualiser avec d'autres métriques AlloyDB Omni. Pour en savoir plus, consultez la page Métriques de ressources personnalisées pour l'opérateur AlloyDB Omni Kubernetes.
Avant de commencer
Assurez-vous de disposer des éléments suivants:
- Un outil de récupération de métriques compatible avec Prometheus exécuté dans votre cluster Kubernetes.
- Accès à l'image kube-state-metrics hébergée sur
registry.k8s.io/kube-state-metrics/kube-state-metrics:v2.14.0
. Vous pouvez pré-extraire l'image vers votre registre privé. - Le gestionnaire de paquets
helm
Vous exécutez des commandes Helm dans un terminal de ligne de commande Linux.
Installer l'opérateur Kubernetes avec les métriques de ressources personnalisées activées
Vous utilisez les variables suivantes dans le graphique Helm de l'opérateur Kubernetes Omni AlloyDB pour contrôler l'installation et la suppression des métriques de ressources personnalisées:
Variable | Type | Description | Par défaut |
---|---|---|---|
|
Booléen (vrai/faux) | Active et désactive les métriques de ressources personnalisées | false (désactivation) |
|
Chaîne | Chemin d'accès complet de l'ksmImage |
|
Si vous n'avez pas encore installé le chart Helm de l'opérateur, définissez les variables lorsque vous exécutez l'installation Helm.
Pour installer l'opérateur Kubernetes avec les métriques de ressources personnalisées activées, procédez comme suit:
- Ouvrez un terminal de ligne de commande Linux.
Définissez les variables d'environnement suivantes en exécutant les commandes suivantes:
export GCS_BUCKET=alloydb-omni-operator export HELM_PATH=$(gcloud storage cat gs://$GCS_BUCKET/latest) export OPERATOR_VERSION="${HELM_PATH%%/*}"
Téléchargez l'opérateur Kubernetes AlloyDB Omni:
gcloud storage cp gs://$GCS_BUCKET/$HELM_PATH ./ --recursive
Si vous pré-extrayez l'image KSM publique à
registry.k8s.io/kube-state-metrics/kube-state-metrics:v2.14.0
dans votre registre privé, ignorez cette étape et passez à l'étape suivante. Sinon, installez l'opérateur Kubernetes AlloyDB Omni avec des métriques de ressources personnalisées, puis passez à l'étape finale de cette procédure.helm install alloydbomni-operator alloydbomni-operator-${OPERATOR_VERSION}.tgz \ --create-namespace \ --namespace alloydb-omni-system \ --set crdMetrics.enabled=true \ --atomic \ --timeout 5m
Exportez la variable d'environnement:
export KSM_IMAGE=<full path to your KSM image>
Pour installer l'opérateur AlloyDB Omni Kubernetes avec des métriques de ressources personnalisées et votre propre emplacement d'image KSM, exécutez la commande suivante:
helm install alloydbomni-operator alloydbomni-operator-${OPERATOR_VERSION}.tgz \ --create-namespace \ --namespace alloydb-omni-system \ --set crdMetrics.enabled=true,crdMetrics.ksmImage=${KSM_IMAGE} \ --atomic \ --timeout 5m
Si l'installation aboutit, le résultat suivant s'affiche:
NAME: alloydbomni-operator LAST DEPLOYED: CURRENT_TIMESTAMP NAMESPACE: alloydb-omni-system STATUS: deployed REVISION: 1 TEST SUITE: None
Nettoyez l'installation en supprimant le fichier d'installation de l'opérateur Kubernetes AlloyDB Omni téléchargé. Le fichier est nommé
alloydbomni-operator-VERSION_NUMBER.tgz
et se trouve dans votre répertoire de travail actuel.
Activer les métriques de ressources personnalisées sur un opérateur Kubernetes existant
Si vous avez déjà installé la version 1.3.0 (ou ultérieure) de l'opérateur Kubernetes AlloyDB Omni, vous pouvez activer les métriques de ressources personnalisées en mettant à niveau l'opérateur existant.
- Ouvrez un terminal de ligne de commande Linux.
Recherchez la version actuelle de l'opérateur Kubernetes AlloyDB Omni et définissez les variables d'environnement en exécutant les commandes suivantes:
export OPERATOR_VERSION=$(helm ls -n alloydb-omni-system -o json | jq -r 'map(select(.name == "alloydbomni-operator") | .chart)| .[0]') OPERATOR_VERSION=${OPERATOR_VERSION#"alloydbomni-operator-"} echo $OPERATOR_VERSION export GCS_BUCKET=alloydb-omni-operator export HELM_PATH=$OPERATOR_VERSION/alloydbomni-operator-$OPERATOR_VERSION.tgz
La sortie correspond à la version de l'opérateur Kubernetes AlloyDB Omni installée, par exemple
1.3.0
.Téléchargez l'opérateur de version spécifié:
gcloud storage cp gs://$GCS_BUCKET/$HELM_PATH ./ --recursive
Mettez à niveau l'opérateur Kubernetes AlloyDB Omni en exécutant les commandes suivantes, puis passez à l'étape finale de cette procédure. Si vous pré-extrayez l'image KSM publique à
registry.k8s.io/kube-state-metrics/kube-state-metrics:v2.14.0
dans votre registre privé, ignorez cette étape et passez directement à l'étape suivante.helm upgrade alloydbomni-operator alloydbomni-operator-${OPERATOR_VERSION}.tgz \ --namespace alloydb-omni-system \ --reuse-values \ --set crdMetrics.enabled=true \ --atomic \ --timeout 5m
Exportez la variable d'environnement:
export KSM_IMAGE=<full path to your KSM image>
Pour effectuer la mise à niveau, exécutez la commande suivante:
helm upgrade alloydbomni-operator alloydbomni-operator-${OPERATOR_VERSION}.tgz \ --namespace alloydb-omni-system \ --reuse-values \ --set crdMetrics.enabled=true,crdMetrics.ksmImage=${KSM_IMAGE} \ --atomic \ --timeout 5m
Si la migration aboutit, le résultat suivant s'affiche:
NAME: alloydbomni-operator LAST DEPLOYED: CURRENT_TIMESTAMP NAMESPACE: alloydb-omni-system STATUS: deployed REVISION: 2 TEST SUITE: None
Désactiver les métriques de ressources personnalisées sur un opérateur Kubernetes existant
- Ouvrez un terminal de ligne de commande Linux.
Exécutez la commande suivante :
export OPERATOR_VERSION=$(helm ls -n alloydb-omni-system -o json | jq -r 'map(select(.name == "alloydbomni-operator") | .chart)| .[0]') OPERATOR_VERSION=${OPERATOR_VERSION#"alloydbomni-operator-"}
Pour désactiver les métriques de ressources personnalisées, exécutez la commande suivante:
helm upgrade alloydbomni-operator alloydbomni-operator-${OPERATOR_VERSION}.tgz \ --namespace alloydb-omni-system \ --reuse-values \ --set crdMetrics.enabled=false \ --atomic \ --timeout 5m
Afficher les métriques à l'aide de l'API Prometheus
Pour afficher vos métriques, consultez Afficher les métriques à l'aide de l'API Prometheus.
Étape suivante
- Découvrez les métriques de définition des ressources personnalisées pour l'opérateur Kubernetes AlloyDB Omni.