REST API active (appplication)

Le composant d'analyseur actif de l'API REST vous permet d'exécuter le moniteur sur un périphérique spécifique et d'obtenir des informations sur l'état d'un périphérique, d'un serveur ou d'une application en évaluant si l'analyseur est disponible ou non.

Pour ajouter un analyseur actif d'API REST en tant que composant à une application existante :

1. Sélectionnez Paramètres > Surveillance des applications > Paramétrage de l'application et du profil.
2. Ajoutez un profil d'application comme décrit dans Utilisation des profils d'application.
3. Ajoutez un composant comme décrit dans Composants, groupes de composants critiques et applications discrètes.
4. Dans la boîte de dialogue Modification du profil d'application, sélectionnez l'onglet Composants, puis cliquez sur l'icône Ajouter pour ajouter un nouveau composant.
5. Pour le nom du composant, sélectionnez API REST> API REST active.
6. Dans l'éditeur de composants, configurez les champs suivants :
   • Nom. Saisissez un nom unique pour le composant. Ce nom s'affiche dans la page Composants de performance de l'éditeur du profil d'application.
   • Description. Saisissez les informations supplémentaires du composant.
   • Critique. Sélectionnez s'il s'agit d'un composant critique.
   • Remplacement du périphérique. Sélectionnez si vous souhaitez autoriser un périphérique à remplacer ce composant.
   • Intervalle d'interrogation. Sélectionnez l'intervalle de vérification du composant.
   • Délai de connexion dépassé. Sélectionnez la durée de la demande avant l'expiration du délai.
   • API REST. Ajoutez l'URL du terminal de l'API REST pour le composant.

   Note: Les variables de référence (également appelées variables de pourcentage) pour Système (%System), Périphérique (%Device) et Application (%Application) sont prises en charge dans l'URL de l'API REST. Pour plus d'informations, consultez Variables de pourcentage. Cependant, l'expression sera évaluée à faux si testé. Il est recommandé de s'assurer que l'API REST renvoie une réponse valide avant de paramétrer l'expression et de l'attacher à un périphérique.

   • Modifier les en-têtes personnalisés. Entrez jusqu'à dix en-têtes personnalisés requis pour accéder au terminal de l'API REST. Un en-tête Accept par défaut est fourni et est spécifié comme application/json.

   Note: Pour surveiller un serveur d'applications Progress pour le terminal de l'API REST d'OpenEdge OEManager, l'en-tête Accept doit être défini sur application/vnd.progress+json ou */*.

   • Méthode. Sélectionnez la méthode HTTP prise en charge pour le terminal de l'API REST. Actuellement, seule la méthode GET est prise en charge.
   • Ignore Certificate Errors (Ignorer les erreurs du certificat). Cochez cette case pour forcer WhatsUp Gold à ignorer les erreurs de certificat.
   • Utiliser l'accès anonyme. Si le terminal de l'API REST ne nécessite pas d'authentification, cochez cette case.
   • JSONPATH. Entrez le chemin d'accès à l'objet JSON que vous souhaitez surveiller ou utilisez le générateur JSONPath pour vous assurer que vous disposez du chemin correct vers l'objet que vous souhaitez surveiller.

   Note: Pour plus d'informations sur JSONPath et JSONPath Builder, consultez Requête JSONPath et générateur JSONPath.

   • Générateur JSONPath. Une fois que vous avez entré un terminal d'URL d'API REST valide, vous pouvez utiliser le générateur JSONPath pour afficher la structure de la réponse JSON et sélectionner la valeur JSON que vous souhaitez surveiller.
   • État Indisponible. L'analyseur se signalera comme inactif si l'un des codes de réponse HTTP répertoriés est renvoyé. Vous pouvez contrôler quels codes de réponse indiquent que l'analyseur est indisponible, et vous pouvez également fournir une requête JSONPath avec des conditions pour indiquer si l'analyseur est indisponible. L'analyseur peut utiliser une condition d'indisponibilité, une requête JSONPath ou les deux pour renvoyer une réponse d'indisponibilité.
   • Requête JSONPATH. Concevez un test logique pour évaluer les conditions renvoyées par le terminal de l'API REST :
   1. Sélectionnez l'icône Ajouter pour entrer un test conditionnel à l'aide de la requête JSONPath. Par défaut, le texte « Pas de comparaison configurée » apparaît en ligne.
   2. Double-cliquez dans l'entrée de requête JSONPath, puis sélectionnez le logo de la loupe. Cela vous invite à entrer un identifiant d'API REST si « Utiliser l'accès anonyme » n'est pas coché. Une fois les Informations d'identification de l'API REST vérifiées, la fenêtre JSONPath Builder s'ouvre.
   3. Sélectionnez le terminal que vous souhaitez surveiller.
   4. Créez un test logique qui représente une condition d'indisponibilité pour surveiller le terminal de l'API REST. Les types de valeur pris en charge sont Boléen, Nombre, Chaîne et Autre. Le type de données Autre vérifie si une valeur est nulle. Les chaînes vides sont prises en charge.
   5. Cliquez sur Save (Enregistrer).
7. Sélectionnez Test pour exécuter l'API REST.
8. Cliquez sur OK pour quitter l'éditeur de composant.

Pour ajouter ce composant à un profil d'application existant sur un périphérique :

1. Accédez à Applications surveillées, puis sélectionnez l'icône Ajouter.
2. Ajoutez le profil d'application que vous avez créé et le périphérique auquel attacher le profil d'application.
3. Configurez des champs supplémentaires si nécessaire.
4. Cliquez sur Save (Enregistrer).

Le test des composants est exécuté sur le périphérique.

See Also Composants, groupes de composants critiques et applications discrètes Surveillance de cloud pour Azure Surveillance de cloud pour AWS Utilisation du processeur Requête de base de données Utilisation du disque Contenu de fichier Vérification de contenu HTTP Statistiques d'interface Vérification de performances JMX Utilisation de la mémoire Vérification du port réseau Vérification du processus Performances de l'API REST (application) Scripts (PowerShell) Scripts (Analyse des utilisateurs finaux) Vérification des services SNMP SSH WMI Compteur de performances Windows