Créer un jeton d'ingestion
Créez le jeton qui identifie votre entreprise quand une application ou un navigateur envoie de la télémétrie à l'APM, et révoquez-le quand il n'est plus utilisé.
Sur cette page
Le jeton détermine à quelle entreprise vont les données. Il en existe deux types, chacun avec un usage différent :
Type | Pour quoi | Ce qu'il peut envoyer |
|---|---|---|
Jeton serveur | Applications back-end, processus, l'OpenTelemetry Collector | Traces, métriques et journaux |
Jeton navigateur | Code qui s'exécute dans la page web de vos utilisateurs | Uniquement des traces, uniquement depuis les origines indiquées et toujours avec le même nom de service |
Ne mettez jamais un jeton serveur dans une page web : quiconque ouvre la page peut le lire. Pour le navigateur, utilisez toujours un jeton navigateur.
Avant de commencer
Il vous faut l'autorisation Administrer sur le module APM.
L'APM doit être actif. Voir Activer l'APM.
Créer un jeton serveur
Allez dans Paramètres → APM → Clé API et SDK.
Dans la carte Jetons d'ingestion, appuyez sur Jeton serveur.
Saisissez un Nom qui identifie le système ou le serveur (par exemple, le nom de l'application et son environnement).
Appuyez sur Créer.
Copiez le jeton avec Copier et conservez-le en lieu sûr. Appuyez ensuite sur Terminé.
Créer un jeton navigateur
Allez dans Paramètres → APM → Clé API et SDK.
Dans Jetons d'ingestion, appuyez sur Jeton navigateur.
Complétez :
Nom : par exemple, « Portail clients ».
Nom du service (service.name fixe) : le nom sous lequel le site apparaîtra dans l'APM. Uniquement des lettres, des chiffres et
_ . : / -, sans espaces.Origines autorisées (une par ligne) : le schéma et le domaine depuis lesquels la page sera chargée, sans chemin. Par exemple
https://portal.midominio.cl. Jusqu'à 20.
Appuyez sur Créer, copiez le jeton et appuyez sur Terminé.
Le jeton ne s'affiche qu'une seule fois. ARGUNIS ne conserve que son empreinte : si vous le perdez, créez-en un nouveau et révoquez l'ancien.
Tant que vous ne quittez pas la page, les guides Comment instrumenter reprennent déjà dans les exemples le jeton tout juste créé et l'URL d'ingestion : vous pouvez copier les blocs tels quels.
Révoquer un jeton
Dans Jetons d'ingestion, repérez le jeton dans le tableau.
Appuyez sur le bouton corbeille de sa ligne et confirmez avec Révoquer.
Les systèmes qui l'utilisent cessent d'envoyer des données en moins d'une minute. Le jeton reste dans le tableau comme révoqué, avec sa date.
Ce qui se passe ensuite
Le tableau affiche chaque jeton avec son Type, son Préfixe, qui l'a créé et quand, et sa Dernière utilisation. Un jeton par système permet de n'en révoquer qu'un s'il fuite.