Prometheus est un système et un système de surveillance des services. Il collecte des mesures auprès de cibles configurées à intervalles donnés, évalue les expressions de règle, affiche les résultats et peut déclencher des alertes si certaines conditions sont observées comme vraies. Alertmanager gère les alertes générées par Prometheus et les achemine vers leurs points de terminaison de réception. Déployez l'extension TKG pour les modules Tanzu afin de collecter et d'afficher des mesures pour les clusters TKG 2.
Conditions requises pour les modules
Respectez les exigences suivantes pour le déploiement de l'extension Tanzu pour l'entrée Contour.
- Provisionnez un cluster TKG 2 avec une classe de stockage par défaut. Reportez-vous à la section Provisionnement de clusters TKG 2 sur le Superviseur.
Note : Prometheus nécessite une classe de stockage persistant par défaut. Si vous disposez d’un cluster TKG 2 sans classe de stockage par défaut, vous pouvez le corriger. Reportez-vous à la section Configuration de stockage persistant requise par défaut pour les modules Tanzu.
- Connectez-vous au cluster TKG 2. Reportez-vous à la section Gestion des identités et des accès pour les clusters TKG 2 sur le Superviseur.
- Conditions préalables à l'installation du module Tanzu. Reportez-vous à la section Installer les conditions préalables du module Tanzu à l'aide de Kubectl.
Composants du module Prometheus
Lme module Prometheus pour Tanzu installe plusieurs conteneurs. Pour plus d'informations, consultez
https://prometheus.io/. Le module extrait les conteneurs du registre public VMware spécifié dans le référentiel de modules.
| Conteneur | Type de ressource | Réplicas | Description |
|---|---|---|---|
prometheus-alertmanager |
Déploiement | 1 | Gère les alertes envoyées par les applications clientes, telles que le serveur Prometheus. |
prometheus-cadvisor |
DaemonSet | 5 | Analyse et expose les données d'utilisation des ressources et de performances des conteneurs en cours d'exécution. |
prometheus-kube-state-metrics |
Déploiement | 1 | Surveille l'état et la capacité du nœud, la conformité de l'ensemble de réplicas, l'état de l'espace, de la tâche et du croobob, ainsi que les demandes de ressources et les limitations. |
prometheus-node-exporter |
DaemonSet | 5 | Exportateur de mesures matérielles et de système d'exploitation exposées par les noyaux. |
prometheus-pushgateway |
Déploiement | 1 | Service qui vous permet de transférer des mesures à partir de tâches pour lesquelles le scraping est impossible. |
prometheus-server |
Déploiement | 1 | Fournit des fonctionnalités essentielles, notamment le scraping, le traitement des règles et les alertes. |
Installer le module Prometheus
Installez le module Prometheus.
- Créez la spécification
prometheus.yaml.apiVersion: v1 kind: ServiceAccount metadata: name: prometheus-sa namespace: tkg-system --- # temp apiVersion: rbac.authorization.k8s.io/v1 kind: ClusterRoleBinding metadata: name: prometheus-role-binding roleRef: apiGroup: rbac.authorization.k8s.io kind: ClusterRole name: cluster-admin subjects: - kind: ServiceAccount name: prometheus-sa namespace: tkg-system --- apiVersion: packaging.carvel.dev/v1alpha1 kind: PackageInstall metadata: name: prometheus namespace: tkg-system spec: serviceAccountName: prometheus-sa packageRef: refName: prometheus.tanzu.vmware.com versionSelection: constraints: 1.20.2+vmware.1-tkg.1-rc.2 values: - secretRef: name: prometheus-data-values --- apiVersion: v1 kind: Secret metadata: name: prometheus-data-values namespace: tkg-system stringData: values.yml: | --- prometheus: pspNames: "vmware-system-restricted" - Installez le module Prometheus.
kubectl apply -f prometheus.yaml
Paramètres de configuration Prometheus
La configuration Prometheus est définie dans
prometheus-data-values.yaml. Le tableau répertorie et décrit les paramètres disponibles.
| Paramètre | Description | Type | Par défaut |
|---|---|---|---|
| monitoring.namespace | Espace de noms dans lequel Prometheus sera déployé | string | tanzu-system-monitoring |
| monitoring.create_namespace | L'indicateur permet de savoir s'il faut créer l'espace de noms spécifié par monitoring.namespace | booléen | false |
| monitoring.prometheus_server.config.prometheus_yaml | Détails de la configuration du moniteur de cluster Kubernetes à transmettre à Prometheus | Fichier yaml | prometheus.yaml |
| monitoring.prometheus_server.config.alerting_rules_yaml | Règles d'alerte détaillées définies dans Prometheus | Fichier yaml | alerting_rules.yaml |
| monitoring.prometheus_server.config.recording_rules_yaml | Règles d'enregistrement détaillées définies dans Prometheus | Fichier yaml | recording_rules.yaml |
| monitoring.prometheus_server.service.type | Type de service pour exposer Prometheus. Valeurs prises en charge : ClusterIP | string | ClusterIP |
| monitoring.prometheus_server.enable_alerts.kubernetes_api | Activer l'alerte SLO pour l'API Kubernetes dans Prometheus | booléen | true |
| monitoring.prometheus_server.sc.aws_type | Type AWS défini pour storageclass sur AWS | string | gp2 |
| monitoring.prometheus_server.sc.aws_fsType | Type de système de fichiers AWS défini pour storageclass sur AWS | string | ext4 |
| monitoring.prometheus_server.sc.allowVolumeExpansion | Définir si l'extension de volume est autorisée pour storageclass sur AWS | booléen | true |
| monitoring.prometheus_server.pvc.annotations | Annotations de classe de stockage | mappage | {} |
| monitoring.prometheus_server.pvc.storage_class | Classe de stockage à utiliser pour la réclamation de volume persistant. Par défaut, cette valeur est nulle, et le provisionneur par défaut est utilisé | string | null |
| monitoring.prometheus_server.pvc.accessMode | Définissez le mode d'accès pour la réclamation de volume persistant. Valeurs prise en charge : ReadWriteOnce, ReadOnlyMany, ReadWriteMany | string | ReadWriteOnce |
| monitoring.prometheus_server.pvc.storage | Définir la taille de stockage pour la réclamation de volume persistant | string | 8Gi |
| monitoring.prometheus_server.deployment.replicas | Nombre de réplicas Prometheus | entier | 1 |
| monitoring.prometheus_server.image.repository | Emplacement du référentiel avec l'image Prometheus. La valeur par défaut est le registre VMware public. Modifiez cette valeur si vous utilisez un référentiel privé (par exemple, un environnement air-gapped). | string | projects.registry.vmware.com/tkg/prometheus |
| monitoring.prometheus_server.image.name | Nom de l'image Prometheus | string | prometheus |
| monitoring.prometheus_server.image.tag | Balise d'image Prometheus. Il peut être nécessaire de mettre à jour cette valeur si vous mettez à niveau la version. | string | v2.17.1_vmware.1 |
| monitoring.prometheus_server.image.pullPolicy | Stratégie d'extraction d'image Prometheus | string | IfNotPresent |
| monitoring.alertmanager.config.slack_demo | Configuration des notifications Slack pour Alertmanager | string |
slack_demo:
name: slack_demo
slack_configs:
- api_url: https://hooks.slack.com
channel: '#alertmanager-test'
|
| monitoring.alertmanager.config.email_receiver | Configuration des notifications par e-mail pour Alertmanager | string |
email_receiver:
name: email-receiver
email_configs:
- to: demo@tanzu.com
send_resolved: false
from: from-email@tanzu.com
smarthost: smtp.eample.com:25
require_tls: false
|
| monitoring.alertmanager.service.type | Type de service pour exposer Alertmanager. Valeurs prises en charge : ClusterIP | string | ClusterIP |
| monitoring.alertmanager.image.repository | Emplacement du référentiel avec l'image Alertmanager. La valeur par défaut est le registre VMware public. Modifiez cette valeur si vous utilisez un référentiel privé (par exemple, un environnement air-gapped). | string | projects.registry.vmware.com/tkg/prometheus |
| monitoring.alertmanager.image.name | Nom de l'image Alertmanager | string | alertmanager |
| monitoring.alertmanager.image.tag | Balise d'image Alertmanager. Il peut être nécessaire de mettre à jour cette valeur si vous mettez à niveau la version. | string | v0.20.0_vmware.1 |
| monitoring.alertmanager.image.pullPolicy | Stratégie d'extraction d'image Alertmanager | string | IfNotPresent |
| monitoring.alertmanager.pvc.annotations | Annotations de classe de stockage | mappage | {} |
| monitoring.alertmanager.pvc.storage_class | Classe de stockage à utiliser pour la réclamation de volume persistant. Par défaut, cette valeur est nulle et le provisionneur par défaut est utilisé. | string | null |
| monitoring.alertmanager.pvc.accessMode | Définissez le mode d'accès pour la réclamation de volume persistant. Valeurs prise en charge : ReadWriteOnce, ReadOnlyMany, ReadWriteMany | string | ReadWriteOnce |
| monitoring.alertmanager.pvc.storage | Définir la taille de stockage pour la réclamation de volume persistant | string | 2Gi |
| monitoring.alertmanager.deployment.replicas | Nombre de réplicas Alertmanager | entier | 1 |
| monitoring.kube_state_metrics.image.repository | Référentiel contenant l'image kube-state-metrics. La valeur par défaut est le registre VMware public. Modifiez cette valeur si vous utilisez un référentiel privé (par exemple, un environnement air-gapped). | string | projects.registry.vmware.com/tkg/prometheus |
| monitoring.kube_state_metrics.image.name | Nom de l'image kube-state-metrics | string | kube-state-metrics |
| monitoring.kube_state_metrics.image.tag | Balise d'image kube-state-metrics. Il peut être nécessaire de mettre à jour cette valeur si vous mettez à niveau la version. | string | v1.9.5_vmware.1 |
| monitoring.kube_state_metrics.image.pullPolicy | Stratégie d'extraction d'image kube-state-metrics | string | IfNotPresent |
| monitoring.kube_state_metrics.deployment.replicas | Nombre de réplicas kube-state-metrics | entier | 1 |
| monitoring.node_exporter.image.repository | Référentiel contenant l'image de l'exportateur de nœuds. La valeur par défaut est le registre VMware public. Modifiez cette valeur si vous utilisez un référentiel privé (par exemple, un environnement air-gapped). | string | projects.registry.vmware.com/tkg/prometheus |
| monitoring.node_exporter.image.name | Nom de l'image du exportateur de nœuds | string | node-exporter |
| monitoring.node_exporter.image.tag | Balise d'image de l'exportateur de nœuds. Il peut être nécessaire de mettre à jour cette valeur si vous mettez à niveau la version. | string | v0.18.1_vmware.1 |
| monitoring.node_exporter.image.pullPolicy | Stratégie d'extraction d'image node-exporter | string | IfNotPresent |
| monitoring.node_exporter.hostNetwork | Si cette valeur est définie sur hostNetwork: true, l'espace peut utiliser l'espace de noms réseau et les ressources réseau du nœud. |
booléen | false |
| monitoring.node_exporter.deployment.replicas | Nombre de réplicas node-exporter | entier | 1 |
| monitoring.pushgateway.image.repository | Référentiel contenant l'image pushgateway. La valeur par défaut est le registre VMware public. Modifiez cette valeur si vous utilisez un référentiel privé (par exemple, un environnement air-gapped). | string | projects.registry.vmware.com/tkg/prometheus |
| monitoring.pushgateway.image.name | Nom de l'image pushgateway | string | pushgateway |
| monitoring.pushgateway.image.tag | Balise d'image pushgateway. Il peut être nécessaire de mettre à jour cette valeur si vous mettez à niveau la version. | string | v1.2.0_vmware.1 |
| monitoring.pushgateway.image.pullPolicy | Stratégie d'extraction d'image pushgateway | string | IfNotPresent |
| monitoring.pushgateway.deployment.replicas | Nombre de réplicas pushgateway | entier | 1 |
| monitoring.cadvisor.image.repository | Référentiel contenant l'image cadvisor. La valeur par défaut est le registre VMware public. Modifiez cette valeur si vous utilisez un référentiel privé (par exemple, un environnement air-gapped). | string | projects.registry.vmware.com/tkg/prometheus |
| monitoring.cadvisor.image.name | Nom de l'image cadvisor | string | cadvisor |
| monitoring.cadvisor.image.tag | Balise d'image cadvisor. Il peut être nécessaire de mettre à jour cette valeur si vous mettez à niveau la version. | string | v0.36.0_vmware.1 |
| monitoring.cadvisor.image.pullPolicy | Stratégie d'extraction d'image cadvisor | string | IfNotPresent |
| monitoring.cadvisor.deployment.replicas | Nombre de réplicas cadvisor | entier | 1 |
| monitoring.ingress.enabled | Activer/désactiver l'entrée pour Prometheus et Alertmanager | booléen | false Pour utiliser l'entrée, définissez ce champ sur |
| monitoring.ingress.virtual_host_fqdn | Nom d'hôte pour accéder à Prometheus et Alertmanager | string | prometheus.system.tanzu |
| monitoring.ingress.prometheus_prefix | Préfixe de chemin d'accès pour Prometheus | string | / |
| monitoring.ingress.alertmanager_prefix | Préfixe de chemin d'accès pour Alertmanager | string | /alertmanager/ |
| monitoring.ingress.tlsCertificate.tls.crt | Certificat facultatif pour entrée si vous souhaitez utiliser votre propre certificat TLS. Un cert auto-signé est généré par défaut | string | Certificat généré |
| monitoring.ingress.tlsCertificate.tls.key | Clé privée de certificat facultatif pour entrée si vous souhaitez utiliser votre propre certificat TLS. | string | Clé de certificat généré |
| Paramètre | Description | Type | Par défaut |
|---|---|---|---|
| evaluation_interval | Fréquence d'évaluation des règles | durée | 1 min |
| scrape_interval | Fréquence de scraping des cibles | durée | 1 min |
| scrape_timeout | Délai d'attente avant expiration d'une demande de scraping | durée | 10 s |
| rule_files | Les fichiers de règle spécifient une liste de globs. Les règles et les alertes sont lues à partir de tous les fichiers correspondants | Fichier yaml | |
| scrape_configs | Liste des configurations de scraping. | liste | |
| job_name | Nom de la tâche attribué aux métriques de scraping par défaut | string | |
| kubernetes_sd_configs | Liste des configurations de détection de services Kubernetes. | liste | |
| relabel_configs | Liste des configurations de relabel cibles. | liste | |
| action | Action à effectuer en fonction de la correspondance regex. | string | |
| regex | Expression régulière par rapport à laquelle la valeur extraite est mises en correspondance. | string | |
| source_labels | Les étiquettes source sélectionnent des valeurs à partir d'étiquettes existantes. | string | |
| scheme | Configure le schéma de protocole utilisé pour les demandes. | string | |
| tls_config | Configure les paramètres TLS de la demande de scraping. | string | |
| ca_file | Certificat CA avec qui valider le certificat du serveur API. | filename | |
| insecure_skip_verify | Désactivez la validation du certificat de serveur. | booléen | |
| bearer_token_file | Informations d'authentification facultatives du fichier de jeton de support. | filename | |
| replacement | Valeur de remplacement par rapport à laquelle un remplacement regex est effectué si l'expression régulière correspond. | string | |
| target_label | Étiquette dans laquelle la valeur résultante est écrite dans une action de remplacement. | string |
| Paramètre | Description | Type | Par défaut |
|---|---|---|---|
| resolve_timeout | « ResolveTimeout » est la valeur par défaut utilisée par Alertmanager si l'alerte n'inclut pas « EndsAt » | durée | 5 min |
| smtp_smarthost | Hôte SMTP par lequel les e-mails sont envoyés. | durée | 1 min |
| slack_api_url | URL du Webhook Slack. | string | global.slack_api_url |
| pagerduty_url | URL pagerduty à laquelle envoyer les demandes d'API. | string | global.pagerduty_url |
| modèles | Fichiers à partir desquels les définitions de modèles de notifications personnalisées sont lues | chemin d'accès du fichier | |
| group_by | grouper les alertes par étiquette | string | |
| group_interval | Définir le temps d'attente avant l'envoi d'une notification concernant les nouvelles alertes ajoutées à un groupe | durée | 5 min |
| group_wait | Délai d'attente initiale avant l'envoi d'une notification pour un groupe d'alertes | durée | 30 s |
| repeat_interval | Délai d'attente avant de renvoyer une notification si elle a déjà été correctement envoyée pour une alerte | durée | 4 h |
| receivers | Liste de récepteurs de notification. | liste | |
| severity | Gravité de l'incident. | string | |
| channel | Canal ou utilisateur auquel envoyer des notifications. | string | |
| html | Corps HTML de la notification par e-mail. | string | |
| text | Corps du texte de la notification par e-mail. | string | |
| send_resolved | Notifier ou non les alertes résolues. | filename | |
| email_configs | Configurations pour l'intégration des e-mails | booléen |
Les annotations sur les espaces permettent un contrôle précis du processus de scraping. Ces annotations doivent faire partie des métadonnées de l'groupe. Elles n'auront aucun effet si elles sont définies sur d'autres objets, tels que Services ou DaemonSets.
| Annotation d'un espace | Description |
|---|---|
prometheus.io/scrape |
La configuration par défaut effectuera le scraping de tous les espaces et, si elle est définie sur « false », cette annotation exclura l'espace du processus de scraping. |
prometheus.io/path |
Si le chemin des métriques n'est pas « /metrics », définissez-le avec cette annotation. |
prometheus.io/port |
Effectuez le scraping de l'espace sur le port indiqué au lieu des ports déclarés de l'espace (la cible par défaut est sans port si aucun n'est déclaré). |
Le manifeste DaemonSet ci-dessous demandera à Prometheus d'effectuer le scraping de tous ses espaces sur le port 9102.
apiVersion: apps/v1beta2 # for versions before 1.8.0 use extensions/v1beta1
kind: DaemonSet
metadata:
name: fluentd-elasticsearch
namespace: weave
labels:
app: fluentd-logging
spec:
selector:
matchLabels:
name: fluentd-elasticsearch
template:
metadata:
labels:
name: fluentd-elasticsearch
annotations:
prometheus.io/scrape: 'true'
prometheus.io/port: '9102'
spec:
containers:
- name: fluentd-elasticsearch
image: gcr.io/google-containers/fluentd-elasticsearch:1.20
