Passer au contenu principal
Centre de documentation officiel

Suggestions de contrôle.

Contient des instructions de base, des paramètres de déploiement et une FAQ pour EasyOps et Asset Sonar.

Project A

EasyOps

Knowledge Base

Base de connaissances complète sur l'exploitation et la maintenance

Points clés :prend en charge la récupération hors ligne et la navigation classifiée, s'adaptant aux scénarios de salle informatique sans réseau.

Ingénierie des réseaux

Vérification rapide des commandes Huawei/H3C/Cisco, dépannage OSPF/STP.

Sécurité courant faible

, schéma de câblage du contrôle d'accès, surveillance de l'écran noir et localisation des défauts PTZ.

Exploitation et maintenance des postes de travail

Dépannage Windows, problèmes de partage d'imprimante, réparation DNS/IP.

Linux/Serveur

Commandes communes Shell, maintenance RAID, configuration et renforcement du pare-feu.

Cloud natif

Docker/K8s, diagnostic des exceptions de pod et vérification rapide du déploiement.

Base de connaissances

Manuel d'exploitation et de maintenance MySQL / Redis, requête lente et guide de sauvegarde et de récupération.

Toolbox

Configuration administrateur

Points clés :sont organisées hiérarchiquement selon « calcul + diagnostic + requête + fonctionnement et maintenance » pour faciliter le positionnement rapide des outils.

Catalogue de termes

Estimation de la capacité du disque dur NVR

masque de sous-réseau

et informatique de diffusion

Suggestions de filtrage et de débruitage

Budget alimentation des bornes

Atténuation des fibres

Estimation de la perte en dB de la liaison

Échec de la nouvelle tentative

Ping TCP/analyse de ports/analyse LAN

Contrat de service utilisateur

Détection HTTP/WOL/Agrégation d'outils

Application iOS

DNS / Whois(RDAP) / OUI

Contrat de service utilisateur

/interrogation d'état/commande rapide

Premières instructions d'initialisation

Points clés :doit être connecté à Internet pour la première fois pour télécharger environ 15 Mo de données de base. Il peut être utilisé hors ligne une fois l’initialisation terminée.
Priorité locale :La base de connaissances, les collections, l'historique et les résultats d'analyse sont stockés localement sur l'appareil par défaut et les données principales ne sont pas téléchargées.
Stockage sécurisé :sont enregistrés à l’aide des fonctionnalités de sécurité du système (telles que le trousseau) pour éviter l’exposition de texte en clair.
Project Divider

Project B

Asset Sonar Documentation

Instructions d'initialisation

Il est recommandé d'effectuer un exercice complet de processus (analyse → vérification → synchronisation → exportation) dans l'environnement de test avant de passer à la configuration de production.

Rappel important

dans l'environnement de test avant d'entrer en production ; pour le premier lot de production, il est recommandé de synchroniser 10 à 20 unités de niveaux de gris, puis de relâcher le volume après stabilisation.

01Exigences environnementales

  • Windows 10/11 (22H2+ recommandé, x64)
  • .NET Desktop Runtime 8.0 (x64)
  • Il est recommandé d'exécuter avec les privilèges d'administrateur (pour faciliter la lecture des informations complètes sur le matériel et le système)
  • Snipe-IT (avec au moins les autorisations de lecture et d'écriture des actifs, d'association composant/accessoire)
  • Le client est accessible sur le réseau Snipe-IT (autorisé par les politiques HTTP/HTTPS et proxy inverse)

02(environnements multiples)

{
  "Profiles": [
    {
      "Name": "Production",
      "ApiUrl": "http://snipeit.company.local/api/v1",
      "ApiKey": "YOUR_PROD_API_KEY",
      "TagPrefix": "AS-",
      "EnableComponents": true,
      "EnableAccessories": true,
      "Location": "HQ",
      "Company": "JianXiu Tech"
    },
    {
      "Name": "Lab",
      "ApiUrl": "http://snipeit-lab.local/api/v1",
      "ApiKey": "YOUR_LAB_API_KEY",
      "TagPrefix": "LAB-",
      "EnableComponents": false,
      "EnableAccessories": false,
      "Location": "LAB",
      "Company": "JianXiu Tech"
    }
  ]
}

Il est recommandé de confier la clé API au mécanisme de sécurité du système pour la conserver et de ne pas la stocker en texte brut sur une machine partagée pendant une longue période.

