hw-bundle-util диагностикалық утилитасы
hw-bundle-util — VK Cloud жасаған, Bare Metal серверінің диагностикалық деректерін жинауға арналған Linux утилитасы. Утилита жабдық пен ОЖ туралы мәліметтерді бір архивке жинайды, мысалы, техникалық қолдау қызметіне жүгіну үшін.
Утилитаны пайдаланушы ОЖ-де қолмен іске қосады. Мынадай Linux дистрибутивтері (amd64 және arm64) қолдау табады:
- Ubuntu 18.04/20.04/22.04/24.04,
- Debian 10/11/12,
- CentOS 8, CentOS Stream 9,
- AlmaLinux 8/9,
- Rocky Linux 8/9,
- РЕД ОС 7/8.
Диагностикалық ақпараттың бір бөлігі тек суперпайдаланушы құқықтарымен қолжетімді, сондықтан hw-bundle-util утилитасын sudo арқылы немесе тікелей root тіркелгісінен іске қосу ұсынылады.
Утилита пайдаланушы деректерін және ОЖ параметрлерін өзгертпейді. Іске қосқаннан кейін орындалатын файлдың жанында диагностикалық ақпаратты жинауға арналған директория жасалады. Әдепкі бойынша hw-bundle-util сәтті орындалып, есеп қалыптастырылғаннан кейін барлық уақытша файлдар жойылады. Қажет болса, өз іске қосу параметрлеріңізді беруге болады.
Жүйенің әртүрлі құрамдастары туралы ақпарат жинау үшін Linux дистрибутивтерінің көпшілігінде қолжетімді көмекші утилиталар пайдаланылады, сондай-ақ procfs виртуалды файлдық жүйесінен жүйелік ақпарат оқылады.
hw-bundle-util мынадай дереккөздерді пайдаланады:
- Bare Metal серверінің платформасы сипаттамалары (аналық плата, процессор, жады, BIOS/UEFI нұсқасы):
dmidecode. - ОЖ параметрлері және жүйелік көрсеткіштер:
hostname,hostnamectl,lscpu,/proc/cpuinfo,uname,/etc/os-release,/proc/uptime,/proc/loadavg. - Жедел жады күйі:
free -h,/proc/meminfo. - Файлдық жүйе және жинақтауыштар параметрлері:
lsblk,blkid,/sys/block,/proc/partitions. - SMART көрсеткіштері: табылған әрбір құрылғы бойынша
smartctlкеңейтілген шығысы. - EDAC ішкі жүйесінен жабдықтың жұмысындағы қателер:
/sys/devices/system/edac,ras-mc-ctl,edac-util,/var/log/mcelog,rasdaemonжәне ядро журналы (dmesg) жазбалары. - Соңғы 24 сағаттағы
dmesg -Tядро журналы,journalctl --dmesgжәне/var/log/kern.logфайлының соңғы жазбалары. - Желі күйі:
ethtoolарқылы желі интерфейстерінің параметрлері, DNS конфигурациясы жәнеvk.ruменcloud.vk.ruатауларының шешілуін тексеру (dig), шлюзге,vk.ruжәнеcloud.vk.ruмекенжайларына, сондай-ақ8.8.8.8,8.8.4.4,77.88.8.8,77.88.8.88жалпыға ортақ DNS серверлеріне байланысты тексеру (ping). - Ағымдағы уақыт және жүйелік уақыт параметрлері:
date,timedatectl. - Жүйелік файлдар:
/proc/cmdline,/proc/uptime,/proc/cpuinfo,/proc/meminfo,/proc/sys/kernel/tainted,/etc/os-releaseкөшірмелері,/var/log/syslogнемесе/var/log/messagesфайлының соңғы 10000 байты.
Желі жылдамдығы тексерілмейді.
Утилита жұмысын аяқтағаннан кейін орындалатын файлдың жанында мынадай құрылымы бар bmaas-bundle.tar.gz архиві жасалады:
bmaas-bundle.tar.gz├── log.log└── bundle/├── hw-bundle-util.version├── sanitize.legend├── collect/├── exec/│ └── <ПРОВЕРКА>/│ ├── <ИМЯ_УТИЛИТЫ>[.<УТОЧНЕНИЕ>].stdout│ ├── <ИМЯ_УТИЛИТЫ>[.<УТОЧНЕНИЕ>].stderr│ ├── <ИМЯ_УТИЛИТЫ>.version│ └── legend└── collection.incomplete
Мұндағы:
-
log.log:hw-bundle-utilжұмысының журналы. -
bundle/hw-bundle-util.version: есеп жиналғанhw-bundle-utilнұсқасы. -
bundle/sanitize.legend: есеп буып-түйілместен бұрын ядроны жүктеу параметрлерінде ауыстырылған мәндердің тізбесі. -
bundle/collect/: жүйеден көшірілген ОЖ файлдары./proc/cmdlineкөшірмесі алдын ала құпия деректерден тазартылады. -
bundle/exec/<ПРОВЕРКА>/: көмекші утилиталарды шақыру нәтижелері. Әрбір тексеру үшін бөлек директория жасалады, онда мыналар болады:-
<ИМЯ_УТИЛИТЫ>[.<УТОЧНЕНИЕ>].stdoutжәне<ИМЯ_УТИЛИТЫ>[.<УТОЧНЕНИЕ>].stderr:stdoutстандартты ағынынан, сондай-ақstderrстандартты қате ағынынан шығыс жазылған файлдар. Көмекші утилитаның жұмысы кезінде диагностикалық және жөндеу хабарламалары болмаса,stderrфайлы болмайды.Мұндағы
<УТОЧНЕНИЕ>— тексеру туралы қосымша ақпарат. Мысалы,ethtoolүшін интерфейс атауы нақтыланады:ethtool.eth0. -
<ИМЯ_УТИЛИТЫ>.version: көмекші утилита нұсқасы. -
legend: көмекші утилитаны іске қосу туралы жиынтық — аргументтер және нәтиженің жоқ болу себептері.
-
-
bundle/collection.incomplete: орындау мүмкін болмаған тексерулердің тізбесі және себептері. Файл деректер толық жиналмаған жағдайда ғана жасалады, мысалы, жүйеде қажетті көмекші утилита болмаса немесе root құқықтарынсыз іске қосылса.
Есеп жасалғанға дейін ядроны жүктеу параметрлеріндегі тіркелгі деректері тазартылады. Жою құпия ақпаратты сақтаудың белгілі үлгілері бойынша, сондай-ақ password, passwd, token, secret, credential, apikey, api_key, accesskey, access_key кілт сөздері бойынша орындалады. Жойылған мәннің орнында secret:S0:secret-key:len=<КОЛИЧЕСТВО_СИМВОЛОВ>:fp=<ОТПЕЧАТОК> түріндегі жазба қалады, жолдың қалған бөлігі өзгермейді. Мұндағы <ОТПЕЧАТОК> — бір құпия үшін бірдей таңбалар тізбегі. Осылайша құпияның мазмұнын ашпай, қандай құпия қайда пайдаланылатынын білуге болады. Утилитаны қайта іске қосса, жаңа архивте бірдей құпиялардың жазбалары өзгереді. Бұл ізқалдырғыш әр іске қосқан сайын қайта жасалатындықтан болады.
Тазарту collect/cmdline файлына, сондай-ақ exec/kernel/dmesg.stdout және journalctl.stdout шығысына қолданылады. Қалған мазмұн архивке өзгеріссіз кіреді: көмекші утилиталардың шығысы, /proc, /sys және /etc ішіндегі файлдардың көшірмелері, утилитаның өз жұмыс журналы. /var/log/syslog немесе /var/log/messages және /var/log/kern.log файлдарынан архивке файлдың бүкіл мазмұны емес, тек соңғы жазбалар енгізіледі.
Іске қосу пішімі:
./hw-bundle-util [КОМАНДА] [ПАРАМЕТРЫ]
Команда | Мақсаты |
|---|---|
| Диагностикалық деректерді жинау. Команда көрсетілмесе, әдепкі бойынша пайдаланылады |
| Утилита нұсқасын шығару |
Параметр | Әдепкі мәні | Мақсаты |
|---|---|---|
Анықтама | ||
| — | Анықтаманы шығару. |
| ||
|
| Жұмыс директориясы. Архив оның жанында жасалады және атауы сондай болады, бірақ |
|
| Терминалға шығарудың егжей-тегжейлілігі. Рұқсат етілген мәндер: |
|
| Архив ішіндегі |
| Пайдаланылмайды | Архив жасалғаннан кейін жиналған каталогтар ағашын жоймау. Әдепкі бойынша ол жойылады, өйткені архивте дәл сол деректер бар |
| ||
| — | Архивті жіберу керек URL мекенжайы. Параметр көрсетілмесе, архив тек дискіде, орындалатын файлдың жанында немесе |
|
| Жіберу тәсілі. Рұқсат етілген мәндер: |
|
| Жіберуге арналған уақыт шектеуі |
| — |
|
| Пайдаланылмайды | Сервер сертификатын тексермеу. Өздігінен қол қойылған сертификаты бар орталарда пайдаланылады |
Код | Мағынасы |
|---|---|
| Сәтті: есеп толық жиналды |
| Күтпеген қате |
| Пәрмен жолы аргументтеріндегі қате |
| Белгісіз команда берілді |
| Архивті жасау мүмкін болмады |
| Директорияны жасау мүмкін болмады |
| Файлды жасау мүмкін болмады |
| Файлды жазу мүмкін болмады |
| Архивті жіберу мүмкін болмады |
| Жұмыс директориясын анықтау мүмкін болмады |
| Директорияны жою мүмкін болмады |
| Есеп жиналып, жеткізілді, бірақ тексерулердің бір бөлігі деректер бермеді. Толығырақ |
|
|
|
|