# Explicador do protocolo iQuery

> Decodifique a saída do iqdump do F5 BIG-IP DNS e as mensagens iQuery do /var/log/gtm, ou explique a arquitetura do iQuery (malha, porta 4353, confiança SSL, iqdump, gtmd, big3d). Roda localmente.

- Tool: https://ronutz.com/pt-BR/tools/iquery-protocol-explainer
- Family: Redes

---

## O que faz

Cole a saída do comando `iqdump` do F5, linhas do `/var/log/gtm`, ou o nome de um tópico, e a ferramenta explica o protocolo iQuery da F5 sem tocar em nenhum equipamento. O iQuery é o protocolo proprietário, baseado em XML, que o BIG-IP DNS (antigo GTM) usa para conversar com o agente `big3d` nele mesmo e em cada outro BIG-IP que conhece. A ferramenta decodifica o que você cola e explica a arquitetura por trás disso. Ela decodifica e explica inteiramente no seu navegador, fundamentada na própria documentação de BIG-IP DNS/GTM da F5.

## Decodificando a saída do iqdump

O `iqdump` transmite ao vivo os dados iQuery entre dois sistemas para você verificar o caminho e a autenticação SSL. Cole a saída e a ferramenta lê de volta as linhas de comentário do cabeçalho, o hostname local de onde você o executou, o par `big3d` ao qual se conectou e a porta (4353), o grupo de sincronização assinado e o horário, e então os campos da seção `<xml_connection>` como `version`, a string de build do `big3d` e `connection_id`. Cada campo é explicado, e a presença de uma linha de par `big3d` é destacada como prova de que o caminho TCP e a confiança SSL até aquele agente estão funcionando, pois um caminho quebrado faz o `iqdump` reportar um erro.

## Decodificando linhas do /var/log/gtm

O processo `gtmd` registra a saúde da malha iQuery no `/var/log/gtm`. Cole essas linhas e a ferramenta decodifica as mensagens de mudança de estado da caixa, por exemplo uma transição `green --> red` que significa que um BIG-IP ficou indisponível pelo iQuery, junto com as entradas `SNMP_TRAP` e as mensagens de conexão `big3d` estabelecida/perdida. Uma transição `green --> red` é sinalizada com o que verificar em seguida: o caminho iQuery (TCP 4353, confiança SSL) até aquela caixa, e se o `big3d` dela está rodando e com versão compatível.

## Explicando a arquitetura

Digite ou clique em um tópico e a ferramenta o explica nos termos da F5: a malha iQuery de conexões de longa duração, a porta TCP 4353, a confiança baseada em certificado SSL que o `bigip_add`, o `big3d_install` e o `gtm_add` estabelecem, o próprio comando `iqdump`, o que o iQuery transporta (a disponibilidade dos objetos mais as métricas de balanceamento que o GSLB dinâmico precisa), os agentes `gtmd` e `big3d`, e a regra de VLAN de que o iQuery é enviado apenas na VLAN pela qual o sistema o recebe.

## Escopo e fundamentação

Ela explica e decodifica; nunca abre um socket, executa o `iqdump` ou busca nada, e a mesma entrada sempre produz a mesma saída. Ela lê o formato do texto do `iqdump` e dos logs, em vez de validar uma troca iQuery inteira. Todo fato vem dos manuais de conceitos e implementações de BIG-IP DNS/GTM da F5, do guia de operações LTM-DNS e dos artigos K sobre confiança e troubleshooting do iQuery; o exemplo é uma amostra real de `iqdump` publicada pela F5. Note que o módulo Link Controller foi removido no BIG-IP 21.0.0. Nada que você cola sai da página.

## Standards and references

- [F5 BIG-IP GTM Concepts: Communications Between BIG-IP GTM and Other Systems (iQuery is an XML protocol using gzip compression; iqdump; VLAN rule; gtmd/big3d)](https://techdocs.f5.com/kb/en-us/products/big-ip_gtm/manuals/product/gtm-concepts-11-5-0/2.html)
- [F5 BIG-IP DNS Implementations: Integrating BIG-IP DNS Into a Network with BIG-IP LTM Systems (gtmd uses iQuery to big3d; TCP 4353; big3d_install/bigip_add SSL trust)](https://techdocs.f5.com/kb/en-us/products/big-ip-dns/manuals/product/bigip-dns-implementations-13-0-0/1.html)
- [F5 K14707: Configuring BIG-IP DNS server objects behind a firewall NAT (iQuery over TCP 4353; probes follow the same path as DNS clients; bigip_add trust)](https://my.f5.com/manage/s/article/K14707)
- [F5 K13312: Overview of the BIG-IP DNS big3d_install, bigip_add, and gtm_add utilities (trust bootstrap; SSH port 22; Link Controller removed in 21.0.0)](https://my.f5.com/manage/s/article/K13312)
- [F5 K000139663: DNS iQuery third party certificate validation (real iqdump output sample: header comments and the <xml_connection> stanza)](https://my.f5.com/manage/s/article/K000139663)
- [F5 BIG-IP LTM-DNS Operations Guide: BIG-IP DNS iQuery (iQuery mesh; SSL cert auth; iqdump syntax and version XML stanza; /var/log/gtm state-change messages)](https://my.f5.com/manage/s/article/K13690)

## Related reading

- [Como o iQuery Conecta o BIG-IP DNS ao Resto da Rede](https://ronutz.com/pt-BR/learn/how-iquery-connects-bigip-dns.md): O iQuery é o protocolo XML que o BIG-IP DNS usa para saber se os objetos que ele resolve estão realmente no ar. Este artigo percorre a malha: gtmd e big3d, as conexões de longa duração na TCP 4353, a confiança por certificado SSL que o bigip_add estabelece, o que o iqdump mostra e a razão clássica de um virtual server estar verde no LTM mas vermelho no DNS.
