Spuštění analyzátoru klienta na Linux

Pokud máte problémy s Microsoft Defender for Endpoint na Linux a potřebujete podporu, můžete být požádáni o zadání výstupu z nástroje Client Analyzer. Jedná se o diagnostický nástroj, který pomáhá správcům a týmům podpory řešit problémy s Microsoft Defender for Endpoint. Shromažďuje podrobné informace o instalaci, konfiguraci, stavu služby, protokolech, stavu připojení atd. Tento nástroj se primárně používá ke kontrole stavu systému, ověřování konfigurací a odstraňování potenciálních problémů.

Diagnostické informace nástroje Client Analyzer můžete shromažďovat kterýmkoli z následujících způsobů:

  1. Příkazová řádka: Spusť klientský analyzátor lokálně na zařízení. Vizte run-the-binary-version-of-the-client-analyzer nebo run-the-python-based-client-analyzer.

  2. Živá odpověď: Spustit klientský analyzátor na dálku během živé reakční relace. Viz záznam o použití živé odpovědi na sběr a diagnostice

  3. Balíček pro vyšetřování: Získejte balíček vyšetřování ze stránky zařízení v portálu Microsoft Defender. V systému Linux balíček obsahuje diagnostické nástroje Client Analyzer. Viz sběr-vyšetřovací balíček-od-zařízení

Tip

Podívejte se na toto video a získejte přehled analyzátoru klienta : Přehled analyzátoru klienta Defenderu for Endpoint

Spuštění binární verze klientského analyzátoru

Binární verze klientského analyzátoru je k dispozici dvěma způsoby:

  • Dodává se s Microsoft Defender pro Linux
  • Dodáváno jako samostatný nástroj

Spusťte binární soubor Client Analyzer dodávaný s Microsoft Defender pro Linux:

Poznámka

Počínaje verzí Microsoft Defender for Endpoint 101.25082.0000 je Client Analyzer dodáván s agentem. Najdete ho v následujícím umístění: /opt/microsoft/mdatp/tools/client_analyzer/binary

Spuštěním tohoto nástroje se vygeneruje diagnostický balíček jako .zip soubor v adresáři /tmp .

Chcete-li spustit nástroj Client Analyzer, postupujte takto:

  1. Přejděte do adresáře /opt/microsoft/mdatp/tools/client_analyzer/binary:

    cd /opt/microsoft/mdatp/tools/client_analyzer/binary
    
  2. Spuštěním nástroje s kořenovými oprávněními vygenerujte diagnostický balíček:

    sudo ./MDESupportTool -d
    

Stažení a spuštění samostatného binárního nástroje Client Analyzer

Pokud chcete použít samostatný binární soubor ClientAnalyzer, proveďte následující kroky.

  1. Stáhněte si binární nástroj XMDE Client Analyzer do počítače Linux, který potřebujete prozkoumat. Pokud používáte terminál, stáhněte si nástroj zadáním následujícího příkazu:

    wget --quiet -O XMDEClientAnalyzerBinary.zip "https://go.microsoft.com/fwlink/?linkid=2336125"
    
  2. Ověřte stažení:

    echo '5F906591D33D675F14D73D5B658A796CEC7480B023B18D45C5D687713A4D4FBB XMDEClientAnalyzerBinary.zip' | sha256sum -c
    
  3. Rozbalte obsah XMDEClientAnalyzerBinary.zip v počítači.

    unzip -q XMDEClientAnalyzerBinary.zip -d XMDEClientAnalyzerBinary
    
  4. Změňte adresář:

    cd XMDEClientAnalyzerBinary
    
  5. Vytvoří se dva nové soubory ZIP:

    • SupportToolLinuxamd64Binary.zip: Pro zařízení x86 se systémem Linux
    • SupportToolLinuxarm64Binary.zip: Pro zařízení se systémem Linux ARM
  6. Rozbalte konkrétní soubor ZIP na základě architektury operačního systému Linux. Tady například použijeme SupportToolLinuxamd64Binary.zip soubor.

    unzip -q SupportToolLinuxamd64Binary.zip
    
  7. Spuštěním nástroje s kořenovými oprávněními vygenerujte diagnostický balíček:

    sudo ./MDESupportTool -d
    

Spuštění analyzátoru klienta založeného na Pythonu

Verze pythonu klientského analyzátoru je dostupná dvěma způsoby:

  • Dodává se s Microsoft Defender pro Linux
  • Dodáváno jako samostatný nástroj

