Checkmk
to checkmk.com
Important

This is a machine translation based on the English version of the article. It might or might not have already been subject to text preparation. If you find errors, please file a GitHub issue that states the paragraph that has to be improved.

1. Introduction

logo aws

Checkmk comprend un module complet pour la supervision d'Amazon Web Services (AWS), composé d'un connecteur vers AWS et d'une collection exhaustive de plugins de supervision qui récupèrent et évaluent pour vous diverses métriques et états.

Outre les informations générales sur les coûts générés par votre environnement AWS et l'état actuel d'AWS dans votre région, vous pouvez surveiller les produits AWS suivants avec toutes les éditions de Checkmk :

Avec l'CSE Checkmk Ultimate, vous pouvez également intégrer les produits suivants à votre système de supervision :

Vous trouverez la liste complète de tous les plugins de supervision disponibles pour la supervision d'AWS dans notre Catalogue de plugins de supervision. Nous décrivons également comment intégrer vos clusters Amazon EKS (Amazon Elastic Kubernetes Service) dans Checkmk dans l'article Surveillance de Kubernetes.

2. Configuration de la supervision via la configuration rapide (facultatif)

La manière la plus rapide de configurer une supervision claire et intuitive pour les environnements AWS consiste à utiliser notre Configuration rapide. Pour ce faire, rendez-vous sur Setup > Quick Setup > Amazon Web Services (AWS) et cliquez sur « Add configuration ». La Configuration rapide vous guidera ensuite pas à pas jusqu’à votre objectif.

Vous trouverez des instructions détaillées sur la manière d'effectuer les préparatifs nécessaires dans votre environnement AWS dans le chapitre « Préparation d'AWS pour Checkmk ».

Le principal avantage de la Configuration rapide réside sans aucun doute dans le fait que toute erreur est immédiatement signalée pendant le processus de configuration. Au pire, vous recevrez alors une indication claire et précise de ce que vous devez corriger avant de pouvoir passer à l'étape suivante.

Si vous souhaitez ou devez modifier ultérieurement la configuration créée par la Configuration rapide, vous pouvez revenir sur Setup > Quick Setup. Cliquez ensuite sur l’icône « icon edit » (Edition de la configuration), puis sélectionnez le composant que vous souhaitez modifier.

Tip

Les autres chapitres de cet article sont uniquement destinés à servir de référence aux utilisateurs de la Configuration rapide. Toutefois, si votre environnement AWS est assez complexe, il est recommandé de poursuivre la configuration en suivant les étapes suivantes.

3. Mise en œuvre concrète de la supervision AWS

3.1. Ordinateurs hôtes et services

Dans Checkmk, tous les objets à surveiller sont organisés selon une structure hiérarchique d’ordinateurs hôtes et de services. Le concept d’ordinateur hôte n’existe pas dans les services basés sur le cloud. Toutefois, afin de préserver la simplicité et la cohérence de Checkmk, nous continuons à effectuer l’affectation des objets AWS selon le schéma hôte/service.

Un exemple permet d’illustrer au mieux comment cela est réalisé : dans une région, plusieurs instances EC2 ont été configurées. Une instance EC2 est généralement associée à un volume EBS. Cette configuration se présente ainsi dans Checkmk :

  • Il existe un ordinateur hôte correspondant au compte AWS. Cet ordinateur hôte offre un aperçu de toutes les instances EC2 et de leur état en tant que service.

  • Les instances EC2 elles-mêmes constituent leurs propres ordinateurs hôtes.

  • Sur ces ordinateurs hôtes EC2, vous trouverez des services avec les métriques réelles.

  • Les EBS sont interprétés comme un type de disque dur et fournissent donc des métriques d'E/S (par exemple, le nombre d'octets lus ou écrits). À cette fin, dans chaque EBS, il existe des services distincts dans Checkmk portant le nom « AWS/EBS Disk IO », qui sont affectés à l'instance EC2.

3.2. Accès à AWS

AWS fournit une API basée sur HTTP via laquelle les données de surveillance sont également disponibles. Checkmk accède à cette API via l’agent spécial « agent_aws » — qui remplace l’agent Checkmk — mais, contrairement à ce dernier, cet agent s’exécute localement sur le serveur Checkmk.

4. Préparation d'AWS pour Checkmk

4.1. Création d'un utilisateur

Pour activer la supervision via Checkmk, il est préférable de créer un utilisateur AWS dédié sous votre compte root. Connectez-vous à AWS en tant qu’utilisateur root, puis accédez à All services et rendez-vous dans la section « Security, Identity, & Compliance > IAM » (Gestion des identités et des accès). Rendez-vous à l’adresse Users et créez un nouvel utilisateur en cliquant sur « Add user ». Choisissez comme nom d’utilisateur, par exemple, check-mk. Il est important de sélectionner l’Access key - Programmatic accesse « Select AWS credential type ».

