Studio TCS.net

Wykrywanie sprzętu IT - import raportu JSON z agenta

Ewidencja rozjeżdża się z rzeczywistością po pierwszej wymianie dysku. Pokazujemy, jak raport z agenta trafia do ewidIT, jak program dopasowuje urządzenia i o czym decyduje operator.

W skrócie

Wykrywanie sprzętu IT to porównanie ewidencji z danymi zebranymi na stacjach roboczych: numerem seryjnym, pamięcią RAM, dyskami, systemem i zainstalowanymi programami. W ewidIT sieci nie skanuje sam moduł. Agent albo konektor zapisuje raport w pliku JSON, operator IT wczytuje go na ekranie Wykrywanie, a program dopasowuje urządzenia do kart sprzętu, uzupełnia dane i zgłasza to, co się nie zgadza.

Ewidencja prowadzona ręcznie rozjeżdża się z rzeczywistością po pierwszej wymianie dysku albo po przeniesieniu laptopa do innego działu. Poniżej opisano, co zawiera raport, jak program dopasowuje urządzenie, które dane aktualizuje sam i o jakich zmianach decyduje operator. Funkcja jest częścią systemu ewidencji sprzętu IT ewidIT w Studio TCS.net.

Skąd bierze się raport z agenta

Agent to skrypt PowerShell zgodny z Windows PowerShell 5.1. Odczytuje konfigurację lokalnego komputera przez CIM/WMI i rejestr, a wynik zapisuje w pliku JSON w schemacie raportu ewidIT. Opis agenta wyklucza zbieranie haseł, plików i historii przeglądania. Jeden raport opisuje jeden komputer:

Pole raportuCo zawiera
host, uuid, snnazwa komputera, UUID z SMBIOS, numer seryjny z BIOS
producent, modelproducent i model komputera
cpu, ram_gbnazwa procesora z liczbą rdzeni, pamięć RAM w GB
dyskinumer seryjny, model, pojemność i szyfrowanie każdego dysku
siecadres MAC i adres IP każdej aktywnej karty sieciowej
os, uzytkowniknazwa i wersja systemu, ostatnio zalogowany użytkownik
oprogramowanienazwa, wydawca, wersja i data instalacji każdego programu

Stan szyfrowania dysku agent sprawdza tylko wtedy, gdy działa z uprawnieniami administratora. Bez nich pole zostaje puste, a program nie zakłada incydentu braku szyfrowania. Raport dla jednego komputera wygląda tak (skrócony, dane przykładowe):

{
  "schemat": "ewit-raport/1",
  "zebrano": "2026-10-19T09:15:00",
  "host": "DEMO-PRZYKLAD-01",
  "sn": "DEMOSN000001",
  "ram_gb": 16,
  "dyski": [ { "sn": "DEMODYSK000001", "gb": 512, "szyfrowanie": true } ],
  "siec": [ { "mac": "00:00:5E:00:53:01", "ip": "192.0.2.15" } ],
  "os": { "nazwa": "Microsoft Windows 11 Pro", "wersja": "10.0.26100" }
}

Wczytanie raportu na ekranie Wykrywanie

Ekran znajduje się w menu Inwentaryzacja, a w pasku ewidIT jako zakładka Wykrywanie obok Licencji i Zgodności. Na górze jest pole „Wczytaj raport JSON”. Operator wskazuje plik z agenta albo z konektora i naciska Wczytaj. Plik może zawierać jeden raport albo paczkę w postaci {"raporty":[...]}, czyli dane wielu komputerów naraz.

Droga raportu od stacji do wyników wykrywaniaSchemat: agent albo konektor zapisuje plik JSON, operator wczytuje go na ekranie Wykrywanie, program dopasowuje urządzenia i kieruje wyniki do czterech zakładek: rozbieżności, incydenty, nieznane urządzenia i raporty.Od stacji roboczej do decyzji operatora1Agentlub konektorzapisuje plik JSON2Wczytanieoperator wskazujeplik i klika Wczytaj3DopasowanieUUID, SN,MAC, host4Wynikicztery zakładkido rozstrzygnięciaRozbieżnościIncydentyNieznane urządzeniaRaportyModuł nie skanuje sieci: plik z danymi dostarcza agent albo konektor.
Plik z agenta albo konektora trafia na ekran Wykrywanie, a stamtąd do czterech zakładek wyników

Przeglądarka sprawdza, czy plik jest poprawnym JSON, i wysyła go do bazy w częściach, więc operator nie musi niczego dzielić ręcznie. Granicą jest rozmiar raportu: procedura odrzuca tekst dłuższy niż 2 mln znaków. Większą liczbę komputerów trzeba rozłożyć na kilka plików i wczytać je jeden po drugim. Raporty wczytuje operator IT albo administrator firmy, pracownik ich nie widzi.

