REST API (Active)

L'analyseur actif de l'API REST vous permet de surveiller toute API REST qui prennent en charge l'authentification anonyme et de base. Il vous permet également de valider la réponse JSON avec des requêtes JSONPath.

Pour configurer un analyseur actif d'API REST :

Nom. Saisissez un nom unique pour l'analyseur. Ce nom s'affiche dans la bibliothèque d'analyseurs actifs.
Description. Saisissez les informations supplémentaires de l'analyseur. Cette description s'affiche à côté du nom de l'analyseur dans la bibliothèque des analyseurs actifs.
Utiliser lors d'une nouvelle analyse. Cette option indique à WhatsUp Gold qu'il doit tenter d'appliquer cet analyseur actif lorsque Découverte détecte de nouvelles conditions qui le justifient.
Délai. Entrez la durée pendant laquelle WhatsUp Gold attend que l'API REST réponde avant de mettre fin à la connexion et de renvoyer l'erreur de délai d'expiration. La valeur minimale autorisée est de 1 seconde et la valeur maximale autorisée est de 120.
API REST
- 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 */*.
- URL DE L'API REST. L'URL du point de terminaison de l'API REST que vous souhaitez surveiller.
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.
- Méthode. Sélectionnez une méthode HTTP prise en charge pour le terminal 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.
É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).

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