Диагностика және типтік мәселелер

Бұл бөлім Qarvix мәселелерін жылдам талдауға көмектеседі: құрылғы online болмайды, WSS-арнасы орнамайды, WireGuard-handshake жаңармайды, VPN IP бар, бірақ қолжетімділік жоқ, LAN/API туннель арқылы қолжетімсіз немесе пайдаланушы қажетті нысанды көрмейді.

Тәсіл қарапайым: қабаттар бойынша, жалпыдан нақтыға қарай тексеру керек, әрі желі, маршруттар, ACL мен журналдар тексерілмей тұрып агентті қайта орнатпау керек.

Қысқаша

• Алдымен қатысушы түрін анықтаңыз: басқарылатын құрылғы ма, статикалық клиент пе.
• Ұйым мен желіні тексеріңіз.
• Online-статусты, Last seen мен журналдарды тексеріңіз.
• Басқарылатын құрылғы үшін WSS пен WireGuard-ты бөлек тексеріңіз.
• Статикалық клиент үшін WireGuard-handshake жаңалығына қараңыз.
• LAN/API қолжетімсіз болса, subnet route, ACL, firewall мен мекенжай жоспарын тексеріңіз.
• Қолдау қызметіне жүгінер алдында симптомдарды, уақытты, құрылғыны, желіні және журналдарды жинаңыз.

Диагностиканың негізгі тәртібі

1. Ұйымды табыңыз.
2. Қажетті желіні ашыңыз.
3. Қатысушыны табыңыз.
4. VPN IP-ді тексеріңіз.
5. Online/offline мен Last seen тексеріңіз.
6. Құрылғы журналын ашыңыз.
7. Мәселе кезеңі бойынша аудит журналын тексеріңіз.
8. Маршруттарды, ACL мен peer mesh тексеріңіз.
9. Жергілікті құрылғының немесе API-дің қолжетімділігін тексеріңіз.
10. Уақытты, симптомдарды және тексеру нәтижесін тіркеңіз.

Мәселе тұрақсыз болса, нақты күн мен уақыт әсіресе маңызды. Оларсыз журналды шағыммен салыстыру қиын.

Құрылғы тізімде пайда болмайды

Симптомдары

• токен жасалған, бірақ құрылғы пайда болмайды;
• инженер агент орнатылғанын хабарлайды;
• құрылғылар тізімінде жаңа түйін жоқ;
• аудит журналында токен жасалғаны көрінеді, бірақ қосылым жоқ.

Мүмкін себептері

• токеннің мерзімі өткен;
• токен бұрын қолданылған;
• дұрыс емес желі таңдалған;
• құрылғының control plane-ге қолжетімділігі жоқ;
• DNS жұмыс істемейді;
• TLS-қосылымы орнамайды;
• құрылғыдағы уақыт күрт ерекшеленеді;
• firewall WSS-ті бұғаттайды.

Нені тексеру керек

• токеннің қолданылу мерзімі;
• дұрыс ұйым мен желі;
• құрылғының Qarvix серверіне қолжетімділігі;
• нысандағы DNS;
• құрылғыдағы уақыт;
• агент логтары;
• аудит журналы.

Токеннің мерзімі өтсе немесе пайдаланылған болса, жаңасын жасаңыз. Ескі токенді қайта пайдалануға тырыспаңыз.

WSS-арнасы орнамайды

WSS басқарылатын құрылғыға командалар, конфигурация және heartbeat үшін қажет.

Симптомдары

• құрылғы конфигурация алмайды;
• heartbeat жаңармайды;
• агент online болмайды;
• логтарда WebSocket-ке қосылу қателері бар;
• WireGuard ағымдағы баптауларды алмайды.

Мүмкін себептері

• control plane endpoint қолжетімсіз;
• HTTPS/WSS бұғатталған;
• TLS қатесі;
• құрылғыда уақыт дұрыс емес;
• прокси немесе firewall қосылымды үзеді;
• агенттің токені немесе есептік деректері дұрыс емес.

Нені тексеру керек

• сервер мекенжайының құрылғыдан қолжетімділігі;
• DNS;
• уақыт пен уақыт белдеуі;
• TLS сертификаты;
• firewall ережелері;
• агент журналдары;
• Qarvix-тағы құрылғы журналы.

WSS жұмыс істемесе, басқарылатын құрылғы командалар мен конфигурация жаңартуларын тұрақты ала алмайды.

WireGuard-handshake жаңармайды

WireGuard-handshake қатысушының жақында қорғалған трафикпен алмасқанын көрсетеді.