aws create user

4.2. Autorisations

L'utilisateur que vous venez de créer ne doit servir qu'à la supervision par Checkmk et n'a besoin que d'un accès en lecture seule à AWS. Nous vous recommandons d'attribuer simplement la directive « ReadOnlyAccess » à cet utilisateur. Pour trouver cette directive, cliquez d'abord sur « Attach existing policies directly », puis saisissez « readonlyaccess » dans le champ de recherche. Dans la liste située sous le champ de recherche, vous devrez faire défiler la page assez loin vers le bas, car il existe un certain nombre de directives contenant cette chaîne de caractères.

aws create user policies

4.3. Clés

Une fois la création de l'utilisateur terminée, une clé d'accès sera générée automatiquement pour vous. Important : le secret de la clé n'est affiché qu'une seule fois, immédiatement après sa création. Veillez donc à copier la clé et à l'enregistrer, par exemple dans le coffre-fort à mot de passe de Checkmk. Vous pouvez également la spécifier en texte clair dans une règle (voir ci-dessous). Pour Checkmk, vous avez besoin de l'Access key ID, en plus du secret. Le nom de l'utilisateur (dans notre exemple check-mk) n'a ici aucune importance.

aws create user key

Si, pour une raison quelconque, vous deviez perdre le secret, vous pouvez créer une nouvelle clé d'accès pour l'utilisateur et obtenir un nouveau secret :

aws create access key

4.4. Accès aux informations de facturation

Si vous souhaitez que Checkmk dispose d'un accès en lecture aux informations de facturation (afin d'effectuer la vérification globale « Costs and Usage »), vous avez besoin d'une autre directive pour votre utilisateur AWS — une directive que vous devez d'abord définir vous-même.

Sous « Security, Identity, & Compliance > IAM > Policies », sélectionnez le bouton « Create Policy ». Sélectionnez le service « Billing » dans « Select a Service > Service > Choose a Service ». Sous « Actions », cochez la case à cocher « Read ». Nous devons définir une autorisation supplémentaire. Ajoutez-en une via le bouton « Add additional permissions ». Sélectionnez le service « Cost Explorer Service » dans « Select a Service > Service > Choose a Service ». Sous « Actions », cochez à nouveau la case à cocher « Read ».

aws policies

Cliquez sur « Review » pour passer à l'étape 2. Définissez « BillingViewAccess » comme « Name », puis enregistrez-le à l'aide du bouton « Create policy ».

Vous devez maintenant ajouter cette nouvelle directive à l'utilisateur. Accédez à nouveau à « Security, Identity, & Compliance > IAM > Policies » (Gérer les directives) — dans la case de recherche « Filter Policies » (Directive de gestion des utilisateurs et des ordinateurs), recherchez « BillingViewAccess » (Directive de gestion des utilisateurs et des ordinateurs), sélectionnez-la en cliquant sur le cercle à gauche, puis cliquez sur « Policy actions > Attach » (Appliquer). Vous trouverez ici votre utilisateur « check-mk » ; sélectionnez-le et confirmez en cliquant sur « Attach policy » (Appliquer).

5. Configuration de la supervision dans Checkmk

5.1. Création d'un ordinateur hôte pour AWS

Créez maintenant un hôte pour surveiller AWS dans Checkmk. Vous pouvez attribuer le nom de domaine de votre choix. Important : comme AWS, en tant que service, ne dispose ni d'adresse IP ni de nom DNS (l'accès est accordé par l'agent spécial lui-même), vous devez définir l'IP address familye sur No IP.

monitoring aws add host no ip

5.2. Configuration de l'agent AWS

AWS ne peut pas être interrogé via l'agent Checkmk standard ; vous devez donc configurer l'agent spécial AWS. Pour ce faire, sous « Setup > Agents > VM, cloud, container > Amazon Web Services (AWS) », ajoutez une règle dont les conditions s'appliquent uniquement à l'hôte AWS que vous venez de créer.

Dans le contenu de la règle, vous trouverez tout d’abord les informations de login. Saisissez ici l’« Access key ID » de l’utilisateur AWS nouvellement créé check-mk. Indiquez également ici si vous avez besoin d’un proxy pour récupérer les données et quelles données globales vous souhaitez soumettre à la supervision, c’est-à-dire celles qui sont indépendantes d’une région. Il s’agit actuellement uniquement des données relatives aux coûts :

aws rule 1

Sur l'image ci-dessus, vous pouvez également voir l'option « Use STS AssumeRole to assume a different IAM role ». Si vous utilisez différents comptes sur AWS, vous pouvez utiliser un seul utilisateur de supervision pour surveiller également les autres comptes.

