IBM API Connect de suivi pour les indicateurs des organismes prestataires
IBM API Connect est une solution intégrée ( API Management ) qui offre des fonctionnalités et des outils pour toutes les phases du cycle de vie de l' API. Dans un environnement IBM Cloud , l'équipe IBM déploie et gère l'infrastructure API Connect . Vous pouvez également déployer et gérer l'infrastructure API Connect dans votre environnement dédié ou dans un cloud tiers. Instana surveille les organismes prestataires en ce qui concerne le catalogue, l'espace et d'autres indicateurs.
Informations complémentaires
Systèmes d'exploitation pris en charge
Le capteur IBM API Connect Instana s'installe automatiquement une fois l'agent hôte installé sur les systèmes d'exploitation pris en charge. Pour plus d'informations, consultez la section « Systèmes d'exploitation pris en charge » pour les agents hôtes, par exemple « Systèmes d'exploitation pris en charge pour UNIX ».
Versions prises en charge
Instana prend en charge les métriques et les données de configuration pour IBM API Connect, version 10 et ultérieures.
Configuration
Pour connecter l'agent « Instana » à « IBM API Connect », configurez les propriétés suivantes dans le fichier de configuration de l'agent « <agent_install_dir>/etc/instana/configuration.yamlInstana » :
com.instana.plugin.ibmapiconnect:
remote: # Multiple configurations can be specified
- host: '' # hostname or IP of API-Connect manager
port: '443' # port of API-Connect manager
username: '' # username of API-Connect manager. User can connect either through 'username & password' or 'apikey'.
password: '' # password of API-Connect manager. 'username & password' are optional if 'apikey' is provided.
api_key: '' # api-key of API-Connect manager. 'apikey' is optional if 'username & password' are provided.
realm: '' # realm of API-Connect manager
clientId: '' # downloaded clientId from tool-kit
clientSecret: '' # downloaded clientSecret from tool-kit
availabilityZone: 'API-Connect' # default is 'API-Connect'
poll_rate: 10 # Poll rate in seconds.
Affichage des mesures
Une fois l'agent configuré et déployé sur un hôte distant pour la collecte des métriques d' IBM API Connect, vous pouvez consulter les métriques de l'organisation du fournisseur dans l'interface utilisateur d' Instana.
Vue de l'infrastructure
Pour afficher les métriques, procédez comme suit:
- Dans la barre latérale de l'interface utilisateur d' Instana, sélectionnez « Infrastructure ». Vous pouvez consulter la carte des entités de l' API Connect e dans l'onglet « Carte ».
- Dans l'onglet Carte , cliquez sur une tour spécifique au système API Connect .
- Pour afficher toutes les métriques collectées pour le système API Connect , cliquez sur Ouvrir le tableau de bord.
Indicateurs relatifs aux organismes prestataires
Le tableau suivant répertorie les métriques affichées pour une organisation de type fournisseur:
| Métrique | Description | Granularité |
|---|---|---|
| Nombre de catalogues | Nombre total de catalogues dans l'organisation de type fournisseur. | 10 secondes |
| Nombre total de produits | Nombre total de produits. | 10 secondes |
| Nombre total d'appels API | Nombre total d'appels à la fonction ` API ` effectués par le catalogue. | 10 secondes |
| Nombre total d'erreurs | Nombre total d'erreurs détectées par le catalogue. | 10 secondes |
| Catalogues | Liste des catalogues | 10 secondes |
Indicateurs du catalogue
Le tableau suivant répertorie les métriques affichées pour un catalogue:
| Métrique | Description | Granularité |
|---|---|---|
| Nom du catalogue | Nom du catalogue pris en charge par l'organisation de type fournisseur. | 10 secondes |
| Nombre total d'appels API | Nombre total d'appels à la fonction ` API ` effectués par le catalogue. | 10 secondes |
| Nombre total d'erreurs | Nombre total d'erreurs détectées par le catalogue. | 10 secondes |
| Réponse de Max API | Temps de réponse maximal des API en millisecondes. | 10 secondes |
| Réponse d' API | Temps de réponse minimal des API en millisecondes. | 10 secondes |
| Réponse moyenne d' API | Temps de réponse moyen des API en millisecondes. | 10 secondes |
| 2xx Code de statut | Nombre de codes de statut 2xx capturés dans une période. | 10 secondes |
| 4xx Code de statut | Nombre de codes de statut 4xx capturés dans une période. | 10 secondes |
| 5xx Code de statut | Nombre de codes de statut 5xx capturés dans une période. | 10 secondes |
| Délai de traitement de la demande (tous les succès 2xx,3xx) | Temps total nécessaire à l'exécution de toutes les demandes ayant abouti (2xx et 3xx). | 10 secondes |
| Délai de traitement de la demande (toutes les erreurs 4xx,5xx) | Temps total nécessaire à l'exécution de toutes les demandes d'erreur (4xx et 5xx). | 10 secondes |
| Espaces | Liste des espaces | 10 secondes |
Mesures spatiales
Le tableau suivant répertorie les métriques affichées pour un espace:
| Métrique | Description | Granularité |
|---|---|---|
| Nom d'espace | Nom de l'espace pris en charge par l'organisation de type fournisseur. | 10 secondes |
| Nombre total d'appels API | Nombre total d'appels « API » effectués par l'espace. | 10 secondes |
| Nombre total d'erreurs | Nombre total d'erreurs rencontrées par l'espace. | 10 secondes |
| Réponse de Max API | Temps de réponse maximal des API en millisecondes. | 10 secondes |
| Réponse d' API | Temps de réponse minimal des API en millisecondes. | 10 secondes |
| Réponse moyenne d' API | Temps de réponse moyen des API en millisecondes. | 10 secondes |
| 2xx Code de statut | Nombre de codes de statut 2xx capturés dans une période. | 10 secondes |
| 4xx Code de statut | Nombre de codes de statut 4xx capturés dans une période. | 10 secondes |
| 5xx Code de statut | Nombre de codes de statut 5xx capturés dans une période. | 10 secondes |
| Délai de traitement de la demande (tous les succès 2xx,3xx) | Temps total nécessaire à l'exécution de toutes les demandes ayant abouti (2xx et 3xx). | 10 secondes |
| Délai de traitement de la demande (toutes les erreurs 4xx,5xx) | Temps total nécessaire à l'exécution de toutes les demandes d'erreur (4xx et 5xx). | 10 secondes |
Traitement des incidents
Importation du certificat autosigné utilisé par le serveur du gestionnaire APIC Si le serveur du gestionnaire APIC utilise un certificat autosigné, assurez-vous qu'il est importé dans le fichier cacert de la machine virtuelle Java. Par ailleurs, si vous constatez l'exception suivante dans le journal, cela signifie que le serveur APIC Manager utilise un certificat auto-signé, qui doit être importé dans le fichier `cacert` de la JVM.
sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target. PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target.Solution : Importez un certificat auto-signé en suivant les instructions de la section « Certificat auto-signé ».
- Si vous rencontrez des difficultés lors de la validation des certificats ou de leur intégration dans le pod de l'agent « Instana », consultez la section « Ajout d'un certificat APIC ».