Симптомдары

• құрылғы немесе клиент offline болып көрінеді;
• VPN IP бар, бірақ трафик өтпейді;
• статикалық клиент ұзақ уақыт статусын жаңартпаған;
• hub жаңа handshake көрмейді.

Мүмкін себептері

• UDP бұғатталған;
• кілттер дұрыс емес;
• endpoint дұрыс емес;
• AllowedIPs қайшылығы;
• құрылғы трафик жібермейді;
• firewall WireGuard-ты бұғаттайды;
• сыртқы мекенжай немесе NAT күйі өзгерген.

Нені тексеру керек

• hub-қа дейінгі UDP-қолжетімділік;
• WireGuard конфигурациясы;
• кілттер;
• AllowedIPs;
• клиенттен шығыс трафиктің бары;
• клиенттегі және нысандағы firewall;
• құрылғы журналы немесе hub күйі.

Статикалық клиент үшін жаңа handshake-тің болмауы әрқашан ақаудың белгісі емес. Кейде клиент жай ғана трафик бермеген.

VPN IP бар, бірақ қолжетімділік жоқ

Симптомдары

• қатысушы online;
• VPN IP берілген;
• қажетті мекенжайға ping немесе қосылым өтпейді;
• құрылғының web/API-і қолжетімсіз.

Мүмкін себептері

• ACL бағытқа тыйым салады;
• subnet route қосылмаған;
• peer mesh өшірулі;
• роутердегі firewall forward-ты бұғаттайды;
• жергілікті құрылғы жауап бермейді;
• кері маршрут жоқ;
• ішкі желілер қиылысады;
• дұрыс емес мекенжай немесе порт таңдалған.

Нені тексеру керек

1. Роутердің VPN IP-іне ping өте ме.
2. LAN-ға дейінгі маршрут бар ма.
3. ACL қажетті бағытты рұқсат ете ме.
4. Тікелей қолжетімділік қажет болса, peer mesh қосулы ма.
5. Роутердің firewall-ы трафикті LAN-ға өткізе ме.
6. Жергілікті құрылғы LAN-ның өзінен қолжетімді ме.
7. VPN CIDR мен LAN-ішкі желісінің қиылысуы жоқ па.

VPN IP қолжетімді, ал LAN қолжетімсіз болса, мәселе көбіне маршрутта, ACL-де немесе firewall-да болады.

LAN-ішкі желі жұмыс істемейді

Симптомдары

• роутер online;
• роутердің VPN IP-і қолжетімді;
• LAN-дағы құрылғылар ашылмайды;
• роутер артындағы API қолжетімсіз.

Мүмкін себептері

• subnet route қосылмаған;
• маршрут дұрыс емес gateway-ге қосылған;
• жергілікті ішкі желі дұрыс көрсетілмеген;
• роутердің firewall-ы forward-қа тыйым салады;
• жергілікті құрылғы басқа gateway пайдаланады;
• мекенжай ішкі желісі пайдаланушы желісімен қиылысады;
• ACL қолжетімділікке тыйым салады.

Нені тексеру керек

• LAN CIDR-дің дұрыстығы;
• gateway-құрылғы;
• маршруттар кестесі;
• firewall;
• құрылғының LAN-нан қолжетімділігі;
• ACL;
• агенттің конфигурацияны қолдану журналы.

Құрылғы API-і туннель арқылы қолжетімсіз

Симптомдары

• LAN-маршрут бар;
• құрылғыға ping өтеді немесе ішінара қолжетімді;
• web/API ашылмайды;
• интеграция timeout немесе connection refused алады.

Мүмкін себептері

• порт дұрыс емес;
• сервис тек жергілікті интерфейсті тыңдайды;
• жергілікті firewall портты бұғаттайды;
• API HTTPS немесе жеке авторизацияны талап етеді;
• ACL ICMP-ге рұқсат етеді, бірақ қажетті TCP/UDP-ге бермейді;
• құрылғы тек белгілі мекенжайлардан қолжетімді;
• құрылғының сертификаты сенімсіз.

Нені тексеру керек

• API-дің IP-і мен порты;
• API-дің нысанның LAN-ынан қолжетімділігі;
• HTTP/HTTPS/RTSP/Modbus немесе басқа хаттама;
• жергілікті firewall;
• порттар бойынша ACL;
• API есептік деректері;
• интеграция логтары.

Пайдаланушы нысанды көрмейді

Симптомдары

