Informações gerais
A descoberta automatizada de problemas (AIS, na sigla em inglês) fornece informações rápidas sobre problemas em andamento detectados no cluster híbrido. Essas informações incluem links para a documentação sobre solução de problemas. A descoberta automatizada de problemas identifica apenas problemas conhecidos, comuns e detectáveis do sistema e não consegue detectar todos os problemas em um cluster.
A partir da Apigee híbrida v1.10, o componente de monitoramento do ambiente de execução da Apigee verifica automaticamente o plano de controle e o estado do servidor da API Kubernetes para determinar se há algum problema de configuração. Por padrão, a verificação acontece a cada 60 segundos. Você pode alterar o intervalo ou desativar a verificação, se preferir.
Quando o AIS detecta um problema, ele cria uma nova instância de ApigeeIssue no servidor da API Kubernetes. Essas instâncias contêm informações sobre os problemas e links para a documentação sobre eles.
Quando você resolver problemas, eles serão automaticamente excluídos do servidor da API Kubernetes quando a verificação determinar que eles não estão mais ocorrendo.
Como usar a descoberta automatizada de problemas
Verifique se há problemas com o comando kubectl get apigeeissues:
kubectl -n APIGEE_NAMESPACE get apigeeissues
Por exemplo:
kubectl -n APIGEE_NAMESPACE get apigeeissues NAME SEVERITY AGE URL vhost-missing-eg-nonprod Error 1hr https://cloud.google.com/apigee/docs/hybrid/MISSING_ENV_GROUP control-plane-connectivity-failure Error 1d https://cloud.google.com/apigee/docs/hybrid/OLD_TLS_VERSION
Para informações mais detalhadas sobre um problema específico, use o comando kubectl describe com o nome do problema. O nome precisa ser precedido por apigeeissues. Por exemplo: apigeeissues vhost-missing-eg-nonprod.
kubectl -n APIGEE_NAMESPACE describe apigeeissues vhost-missing-eg-nonprod Name: vhost-missing-eg-nonprod Namespace: apigee Labels:Annotations: API Version: apigee.cloud.google.com/v1alpha1 Kind: ApigeeIssue Metadata: Creation Timestamp: 2022-08-25T20:41:56Z Managed Fields: API Version: apigee.cloud.google.com/v3 Resource Version: 12345678 UID: aaaaaaaa-bbbb-cccc-dddd-eeeeffffgggg Spec: Severity: Error Reason: MISSING_ENV_GROUP Details: Expected envgroup "nonprod" for ApigeeRouteConfig "my-org-nonprod" Documentation: https://cloud.google.com/apigee/docs/hybrid/MISSING_ENV_GROUP Ignore: false IgnoreReason: Events:
Como alterar o intervalo de verificação
Por padrão, o inspetor verifica problemas no plano de controle a cada 60 segundos. Para alterar o intervalo de verificação, especifique o novo intervalo em segundos com a propriedade watcher.args.issueScanInterval no arquivo de modificações. Por exemplo:
watcher:
args:
issueScanInterval: 120
Aplique a configuração.
Helm
Faça upgrade do gráfico apigee-env para cada ambiente da Apigee.
helm upgrade $ORG_NAME apigee-org/ \ --namespace APIGEE_NAMESPACE \ -f OVERRIDES_FILE
apigeectl
Aplique a mudança em todos os ambientes.
apigeectl apply -f OVERRIDES_FILE --org
Como desativar a exibição automática de problemas
Você pode desativar a exibição automática de problemas definindo a propriedade watcher.args.enableIssueScanning como false no arquivo de modificações. Por exemplo:
watcher:
args:
enableIssueScanning: false
Aplique a configuração.
Helm
Faça upgrade do gráfico apigee-env para cada ambiente da Apigee.
helm upgrade $ORG_NAME apigee-org/ \ --namespace APIGEE_NAMESPACE \ -f OVERRIDES_FILE
apigeectl
Aplique a mudança em todos os ambientes.
apigeectl apply -f OVERRIDES_FILE --org
Guias de solução de problemas relacionados
A descoberta automatizada de problemas pode fornecer links diretamente para os guias de solução de problemas, incluindo:- Não há conectividade de rede entre o plano de ambiente de execução e o plano de controle
- Grupo de ambiente virtual ausente no host
- Seletor do host virtual não informado
- Incompatibilidade do certificado de entrada
- Validade do certificado de entrada
- Validade do certificado de CA mTLS de entrada
- Certificado de CA mTLS da entrada inválido