Mais les données vraiment intéressantes sont attribuées à des régions. Sélectionnez donc ici votre ou vos régions AWS :

aws rule 2

Sous « Services by region to monitor », vous spécifiez les informations que vous souhaitez récupérer à partir de ces régions. Par défaut, tous les services AWS et la supervision de leurs limites sont activés. Dans l'image suivante, tous sauf un sont désactivés afin d'obtenir un meilleur aperçu :

aws rule 3

Vous pouvez désormais limiter les données récupérées par service web ou de manière globale via « Restrict monitoring services by one of these AWS tags ». La restriction globale sera remplacée si vous appliquez une restriction par service web. De plus, vous avez non seulement la possibilité de limiter par balises AWS, mais également de spécifier des noms explicites :

aws rule 4

N'oubliez pas d'attribuer l'agent spécial à l'ordinateur hôte créé précédemment en saisissant ce nom de domaine dans Conditions > Explicit hosts.

5.3. Services sur l'ordinateur hôte AWS lui-même

Passez maintenant à la reconnaissance du service de l'ordinateur hôte AWS nouvellement créé dans Checkmk, où Checkmk devrait désormais trouver plusieurs services. Une fois les services ajoutés et les modifications activées, la supervision se présentera comme suit :

aws services ec

5.4. Création d'ordinateurs hôtes pour les instances EC2

Les services attribués aux instances EC2 ne sont pas affectés à l’hôte AWS, mais à ce que l’on appelle des hôtes « ferroutés ». Le fonctionnement est le suivant : les données récupérées depuis l’hôte AWS sont distribuées à ces hôtes « ferroutés », qui fonctionnent sans agents de supervision propres. Un hôte « ferrouté » est attribué à chaque instance EC2.

Pour la dénomination de ces hôtes ferroutés, vous pouvez choisir entre deux schémas lors de la configuration de l’agent spécial. D’une part, vous pouvez nommer les hôtes en fonction de leur nom DNS d’adresse IP privée, ou bien vous pouvez opter pour une dénomination un peu plus longue mais unique, basée sur l’adresse IP, la région et l’ID d’instance. Cette dernière variante est notre paramètre par défaut depuis la version Checkmk 2.2.0. La variante sans région ni ID d'instance n'est proposée que pour des raisons de compatibilité. Un tel hôte ferrouté pourrait ainsi être nommé 172.23.1.123-ap-northeast-2-i-0b16121900a32960c, par exemple. Créez ces hôtes manuellement ou, si possible, confiez cette tâche à la gestion dynamique des hôtes.

Configuration de la gestion dynamique des hôtes

CEE En tant qu’utilisateur de l’une de nos éditions commerciales, vous pouvez simplement confier la création et la suppression des ordinateurs hôtes pour vos instances de VM à la gestion dynamique des hôtes. L’entrée « Setup > Hosts > Dynamic host management » vous mène à la page d’aperçu de toutes les connexions déjà configurées. Cliquez sur « icon new » Add connection puis attribuez à la connexion un « ID » et un « Title ».

Toutes les options disponibles dans l'Connection properties ne sont pas abordées ci-dessous. Consultez l'aide en ligne et l'article principal lié ci-dessus si vous avez des questions.

Tout d'abord, assurez-vous que le mode Show more est activé dans la case de dialogue « Connection properties » afin que toutes les options disponibles s'affichent.

Ensuite, sous « Piggyback creation options », cliquez sur « Add new element ». Personnalisez le dossier dans lequel les ordinateurs hôtes de vos instances de VM doivent être créés. Les paramètres prédéfinis (Host attributes) sont globalement corrects pour les hôtes ferroutés et n’ont pas vraiment besoin d’être modifiés.

En activant l’option « Delete vanished hosts », vous vous assurez que les hôtes ferroutés pour lesquels aucune nouvelle donnée n’est reçue pendant une période de temps spécifiée seront automatiquement supprimés.

Dans le cadre de la supervision de vos projets GCP, l'option « Restrict source hosts » doit être activée. Saisissez votre ordinateur hôte GCP à partir de la section « Création d'un ordinateur hôte pour AWS » ici.

À titre d'exemple, la configuration d'une telle connexion pourrait alors ressembler à ceci :

Exemplary configuration of connection properties.

Création manuelle d'ordinateurs hôtes pour les instances EC2

Vous pouvez également créer manuellement des ordinateurs hôtes pour les données ferroutées. Ce faisant, il est important que les noms des ordinateurs hôtes correspondent exactement au schéma décrit ci-dessus.

Tip

L’instruction « cmk-piggyback list orphans » vous permet de trouver tous les hôtes ferroutés orphelins pour lesquels il existe des données, mais qui n’ont pas encore été créés en tant qu’ordinateurs hôtes dans Checkmk.