• құрылғы бар, бірақ пайдаланушы оны көрмейді;
• пайдаланушы ұйымды көреді, бірақ желіні көрмейді;
• қолжетімділік берілген, бірақ нысан қолжетімсіз.

Мүмкін себептері

• пайдаланушы басқа ұйымда;
• пайдаланушының рөлі қажетті желіге байланбаған;
• рөл құрылғыларды көруге мүмкіндік бермейді;
• мердігердің қолжетімділігі қайтарылып алынған;
• пайдаланушы басқа есептік жазба немесе SSO-тобы арқылы кірген.

Құрылғы панельде көрінбесе, мәселе ACL-де емес: ACL қатысушының трафигі қайда жететінін шешеді, пайдаланушы интерфейсте нені көретінін емес. Көрінуді ұйым, рөл және оның қай желілерге байланғаны анықтайды.

Нені тексеру керек

• пайдаланушының ұйымы;
• рөл және оның байланған желілері;
• OIDC пайдаланылса, SSO топтары;
• аудит журналы;
• қолжетімділік ережелері;
• есептік жазбаның белсенділігі.

Қосылым токені жұмыс істемейді

Симптомдары

• агент тіркеу қатесін хабарлайды;
• құрылғы пайда болмайды;
• токен қайта енгізіледі;
• токен көп бұрын жіберілген.

Мүмкін себептері

• токеннің мерзімі өткен;
• токен бұрын қолданылған;
• токен басқа желі үшін жасалған;
• токен қате көшірілген;
• құрылғы серверге жете алмайды.

Не істеу керек

• қолданылу мерзімін тексеріңіз;
• жаңа токен жасаңыз;
• дұрыс желі таңдалғанына көз жеткізіңіз;
• токенді тек жауапты инженерге беріңіз;
• құрылғыдан WSS-қолжетімділігін тексеріңіз.

ACL өзгертілгеннен кейінгі мәселелер

Симптомдары

• қолжетімділік жұмыс істеп тұрды, ережелер өзгергеннен кейін жоғалды;
• топтың бір бөлігі қолжетімділігін жоғалтады, бір бөлігі жұмыс істей береді;
• мониторинг деректер алуды тоқтатты.

Мүмкін себептері

• ереже тым қатаң болып қалды;
• LAN-ішкі желіге дейінгі рұқсат ұмытылған;
• құрылғы ереженің қажетті тобына кірмейді;
• ереже басқа желіге қолданылған;
• әдепкі қолжетімділік бағытқа тыйым салады.

Нені тексеру керек

• аудит журналы;
• ACL-дің соңғы өзгерісі;
• құрылғы қай топқа кіреді;
• қандай мекенжайлар мен порттарға рұқсат етілген;
• қандай ережелер бұрын қолданылады;
• API немесе LAN үшін жеке ереже бар ма.

Қолдау қызметіне нені тіркеу керек

Қолдау қызметі ұзақ хат алмасусыз бастай алуы үшін мыналарды тіркеңіз:

• ұйым;
• желі атауы;
• құрылғы немесе клиент аты;
• VPN IP;
• маршрут мәселесі болса, LAN-ішкі желі;
• роутер артындағы құрылғы мәселесі болса, API мекенжайы мен порты;
• мәселенің дәл уақыты;
• статус скриншоты;
• құрылғы журналының үзіндісі;
• аудит журналының үзіндісі;
• не тексерілгені;
• күтілетін және нақты нәтиже.

Мәселе роутерге қатысты болса, модель, прошивка мен агент нұсқасын қосыңыз.

Симптомдардың жылдам кестесі

Диагностика бақылау тізімі

• Қатысушы түрі анықталды.
• Ұйым мен желі тексерілді.
• VPN IP дұрыс берілді.
• Online/offline қатысушы түрін ескере отырып оқылды.
• Басқарылатын құрылғы үшін WSS тексерілді.
• Клиент үшін WireGuard-handshake тексерілді.
• LAN үшін subnet route тексерілді.
• Қажетті бағыт үшін ACL тексерілді.
• Нысанның firewall-ы мен жергілікті желісі тексерілді.
• Журналдар жүгінуге тіркелді.

Байланысты бөлімдер

• Құрылғылар және VPN-мекенжайлар - қатысушы түрлері мен статустар.
• Желілер, маршруттар және ACL - маршруттар, peer mesh және қолжетімділік ережелері.
• Туннель арқылы құрылғылар API-і - жергілікті API-лерді диагностикалау.
• Журналдар мен есептер - оқиғалар мен өзгерістерді қайдан іздеу керек.
• Offline-орналастыру - тұйық контурлардың ерекшеліктері.