TapHome
Zjišťujeme zájem Funkce

Záznam zpráv pro Packet Parser a MQTT: podívejte se, co modul odeslal a přijal

Krátký záznam zpráv, které modul Packet Parser odesílá a přijímá, s časem, směrem, tématem MQTT nebo adresou a obsahem, zobrazený v jeho servisním nastavení, když hledáte chybu. Bez síťového snifferu a jen vlastní zprávy modulu, ne celá síť.

Messages over MQTT, HTTP, TCP and UDP go in and out of a Packet Parser module on the Core, which hands each received one to its devices: two process it, one message is processed by none. The record lists every message, marked as processed or not, while other network traffic stays outside.
Messages over MQTT, HTTP, TCP and UDP go in and out of a Packet Parser module on the Core, which hands each received one to its devices: two process it, one message is processed by none. The record lists every message, marked as processed or not, while other network traffic stays outside.

Proč a jak byste to využili

Packet Parser připojuje zařízení třetích stran k řídicí jednotce Core přes HTTP, TCP, UDP, FTP a MQTT. Když hodnota nedorazí nebo chodí mnohem častěji, než by měla, instalatér potřebuje vidět samotné zprávy: co přišlo, s jakým tématem, s jakým obsahem a co odešlo z Core. Dnes servisní nastavení modulu Packet Parser zobrazuje statistiky: kolik zpráv bylo přijato a odesláno za posledních 5 a 30 minut, kolik bajtů bylo přijato a u MQTT zprávy podle témat. Řeknou vám, že něco přichází, ne však, co to je ani které zařízení to poslalo.

Typický případ: instalatér sleduje broker MQTT a vidí stav jednoho svítidla každých pár sekund, někdy i několikrát za sekundu, přestože by se měl zapisovat jednou za minutu. Posílá ho Core, nebo jiný systém? Pokud Core, tak které zařízení a který skript? Dnes je na to potřeba síťový sniffer nebo MQTT klient na počítači u instalace. Jiný případ: novější generace zařízení publikuje pod jinými tématy, než očekává listener skript. Hodnota zůstane prázdná a aplikace neukáže žádnou chybu, protože nikdy nedorazí nic, co by odpovídalo.

Draft of the message log window in the TapHome app on a Mac for an MQTT module: messages with time, direction, topic, size, content and device. A lamp's write script sends the same message every second, and one message is marked Not processed. Below, the selected message with its full content.

Záznam by ukázal oba případy na první pohled. V tomto návrhu skript pro zápis svítidla posílá stejnou zprávu každou sekundu a zpráva s jiným tématem je označena jako nezpracovaná, takže ji nečte žádné zařízení.

DnesS tímto nápadem
Zprávy podle tématJen počtyPočty a obsah
Obsah zprávySamostatný nástrojServisní nastavení
Kdo ji poslalNení vidětZařízení a skript

Co bude možné

Tento nápad posuzujeme. Nic z toho, co následuje, zatím není naplánováno a podrobnosti se ještě mohou změnit.

  • Záznam na vyžádání. Záznam byste spustili v servisním nastavení modulu Packet Parser na omezenou dobu, když hledáte chybu, a otevřeli byste ho ve vlastním okně na počítači. Zastavil by se sám, a dokud je vypnutý, nic se nezaznamenává.
  • Oba směry. Každý řádek by nesl čas s přesností na milisekundu, směr (přijatá nebo odeslaná), téma MQTT nebo adresu a port, velikost a obsah, jako text nebo jako bajty.
  • Které zařízení ji použilo. U přijaté zprávy by záznam ukázal, která zařízení modulu ji zpracovala, nebo že žádné: téma, které nečte žádný listener skript. U odeslané zprávy by ukázal zařízení a skript, který ji odeslal, například skript pro zápis s MQTTPUBLISH.
  • Každý protokol po svém. MQTT: téma a obsah zprávy. HTTP: metoda, cesta, stavový kód, doba odezvy a zkrácené tělo. TCP a UDP: data odeslaná pomocí SENDDATA a přijatá data. FTP: název souboru, velikost a výsledek, ne samotný soubor.
  • Události připojení. Připojení, odpojení a neúspěšné připojení, s důvodem a adresou brokeru nebo zařízení.
  • Skrytá hesla. Hlavičky Authorization, cookies, uživatelská jména, hesla a tokeny v adresách by se před zápisem zamaskovaly. Záznam by zůstal v paměti Core: neposílal by se do cloudu, nebyl by součástí zálohy a po restartu by zmizel.

Co nebude možné

  • Zachytávání celé sítě. Na Core by se nezachytával veškerý provoz na jeho síťovém portu a nevznikal by soubor pro Wireshark. Takový záznam by obsahoval provoz každého zařízení v domě včetně hesel jiných systémů.
  • Veškerý provoz brokeru MQTT na Core v první verzi. Záznam by nesl to, co sám modul Packet Parser odesílá a přijímá. Zprávy, které si přes broker na Core vyměňují jiná zařízení, aniž by je odebíral některý modul TapHome, by v něm nebyly.
  • Dlouhá historie. Záznam by uchovával posledních několik stovek zpráv a dlouhý obsah by zkracoval. Je to nástroj pro hledání chyb, ne trvalý log.
  • Zprávy z doby před spuštěním. Co přišlo předtím, než jste záznam spustili, například hned po restartu Core, by v něm nebylo.
  • Jiné integrace. Modbus, sběrnice TapHome, Zigbee a další integrace nejsou součástí tohoto nápadu.

Jak to řešit dnes

  • Statistiky v servisním nastavení. Otevřete servisní nastavení modulu Packet Parser a porovnejte počty přijatých a odeslaných zpráv a u MQTT i témata. Téma, které jste nečekali, ukazuje, že zařízení publikuje pod jiným názvem; téma s mnoha zprávami je důvod zúžit filtr tématu, viz část Analýza paketů.
  • V listener skriptu nejdřív zkontrolujte téma. Porovnejte RECEIVEDMSG.Topic dřív, než přečtete obsah, aby zprávy, které nepotřebujete, nestály téměř nic, viz část Listener skript.
  • MQTT klient na počítači. Připojte MQTT klienta (například MQTT Explorer) ke stejnému brokeru, i když je to Broker MQTT na Core, a přihlaste se k odběru tématu zařízení nebo #. Zobrazí každou zprávu s časem a obsahem.
  • Zrcadlení portu na switchi. U HTTP, TCP a UDP umí spravovatelný switch kopírovat provoz portu Core do počítače s programem Wireshark. Obsah HTTPS zůstává šifrovaný.

Jak by to mohlo vypadat

Draft of the message log window for an HTTP module: each request with method and path, each answer with status code and response time, a timeout and an Unauthorized answer in pink. The selected request shows its headers with the Authorization value hidden.

U modulu HTTP by záznam spároval každý požadavek s jeho odpovědí, ukázal stavový kód a dobu odezvy, označil chyby, například timeout, a skryl hlavičku Authorization. Obrázky jsou návrh: výsledné obrazovky mohou vypadat jinak.

Další informace

U kterého protokolu hledáte chyby nejčastěji a co byste v záznamu potřebovali vidět? Hlasujte pro tento nápad a sledujte ho kvůli novinkám.

Související

Historie stavu

  • 4. 11. 2026 Zjišťujeme zájem Zveřejněno

Komentáře 0

Zapojte se do diskuse

Pro komentování se přihlaste svým účtem TapHome. Tým TapHome komentáře před zveřejněním schvaluje.

Zatím žádné komentáře.

Ideas ukazují směr, nikoli závazky. Termíny nezveřejňujeme; vydané funkce oznamujeme v release notes.