TeskaLabs LogMan.io Collector¶

Toto je administrátorská příručka pro TeskaLabs LogMan.io Collector. Popisuje instalaci a správu Collectoru.

Možnosti konfigurace a podrobnosti o zdrojích logů viz referenční příručka.

Architektura¶

LogMan.io Collector je mikroslužba, která sbírá logy a další události z různých vstupů a odesílá je do LogMan.io Receiver. Obvykle běží jako kontejner na dedikovaném stroji a k Receiver se připojuje přes WebSocket a HTTPS.

Collector lze spouštět, zastavovat, restartovat a konfigurovat z webového rozhraní LogMan.io.

Identita kolektoru¶

Každý Collector je identifikován jedinečnou identitou — 16znakovým řetězcem písmen a číslic (například A3K9M2P7QW4R8T6X).

Identita se přiřadí automaticky při prvním startu Collectoru. Collector vytvoří jedinečné přihlašovací údaje a uloží je lokálně na stroji. Identita se z těchto údajů odvodí a zůstává stejná po celou životnost dané instalace Collectoru.

Identita není hostname, IP adresa ani jiný síťový atribut stroje. Každá instance Collectoru dostane vlastní identitu. Přeinstalace bez zachování přihlašovacích údajů vede k nové identitě.

Identitu najdete v logách Collectoru po prvním startu. Zobrazí se také ve webovém rozhraní LogMan.io po registraci u Receiver. Identitu potřebujete pro provisioning a pro odkazy v administrátorských úlohách.

Dokud Collector uchová lokální přihlašovací údaje, identita zůstává stejná při restartech i obnově certifikátů. Pokud údaje zmizí (například smazáním datového volume nebo přeinstalací bez zálohy), Collector vygeneruje nové údaje a novou identitu. Ze systémového hlediska jde o jiný Collector, který je třeba znovu provisionovat.

Při připojení k LogMan.io Receiver Collector předloží své přihlašovací údaje. Receiver podle identity zjistí, zda byl Collector provisionován a autorizován k přesměrování logů pro daného tenanta.

Instalace¶

Instalace Collectoru je popsána v instalační příručce.

Provisioning¶

Po instalaci musí být Collector provisionován, než může přesměrovávat logy. Provisioning autorizuje Collector k odesílání dat do LogMan.io Receiver pro daného tenanta. Provisionujte Collectory z webového rozhraní LogMan.io.

Otevřete Log sources >> Collectors ve webovém rozhraní LogMan.io. Stránka zobrazí všechny Collectory registrované u Receiver. Neprovisionované jsou označeny šedou tečkou.
Klikněte na Provision u Collectoru, který chcete autorizovat. Přejdete na stránku detailu Collectoru. Ověřte identitu a vyberte tenant, pro který může Collector logy přesměrovávat.
Po provisioningu je Collector označen zelenou tečkou. Můžete nastavit zobrazované jméno a zkontrolovat konfiguraci Collectoru.

Identita kolektoru v logách

Identita Collectoru je také v logách kontejneru Collector. Na stroji, kde Collector běží, v logách hledejte řetězec identity:

docker logs <collector-container> 2>&1 | grep identity
NOTICE lmiocollector.commlink.identity.service [sd url="https://example.domain.com/lmio-receiver/csr" identity="L4RXQCQXWFGFP2IP"] Requesting certificate from the server

Provisioning z příkazové řádky

Collector lze provisionovat i pomocí REST API LogMan.io Receiver a endpointu PUT /provision/<identity>?tenant=<tenant>.

Konfigurace¶

Collector konfigurujte z webového rozhraní LogMan.io. Otevřete Log sources >> Collectors, vyberte Collector a klikněte na Configure.

Samostatné záložky pokrývají běžné zdroje logů (Syslog, Windows Event Logs, Microsoft 365 a další). Vlastní zdroje se konfigurují na záložce Custom v YAML.

Více v referenční příručce.