Téléchargement des cartes source JavaScript

Modifier en ligne

La récupération automatique des cartes de source d' JavaScript s ne fonctionne pas pour les clients qui surveillent des sites Web privés à l'aide de Instana SaaS, car les cartes de source de ces sites ne sont pas accessibles au public. Ici, Instana propose un moyen de télécharger des fichiers de mappage de sources JavaScript pour les sites web privés via Instana SaaS.

Prérequis

Modifier en ligne

Créez un jeton d' API e avec les autorisations de configuration de la surveillance des sites Web activées. Pour plus d'informations, consultez la page « API Tokens ».
Enregistrez les cartes de sources pour l'édition personnalisée auto-hébergée ( Kubernetes ou Red Hat OpenShift Container Platform ) en configurant un stockage externe.

Procédure

Modifier en ligne

Instana fournit une interface utilisateur permettant de créer des configurations de téléchargement de fichiers, qui servent à organiser les fichiers de carte de source d' JavaScript s téléchargés. Dans l'onglet « Configuration » du site Web, dans l'interface utilisateur d' Instana, cliquez sur « Traduction de la trace de pile JS », puis sur « Configurations de téléchargement de fichiers ». Vous pouvez ajouter une configuration ici.

Capture d'écran présentant la vue des paramètres de téléchargement des cartes de source JS

Après avoir créé une nouvelle configuration de téléchargement de fichier, vous pouvez utiliser les API Web REST suivantes pour télécharger ou supprimer vos fichiers de carte source JavaScript .

API Web REST

Modifier en ligne

A partir de l'édition 250, les API REST Web pour le téléchargement et la suppression du fichier de carte source JavaScript sont modifiées.

Pour télécharger le fichier de mappe source JavaScript , exécutez la commande suivante:
```
curl -L -X PUT \
    'https://$UNIT-$TENANT.instana.io/api/website-monitoring/config/$WEBSITE_ID/sourcemap-upload/$UPLOAD_CONFIG_ID/form' \
    -H 'authorization: apiToken $API_TOKEN' \
    -F 'url="$JAVASCRIPT_URL"' \
    -F 'sourceMap=@"$LOCAL_MAPFILE_LOCATION"'
 
```
Remarques :
- Cette interface Web REST API ne prend pas en charge le téléchargement de plusieurs fichiers de carte source. Seuls le premier URL et le premier fichier de carte de sources dans l'interface CLI de Rest API sont acceptés.
- Si le fichier de carte source dépasse 10 Mo, cette interface Web REST API renvoie une erreur indiquant que l'entité de la requête est trop volumineuse. Il est recommandé d'utiliser un fichier de carte source compressé, au format tgz ou tar.gz. Et indiquez le paramètre -F 'fileFormat="tgz"' dans l'interface de ligne de commande d' Web REST API.

Pour supprimer le fichier de mappe source JavaScript , exécutez la commande suivante:

curl -L -X PUT \
    'https://$UNIT-$TENANT.instana.io/api/website-monitoring/config/$WEBSITE_ID/sourcemap-upload/$UPLOAD_CONFIG_ID/clear' \
    -H 'authorization: apiToken $API_TOKEN'

Mais pour l'édition 249, utilisez les API Web REST suivantes:

Pour télécharger le fichier de mappe source JavaScript :

curl -L -X PUT \
    'https://$UNIT-$TENANT.instana.io/api/website-monitoring/config/$WEBSITE_ID/sourceMapUpload/$UPLOAD_CONFIG_ID/form' \
    -H 'authorization: apiToken $API_TOKEN' \
    -F 'url="$JAVASCRIPT_URL"' \
    -F 'sourceMap=@"$LOCAL_MAPFILE_LOCATION"'

Pour supprimer le fichier de mappe source JavaScript :

curl -L -X PUT \
    'https://$UNIT-$TENANT.instana.io/api/website-monitoring/config/$WEBSITE_ID/sourceMapUpload/$UPLOAD_CONFIG_ID/clear' \
    -H 'authorization: apiToken $API_TOKEN'