Skip to main content
Veuillez d’abord suivre le guide d’installation lorsque vous ajoutez une nouvelle application à AppSignal.

Création d’une clé Push API

Avant de commencer, vous devez trouver votre clé Push API dans la section « Push and deploy » de la page des paramètres de votre application. Vous trouverez votre clé API sous « Front-end error monitoring ». Une fois que vous avez votre clé, suivez les instructions de la section Installation pour l’utiliser dans votre application.

Installation

Avec npm ou yarn

Tout d’abord, ajoutez le package @appsignal/javascript à votre package.json. Ensuite, exécutez yarn install/npm install. Vous aurez également besoin d’une clé Front-end error monitoring depuis la section « Push and deploy » de la page des paramètres de votre application. Vous pouvez également ajouter ces packages à votre package.json en ligne de commande :

Avec JSPM.dev

Il n’est pas recommandé d’utiliser le CDN JSPM.dev en production. Pour une configuration prête pour la production sans étape de build, nous recommandons d’utiliser les import maps JSPM.io.
Grâce au CDN JSPM, il est possible d’utiliser l’intégration AppSignal pour JavaScript sans étape de build des assets front-end. Votre application peut importer les packages directement depuis le CDN :

Avec les import maps JSPM.io

Avec le générateur d’import maps JSPM.io, vous pouvez générer une import map pour les dépendances de votre application. Ajoutez @appsignal/javascript à la liste des dépendances, puis ajoutez l’import map générée et les shims des modules ES au code de votre application.

Avec rails-importmap

Utilisez la commande suivante pour ajouter ces packages aux import maps de votre application Rails :

Utilisation

Créez un fichier appsignal.js pour requérir et configurer AppSignal. Depuis ce fichier, nous exportons l’instance de l’objet Appsignal que nous utiliserons depuis notre application. Pour plus d’informations sur la configuration, consultez notre section configuration.
Vous pouvez alors importer et utiliser l’objet Appsignal dans votre application :
REMARQUE : Si vous utilisez un CDN devant vos assets, vous devrez apporter deux modifications pour que le rapport d’erreurs puisse envoyer les erreurs à notre point d’accès API. Lisez-en plus sur les modifications requises.Si vous utilisez une Content Security Policy, assurez-vous d’ajouter les bons en-têtes comme décrit ici.

Ajouter des intégrations

Votre application utilise peut-être un framework ou une bibliothèque qu’AppSignal prend en charge. Veuillez consulter la section intégrations pour toute bibliothèque utilisée par votre application et suivez les instructions pour ajouter l’instrumentation pour ces bibliothèques. Ajouter des intégrations à votre application.

Ajouter des plugins

AppSignal propose également des plugins pour les fonctionnalités JavaScript dans le navigateur. Veuillez consulter la section plugins pour toute instrumentation supplémentaire que vous souhaiteriez ajouter à votre application. Ajouter des plugins à votre application.

Rapport d’erreurs personnalisé

Vous n’utilisez pas de framework ou de bibliothèque, mais souhaitez signaler les erreurs JavaScript manuellement ? Utilisez notre API Span pour créer des spans sur lesquels signaler les erreurs, ajouter des tags et davantage de métadonnées. Lisez ensuite notre guide de gestion des erreurs pour savoir comment signaler les erreurs à AppSignal.
📖 Poursuivez avec notre guide d’installation.

Désinstallation

Désinstallez AppSignal de votre application en suivant les étapes ci-dessous. Une fois ces étapes terminées, votre application n’enverra plus de données aux serveurs AppSignal.
  1. Dans le package.json de votre application, supprimez toutes les lignes faisant référence à un package appsignal : "*appsignal/*": "*".
  2. Exécutez npm install ou yarn install pour mettre à jour votre package.lock/yarn.lock avec l’état des packages supprimés.
    • Vous pouvez également exécuter npm uninstall @appsignal/<package name> ou yarn remove @appsignal/<package name> pour désinstaller un package AppSignal.
  3. Supprimez toute configuration AppSignal de votre application.
  4. Validez, déployez et redémarrez votre application.
    • Cela garantira que les serveurs AppSignal ne continueront pas à recevoir des données de votre application.
  5. Enfin, supprimez l’application sur AppSignal.com.
📖 Poursuivez avec notre guide de désinstallation.