Centro de documentación

Project A

EasyOps Documentación

Knowledge Base

Base de conocimientos de operación y mantenimiento de pila completa

Puntos clave:admite la recuperación sin conexión y la navegación clasificada, adaptándose a escenarios de salas de ordenadores sin red.

Ingeniería de redes

Comprobación rápida de comandos Huawei/H3C/Cisco, resolución de problemas de OSPF/STP.

Seguridad actual débil

Depuración de IPC, diagrama de cableado de control de acceso, monitoreo de pantalla negra y ubicación de fallas de PTZ.

Operación y mantenimiento de computadoras de escritorio

Solución de problemas de Windows, problemas de uso compartido de impresoras, reparación de DNS/IP.

Linux/Servidor

Comandos comunes de Shell, mantenimiento de RAID, configuración y refuerzo de firewall.

Nativo de la nube

Comandos comunes de Docker/K8s, diagnóstico de excepciones de Pod y verificación rápida de implementación.

Base de conocimientos

Manual de operación y mantenimiento de MySQL/Redis, consulta lenta y guía de respaldo y recuperación.

Toolbox

Caja de herramientas de ingeniería

Puntos clave:Las capacidades de alta frecuencia en el sitio están organizadas jerárquicamente según "cálculo + diagnóstico + consulta + operación y mantenimiento" para facilitar la ubicación rápida de las herramientas.

Almacenamiento de seguridad

Estimación de capacidad del disco duro NVR

Asociación de componentes

Informática de difusión y alcance IP

Consumo de energía PoE

Presupuesto de alimentación del terminal

Atenuación de fibra

Estimación de pérdida de dB del enlace

Diagnóstico de red

Ping TCP/Escaneo de puertos/Escaneo LAN

Centro de Operación y Mantenimiento de Redes

Detección HTTP/WOL/Agregación de herramientas

Centro de consultas de red

DNS / Whois(RDAP) / OUI

Acuerdo de servicio de usuario

/sondeo de estado/comando rápido

Primeras instrucciones de inicialización

Puntos clave:a Internet por primera vez para descargar aproximadamente 15 MB de datos centrales. Se puede utilizar sin conexión una vez completada la inicialización.

Prioridad local:La base de conocimientos, las colecciones, el historial y los resultados del análisis se almacenan localmente en el dispositivo de forma predeterminada y los datos principales no se cargan.

Almacenamiento seguro:se guardan utilizando las capacidades de seguridad del sistema (como Llavero) para evitar la exposición de texto claro.

Project Divider

Project B

Asset Sonar Documentación

Implementación y configuración

Se recomienda completar un simulacro de proceso completo (escanear → verificar → sincronizar → exportar) en el entorno de prueba antes de cambiar a la configuración de producción.

Recordatorio importante

en el entorno de prueba antes de ingresar a producción; para el primer lote de producción, se recomienda sincronizar de 10 a 20 unidades en escala de grises y luego liberar el volumen después de la estabilización.

01Requisitos medioambientales

Windows 10/11 (se recomienda 22H2+, x64)
.NET Desktop Runtime 8.0 (x64)
Se recomienda ejecutar con privilegios de administrador (para facilitar la lectura de información completa del hardware y del sistema)
Clave API Snipe-IT (con al menos lectura y escritura de activos, permisos de asociación de componentes/accesorios)
Se puede acceder al cliente en la red Snipe-IT (permitido por HTTP/HTTPS y políticas de proxy inverso)

02perfiles.json (múltiples entornos)

{
  "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"
    }
  ]
}

Se recomienda que la clave API se entregue al mecanismo de seguridad del sistema para su custodia y no se almacene en texto sin formato en una máquina compartida durante mucho tiempo.

02.1Accesorios/Componentes/Referencia de configuración del modelo

se utiliza para unificar la denominación de mapeo de "componentes, accesorios y modelos" en Snipe-IT para evitar fallas de asociación o creación de duplicados durante la sincronización.

{
  "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"
      }
    }
  }
}

