Libérez votre esprit d' Instana e pour observer les nouvelles technologies
Vous pouvez configurer Instana pour surveiller les nouveaux systèmes ou technologies à l'aide du tableau de bord personnalisé et des fonctionnalités de définition d'événements d' Instana, ainsi que de ses capacités d'intégration OpenTelemetry. En utilisant des tableaux de bord publics, des événements et des packages d'intégration réutilisables, vous pouvez mettre en œuvre vous-même les solutions d'observabilité requises.
Exploration des packages d'intégration
Recherchez des tableaux de bord réutilisables et des définitions d'événements regroupés dans des packages d'intégration sur un registre central tel que npmjs. Vous pouvez examiner ces packages pour connaître leurs fonctionnalités, les étapes d'installation et d'autres détails avant de les intégrer à votre environnement d' Instana. La révision des packages garantit une adoption plus rapide des nouvelles fonctionnalités d'observabilité. IBM, en collaboration avec leurs clients et partenaires commerciaux, fournissent leurs packs d'intégration que vous pouvez télécharger et importer afin d'améliorer les capacités de surveillance. Le tableau suivant fournit quelques exemples de forfaits disponibles :
| Nom | Description | Lier |
|---|---|---|
| démonstration-opentelemetry | Le package d'intégration Instana utilisé pour démontrer la surveillance de l'application de démonstration OpenTelemetry, une version Instana du projet opentelemetry-demo issu de la communauté. | démonstration-opentelemetry |
| aller | Le package d'intégration d' Instana utilisé pour prendre en charge la surveillance d' Go. | aller |
| nodejs | Le package d'intégration d' Instana utilisé pour prendre en charge la surveillance d' Node.js. | nodejs |
Téléchargement, importation et exportation de tableaux de bord et de définitions d'événements
Les tableaux de bord réutilisables et les définitions d'événements étant regroupés dans des packages d'intégration et accessibles au public, vous pouvez choisir les packages qui prennent en charge les systèmes ou les technologies que vous souhaitez observer. Téléchargez les paquets requis et importez-les dans vos environnements d' Instana s existants. L'importation des paquets étend immédiatement les capacités de votre environnement d' Instana s pour prendre en charge l'observabilité de nouveaux systèmes ou technologies.
Vous pouvez utiliser l'outil en ligne de commande, l'interface CLI d' Instana, pour gérer les packages d'intégration, les télécharger, les importer et les exporter. Cet outil vous permet de gérer le cycle de vie du package, y compris les tableaux de bord réutilisables et la définition des événements. Pour télécharger la dernière version de l'outil, consultez la page de publication de la gestion des packages d'intégration de l'interface CLI d' Instana.
Pour plus de détails, consultez la page de documentation CLI pour obtenir des exemples d'utilisation et connaître les commandes prises en charge.
Téléchargement des tableaux de bord et des définitions d'événements
Pour télécharger un package d'intégration comprenant les tableaux de bord réutilisables et la définition des événements à l'aide de l'outil, vous devez spécifier le nom du package. Consultez l'exemple de commande suivant pour télécharger un paquet nommé @instana-integration/go:
$ stanctl-integration download --package @instana-integration/go
Par défaut, l'outil crée un sous-répertoire dans le répertoire de travail actuel qui sert de répertoire racine pour stocker tous les paquets d'intégration téléchargés. Vous pouvez également spécifier votre propre répertoire racine pour les paquets à l'aide de --location l'option. Par exemple, la commande suivante télécharge le paquet dans le répertoire racine ./my-packages :
$ stanctl-integration download --package @instana-integration/go --location ./my-packages
Importation des tableaux de bord et définition des événements
Une fois le package d'intégration téléchargé sur votre ordinateur local, vous pouvez utiliser l'outil pour importer les tableaux de bord et la définition des événements dans n'importe quel environnement Instana existant. Vous devez fournir l'adresse du serveur Instana et le jeton API à l'aide des options correspondantes lorsque vous exécutez l'outil. Le jeton d' API est requis car l'outil appelle une série d'API d' Instana s pour terminer l'importation des tableaux de bord et de la définition des événements. Voir l'exemple suivant :
$ stanctl-integration import --package @instana-integration/go \
--server $INSTANA_SERVER \
--token $API_TOKEN
Vous pouvez spécifier le répertoire à l'aide de --location l'option. Par exemple :
$ stanctl-integration import --package @instana-integration/go --location ./my-packages \
--server $INSTANA_SERVER \
--token $API_TOKEN
Sharing custom
dashboards publicly with all users and API tokens. Pour confirmer, ouvrez le menu de navigation Instana et accédez à Paramètres > Paramètres d'équipe > Jetons API, puis sur la page Jetons API, sélectionnez le jeton que vous utilisez pour l'importation. Dans la boîte de dialogue Modifier le jeton d' API, recherchez la section Autorisations du propriétaire et assurez-vous que Sharing custom
dashboards publicly with all users and API tokens l'élément est activé.Spécification des valeurs des paramètres pour les tableaux de bord
Certains tableaux de bord peuvent avoir des paramètres dans leurs définitions inclus dans le package d'intégration. En effet, certaines valeurs apparaissant dans les définitions du tableau de bord peuvent ne pas être encore déterminées lorsque le responsable du tableau de bord définit ce dernier. Vous pouvez consulter la page d'accueil du paquet pour voir si des paramètres sont inclus dans ce paquet. Lorsque vous importez ces tableaux de bord à l'aide de l'outil, vous pouvez spécifier les valeurs réelles de ces paramètres à l'aide de --set l'option, qui peut être utilisée plusieurs fois. Par exemple :
$ stanctl-integration import --package @instana-integration/go \
--server $INSTANA_SERVER \
--token $API_TOKEN \
--set key1=value1 \
--set key2=value2
Exportation des tableaux de bord et définition des événements
En plus du téléchargement et de l'importation, l'interface CLI d' Instana pour la gestion des packages d'intégration prend également en charge l'exportation des tableaux de bord et des définitions d'événements à partir d'un environnement Instana existant. Pour exporter des tableaux de bord et des définitions d'événements, vous devez fournir l'adresse du serveur Instana, un jeton API valide et au moins une --include option spécifiant le type de ressource (tableau de bord ou événement). En plus du type d'actif, vous devez spécifier soit le titre, soit l'identifiant pour identifier l'élément spécifique que vous souhaitez exporter. L'outil utilise les API d' Instana pour récupérer les ressources correspondantes et les enregistre localement dans un format portable. Consultez l'exemple suivant où les tableaux de bord et les définitions d'événements sont exportés en faisant correspondre un titre :
$ stanctl-integration export --server $INSTANA_SERVER \
--token $API_TOKEN \
--include type=dashboard title="dashboardTitle"
Sinon, si vous connaissez l'ID d'un tableau de bord ou d'un événement, vous pouvez l'exporter directement en spécifiant l'ID. Voir l'exemple suivant :
$ stanctl-integration export --server $INSTANA_SERVER \
--token $API_TOKEN \
--include type=event id=eventID