Configurez les ordinateurs hôtes pour ces instances EC2 sans adresse IP (à l'instar de l'ordinateur hôte AWS) et sélectionnez No API integrations, no Checkmk agent comme agent de supervision. Si vous sélectionnez également l'option « Always use and expect piggyback data » sous « Piggyback », vous recevrez une alerte en conséquence si les données ne parviennent pas.

monitoring aws add host for piggyback data

5.5. Ordinateurs hôtes pour l'ELB (Classic Load Balancer)

Les services pour l'ELB sont également attribués à des hôtes ferroutés. Les noms correspondent à leurs noms DNS.

5.6. Superviser les statistiques de trafic des compartiments S3

Avec Checkmk, vous pouvez effectuer la supervision du trafic de chacun de vos compartiments S3. Dans Checkmk, il vous suffit d’activer l’option « Request metrics » sous « Simple Storage Service (S3) ».

Option for S3-Buckets with activated request metrics.

Dans AWS, cela demande un peu plus de travail. Ici, vous devez encore configurer ces métriques de requête pour les compartiments que vous souhaitez soumettre à la supervision. AWS décrit en détail comment cela fonctionne dans l’article Créer une configuration de métriques CloudWatch pour tous les objets de votre compartiment. Lors de la configuration dans AWS, il vous sera demandé de créer un filtre. Vous devez nommer ce filtre « EntireBucket » afin qu’il soit reconnu par Checkmk. Tout filtre portant un nom différent sera ignoré par Checkmk. Vous êtes donc libre de définir d’autres filtres pour ce compartiment sans affecter le fonctionnement de Checkmk.

Creation of a filter for the request metrics.

Le choix de ce que l'on appelle le filtre « Scope » dans AWS vous appartient également. Dans la plupart des cas, il sera toutefois judicieux d'inclure tous les objets du compartiment dans le filtre.

Une fois les métriques de requête configurées, il faudra attendre quelques minutes avant que des métriques ne soient enregistrées. AWS indique que ce délai est de 15 minutes.

Important : tant que les graphiques dans la console S3 sont vides, aucune donnée n'arrivera non plus dans Checkmk via l'agent spécial. Ce n'est qu'une fois les métriques enregistrées que Checkmk peut créer les services correspondants. Si nécessaire, effectuez à nouveau la reconnaissance du service sur l'ordinateur hôte AWS.

5.7. Limites de supervision

Certains services web d'AWS ont des limites et Checkmk est capable de les surveiller. Voici quelques exemples :

Dès qu’un tel plugin de supervision crée des services et les vérifie par la suite, l’agent spécial récupère systématiquement tous les éléments du service web. Ce n’est que de cette manière que Checkmk est en mesure de calculer de manière raisonnable la charge de travail actuelle au niveau de ces limites et de vérifier les valeurs seuils. C’est également le cas même si vous limitez les données récupérées à l’aide de certaines balises ou de certains noms dans la configuration.

La vérification des limites est activée par défaut pour chaque service web surveillé. Si vous souhaitez limiter les données récupérées dans la règle de l'agent spécial afin de réduire la quantité de données transférées, vous devez également désactiver les limites.

5.8. Autres services

Les autres services web dans AWS sont attribués comme suit :

Service Affectation

CE

Coûts et charge de travail

Sur l'ordinateur hôte AWS

EBS

Stockages en blocs

Associé à l'instance EC2 si celle-ci lui appartient, sinon à l'ordinateur hôte AWS

S3

Stockages simples

Sur l'ordinateur hôte AWS

RDS

Bases de données relationnelles

Sur l'ordinateur hôte AWS

6. Tableaux de bord

CEE Pour vous permettre de vous lancer facilement dans la supervision d'AWS, Checkmk fournit, dans Checkmk Ultimate, deux tableaux de bord intégrés : AWS EC2 instances et AWS S3. Ces deux tableaux de bord sont accessibles via les entrées de supervision, sous Monitor > Cloud.

Pour vous donner une idée plus précise, voici deux exemples illustrant la structure de ces tableaux de bord. Tout d’abord, le tableau de bord des instances EC2, où vous pouvez comparer l’état actuel à gauche et l’historique chronologique des métriques les plus importantes à droite :

Dashboard for the AWS EC2 instances.

Le tableau de bord des compartiments S3 est structuré de manière assez similaire. Sur le côté gauche, vous trouverez la charge de travail actuelle pour les compartiments respectifs. Sur la droite, les métriques les plus importantes sont à nouveau affichées par ordre chronologique.

Dashboard for the AWS S3 buckets.

Last modified: Wed, 07 Jan 2026 17:02:09 GMT via commit 76e4c24dd
Sur cette page