Po wczytaniu program podaje wynik w jednym komunikacie: ile raportów przetworzył, ile dopasował do kart sprzętu, ile dotyczyło nieznanych urządzeń oraz ile powstało nowych rozbieżności i incydentów.

Dopasowanie raportu do karty sprzętu

Program szuka karty sprzętu po kolejnych identyfikatorach i zatrzymuje się na pierwszym trafieniu. Pomija sprzęt zlikwidowany i sprzedany.

KrokKluczUwaga
1UUID z SMBIOSnajpewniejszy klucz, przeżywa zmianę nazwy komputera
2numer seryjnyz BIOS albo z identyfikatora produktu
3adres MACkażdy z adresów aktywnych kart
4nazwa hostaostatnia deska ratunku, bo nazwę łatwo zmienić
Kolejność dopasowania raportu do karty sprzętuSchemat: program szuka karty po UUID, potem po numerze seryjnym, adresie MAC i nazwie hosta. Trafienie daje status dopasowany, brak trafienia na liście nieznanych urządzeń.Pierwsze trafienie wygrywa1UUIDSMBIOSbrak2Numerseryjnybrak3AdresMACbrak4NazwahostatrafienieDopasowanykarta sprzętu, aktualizacja danychbrak trafieńNieznane urządzenielista do przyjęcia + incydentSprzęt zlikwidowany i sprzedany jest pomijany. Raport bez żadnego z identyfikatorów kończy się błędem.
Dopasowanie zatrzymuje się na pierwszym trafieniu

Raport bez żadnego z tych identyfikatorów zostaje zapisany ze statusem błędu. Raport, którego nie udało się dopasować, trafia na listę nieznanych urządzeń. Każdy zapisany raport ma wynik: dopasowany, nieznane urządzenie albo błąd.

Co program aktualizuje sam, a o czym decyduje operator

Raport nie zmienia statusu ani przypisania sprzętu. O tym, kto ma laptop i w jakim jest stanie, decydują wyłącznie dokumenty. Raport może jedynie uzupełnić dane opisowe i zgłosić różnice.

DaneZachowanie programu
IP, nazwa hosta, wersja systemu, czas ostatniego raportuaktualizowane automatycznie przy każdym raporcie
Puste pola karty (UUID, numer seryjny, MAC, system, RAM, procesor)uzupełniane z raportu
Lista zainstalowanych programówzapisywana jako instalacje aktywne albo nieaktywne
RAM, procesor, dyskrozbieżność i incydent do wyjaśnienia
System, adres MAC, użytkownikrozbieżność bez incydentu
Dysk bez szyfrowaniaincydent do wyjaśnienia
Co robi program sam, a co zostawia operatorowiSchemat: raport automatycznie aktualizuje IP, nazwę hosta, wersję systemu, czas raportu i puste pola oraz listę programów. Zmiany RAM, procesora i dysku tworzą rozbieżność i incydent, a system, MAC i użytkownik rozbieżność. Operator wybiera: przyjmij do ewidencji, utwórz incydent albo zignoruj. Raport nie zmienia statusu ani przypisania sprzętu.Granica między automatem a decyzjąAutomatycznieIP i nazwa hostawersja systemuczas ostatniego raportupuste pola kartylista programówRozbieżność do decyzjiRAM, procesor, dysk(rozbieżność i incydent)system, adres MAC,użytkownik (rozbieżność)PrzyjmijIncydentZignorujRaport nie zmienia statusu ani przypisania sprzętu - robią to tylko dokumenty.
Raport uzupełnia dane opisowe, a o zmianach sprzętu decyduje operator

Dyski program porównuje po numerach seryjnych. Pierwszy raport zakłada składniki sprzętu, a każda późniejsza zmiana, na przykład wymiana dysku, jest rozbieżnością i incydentem. Rozbieżność dotycząca użytkownika pojawia się tylko wtedy, gdy sprzęt jest przypisany do osoby, a ostatnio zalogowany użytkownik jest kimś innym.

Zakładki wyników wykrywania

Wyniki trafiają do czterech zakładek.

Makieta ekranu WykrywanieMakieta poglądowa: pole wczytania raportu JSON, cztery zakładki wyników i lista rozbieżności z przyciskami Przyjmij do ewidencji, Utwórz incydent i Zignoruj. Dane przykładowe.Studio TCS.net · ewidIT · WykrywanieMakieta poglądowaWczytaj raport JSON (plik z agenta albo konektora)ewit-raport-DEMO-PRZYKLAD-01.jsonWczytajRozbieżnościIncydentyNieznane urządzeniaRaportyPrzyjmij do ewidencjiUtwórz incydentZignorujZasóbHostPoleW ewidencjiW raporcieIT-LAP-2026-00042DEMO-PRZYKLAD-01RAM_GB16 GB32 GBIT-LAP-2026-00057DEMO-PRZYKLAD-02DYSKDEMODYSK01DEMODYSK07IT-LAP-2026-00061DEMO-PRZYKLAD-03OSWindows 10 ProWindows 11 ProKomunikat po wczytaniu podaje liczby raportów, dopasowań, rozbieżności i incydentów.
Makieta poglądowa, dane przykładowe: ekran Wykrywanie z listą rozbieżności

