Agent monitorowania Codenica Insight Agent to niewielki program instalowany na komputerze, który ma być objęty monitoringiem. Jego zadaniem jest przekazywanie do systemu Codenica danych potrzebnych do analizy pracy stanowiska, aktywności komputera, używanych aplikacji, zdarzeń systemowych oraz innych obszarów włączonych w ustawieniach monitorowania. Po poprawnej instalacji agent działa w tle i nie wymaga codziennej obsługi przez użytkownika komputera.

Pobranie instalatora znajduje się w górnej części widoków monitorowania. W panelu dostępny jest przycisk Pobierz instalator agenta oraz rozwijana pomoc Jak zainstalować agenta monitorowania. Najważniejsze jest to, że paczka instalacyjna jest przygotowywana dla konkretnej firmy. Oznacza to, że konfiguracja połączenia z Twoim środowiskiem Codenica jest już dołączona do instalatora.

W praktyce instalacja jest bardzo prosta:

  1. Otwórz dowolny widok monitorowania w systemie Codenica.
  2. Kliknij Pobierz instalator agenta.
  3. Rozpakuj pobraną paczkę ZIP na komputerze, który chcesz monitorować.
  4. Uruchom plik install-agent.bat jako administrator.
  5. Poczekaj na zakończenie instalacji.

Komputer musi mieć zainstalowany Microsoft .NET Desktop Runtime 10.0.8 lub nowszy. Jeżeli runtime nie jest jeszcze dostępny na komputerze, pobierz go ze strony Microsoft: pobierz .NET 10. W panelu monitorowania dostępny jest też przycisk prowadzący bezpośrednio do instalatora .NET 10.0.8.

Co znajduje się w paczce instalacyjnej agenta monitorowania?

Pobrany plik jest paczką ZIP przygotowaną dla Twojej firmy. Nie jest to przypadkowy, ogólny instalator. System dodaje do niej plik konfiguracyjny z informacjami potrzebnymi do połączenia agenta z właściwym środowiskiem Codenica. Dzięki temu osoba instalująca agenta nie musi ręcznie wpisywać identyfikatora firmy, adresu serwera ani innych parametrów technicznych.

Po rozpakowaniu folderu znajdziesz w nim między innymi:

  • codenica-insight-agent-installer.exe - właściwy instalator programu Codenica Insight Agent.
  • codenica-insight-agent.config.json - konfigurację przygotowaną dla konkretnej firmy i środowiska Codenica.
  • install-agent.bat - najprostszy plik startowy do instalacji na pojedynczym komputerze.
  • install-agent.ps1 - skrypt PowerShell używany przez plik BAT, przydatny także przy instalacji zdalnej lub automatycznej.
  • Pliki instrukcji w kilku językach, które opisują zawartość paczki i podstawowy sposób instalacji.

Najważniejsza zasada jest prosta: do standardowej instalacji używaj pliku install-agent.bat. To on uruchamia proces we właściwej kolejności i korzysta z konfiguracji dołączonej do paczki.

Instalacja Codenica Insight Agent krok po kroku

Standardowa instalacja agenta monitorowania nie wymaga ręcznego kopiowania plików do katalogów systemowych. Paczka zawiera skrypt, który wykonuje potrzebne czynności automatycznie. Użytkownik musi tylko uruchomić instalację z odpowiednimi uprawnieniami.

  1. Pobierz paczkę instalacyjną z panelu monitorowania w Codenica.
  2. Przenieś paczkę na komputer, który ma być objęty monitoringiem.
  3. Rozpakuj cały folder ZIP. Nie uruchamiaj plików bezpośrednio z podglądu archiwum.
  4. Sprawdź, czy w rozpakowanym folderze znajdują się razem pliki install-agent.bat, install-agent.ps1, codenica-insight-agent-installer.exe oraz codenica-insight-agent.config.json.
  5. Kliknij prawym przyciskiem myszy install-agent.bat.
  6. Wybierz Uruchom jako administrator.
  7. Poczekaj, aż skrypt zakończy pracę i wyświetli komunikat końcowy.

