Premiers pas avec l' Instana REST API

L'interface de programmation d'applications (API) Instana REST API vous permet d'intégrer la plateforme de surveillance et d'observabilité d' Instana à vos applications.

Prérequis

Avant de commencer, assurez-vous de disposer de connaissances de base sur les API RESTful et les protocoles de l' HTTP, ainsi que d'un compte Instana.

Génération d'un jeton d' API s pour l'authentification

Pour authentifier les requêtes adressées à l'interface de programmation d'applications (API) Instana REST API, vous devez disposer d'un jeton API. Suivez les étapes suivantes pour générer votre jeton « API » :

  1. Connectez-vous à votre compte Instana.
  2. Dans le menu de navigation de l'interface utilisateur d' Instana, cliquez sur Paramètres.
  3. Dans l'onglet « Sécurité et accès », dans la section « Contrôle d'accès », cliquez sur « Jetons d' API ».
  4. Entrez un nom pour votre jeton et définissez les autorisations appropriées.
  5. Une fois le jeton « API » généré, copiez votre jeton « API » et conservez-le en lieu sûr pour une utilisation ultérieure.

soumission de demandes

Instana REST API utilise les méthodes standard d' HTTP. L' URL de base de l' Instana REST API est propre à chaque instance de Instana et se compose du tenant et de l'unité. L' URL de base est la même URL que celle utilisée pour accéder à l'interface utilisateur Instana.

Utilisez votre jeton API pour authentifier chaque requête.

  • Adresse URL de base : https://<TENANT>-<UNIT>.instana.io/api
  • Autorisation : incluez votre jeton API dans Authorization l'en-tête en utilisant le apiToken préfixe.

L'exemple de format suivant montre une requête utilisant curl, incluant le jeton API dans l'en-tête Authorization.

curl -X GET https://<TENANT>-<UNIT>.instana.io/api/<INSTANA_REST_API_ENDPOINT> \
  -H "Authorization: apiToken <YOUR_API_TOKEN>"
 

Nœuds finaux d'API

API Les points de terminaison de l' Instana REST API désignent les différents itinéraires ou chemins que l' API utilise pour diverses fonctions ou opérations. Grâce à ces points de terminaison, vous pouvez interagir avec différents aspects de la plateforme Instana, tels que la gestion des données de surveillance, les alertes et les événements personnalisés. Pour plus d'informations sur l'utilisation de Instana REST API et de chaque point de terminaison, y compris les paramètres de requête, les formats de réponse et des exemples de requêtes, consultez la documentation disponible à l'adresse API.

Limites de débit

Vous devez toujours consulter les limites de débit sur le site Instana REST API. Ces limites permettent de maintenir la disponibilité et les performances du service pour tous les utilisateurs.