Se recomienda crear previamente el objetivo en Snipe-IT primero. Model、Component、Accessory, vuelva a realizar la sincronización por lotes.
Mantenga nombres únicos y estables para evitar sinónimos que conduzcan a objetos duplicados (p. ej. 16G / 16GB）。
se conecta por primera vez, se recomienda tomar una muestra de 10 unidades para verificar el mapeo antes de expandir el lote.

03Procedimientos operativos recomendados (entorno de producción)

Etapa de preparación (antes de conectarse)
- Confirme que el actualmente seleccionado Production Perfil para evitar escribir por error el entorno de prueba.
- Catálogo ApiUrl、ApiKey, los interruptores de componentes/accesorios son consistentes con el alcance de este inventario.
- Primero use una máquina prototipo para verificar la conectividad (puede escanear, sincronizar y escribir campos clave).
(primero local, luego sincronizada)
- realiza un escaneo local, enfocándose en verificar si el número de serie, el número de modelo y la etiqueta de activo están completos.
- Primero complete o marque los campos de valor nulo para evitar sincronizar directamente datos sucios con la biblioteca de activos.
- Se recomienda crear tareas en lotes según departamentos/pisos (por ejemplo, 30~50 unidades por lote).
Etapa de verificación (verificación de muestreo)
- Muestreo de 3 a 5 unidades en cada lote y verificación del mapeo de etiquetas de activos, números de serie, modelos y campos de ubicación.
- Se confirmó que el comportamiento de "Existe actualización de activo/El activo nuevo no existe" es el esperado.
- Si se encuentra una desalineación de campos, corrija la configuración de asignación antes de continuar con lotes posteriores.
Etapa de sincronización (avance en escala de grises)
- sincronice primero en lotes pequeños (se recomiendan de 10 a 20 unidades para el primer lote) y observe el código de error y la tasa de fallas.
- Amplíe el lote después de confirmar la estabilidad para evitar la presión de reversión causada por una importación completa única.
- Exporte una instantánea (CSV/PDF) inmediatamente después de completar cada lote y registre el número de lote.
(stop loss primero)
- Cuando se produce una falla a gran escala, los lotes posteriores se suspenderán y no se realizará una repetición completa.
- se procesa según grupos de códigos de error (permiso 401/403, ruta 404, conflicto 409, campo 422).
- Después de la reparación, sólo se reintentan los objetos fallidos y los objetos exitosos no se escriben repetidamente.
Etapa de cierre (archivo y revisión)
- archiva "instantánea de escaneo + resultados de sincronización + lista de excepciones + registro de operaciones".
- registra este cambio de configuración y las conclusiones sobre el manejo del problema, y actualiza el SOP del equipo.

04sugerencias de filtrado y eliminación de ruido

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

se utiliza para filtrar tarjetas de red virtuales, adaptadores de túnel e interfaces temporales para reducir el ruido de activos no válidos.

05Sugerencias de exportación y archivado

Se recomienda exportar CSV + PDF al mismo tiempo durante la etapa de inventario para facilitar la conciliación del sistema y la retención manual de firmas.
Sugerencias de nombres:site-dept-date-batch,Por ejemplo hq-it-2026-04-08-b01。
Coloque "instantánea del escaneo + resultado de sincronización + lista de excepciones" en el mismo directorio de archivo para facilitar la revisión de auditoría.

Preguntas frecuentes y solución de problemas

Se recomienda leer primero "Fenómenos → Causa → Pasos del tratamiento" y solucionar el problema para localizarlo rápidamente.

1) ¿No se puede escanear el número de serie o el número de modelo está vacío?

Motivos comunes: permisos insuficientes, servicio WMI anormal y falta información del BIOS del dispositivo.

Ejecute Asset Sonar como administrador.
Compruebe si el servicio WMI (Winmgmt) es normal.
Verifique en BIOS/UEFI que el campo del número de serie no esté borrado.

2) ¿No se puede conectar Snipe-IT (401/403/404)?

Primero confirme que la dirección API contiene /api/v1, verifique la clave y los permisos nuevamente.

401: La clave API es incorrecta o ha caducado.
403: Permisos de clave insuficientes (sin permisos de escritura/asociación).
404: Error de ruta, el proxy inverso no reenvía la ruta API.

3) ¿Aparecen activos duplicados después de la sincronización?

generalmente provienen de "números de serie inconsistentes" o "datos históricos sucios".

da prioridad al "número de serie + etiqueta de activo" como estrategia de clave principal.
Complete manualmente los activos históricos de números de serie vacíos o márquelos para archivarlos.
Primero ejecute un lote en el entorno de prueba para confirmar la estrategia de duplicación antes de lanzarlo a producción.

4) ¿Error en la asociación de componente/accesorio?

es más común cuando el objeto de destino no existe o falla la asignación de ID.

Confirme que los componentes y accesorios de destino existen en Snipe-IT y se pueden asignar.
Comprobar si está habilitado en perfiles EnableComponents / EnableAccessories。
Verifique el nombre y el ID del objeto en el registro de fallas, corrija la asignación y vuelva a intentarlo.

5) ¿La velocidad de escaneo es lenta o la interfaz de usuario está bloqueada?

recomienda reducir la simultaneidad, limitar el alcance del análisis y filtrar los dispositivos virtuales.

realiza primero la recopilación del campo principal del hardware y luego realiza el escaneo complementario del campo extendido.
Excluir tarjetas de red virtuales e interfaces no válidas para reducir el ruido.
Ejecutar inventario de lotes grandes en lotes (por departamento/piso).

6) ¿El archivo exportado está confuso o los campos están desalineados?

suele deberse a diferencias en la codificación o la configuración regional.

