TP - Création et utilisation des Entity Selectors

Ce que vous allez apprendre dans ce TP

• Valider les accès au cluster Dynatrace
• Générer un API Token avec les bons droits
• Comprendre la structure globale d'un Entity Selector
• Maîtriser les critères de sélection de base
• Rédiger un Entity Selector complexe
• Savoir cibler des entités spécifiques avec des tags
• Créer un API Token avec les droits nécessaires
• Tester une requête Entity Selector via l'API REST v2
• Valider dynamiquement le résultat retourné par Dynatrace
• Créer un Segment dans la console Dynatrace
• Appliquer une règle de type Entity Selector à un segment

Les prérequis #

Ce que vous allez apprendre dans cette section

• Valider les accès au cluster Dynatrace
• Générer un API Token avec les bons droits

Vous devez disposer d'un cluster Dynatrace (SaaS ou Managed) avec des agents déployés, ainsi que d'un jeton d'accès (API Token) avec les droits de lecture des entités (`entities.read`).

Rappel de la Syntaxe et des Opérateurs Clés #

Ce que vous allez apprendre dans cette section

• Comprendre la structure globale d'un Entity Selector
• Maîtriser les critères de sélection de base

Un Entity Selector est une chaîne de caractères permettant de filtrer les entités Dynatrace. Il est composé de critères de sélection séparés par des virgules (qui font office d'opérateur ET logique).

Astuce : Vous pouvez utiliser l'opérateur NOT pour exclure des entités, par exemple type("HOST"),not(tag("ENV:DEV")).

1. Les critères principaux

   Voici les opérateurs les plus utilisés pour cibler vos entités :
   • type() : Filtre par type d'entité (ex: HOST, SERVICE, APPLICATION).
   • tag() : Filtre par étiquette. Accepte le format clé:valeur (ex: tag("env:training")).
   • entityName() : Filtre par nom d'entité, très utile avec les caractères de remplacement/wildcards comme *.

Création d'un Entity Selector #

Ce que vous allez apprendre dans cette section

• Rédiger un Entity Selector complexe
• Savoir cibler des entités spécifiques avec des tags

L'objectif est d'isoler un sous-ensemble de votre infrastructure. Vous devez écrire un 'entity selector' permettant de cibler uniquement les machines (HOST) qui possèdent le tag 'env=training'.

Règle d'or de conception (Passage à l'échelle) : Pour chaque règle de sélection, vous devez impérativement définir soit un Entity ID (identifiant unique de l'entité), soit un Entity type.

Bonne pratique : L'usage des Entity IDs fixes est à proscrire en production car trop spécifique et rigide. Pour garantir une gestion à grande échelle et compatible avec le cycle de vie dynamique de vos infrastructures, utilisez exclusivement l'Entity type combiné à des attributs ou des tags dynamiques.

1. Syntaxe du sélecteur

   Rédigez la requête permettant de sélectionner ces entités.

2. Serveurs Linux Full Stack

   Lister tous les serveurs Linux avec le Monitoring type 'Full stack'.

3. Services Tomcat et Docker

   Afficher les services utilisant les technologies 'Apache tomcat' et 'Docker'.

Validation via API #

Ce que vous allez apprendre dans cette section

• Créer un API Token avec les droits nécessaires
• Tester une requête Entity Selector via l'API REST v2
• Valider dynamiquement le résultat retourné par Dynatrace

Avant d'appliquer une règle dans une Management Zone ou un Segment, il est fortement recommandé de la tester. Vous devez utiliser l'API Dynatrace (v2) pour vérifier quelles entités sont retournées par votre sélecteur.

1. Création du token

   Pour interroger l'API Dynatrace, vous avez besoin d'un jeton d'API (API Token) avec la permission `entities.read`. Créez ce token dans votre environnement Dynatrace.

2. Test des requêtes

   Utilisez les commandes `curl` suivantes pour tester les Entity Selectors que vous avez créés. N'oubliez pas de remplacer `{VOTRE_TOKEN}` par votre jeton d'API et d'adapter l'URL de votre environnement si nécessaire (ici `https://demo.dynatrace.rousseltm.fr`).

   Conseil : L'encodage URL des caractères spéciaux (comme les guillemets `"` qui deviennent `%22`) est crucial pour les requêtes `curl`.

Création de segments #

Ce que vous allez apprendre dans cette section

• Créer un Segment dans la console Dynatrace
• Appliquer une règle de type Entity Selector à un segment

Maintenant que votre 'entity selector' est validé, vous devez l'utiliser pour créer un nouveau segment nommé avec votre prénom.

1. Configuration dans la console

   Indiquez les étapes pour créer le Segment basé sur le sélecteur 'Services Tomcat et Docker' dans l'interface de Dynatrace.

Niveau de difficulté : ●●●○○ (3/5)