Présentation

Recueillez les métriques de Google Chrome Lighthouse en temps réel pour :

• Visualiser et surveiller les états de Lighthouse
• Mesurer et auditer les scores de vos sites Web en matière d’accessibilité, de meilleures pratiques, de performances, d’adaptabilité et de SEO

Configuration

Le check Lighthouse n’est pas inclus avec le package de l’Agent Datadog : vous devez donc l’installer.

Installation

Pour l’Agent v7.21+/6.21+, suivez les instructions ci-dessous afin d’installer le check Lighthouse sur votre host. Consultez la section Utiliser les intégrations de la communauté pour effectuer une installation avec l’Agent Docker ou avec des versions antérieures de l’Agent.

1. Exécutez la commande suivante pour installer l’intégration de l’Agent :

   datadog-agent integration install -t datadog-lighthouse==<INTEGRATION_VERSION>
   

2. Configurez votre intégration comme une intégration de base.

Configuration

1. Modifiez le fichier lighthouse.d/conf.yaml dans le dossier conf.d/ à la racine du répertoire de configuration de votre Agent pour commencer à recueillir vos métriques Lighthouse. Consultez le fichier d’exemple lighthouse.d/conf.yam pour découvrir toutes les options de configuration disponibles.

2. Redémarrez l’Agent.

Prérequis

1. Node.js LTS (8.9 ou ultérieur) :

   • Vérifiez que Node.js et npm sont installés :

   node -v
   npm -v
   

   • Si ce n’est pas le cas, installez-les.

2. Lighthouse :

   • Vérifiez que Lighthouse est installé.

   # example
   root@hostname:~# npm list -g --depth=0 | grep 'lighthouse'
   |_ lighthouse@5.6.0
   

   • Si ce n’est pas le cas (la commande ci-dessus ne génère aucun résultat), installez-le :

   npm install -g lighthouse
   

3. Google Chrome/Chromium ou Puppeteer :

   • Chromium

     • Debian/Ubuntu

     sudo apt-get update
     sudo apt-get install -y chromium-browser
     

     • RHEL/CentOS

     sudo yum install -y epel-release
     sudo yum install -y chromium
     

     Remarque : cette intégration exécute Chrome/Chromium en mode headless. Il se peut que Chrome/Chromium requière un kernel 4.4 ou ultérieur sur RHEL/CentOS pour que le mode headless fonctionne correctement.

   • Puppeteer

     • Vérifiez que Puppeteer est installé.

     # example
     root@hostname:~# npm list -g --depth=0 | grep 'puppeteer'
     |_ puppeteer@1.12.2
     

     • Si ce n’est pas le cas (la commande ci-dessus ne génère aucun résultat), installez-le :

     npm install -g puppeteer --unsafe-perm=true
     

4. Vérifiez que l’utilisateur dd-agent peut exécuter l’interface de ligne de commande Lighthouse.

   sudo -u dd-agent lighthouse <WEB_URL> --output json --quiet --chrome-flags='--headless'
   

Validation

Lancez la sous-commande status de l’Agent et cherchez lighthouse dans la section Checks.

Données collectées

Métriques

Événements

L’intégration Lighthouse n’inclut aucun événement.

Checks de service

L’intégration Lighthouse n’inclut aucun check de service.

Dépannage

Besoin d’aide ? Contactez l’assistance Datadog.