Uprawnienia administratora są wymagane, ponieważ agent instaluje usługę Windows, zapisuje pliki programu w katalogu Program Files oraz tworzy konfigurację w ProgramData. Jeżeli plik BAT zostanie uruchomiony bez tych uprawnień, instalacja zatrzyma się i poprosi o ponowne uruchomienie jako administrator.

Wymagany .NET 10.0.8 lub nowszy

Do działania Codenica Insight Agent wymagany jest Microsoft .NET Desktop Runtime 10.0.8 lub nowszy. To bezpłatny składnik systemowy Microsoft, który pozwala uruchamiać aplikacje desktopowe oparte o .NET. Nie trzeba instalować pełnego środowiska programistycznego ani SDK, jeśli komputer ma tylko uruchamiać agenta.

Jeżeli nie masz pewności, czy runtime jest już zainstalowany, najprościej potraktować to jako pierwszy krok przygotowania komputera. Pobierz aktualny runtime z oficjalnej strony Microsoft: .NET 10.0 - downloads. W systemie Codenica przy instrukcji instalacji dostępny jest również przycisk Pobierz .NET 10.0.8, który otwiera bezpośredni instalator dla Windows x64.

  • Minimalna wymagana wersja: .NET Desktop Runtime 10.0.8.
  • Można zainstalować nowszą wersję z tej samej linii, jeżeli Microsoft udostępnia aktualniejszy pakiet.
  • Na typowym komputerze z Windows x64 wybierz wariant Windows Desktop Runtime x64.
  • Po instalacji runtime możesz wrócić do folderu agenta i uruchomić install-agent.bat.

Co dzieje się po uruchomieniu pliku BAT?

Plik install-agent.bat uruchamia skrypt PowerShell, który wykonuje właściwą instalację. Najpierw sprawdza, czy działa z uprawnieniami administratora. Następnie przygotowuje katalog konfiguracji agenta, kopiuje plik codenica-insight-agent.config.json do lokalizacji używanej przez program i zapisuje go jako agentsettings.json. Dopiero potem uruchamia instalator EXE.

Podczas instalacji tworzona jest usługa Windows o nazwie CodenicaInsightAgent. Usługa startuje automatycznie i odpowiada za działanie agenta w tle. Po instalacji agent powinien sam rozpocząć pracę, a kolejne dane zaczną trafiać do systemu zgodnie z konfiguracją monitoringu oraz harmonogramem synchronizacji.

Najważniejsze lokalizacje po instalacji:

  • C:\Program Files\Codenica Insight Agent - domyślny katalog programu.
  • C:\ProgramData\Codenica\InsightAgent - katalog danych, konfiguracji i logów.
  • C:\ProgramData\Codenica\InsightAgent\Config\agentsettings.json - właściwy plik konfiguracji używany po instalacji.
  • C:\ProgramData\Codenica\InsightAgent\Logs - katalog logów technicznych.

O czym pamiętać przy instalacji agenta monitorowania?

Instalacja jest prosta, ale kilka zasad pozwala uniknąć typowych problemów. Najważniejsza dotyczy kolejności uruchamiania plików: nie zaczynaj od samego instalatora EXE, ponieważ konfiguracja firmy znajduje się w osobnym pliku JSON. To plik BAT dba o to, aby konfiguracja została skopiowana we właściwe miejsce przed instalacją programu.

  • Nie uruchamiaj jako pierwszego pliku codenica-insight-agent-installer.exe.
  • Nie usuwaj pliku codenica-insight-agent.config.json z rozpakowanego folderu.
  • Nie zmieniaj ręcznie konfiguracji, jeśli nie wiesz dokładnie, jaki efekt chcesz uzyskać.
  • Uruchamiaj install-agent.bat jako administrator.
  • Przed instalacją upewnij się, że komputer ma wymagany .NET Desktop Runtime 10.0.8 lub nowszy.
  • Przy instalacji zdalnej możesz użyć skryptu install-agent.ps1, ale musi być uruchomiony z folderu zawierającego instalator EXE oraz plik konfiguracji.

Po poprawnej instalacji kolejne wersje Codenica Insight Agent będą aktualizowane automatycznie. Dzięki temu użytkownik komputera ani administrator nie muszą za każdym razem ręcznie pobierać nowego instalatora, gdy pojawi się aktualizacja agenta.