02.1Les informations d'identification sensibles telles que

est utilisé pour unifier la dénomination de mappage des « composants, accessoires et modèles » dans Snipe-IT afin d'éviter les échecs d'association ou la création de doublons lors de la synchronisation.

{
  "ActiveProfile": "默认",
  "Profiles": {
    "默认": {
      "InternalUrl": null,
      "ExternalUrl": null,
      "ApiKey": null,
      "Department": null,
      "AssignName": null,
      "AssignUser": null,
      "AssignPassword": null,
      "EmailSuffix": "example.com",
      "ASSET_TAG_PREFIX": "DOZ",
      "CATEGORY_ID_MAP": {
        "笔记本电脑": 4,
        "台式机": 3,
        "显示器": 5
      },
      "COMPONENT_CATEGORY_ID_MAP": {
        "处理器": 7,
        "内存": 9,
        "硬盘": 10
      },
      "ACCESSORY_CATEGORY_ID_MAP": {
        "键盘": 15,
        "鼠标": 16
      },
      "CATEGORY_CODE_MAP": {
        "笔记本电脑": "BJB",
        "台式机": "TSJ"
      }
    }
  }
}
  • Il est recommandé de pré-construire d'abord la cible dans Snipe-IT Model、Component、Accessory, effectuez à nouveau la synchronisation par lots.
  • Gardez un nom unique et stable pour éviter les synonymes qui conduisent à des objets en double (par ex. 16G / 16GB）。
  • est mis en ligne pour la première fois, il est recommandé d'échantillonner 10 unités pour vérifier le mappage avant d'étendre le lot.

03Procédures opérationnelles recommandées (environnement de production)

  1. Étape de préparation (avant de se connecter)
    • Confirmez que le paramètre actuellement sélectionné Production pour éviter d’écrire par erreur l’environnement de test.
    • Catalogue ApiUrl、ApiKey, les commutateurs de composants/accessoires correspondent à la portée de cet inventaire.
    • Utilisez d’abord un prototype de machine pour vérifier la connectivité (peut numériser, synchroniser et réécrire les champs clés).
  2. (d'abord locale, puis synchronisée)
    • effectue une analyse locale, en se concentrant sur la vérification si le numéro de série, le numéro de modèle et l'étiquette d'inventaire sont complets.
    • Remplissez ou marquez d'abord les champs de valeur nulle pour éviter de synchroniser directement les données modifiées avec la bibliothèque d'actifs.
    • Il est recommandé de créer des tâches par lots en fonction des départements/étages (par exemple, 30 à 50 unités par lot).
  3. Étape de vérification (vérification par échantillonnage)
    • Échantillonner 3 à 5 unités dans chaque lot et vérifier le mappage des étiquettes d'actifs, des numéros de série, des modèles et des champs d'emplacement.
    • Confirmation que le comportement « La mise à jour de l'actif existe/Le nouvel actif n'existe pas » est comme prévu.
    • Si un mauvais alignement de champ est détecté, corrigez la configuration de mappage avant de poursuivre les lots suivants.
  4. Étape de synchronisation (avancement en niveaux de gris)
    • Synchronisez d'abord par petits lots (10 à 20 unités sont recommandées pour le premier lot) et observez le code d'erreur et le taux d'échec.
    • Développez le lot après avoir confirmé la stabilité pour éviter la pression de restauration causée par une importation complète unique.
    • Exportez un instantané (CSV/PDF) immédiatement après la fin de chaque lot et enregistrez le numéro de lot.
  5. (stop loss en premier)
    • Lorsqu'une défaillance à grande échelle se produit, les lots suivants seront suspendus et aucune réexécution complète ne sera effectuée.
    • est traité selon les groupes de codes d'erreur (autorisation 401/403, chemin 404, conflit 409, champ 422).
    • Après réparation, seuls les objets ayant échoué sont réessayés et les objets réussis ne sont pas écrits à plusieurs reprises.
  6. Phase de clôture (archivage et révision)
    • archive « instantané d'analyse + résultats de synchronisation + liste d'exceptions + journal des opérations ».
    • enregistre cette modification de configuration et les conclusions de la gestion des problèmes, et met à jour la SOP de l'équipe.

04Suggestions de filtrage et de débruitage

"IGNORE_KEYWORDS": [
  "VMware", "Virtual", "Hyper-V", "Loopback", "Bluetooth",
  "WAN Miniport", "Teredo", "Docker", "vEthernet"
]

est utilisé pour filtrer les cartes réseau virtuelles, les adaptateurs de tunnel et les interfaces temporaires afin de réduire le bruit des actifs non valides.

05Suggestions d’exportation et d’archivage

  • Il est recommandé d'exporter CSV + PDF en même temps pendant la phase d'inventaire pour faciliter le rapprochement du système et la conservation manuelle des signatures.
  • Suggestions de noms :site-dept-date-batch,Par exemple hq-it-2026-04-08-b01。
  • Placez « instantané d'analyse + résultat de synchronisation + liste d'exceptions » dans le même répertoire d'archives pour faciliter l'examen d'audit.

Questions fréquemment posées et dépannage

Il est recommandé de lire d'abord « Phénomènes → Cause → Étapes de traitement » et de procéder au dépannage afin de localiser rapidement le problème.

1) Le numéro de série ne peut pas être scanné ou le numéro de modèle est vide ?
Raisons courantes : autorisations insuffisantes, service WMI anormal et informations manquantes sur le BIOS du périphérique.
  • Exécutez Asset Sonar en tant qu'administrateur.
  • Vérifiez si le service WMI (Winmgmt) est normal.
  • Vérifiez dans le BIOS/UEFI que le champ du numéro de série n'est pas effacé.
2) Impossible de connecter Snipe-IT (401/403/404) ?
Confirmez d'abord que l'adresse API contient /api/v1, vérifiez à nouveau la clé et les autorisations.
  • 401: la clé API est incorrecte ou a expiré.
  • 403: autorisations de clé insuffisantes (pas d'autorisations d'écriture/d'association).
  • 404: Erreur de chemin, le proxy inverse ne transmet pas la route API.
3) Des ressources en double apparaissent après la synchronisation ?
proviennent généralement de « numéros de série incohérents » ou de « données historiques sales ».
  • donne la priorité au « numéro de série + étiquette d'actif » comme stratégie de clé primaire.
  • Remplissez manuellement les actifs de numéro de série vides historiques ou marquez-les pour l'archivage.
  • Exécutez d'abord un batch dans l'environnement de test pour confirmer la stratégie de duplication avant de la lancer en production.
