Lighthouse
Rapport de recherche Datadog : Bilan sur l'adoption de l'informatique sans serveur Rapport : Bilan sur l'adoption de l'informatique sans serveur

Lighthouse

Agent Check Check de l'Agent

Supported OS: Linux

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

Implémentation

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

Installation

Si vous utilisez la version 6.8 ou ultérieure de l’Agent, suivez les instructions ci-dessous pour installer votre check Google Chrome Lighthouse sur votre host. Consultez notre guide relatif à l’installation d’intégrations développées par la communauté pour installer des checks avec une version < 6.8 de l’Agent ou avec Agent Docker :

  1. Installez le kit de développement.
  2. Clonez le référentiel integrations-extras :

    git clone https://github.com/DataDog/integrations-extras.git.
  3. Mettez à jour votre configuration ddev avec le chemin integrations-extras/ :

    ddev config set extras ./integrations-extras
  4. Pour générer le paquet lighthouse, exécutez :

    ddev -e release build lighthouse
  5. Téléchargez et lancez l’Agent Datadog.

  6. Exécutez la commande suivante pour installer le wheel de l’intégration à l’aide de l’Agent :

    datadog-agent integration install -w <PATH_OF_LIGHTHOUSE_ARTIFACT>/<LIGHTHOUSE_ARTIFACT_NAME>.whl
  7. Configurez votre intégration comme n’importe quelle autre intégration fournie avec l’Agent.

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.

Exigences

  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 requiert un kernel 4.4 ou ultérieur sur RHEL/CentOS pour que le mode headless fonctionne correctement.

    • Puppeteer

      • Vérifiez que Lighthouse est installé.

        # example
        root@hostname:~# npm list -g --depth=0 | grep 'puppeteer'
        └── puppeteer@1.12.2
      • Si ce n’est pas le cas (si 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

lighthouse.accessibility
(gauge)
The google chrome lighthouse score for accessibility
Shown as percent
lighthouse.best_practices
(gauge)
The google chrome lighthouse score for best_practices
Shown as percent
lighthouse.performance
(gauge)
The google chrome lighthouse score for performance
Shown as percent
lighthouse.pwa
(gauge)
The google chrome lighthouse score for pwa
Shown as percent
lighthouse.seo
(gauge)
The google chrome lighthouse score for seo
Shown as percent

É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.