La fonction de surveillance des API permet d'analyser en détail les appels d'API d'une application. Elle offre la possibilité de surveiller l'analyse SQL, l'analyse NoSQL, l'analyse des exceptions, l'analyse des erreurs, les services amont et aval, ainsi que les instantanés des appels d'API.
Procédure
Pour accéder à la page Interface Invocation, suivez les étapes ci-dessous :
Accédez à la console ARMS.
Dans le volet de navigation de gauche, sélectionnez . Dans la barre de navigation supérieure, choisissez une région.
Sur la page Applications, cliquez sur l'application que vous souhaitez consulter.
Dans le volet de navigation de gauche, cliquez sur Interface Invocation.
Framework
Ce module fonctionnel détecte et surveille automatiquement les API fournies par les frameworks web et les frameworks d'appel de procédure distante (RPC) suivants :
Tomcat 7+
Jetty 8+
Resin 3.0+
Undertow 1.3+
WebLogic 11.0+
SpringBoot 1.3.0+
HSF 2.0+
Dubbo 2.5+
Consulter les détails d'une API
L'onglet Overview affiche la topologie détaillée des appels d'une API, ainsi que les courbes chronologiques du nombre de requêtes, du temps de réponse, du nombre d'erreurs et des codes d'état HTTP.
Consulter l'analyse SQL et NoSQL
Les onglets SQL Analysis et NoSQL Analysis présentent les requêtes SQL et NoSQL exécutées dans le code des API sélectionnées via le volet de navigation de gauche. Cette vue permet d'identifier les instructions SQL ou NoSQL à l'origine des lenteurs du service. Vous pouvez également cliquer sur Interface Snapshot dans la colonne Actions d'une instruction SQL ou NoSQL pour afficher la trace complète du code contenant la logique d'exécution correspondante.
Consulter l'analyse des exceptions
L'onglet Exception Analysis liste les exceptions Java levées par le code des API sélectionnées dans le volet de navigation de gauche. Cliquez sur Interface Snapshot dans la colonne Actions d'une exception pour visualiser la trace complète associée à la pile d'exceptions.
Consulter l'analyse des erreurs
L'onglet Error Analysis affiche les erreurs et les codes d'état HTTP de l'application. Cliquez sur une valeur de la colonne TraceId pour consulter les informations de trace dans une nouvelle page.
Consulter les services amont et aval
Les onglets Upstream Services et Downstream Services permettent de visualiser les API et les métriques de performance des services amont qui appellent l'application, ainsi que des services aval appelés par celle-ci. Les métriques incluent le temps de réponse, le nombre de requêtes et le nombre d'erreurs.
Figure 1.
Onglet Upstream Services
Depuis les onglets Upstream Services et Downstream Services, vous pouvez effectuer les opérations suivantes selon vos besoins :
Cliquez sur Collapse/Expand All pour réduire ou développer toutes les API.
Saisissez un nom d'application ou un nom d'API (span) dans la zone de recherche, puis cliquez sur l'icône de recherche pour filtrer les API correspondantes.
Cliquez sur le panneau réductible contenant les informations de l'API, ou utilisez la flèche vers le haut ou vers le bas située à la fin de la ligne. Vous pourrez ainsi développer ou réduire les informations relatives aux métriques de performance de l'API.
Consulter les instantanés d'interface
L'onglet Interface Snapshot affiche les paramètres des API sélectionnées. Cliquez sur l'ID de trace pour consulter la trace associée.