4) L'association composant/accessoire a échoué ?
est plus courant lorsque l'objet cible n'existe pas ou que le mappage d'ID échoue.
  • Confirmez que les composants et accessoires cibles existent dans Snipe-IT et peuvent être alloués.
  • Vérifiez s'il est activé dans les profils EnableComponents / EnableAccessories。
  • Vérifiez le nom et l'ID de l'objet dans le journal des échecs, corrigez le mappage et réessayez.
5) La vitesse de numérisation est lente ou l'interface utilisateur est bloquée ?
recommande de réduire la simultanéité, de restreindre la portée de l'analyse et de filtrer les périphériques virtuels.
  • effectue d'abord la collecte du champ principal du matériel, puis effectue une analyse supplémentaire du champ étendu.
  • Excluez les cartes réseau virtuelles et les interfaces non valides pour réduire le bruit.
  • Exécuter l'inventaire par lots volumineux (par département/étage).
6) Le fichier exporté est tronqué ou les champs sont mal alignés ?
est généralement dû à des différences d’encodage ou de paramètres régionaux.
  • CSV Il est recommandé d'utiliser l'outil de table d'importation UTF-8 (y compris la nomenclature).
  • Unifiez le format de date et les règles de virgule décimale pour éviter les différences de localisation.
  • à plusieurs équipes, donnez la priorité à l'utilisation de la version d'archive PDF pour éviter toute déformation.
7) Pourquoi y a-t-il « un succès partiel et un échec partiel » ?
Il s'agit d'une stratégie de protection normale dans les scénarios de traitement par lots : les éléments réussis sont d'abord déposés dans la bibliothèque, et les éléments ayant échoué sont placés dans la file d'attente des nouvelles tentatives.
  • Exportez d’abord la liste des échecs et traitez-la en groupes en fonction des codes d’erreur.
  • Après avoir corrigé les autorisations/mappings/réseaux, réessayez simplement les lots ayant échoué.
  • évite une réexécution complète et réduit le risque d'écriture répétée et de données sales.