Rozbieżności pokazują urządzenia, których dane różnią się od ewidencji: hosta, pole, wartość w ewidencji i wartość z raportu. Dla zaznaczonych wierszy operator wybiera jedną z trzech decyzji. „Przyjmij do ewidencji” aktualizuje kartę sprzętu o wartość z raportu. „Utwórz incydent” zgłasza rozbieżność jako problem do wyjaśnienia. „Zignoruj” zamyka wiersz bez zmian. Przyjęcie zmienia kartę sprzętu, więc program porównuje znacznik wersji rekordu. Jeśli ktoś inny zmienił ten sam sprzęt w międzyczasie, zapis jest odrzucany komunikatem „Rekord zmienił ktoś inny”. Przyjęcie rozbieżności dotyczącej użytkownika nie zmienia przypisania, bo to robi tylko dokument wydania albo zwrotu.

Incydenty to zgłoszenia utworzone z rozbieżności albo założone przez program: nowe urządzenie, zmiana składnika, brak szyfrowania i brak kontaktu z agentem. Incydent ma status otwarty, wyjaśniany albo zamknięty, a zamknięcie wymaga opisu rozstrzygnięcia.

Nieznane urządzenia zbierają sprzęt z raportu, którego nie udało się dopasować do żadnej karty. Operator może go przyjąć do ewidencji: wskazuje model z katalogu, a program tworzy dokument przyjęcia z danymi z raportu (numer seryjny, MAC, UUID, host, system) i nadaje numer inwentarzowy z licznika kategorii. Nowy sprzęt trafia do magazynu IT, a incydent nowego urządzenia zamyka się sam. Przypisania raportu do już istniejącej karty ten ekran nie oferuje.

Makieta okna przyjęcia nieznanego urządzeniaMakieta poglądowa: okno przyjęcia do ewidencji z informacją o dokumencie przyjęcia, wyborem modelu z katalogu i przyciskami Przyjmij oraz Anuluj. Dane przykładowe.Studio TCS.net · ewidIT · Nieznane urządzeniaMakieta poglądowaPrzyjęcie do ewidencji: DEMO-PRZYKLAD-09Powstanie dokument przyjęcia z danymi z raportu (numer seryjny, MAC,UUID, host, system) i numer inwentarzowy z licznika kategorii modelu.Model z katalogu *Dell Latitude 5450PrzyjmijAnulujPo przyjęciu sprzęt trafia do magazynu IT, a incydent nowego urządzenia zamyka się sam.
Makieta poglądowa, dane przykładowe: przyjęcie nieznanego urządzenia do ewidencji

Raporty zawierają historię wczytanych raportów: źródło, host, powiązany sprzęt i wynik. Treść JSON jest usuwana po 90 dniach (parametr firmy), a wynik uzgodnienia zostaje.

Agenci, którzy przestali raportować

Kokpit ewidIT ma kafle Incydenty otwarte, Rozbieżności i Agenci milczący. Zadanie dzienne zakłada incydent braku kontaktu dla sprzętu, który nie przysłał raportu od ponad 14 dni (próg ustawia firma). Jeden sprzęt ma najwyżej jeden otwarty incydent tego rodzaju. Gdy agent przyśle kolejny raport, incydent zamyka się z opisem „Agent ponownie raportuje”.

Brak raportu przez 14 dni i powrót agentaOś czasu: po ostatnim raporcie mija próg 14 dni, zadanie dzienne zakłada jeden incydent braku kontaktu, a kolejny raport agenta zamyka go automatycznie.Agent milczący i incydent braku kontaktuostatni raportdzień 14nowy raportagent milczyotwarty incydentPróg ustawia firma (domyślnie 14 dni). Jeden sprzęt ma najwyżej jeden otwarty incydent tego rodzaju.Kolejny raport zamyka incydent z opisem „Agent ponownie raportuje”.
Brak raportu przez 14 dni zakłada incydent, a powrót agenta zamyka go

Oprogramowanie z raportu i zgodność licencji

Lista programów z każdego raportu trafia do instalacji. Program porównuje nazwę i wydawcę ze wzorcami produktów w katalogu i rozpoznaje instalację jako konkretny produkt. Programy, które zniknęły z raportu, zostają oznaczone jako nieaktywne, a pierwszy i ostatni raport każdej instalacji są zapisane. Dane zasilają ekran Zgodność licencji, który zestawia licencje posiadane z zużytymi, więc niedobór widać zanim zobaczy go audytor producenta.