Poznámka

  • Analyzátor závisí na několika dalších balíčcích PIP (decorator, sh, distro, lxmla psutil), které jsou nainstalovány v operačním systému, když jsou v kořenovém adresáři, aby se vytvořil výstup výsledku. Pokud není nainstalovaný, analyzátor se ho pokusí načíst z oficiálního úložiště pro balíčky Pythonu.
  • Kromě toho nástroj v současné době vyžaduje, aby byl na vašem zařízení nainstalovaný Python verze 3 nebo novější.
  • Počínaje nástrojem Client Analyzer pro MDE Linux verze 1.7.0 je k dispozici podpora spuštění analyzátoru klienta založeného na Pythonu ve virtuálním prostředí Pythonu (venv). Použití virtuálního prostředí je volitelné a nevyžaduje se.
  • Pokud je vaše zařízení za proxy serverem, můžete do skriptu předat proxy server jako proměnnou mde_support_tool.sh prostředí. Příklad: https_proxy=https://myproxy.contoso.com:8080 ./mde_support_tool.sh".

Upozornění

Spuštění analyzátoru klienta založeného na Pythonu vyžaduje instalaci balíčků PIP, což může způsobit některé problémy ve vašem prostředí. Aby nedocházelo k problémům, doporučujeme nainstalovat balíčky do uživatelského prostředí PIP.

Spuštění verze Pythonu nástroje Client Analyzer dodávaná s Microsoft Defender pro Linux

Poznámka

Od verze 101.25082.0000 produktu Defender for Endpoint se nástroj Client Analyzer dodává s agentem. Najdete ho v následujícím umístění: /opt/microsoft/mdatp/tools/client_analyzer/python

Chcete-li spustit tento klientský analyzátor, postupujte takto:

  1. Přejděte do adresáře /opt/microsoft/mdatp/tools/client_analyzer/python:

    cd /opt/microsoft/mdatp/tools/client_analyzer/python
    
  2. Spusťte s oprávněními uživatele root a nainstalujte požadované závislosti.

    sudo ./mde_support_tool.sh
    
  3. Pokud chcete shromáždit balíček diagnostiky a vygenerovat soubor archivu výsledků, spusťte znovu s oprávněními uživatele root.

    sudo ./mde_support_tool.sh -d
    

Stažení a spuštění samostatné verze Pythonu nástroje Client Analyzer

  1. Stáhněte si nástroj XMDE Client Analyzer na Linux počítači, který potřebujete prozkoumat. Pokud používáte terminál, stáhněte si nástroj zadáním následujícího příkazu:

    wget --quiet -O XMDEClientAnalyzerPython.zip "https://go.microsoft.com/fwlink/?linkid=2336046"
    
  2. Ověřte stažení:

    echo '0B7C350A1C19E049416B1C8FB7ED857569DDCC32FB90453A3FCCD083487C0B4E XMDEClientAnalyzerPython.zip' | sha256sum -c
    
  3. Rozbalte obsah XMDEClientAnalyzer.zip v počítači:

    unzip -q XMDEClientAnalyzerPython.zip -d XMDEClientAnalyzerPython
    
  4. Změňte adresář:

    cd XMDEClientAnalyzerPython
    
  5. Udělte nástroji oprávnění ke spuštění:

    chmod a+x mde_support_tool.sh
    
  6. Spusťte jako nerootový uživatel a nainstalujte požadované závislosti:

    ./mde_support_tool.sh
    
  7. Pokud chcete shromáždit balíček diagnostiky a vygenerovat soubor archivu výsledků, spusťte znovu příkaz s oprávněními uživatele root:

    sudo ./mde_support_tool.sh -d
    

Tip

Podívejte se na toto video, kde se dozvíte více o problémech se zprovozněním: Problémy se zprovozněním analyzátoru klienta Defender for Endpoint

Možnosti příkazového řádku

Analyzátor klienta poskytuje následující možnosti příkazového řádku:


usage: MDESupportTool [-h] [--output OUTPUT] [--outdir OUTDIR] [--no-zip]
                      [--force] [--diagnostic] [--skip-mdatp]
                      [--bypass-disclaimer] [--interactive] [--delay DELAY]
                      [--mdatp-log {trace,info,warning,error,debug,verbose}]
                      [--max-log-size MAX_LOG_SIZE]
                      {certinfocollection,performance,installation,exclude,ratelimit,skipfaultyrules,trace,observespikes,connectivitytest}
                      ...

MDE Diagnostics Tool