8) Comment se connecter en toute sécurité dans l'environnement de production ?
recommande la méthode « niveaux de gris en ligne » :
  1. Premier test exécuté dans Lab Profile et vérification du mappage de champ.
  2. L'environnement de production sélectionne d'abord une petite plage d'actifs pour le premier lot de synchronisation.
  3. Étendez la portée après avoir confirmé qu'il n'y a aucune anomalie et conservez les instantanés d'exportation de chaque lot.

(HTTP/erreurs courantes)

est utilisé pour déterminer rapidement par où commencer en cas de « problèmes de configuration, de problèmes d'autorisation et de réseau ».

Code d'erreur/phénomène Raisons typiques Prioriser les étapes
401 Unauthorized est erronée, expirée ou révoquée Régénérez la clé et confirmez que le format d'en-tête de demande et le profil sont efficaces
403 Forbidden La clé a une autorisation insuffisante (pas d'écriture/association) Ajouter des autorisations liées aux actifs, composants et accessoires à la clé
404 Not Found , manquante /api/v1 Correction d'ApiUrl, vérification des règles de transfert de proxy inverse
409 Conflict Conflit d’étiquette d’actif ou de numéro de série Appuyez d'abord sur la touche primaire pour supprimer les doublons, puis effectuez une synchronisation incrémentielle.
422 Unprocessable Entity ne répond pas aux exigences de l'API Vérifiez les champs obligatoires, la longueur, la valeur d'énumération et le format de date
429 Too Many Requests Une fréquence de demande trop élevée déclenche une limitation de courant Réduire la simultanéité et augmenter les intervalles entre les tentatives d'attente et les lots
500 / 503 Exception du serveur ou fenêtre de maintenance Conservez les lots ayant échoué, réessayez à intervalles réguliers et contactez l'administrateur du serveur.
Délai de connexion/échec TLS Le réseau est inaccessible et la chaîne de certificats est anormale. Testez d'abord la connectivité, puis vérifiez le certificat et la synchronisation de l'heure

(version d'exécution sur site)

Lorsque la synchronisation est anormale, il est recommandé d'exécuter dans l'ordre suivant afin de réduire les erreurs d'évaluation et les opérations répétées.

Phase A : connectivité de base

  1. Vérifiez si ApiUrl est accessible (y compris /api/v1）。
  2. Vérifie la résolution DNS, les stratégies de port et les règles de proxy.
  3. Confirmez que l’heure système de l’appareil est exacte pour éviter un échec de vérification TLS.

Phase B : autorisations et configuration

  1. Vérifiez la validité de la clé API et les autorisations de rôle.
  2. Confirmez que l'environnement correct (Lab/Prod) est sélectionné dans Profil.
  3. Vérifiez que les commutateurs des composants/accessoires sont cohérents avec le mappage.

Phase C : Qualité des données et déduplication

  1. Vérifiez les champs du numéro de série, de l'étiquette d'inventaire et du modèle de manière aléatoire.
  2. Nettoyer les numéros de série vides historiques et les actifs en double.
  3. Créez une table de suivi « code d'erreur → gestionnaire » pour les lots ayant échoué.

Phase D : Récupération et relecture

  1. Réessayez uniquement les lots ayant échoué pour éviter les réexécutions complètes.
  2. Exportez la « liste de réussites/échecs » et archivez-la.
  3. Enregistrez la cause première et le plan de réparation, et mettez à jour les SOP de l'équipe.

Carte de dépannage rapide en 5 minutes (urgence en service)

convient aux scénarios dans lesquels « la scène est urgente, restaurez d'abord puis creusez plus profondément ». Triez d’abord le problème, puis entrez le runbook complet.

1ère minute

Voir code erreur

Faites d'abord la distinction entre 4xx / 5xx / timeout et décidez s'il faut utiliser l'autorité ou la ligne réseau.

2ème minute

Vérifier l'URL et la clé

confirmer /api/v1, le profil, la clé API et les autorisations sont-ils corrects ?

3-4 minutes

Réessayez par petits lots

Réessayez uniquement les objets ayant échoué et n'effectuez pas de réexécutions complètes pour éviter d'amplifier l'impact.

5ème minute

Laisser des preuves

Exporter la liste des échecs + fragments de journal, rapport et remise selon le modèle d'ordre de travail.