Czego moduł nie robi

Zakres funkcji jest wąski i zamierzony. Moduł nie wykonuje czterech rzeczy:

  • nie skanuje sieci z przeglądarki ani z serwera,
  • nie instaluje agentów na stacjach,
  • nie zmienia statusu i przypisania sprzętu na podstawie raportu,
  • nie pobiera raportu sam: plik dostarcza agent albo konektor, a wczytuje go operator.

Lista oprogramowania i ostatnio zalogowany użytkownik to dane o pracy pracownika. Firma informuje o ich zbieraniu w obowiązku informacyjnym (art. 13 RODO) i w regulaminie pracy, a zakres ocenia prawnik.

Słownik pojęć

AAgent
Skrypt PowerShell uruchamiany na stacji roboczej. Odczytuje konfigurację komputera i zapisuje ją w pliku JSON.
KKonektor
Narzędzie zbierające dane z wielu urządzeń i zapisujące je w formacie raportu ewidIT. Dostarcza plik, który wczytuje operator.
RRaport JSON
Plik z danymi jednego komputera albo paczka {"raporty":[...]}: numer seryjny, UUID, MAC, RAM, dyski, system i programy.
UUUID SMBIOS
Identyfikator komputera zapisany w firmware. Pierwszy klucz, po którym ewidIT dopasowuje raport do karty sprzętu.
RRozbieżność
Różnica między wartością w ewidencji a wartością w raporcie. Operator przyjmuje ją do ewidencji, zgłasza jako incydent albo ignoruje.
IIncydent
Zgłoszenie do wyjaśnienia, na przykład zmiana dysku, nowe urządzenie, brak szyfrowania albo brak kontaktu z agentem. Zamyka się z opisem rozstrzygnięcia.
FAQ

Pytania o wykrywanie sprzętu IT

01

Jak wykryć nieznany sprzęt w sieci firmowej i dodać go do ewidencji?

Uruchom agenta na stacjach albo zbierz dane konektorem, a wygenerowany plik JSON wczytaj na ekranie Wykrywanie. Urządzenia, których nie da się dopasować po UUID, numerze seryjnym, adresie MAC ani nazwie hosta, trafią do zakładki Nieznane urządzenia. Przyjmujesz je do ewidencji, wskazując model z katalogu, a program tworzy dokument przyjęcia i numer inwentarzowy.

02

Czym różni się agent od skanera sieciowego przy ewidencji sprzętu IT?

Agent działa na samej stacji i odczytuje jej konfigurację przez CIM/WMI i rejestr, więc zna numer seryjny, dyski z numerami i listę zainstalowanych programów. Skaner sieciowy widzi urządzenia z zewnątrz, bez tych danych. ewidIT nie skanuje sieci: przyjmuje raporty z agenta albo z konektora i porównuje je z ewidencją.

03

Co zrobić, gdy raport pokazuje inną ilość RAM niż ewidencja?

Zmiana RAM, procesora albo dysku tworzy rozbieżność i incydent. Na zakładce Rozbieżności wybierasz: przyjmij do ewidencji, jeśli wymiana była zamierzona, utwórz incydent, jeśli wymaga wyjaśnienia, albo zignoruj. Incydent zamykasz z opisem rozstrzygnięcia.

04

Czy ewidIT może zmienić przypisanie sprzętu na podstawie raportu?

Nie. Raport uzupełnia dane opisowe i zgłasza różnice, ale status i przypisanie sprzętu zmieniają tylko dokumenty, takie jak wydanie, zwrot albo przesunięcie. Przyjęcie rozbieżności dotyczącej użytkownika nie zmienia osoby, której sprzęt jest przypisany.

05

Jaki plik można wczytać na ekranie Wykrywanie?

Plik JSON w schemacie raportu ewidIT: jeden raport albo paczkę w postaci {"raporty":[...]}. Przeglądarka sprawdza poprawność JSON i wysyła plik do bazy w częściach, a procedura odrzuca tekst dłuższy niż 2 mln znaków, więc większą liczbę komputerów trzeba rozłożyć na kilka plików.

Ewidencja zgodna z tym, co stoi na biurkach

Moduł ewidIT w Studio TCS.net porównuje raporty z agentów z ewidencją i zgłasza rozbieżności.

Powiązane treści

Zobacz też

TCS

Studio TCS.net

Narzędziownia, utrzymanie ruchu i ewidencja wyposażenia.

dowiedz się więcej →
Artykuł

Odpowiedzialność materialna za powierzony sprzęt IT

Protokoły przekazania z podpisem i archiwum.

dowiedz się więcej →
Cennik

Cennik Studio TCS.net

Model licencyjny i zakres wdrożenia.

dowiedz się więcej →