positional arguments:
  {certinfocollection,performance,installation,exclude,ratelimit,skipfaultyrules,trace,observespikes,connectivitytest}
    certinfocollection  Collect cert information: Subject name and Hashes
    performance         Collect extensive machine performance tracing for
                        analysis of a performance scenario that can be
                        reproduced on demand
    installation        Collect different installation/onboarding reports
    exclude             Exclude specific processes from audit-d monitoring.
    ratelimit           Set the rate limit for auditd events. Rate limit will
                        update the limits for auditd events for all the
                        applications using auditd, which could impact
                        applications other than MDE.
    skipfaultyrules     Continue loading rules in spite of an error. This
                        summarizes the results of loading the rules. The exit
                        code will not be success if any rule fails to load.
    trace               Use OS tracing facilities to record Defender
                        performance traces.
    observespikes       Collect the process logs in case of spike or mdatp
                        crash
    connectivitytest    Perform connectivity test for MDE

optional arguments:
  -h, --help            show this help message and exit
  --output OUTPUT, -o OUTPUT
                        Output path to export report
  --outdir OUTDIR       Directory where diagnostics file will be generated.
  --no-zip, -nz         If set a directory will be created instead of an
                        archive file.
  --force, -f           Will overwrite if output directory exists.
  --diagnostic, -d      Collect extensive machine diagnostic information.
  --skip-mdatp          Skip any mdatp command. Use this when the mdatp
                        command is unresponsive.
  --bypass-disclaimer   Do not display disclaimer banner.
  --interactive, -i     Interactive diagnostic,
  --delay DELAY, -dd DELAY
                        Delay diagnostic by how many minutes (0~2880), use
                        this to wait for more debug logs before it collects.
  --mdatp-log {trace,info,warning,error,debug,verbose}
                        Set MDATP log level. If you use interactive or delay
                        mode, the log level will set to debug automatically,
                        and reset after 48h.
  --max-log-size MAX_LOG_SIZE
                        Maximum log file size in MB before rotating(Will
                        restart mdatp).

Režim diagnostiky

Režim diagnostiky se používá ke shromažďování rozsáhlé sady informací o počítači, jako je paměť, disk a protokoly MDATP. Tato sada souborů poskytuje primární sadu informací potřebných k ladění jakéhokoli problému souvisejícího s Defenderem for Endpoint.

Podporované možnosti jsou následující:


optional arguments:
  -h, --help            show this help message and exit
  --output OUTPUT, -o OUTPUT
                        Output path to export report
  --outdir OUTDIR       Directory where diagnostics file will be generated.
  --no-zip, -nz         If set a directory will be created instead of an
                        archive file.
  --force, -f           Will overwrite if output directory exists.
  --diagnostic, -d      Collect extensive machine diagnostic information.
  --skip-mdatp          Skip any mdatp command. Use this when the mdatp
                        command is unresponsive.
  --bypass-disclaimer   Do not display disclaimer banner.
  --interactive, -i     Interactive diagnostic,
  --delay DELAY, -dd DELAY
                        Delay diagnostic by how many minutes (0~2880), use
                        this to wait for more debug logs before it collects.
  --mdatp-log {trace,info,warning,error,debug,verbose}
                        Set MDATP log level. If you use interactive or delay
                        mode, the log level will set to debug automatically,
                        and reset after 48h.
  --max-log-size MAX_LOG_SIZE
                        Maximum log file size in MB before rotating(Will
                        restart mdatp).

Příklad použití: sudo ./MDESupportTool -d

Poznámka

Funkce automatického resetu úrovně protokolování je k dispozici pouze ve verzi agenta 101.24052.0002 nebo novější.

Soubory vygenerované při použití tohoto režimu jsou shrnuty v následující tabulce:

Soubor Poznámky
mde_diagnostic.zip Protokoly a konfigurace programu Microsoft Defender for Endpoint
health.txt Stav programu Defender for Endpoint
(K dispozici pouze v případě, že je nainstalovaný Defender for Endpoint.)
health_details_features.txt Stav ostatních funkcí programu Defender for Endpoint
(K dispozici pouze v případě, že je nainstalovaný Defender for Endpoint.)
permissions.txt Problémy s oprávněními u složek vlastněných nebo používaných defenderem for Endpoint
(K dispozici pouze v případě, že je nainstalovaný Defender for Endpoint.)
crashes Výpisy paměti při selhání generované nástrojem Defender for Endpoint
process_information.txt Proces spuštěný v počítači při spuštění nástroje
proc_directory_info.txt Mapování virtuální paměti procesů programu Defender for Endpoint
(K dispozici pouze v případě, že je nainstalovaný Defender for Endpoint.)
auditd_info.txt Stav Auditd, pravidla, protokoly
auditd_log_analysis.txt Souhrn událostí zpracovaných službou auditd
auditd_logs.zip Auditované soubory protokolů
ebpf_kernel_config.txt Aktuálně načtená konfigurace jádra Linux
ebpf_enabled_func.txt Seznam všech funkcí jádra, které jsou aktuálně povolené pro trasování
ebpf_syscalls.zip Informace o trasování systémových volání
ebpf_raw_syscalls.zip Trasování událostí souvisejících s nezpracovanými systémovými voláními
ebpf_maps_info.txt ID a informace o velikosti map eBPF
syslog.zip Soubory ve složce /var/log/syslog
messages.zip Soubory pod /var/log/messages
conflicting_processes_information.txt Konfliktní procesy v Microsoft Defender for Endpoint
exclusions.txt Seznam vyloučení antivirové ochrany
definitions.txt Informace o definici antivirového programu
mde_directories.txt Seznam souborů v adresářích Defenderu for Endpoint
disk_usage.txt Podrobnosti o využití disku
mde_user.txt Informace o uživateli Defender for Endpoint
mde_definitions_mount.txt Přípojný bod definic pro Defender for Endpoint
service_status.txt Stav služby Defender for Endpoint
service_file.txt Soubor služby Defender for Endpoint
hardware_info.txt Informace o hardwaru
mount.txt Informace o přípojné bodě
uname.txt Informace o jádru
memory.txt Informace o systémové paměti
meminfo.txt Podrobné informace o využití paměti systému
cpuinfo.txt Informace o procesoru
lsns_info.txt Informace o jmenném prostoru Linuxu
lsof.txt Informace o otevřených deskriptorech souborů v programu Defender for Endpoint
(viz poznámka za touto tabulkou)
sestatus.txt Informace o otevřených popisovačích souborů v programu Defender for Endpoint
lsmod.txt Stav modulů v jádru Linux
dmesg.txt Zprávy z kruhového bufferu jádra
kernel_lockdown.txt informace o uzamčení jádra
rtp_statistics.txt Statistiky služby Defender for Endpoint Real Time Protection (RTP)
(K dispozici pouze v případě, že je nainstalovaný Defender for Endpoint.)
libc_info.txt Informace o knihovně libc
uptime_info.txt Čas od posledního restartování
last_info.txt Výpis naposledy přihlášených uživatelů
locale_info.txt Zobrazit aktuální národní nastavení
tmp_files_owned_by_mdatp.txt Soubory /tmp vlastněné skupinou: mdatp
(K dispozici pouze v případě, že je nainstalovaný Defender for Endpoint.)
mdatp_config.txt Všechny konfigurace Defenderu for Endpoint
(K dispozici pouze v případě, že je nainstalovaný Defender for Endpoint.)
mpenginedb.db
mpenginedb.db-wal
mpenginedb.db-shm
Soubor definic antivirové ochrany
(K dispozici pouze v případě, že je nainstalovaný Defender for Endpoint.)
iptables_rules.txt pravidla Linux iptables
network_info.txt Informace o síti
sysctl_info.txt informace o nastavení jádra
hostname_diagnostics.txt Diagnostické informace o názvu hostitele
mde_event_statistics.txt Statistiky událostí v programu Defender for Endpoint
(K dispozici pouze v případě, že je nainstalovaný Defender for Endpoint.)
mde_ebpf_statistics.txt Statistiky eBPF v Microsoft Defenderu for Endpoint
(K dispozici pouze v případě, že je nainstalovaný Defender for Endpoint.)
kernel_logs.zip Záznamy jádra
mdc_log.zip Protokoly služby Microsoft Defender for Cloud
netext_config.txt
threat_list.txt Seznam hrozeb zjištěných defenderem for Endpoint
(K dispozici pouze v případě, že je nainstalovaný Defender for Endpoint.)
top_output.txt Proces spuštěný v počítači při spuštění nástroje
top_summary.txt Analýza využití paměti a procesoru spuštěného procesu

Volitelné argumenty pro nástroj Client Analyzer

Nástroj Client Analyzer poskytuje následující volitelné argumenty pro shromažďování dalších dat:

Shromažďování informací o výkonu

Shromážděte rozsáhlé trasování výkonu počítačů procesů Defenderu for Endpoint pro účely analýzy scénáře výkonu, který je možné reprodukovat na vyžádání.

-h, --help            show this help message and exit
--frequency FREQUENCY
                      profile at this frequency
--length LENGTH       length of time to collect (in seconds)

Příklad použití: sudo ./MDESupportTool performance --frequency 500

Tento režim vygeneruje následující soubor:

Soubor Poznámky
perf_benchmark.tar.gz Defender for Endpoint zpracovává data o výkonu

Poznámka

Vygenerují se také soubory odpovídající režimu diagnostiky.

Tar obsahuje soubory ve formátu <pid of a MDE process>.data. Datový soubor je možné přečíst pomocí příkazu:

perf report -i <pid>.data

Spuštění testu připojení

Tento režim testuje, jestli jsou cloudové prostředky potřebné pro Defender for Endpoint dostupné nebo ne.


  -h, --help            show this help message and exit
  -o ONBOARDING_SCRIPT, --onboarding-script ONBOARDING_SCRIPT
                        Path to onboarding script
  -g GEO, --geo GEO     Geo string to test <US|UK|EU|AU|CH|IN>

Příklad použití:

sudo ./MDESupportTool connectivitytest -o ~/MicrosoftDefenderATPOnboardingLinuxServer.py`

Výstup vytištěný na obrazovce ukazuje, jestli jsou adresy URL dostupné nebo ne.

Shromažďovat různé reporty o instalaci a zavedení

Tento režim shromažďuje informace související s instalací, jako jsou požadavky na distribuci a systém.


  -h, --help                show this help message and exit
  -d, --distro              Check for distro support
  -m, --min-requirement     Check for the system info against offical minimum requirements
  -e, --external-dep        Check for externel package dependency
  -c, --connectivity        Check for connectivity for services used by MDE
  -a, --all                 Run all checks
  -o ONBOARDING_SCRIPT, --onboarding-script ONBOARDING_SCRIPT
                            Path to onboarding script
  -g GEO, --geo GEO         Geo string to test <US|UK|EU|AU|CH|IN>

Příklad použití:

sudo ./MDESupportTool installation --all

Vygeneruje se jedna sestava installation_report.json. Klíče v souboru jsou následující:

Klíč Poznámky
agent_version Nainstalovaná verze Defenderu for Endpoint.
stav_zaškolení Informace o onboardingu a vyzvánění
support_status MDE se podporuje s aktuálními konfiguracemi systému.
Distro Distribuce, na které je agent nainstalovaný, je nebo není podporovaná.
test připojení Stav testů připojení
minimální_požadavek Jsou splněny minimální požadavky na procesor a paměť.
externí závislost Externí závislosti jsou nebo nejsou splněné.
mde_health Stav agenta MDE
folder_perm Požadovaná oprávnění ke složce jsou nebo nejsou splněna.

Režim vyloučení

Tento režim přidává vyloučení pro audit-d monitorování.


  -h, --help            show this help message and exit
  -e <executable>, --exe <executable>
                        exclude by executable name, i.e: bash
  -p <process id>, --pid <process id>
                        exclude by process id, i.e: 911
  -d <directory>, --dir <directory>
                        exclude by target path, i.e: /var/foo/bar
  -x <executable> <directory>, --exe_dir <executable> <directory>
                        exclude by executable path and target path, i.e: /bin/bash /var/foo/bar
  -q <q_size>, --queue <q_size>
                        set dispatcher q_depth size
  -r, --remove          remove exclusion file
  -s, --stat            get statistics about common executables
  -l, --list            list auditd rules
  -o, --override        Override the existing auditd exclusion rules file for mdatp
  -c <syscall number>, --syscall <syscall number>
                        exclude all process of the given syscall

Příklad použití:

sudo ./MDESupportTool exclude -d /var/foo/bar`

Shromažďování protokolů podpory pomocí živé odpovědi v Defenderu for Endpoint

Client Analyzer lze spustit během Live Response relace buď pomocí verze, která je již součástí Microsoft Defender for Endpoint na Linuxu, nebo stažením Client Analyzeru jako binárního nebo Python balíčku a jeho extrakcí na zařízení.

  • Pro instalaci je vyžadován balíček unzip.
  • Ke spuštění je vyžadován balíček acl.

Důležité

Systém Windows používá neviditelné znaky návratu vozíku a posunu řádku k označení konce jednoho řádku a začátku nového řádku v souboru. Linux systémy používají na konci řádků souboru pouze neviditelný znak Line Feed. Pokud použijete následující skripty, pokud jsou hotové ve Windows, může tento rozdíl způsobit chyby a selhání skriptů, které se mají spustit. Potenciálním řešením je využít Subsystém Windows pro Linux (WSL) a dos2unix balíček k přeformátování skriptu tak, aby odpovídal standardu unixového a Linux formátu.

Dokumenty pro řešení potíží se službou Defender for Endpoint na Linux