PiDoctor Utilitaire de diagnostic et de surveillance de la santé du système Raspberry Pi

Pour surveiller la santé de votre système Raspberry Pi, vous pouvez utiliser l'application PiDoctor de PiCockpit. PiDoctor vous permettra également d'apprendre de nombreux détails sur votre Raspberry Pi, notamment son lieu de fabrication, la quantité de RAM dont il dispose, etc.

Remarque : PiDoctor était autrefois autonome, mais fait désormais partie de picockpit-client. La version autonome de PiDoctor (PiDoctor OS) a été abandonnée, au profit de la version incluse dans picockpit-client qui a des capacités de diagnostic en direct, et augmente le nombre de modules de diagnostic disponibles. Si vous voulez toujours la version historique, allez au bas de cette page et consultez la FAQ.

Explication du développement historique de Raspi Berry

Utilisation de PiDoctor pour diagnostiquer votre Raspberry Pi

Comment exécuter tous les tests de santé de Raspberry Pi

PiDoctor, comme les autres applications PiCockpit, est inclus gratuitement pour un maximum de 5 Raspberry Pis.

  1. Connectez-vous à PiCockpit (s'inscrire si vous n'avez pas encore de compte, c'est gratuit)
  2. Ouvrez le Mes Raspberry Pis pour accéder à la vue d'ensemble de votre Raspberry Pi
PiCockpit Mon Raspberry Pis : vue d'ensemble
Dans la vue d'ensemble de Mes Raspberry Pis, cliquez sur le Raspberry Pi pour lequel vous souhaitez exécuter des diagnostics.
  1. Cliquez sur le Raspberry Pi que vous voulez diagnostiquer.
Parmi les applications disponibles pour votre Raspberry Pi, cliquez sur PiDoctor.

4. Cliquez sur PiDoctor

Vous verrez l'écran suivant :

Écran principal PiCockpit PiDoctor pour un Raspberry Pi 4 Modèle B
Écran de contrôle principal du PiDoctor

5. Cliquez sur Exécuter tous les tests

Les informations de base (RAM et CPU) sont maintenant affichées :

PiDoctor après avoir cliqué sur "Run all tests".

Vous pouvez maintenant faire défiler la page pour voir les résultats des tests des différents modules, ou cliquer sur l'un des boutons d'accès rapide pour accéder au module de test du système qui vous intéresse :

Cliquez sur les boutons d'accès rapide dans PiDoctor pour accéder rapidement au bon module.

Comment exécuter un module individuel de contrôle de santé des Raspberry Pi

Chaque module a un bouton en bas, qui vous permet d'exécuter uniquement les tests de ce module. Par exemple, regardez le test Test USB:

Test USB du PiDoctor - cliquez sur le bouton "Run USB Test" pour exécuter le test.

Il y a également un interrupteur à bascule "auto reload" dans le coin supérieur, qui vous permet de faire exécuter le test automatiquement toutes les 10 secondes. Ceci est utile pour le suivi continu des changements.

Modules de test de l'état du système disponibles

WLAN

capture d'écran du module de test de santé WLAN de PiDoctor

Le module WLAN vous permet de scanner les réseaux WiFi dans le voisinage de votre Raspberry Pi, de déterminer celui auquel il est relié et sa puissance. En cliquant sur les détails, vous pourrez voir les détails techniques complets du réseau :

montrer plus de détails pour un SSID WLAN (extrait)

Dans la section "informations avancées", de nombreuses commandes supplémentaires sont présentes, dont vous pouvez voir les résultats. Certaines d'entre elles ne seront exécutées que si vous cliquez sur "Run this test" :

Le scan iwlist est un test à la demande, il n'est exécuté que si vous cliquez sur "exécuter ce test".

La recherche vous permet de trouver rapidement les lignes correspondantes dans la sortie :

filtrage de la fréquence WLAN

Réseau

Le module réseau vous montre les adresses IP actuelles de votre Raspberry Pi, les liens réseau et les voisins connus.

Adresses IP propres aux Raspberry Pi et liens réseau / voisins connus

Certaines informations supplémentaires sont disponibles dans la section des informations avancées :

ss -tupn et ss-tulpwn peuvent être utilisés pour diagnostiquer les connexions réseau actives et les ports d'écoute sur votre Raspberry Pi.

Système

System est l'un des modules de test de système Raspberry Pi les plus puissants et les plus complets de PiCockpit.

Informations de base sur le système

La première partie, Informations de base sur le systèmevous présente quelques informations importantes :

  • Numéro de série de votre Raspberry Pi
  • votre modèle de Raspberry Pi
  • la température du SoC de votre Raspberry Pi (surveillez la température du CPU en utilisant ceci, ou utilisez PiStats pour voir les mises à jour toutes les secondes !)
  • la mémoire vive du GPU
  • la fréquence actuelle du processeur - ceci est utile si vous overclockez votre Raspberry Pi
  • la tension actuelle du CPU
  • état de la caméra Raspberry Pi - diagnostiquez les problèmes de caméra pour voir si le Raspberry Pi prend en charge et détecte la caméra.
  • la date de fabrication de la carte SD
Contrôle de l'étranglement et de la sous-tension, surveillance du plafond de fréquence ARM

En utilisant la partie suivante, Etranglement et sous-tensionvous pouvez diagnostiquer des informations vitales sur votre Raspberry Pi :

  • L'alimentation de votre Pi est-elle suffisamment puissante ? Attention à la sous-tension
  • Votre Raspberry Pi est trop chaud ? Attention à la limite de température douce, au plafond de fréquence ARM et à l'étranglement.

Au cas où il y aurait des problèmes (actuels ou antérieurs), PiCockpit les affichera ici. Par exemple, pour le capuchon de la fréquence ARM qui est déclenché :

Le plafond de fréquence de l'ARM est actuellement actif, et était précédemment actif - indiquant des problèmes de chaleur.
Périphériques de blocs et systèmes de fichiers en état d'effondrement

Le module Dispositifs de blocage et systèmes de fichiers (espace de stockage) est initialement réduit, mais peut être étendu en cliquant sur la flèche :

Vue étendue de mmcblk0, montrant toutes les partitions

Vous serez en mesure de voir toutes les partitions, leur taille, et l'espace utilisé pour les partitions montées. Cela vous permettra de déterminer si vous manquez d'espace sur votre partition racine sur votre Raspberry Pi.

La partition racine est toujours montée sous / - dans notre cas la dernière partition, mmcblk0p7

Les connaissances utiles de Raspi Berry sur Linux

Cliquez sur une entrée pour voir encore plus de détails :

montrant les détails de la partition racine

Ici, vous pouvez cliquer sur le bouton "Afficher tout" pour afficher encore plus de détails (ce qui n'intéressera probablement que les personnes souhaitant se plonger dans les détails techniques) :

montrer tous les détails d'une partition

En utilisant cette section, vous pouvez diagnostiquer le système de fichiers (fstype) d'une partition, le chemin /dev/ qu'elle possède (par exemple /dev/mmcblk0p1), son point de montage, sa taille, son utilisation et son étiquette, entre autres informations.

Décodeur de code de révision Raspberry Pi

Il y a deux styles de codes de révision Raspberry PiPiCockpit peut gérer les deux. Le nouveau code de révision donnera plus de détails :

  • Modèle de Raspberry Pi
  • Révision du modèle de Raspberry Pi
  • RAM pour Raspberry Pi
  • Processeur Raspberry Pi (SoC qui est utilisé)
  • CPU Raspberry Pi
  • Fabricant - vous pouvez trouver dans quel pays votre Raspberry Pi a été fabriqué ici

Il y a également quelques drapeaux supplémentaires que vous pouvez voir dans la partie Système / Code de révision Raspberry Pi de PiDoctor :

  • Surtension autorisée
  • Programmation OTP autorisée
  • Lecture OTP autorisée
  • Morceau de garantie

Les informations avancées comprennent des diagnostics supplémentaires, présentés sous forme de texte :

Diagnostics avancés : vérifier les bits OTP du Raspberry Pi, lscpu, free -b, vcgencmd get_config int, vcgencmd get_config str

Vidéo

Le module vidéo vous permet de vérifier quels moniteurs sont connectés à votre Raspberry Pi, et quels modes (vidéo et audio) ils prennent en charge. Pour les Raspberry Pi 4 et 400, les deux ports HDMI sont pris en charge.

Le module vidéo de PiDoctor vous permet d'inspecter les téléviseurs / écrans / moniteurs connectés à votre Raspberry Pi.

Comme vous pouvez le voir dans la capture d'écran, ce moniteur prend en charge la sortie audio :

PCM pris en charge : Max canaux : 2, Max samplerate :  48kHz, Taille d'échantillonnage max. 16 bits.

Cliquez sur les modes CEA et les modes DMT pour développer et afficher les modes de moniteur disponibles - ceci est utile pour définir la résolution de l'écran du Raspberry Pi dans le fichier config.txt, si vous avez des difficultés à voir la sortie :

les modes CEA sont une liste de résolutions et de fréquences auxquelles le moniteur est prêt à travailler.

USB

Le module PiDoctor USB vous permettra de surveiller les périphériques USB connectés à votre Raspberry Pi et de récupérer les détails les concernant :

Module USB du PiDoctor, montrant un dispositif USB 3.0 et trois dispositifs USB 2.0.

Cliquez sur la ou les flèches pour développer la hiérarchie des périphériques USB :

Dans cet exemple, un récepteur Unifyuing de Logitech Inc. est relié par USB au Raspberry Pi.

Cliquez sur l'appareil qui vous intéresse pour obtenir plus de détails :

PiCockpit PiDoctor vous montre les détails du périphérique USB connecté.
les détails d'un périphérique USB (extrait) - vous permet d'explorer en profondeur un périphérique particulier, de trouver le fabricant, le produit, le bInterfaceClass (par exemple, Human Interface Device) et l'état du périphérique (par exemple, bus alimenté).

Logiciel

Le module logiciel de PiDoctor vous montrera quelle version du client PiCockpit vous avez - il est important de maintenir le picockpit-client à jour (utilisez PiControl pour le mettre à jour depuis l'interface web de PiCockpit).

Et aussi, il vous permettra de voir les processus en cours d'exécution (sortie ps aux) et de les rechercher par nom :

Module de test du logiciel PiDoctor de PiCockpit
La recherche de picockpit devrait vous montrer le picockpit-client en mode démon.

Notez que ces résultats / la liste des processus ne sont pas mis à jour en direct - si vous souhaitez qu'ils soient rafraîchis périodiquement, cliquez sur le bouton de rechargement automatique (cela les rechargera toutes les 10 secondes) :

Module logiciel avec rechargement automatique activé

Il y a quelques tests supplémentaires dans les informations avancées :

Tests avancés du logiciel PiDoctor

Vous pouvez accéder à la sortie des commandes suivantes ici :

  • dmesg (tampon de messages du noyau)
  • vcdbg log msg
  • hostnamectl
  • Version de vcgencmd
  • lsmod (modules du noyau chargés)
  • ps aux (sortie brute)

Vous pourrez effectuer une recherche rapide dans les résultats, en saisissant le texte que vous recherchez dans le champ de recherche situé au-dessus de la sortie de l'information avancée qui vous intéresse :

dmesg, tampon de messages de diagnostic du noyau - est un test à la demande, cliquez sur Exécuter ce test pour l'exécuter.

Désactiver les tests dans PiDoctor

Si vous souhaitez désactiver les tests, pour des raisons de sécurité, par exemple, vous devez supprimer les fichiers de définition .json correspondants de l'application

/etc/picockpit-client/apps/com.picockpit/pidoctor/modules

Ajout de tests personnalisés à PiDoctor

L'ajout de tests personnalisés est possible en ajoutant des définitions de modules .json supplémentaires. Regardez les exemples dans le code qui sont présents, assurez-vous de définir vos propres poignées uniques, et redémarrez picockpit-client.

J'ajouterai plus de documentation pour créer vos propres tests ici, si les gens me le demandent.

Notez que les tests personnalisés seront toujours affichés comme "Informations avancées", car aucune interface utilisateur personnalisée n'a été construite pour eux. Si vous avez besoin de votre propre personnalisation / interface utilisateur pour une fonctionnalité particulière, veuillez nous contacter pour obtenir un devis..

Comment puis-je obtenir PiDoctor pour mon Raspberry Pi ?

C'est très simple :

  1. Enregistrez-vous pour un compte avec picockpit.com, votre plateforme web de gestion des Raspberry Pi. C'est gratuit pour un maximum de 5 Raspberry Pis.
  2. Suivez les instructions d'installation pour PiCockpit. (Vous allez créer une clé API et installer picockpit-client sur votre Raspberry Pi)
  3. Maintenant, vous pouvez simplement accéder à PiDoctor depuis l'interface web du navigateur de votre choix, comme décrit sur cette page

FAQ

PiDoctor ne s'affiche pas sous les outils supplémentaires, comment puis-je y accéder ?

PiDoctor a été fusionné avec PiCockpit - merci. installer le picockpit-client sur votre Raspberry Piet accéder à l'application PiDoctor.

La version classique et autonome de PiDoctor a été abandonnée.

Comment puis-je télécharger l'EDID ? Il était auparavant disponible dans le logiciel PiDoctor classique.

Actuellement, l'extraction de l'EDID n'est pas implémentée dans la nouvelle application PiDoctor. Une grande partie des sorties pour lesquelles vous voudriez avoir l'EDID est cependant implémentée, Veuillez consulter les captures d'écran ci-dessus..

Pour savoir comment lire manuellement l'EDID de votre écran sur un Raspberry Pi, cliquez ici.

Puis-je télécharger la version autonome historique de PiDoctor ?

Vous pouvez télécharger la dernière version autonome héritée de PiDoctor ici (Version 2.1.18). Le logiciel est fourni en l'état, sans garantie d'aucune sorte.

Avec la version historique, vous pouvez utiliser la même carte SD avec plusieurs Pi différents en séquence - elle créera un fichier journal JSON pour chaque Pi que vous avez testé, en extrayant différentes données.

Cet article de blog pourrait être utile pour prendre des notes. comment utiliser PiDoctor legacy.

Liens de téléchargement :

Ces liens de téléchargement contiennent le même logiciel de base, basé sur Alpine Linux - dans différents formats pour votre confort. En cas de doute, choisissez le .img.zip et écrivez l'image en utilisant des outils tels que Etcher.

Veuillez noter les limitations suivantes :

  • l'ancienne version de PiDoctor ne prend pas en charge le Pi 4 ou le Pi 400 (la nouvelle version de PiDoctor, qui fait partie de l'offre de services de l PiCockpit supporte tous les Raspberry Pis et continuera d'être mise à jour)
  • la version héritée ne peut pas être installée sur un système d'exploitation existant - vous devez la placer sur sa propre carte SD
  • l'outil d'évaluation en ligne a été abandonné, vous devrez donc examiner vous-même le fichier JSON brut - malheureusement, ce format de fichier n'est pas compatible avec la nouvelle plateforme PiCockpit v2
  • nous ne sommes pas en mesure de fournir une assistance non rémunérée pour la version héritée. - Cependant, si vous souhaitez que nous construisions une solution autour de ce système pour votre entreprise et que vous êtes prêt à... payer pour le conseil et le développement, veuillez nous contacter

Vous avez encore des questions ou besoin d'aide ?

S'il vous plaît contactez-nousnous avons pour objectif de vous aider à démarrer rapidement avec PiCockpit.