CSV Se recomienda utilizar la herramienta de importación de tablas UTF-8 (incluida BOM).
Unifique el formato de fecha y las reglas del punto decimal para evitar diferencias de localización.
a todos los equipos, dé prioridad al uso de la versión de archivo PDF para evitar deformaciones.

7) ¿Por qué hay "éxito parcial y fracaso parcial"?

Esta es una estrategia de protección normal en escenarios de procesamiento por lotes: los elementos exitosos se colocan primero en la biblioteca y los elementos fallidos se colocan en la cola de reintento.

Primero exporte la lista de fallas y procésela en grupos según los códigos de error.
Después de arreglar permisos/asignaciones/redes, simplemente vuelva a intentar los lotes fallidos.
evita la repetición completa y reduce el riesgo de escritura repetida y datos sucios.

8) ¿Cómo conectarse de forma segura en el entorno de producción?

recomienda el método "escala de grises en línea":

Primera ejecución de prueba en Lab Profile y verificar el mapeo de campo.
El entorno de producción primero selecciona una pequeña gama de activos para el primer lote de sincronización.
Amplíe el alcance después de confirmar que no hay anomalías y conserve las instantáneas de exportación de cada lote.

(HTTP/errores comunes)

se utiliza para determinar rápidamente por dónde empezar con "problemas de configuración, problemas de permisos y problemas de red".

Código/fenómeno de error	Razones típicas	Priorizar pasos
`401 Unauthorized`	La clave API es incorrecta, caducada o revocada	Regenerar la clave y confirmar que el formato del encabezado de solicitud y el perfil son efectivos
`403 Forbidden`	La clave no tiene permiso suficiente (sin escritura/asociación)	Agregar permisos relacionados con activos, componentes y accesorios a la clave
`404 Not Found`	Error de ruta URL, falta `/api/v1`	Arreglar ApiUrl, verificar las reglas de reenvío de proxy inverso
`409 Conflict`	Conflicto entre etiqueta de activo o número de serie	Presione la tecla principal para eliminar duplicados primero y luego realice la sincronización incremental.
`422 Unprocessable Entity`	no cumple con los requisitos de API	Verifique los campos obligatorios, la longitud, el valor de enumeración y el formato de fecha
`429 Too Many Requests`	Una frecuencia de solicitud demasiado alta activa la limitación de corriente	Reducir la simultaneidad y aumentar los reintentos de retroceso y los intervalos por lotes
`500 / 503`	Ventana de excepción o mantenimiento del servidor	Mantenga los lotes fallidos, vuelva a intentarlo a intervalos y comuníquese con el administrador del servidor
Tiempo de espera de conexión/fallo de TLS	La red es inaccesible y la cadena de certificados es anormal.	Pruebe primero la conectividad, luego verifique el certificado y la sincronización horaria

Runbook de solución de problemas (versión de ejecución in situ)

Cuando la sincronización es anormal, se recomienda ejecutarla en el siguiente orden para reducir errores de juicio y operaciones repetidas.

Fase A: Conectividad Básica

Compruebe si se puede acceder a ApiUrl (incluido /api/v1）。
Verifica la resolución de DNS, las políticas de puertos y las reglas de proxy.
Confirme que la hora del sistema del dispositivo sea precisa para evitar fallas en la verificación TLS.

Fase B: Permisos y Configuración

Verificar la validez de la clave API y los permisos de rol.
Confirme que esté seleccionado el entorno correcto (Lab/Prod) en Perfil.
Compruebe si el interruptor de componente/accesorio es coherente con la asignación.

Fase C: Calidad de datos y deduplicación

Verifique los campos de número de serie, etiqueta de activo y modelo de forma aleatoria.
Limpiar números de serie vacíos históricos y activos duplicados.
Cree una tabla de seguimiento de "código de error → controlador" para lotes fallidos.

Fase D: Recuperación y Reproducción

Reintente solo los lotes fallidos para evitar reejecuciones completas.
Exporte la "lista de éxitos/fracasos" y archívela.
Registre la causa raíz y el plan de reparación, y actualice el SOP del equipo.

Tarjeta de resolución rápida de problemas de 5 minutos (emergencia en servicio)

es adecuado para escenarios donde "la escena es urgente, restaure primero y luego profundice". Primero evalúe el problema y luego ingrese el runbook completo.

1er minuto

Ver código de error

Primero distinga entre 4xx / 5xx / tiempo de espera y decida si usará la línea de autoridad o de red.

2do minuto

Verificar URL y clave

confirmar /api/v1, perfil, clave API y permisos?

3-4 minutos

Reintentar en lotes pequeños

solo reintenta objetos fallidos y no realiza repeticiones completas para evitar amplificar el impacto.

5to minuto

dejar evidencia

Exportar lista de fallas + fragmentos de registro, informar y entregar de acuerdo con la plantilla de orden de trabajo.

Sugerencias de control.