Configurações incorretas em uma service mesh — como incompatibilidade de versões, rótulos errados ou serviços virtuais conflitantes — podem degradar silenciosamente o roteamento de tráfego e a confiabilidade do serviço. O Service Mesh (ASM) oferece um recurso de diagnóstico integrado que verifica sua mesh em busca desses riscos e apresenta resultados acionáveis em quatro níveis de severidade: Normal, Sugestão, Aviso e Erro.
Pré-requisitos
Antes de começar, certifique-se de ter:
Uma instância do ASM com pelo menos um cluster Kubernetes associado
Permissões para acessar o console do ASM
Itens de verificação do diagnóstico
Cada execução de diagnóstico avalia as seguintes categorias:
|
Categoria |
O que é verificado |
|
Versões dos componentes do plano de dados |
Detecta incompatibilidades de versão entre proxies sidecar e o plano de controle |
|
Portas de serviço |
Valida se as configurações de porta do serviço estão corretas |
|
Associações de serviço |
Verifica se os serviços estão adequadamente associados às cargas de trabalho |
|
Rótulos de aplicação e versão |
Confirma se os pods possuem os rótulos |
|
Endereços de destino |
Assegura que os endereços de destino nas regras de roteamento sejam acessíveis |
|
Conflitos de serviço virtual |
Identifica definições conflitantes de serviços virtuais que podem causar erros de roteamento |
Executar um diagnóstico pelo console
Faça login no console do ASM. No painel de navegação à esquerda, escolha .
Na página Mesh Management, clique em o nome da instância do ASM. No painel de navegação à esquerda, escolha .
-
Inicie o diagnóstico conforme a versão do seu ASM:
Anterior à V1.17.2.10: Na página Mesh Diagnosis, clique em Run.
-
V1.17.2.10 e posteriores: Na página Mesh Diagnosis, desmarque os namespaces que deseja excluir do diagnóstico e clique em Run.
NotaNenhum resultado de diagnóstico é gerado para namespaces desmarcados.
Se existir um diagnóstico anterior, a página Mesh Diagnosis exibirá esses resultados. Clique em Run para iniciar um novo diagnóstico.
Interpretar os resultados do diagnóstico
Após a conclusão do diagnóstico, os resultados aparecem na seção Diagnosis results. Cada item verificado apresenta um dos seguintes níveis de severidade:
|
Ícone |
Severidade |
Significado |
|
|
Normal |
O item foi aprovado. Nenhuma ação necessária. |
|
|
Sugestão |
Um problema não crítico foi detectado. A mesh continua funcionando normalmente. |
|
|
Aviso |
Um risco potencial foi identificado. A instância do ASM pode apresentar comportamento inesperado. |
|
|
Erro |
Um problema crítico foi encontrado. Alguns recursos do ASM podem falhar. |
Para qualquer item reprovado, consulte as orientações de correção na coluna Details. Para obter sugestões específicas ao contexto, clique em Obtain Intelligent Diagnostics Suggestions na coluna Details para que o ASM AI Diagnostics Assistant (alpha) gere recomendações direcionadas.
Ferramentas adicionais de diagnóstico
O ASM disponibiliza ferramentas complementares ao recurso de diagnóstico integrado:
|
Ferramenta |
Caso de uso |
Mais informações |
|
CLI asmctl |
Diagnosticar configurações da instância do ASM diretamente pelo terminal |
|
|
Coleta de logs do plano de controle e alertas |
Coletar logs do plano de controle e configure alertas para detectar problemas proativamente |
Ative coleta de logs do plano de controle e alertas baseados em logs |
|
Alertas de auditoria para recursos do ASM |
Monitorar alterações em serviços virtuais, regras de destino e outros recursos do ASM |
Configure alertas de auditoria para operações em recursos do ASM |



