Visão geral
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 get apigeeissues
Exemplo:
kubectl -n apigee 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 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. Exemplo:
watcher: args: issueScanInterval: 120
Aplique a configuração.
Faça upgrade do gráfico apigee-env
para cada ambiente da Apigee.
helm upgrade ENV_NAME apigee-env/ \ --install \ --namespace NAMESPACE \ --set env=ENV_NAME \ --atomic \ -f overrides.yaml
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. Exemplo:
watcher: args: enableIssueScanning: false
Aplique a configuração.
Faça upgrade do gráfico apigee-env
para cada ambiente da Apigee.
helm upgrade ENV_NAME apigee-env/ \ --install \ --namespace NAMESPACE \ --set env=ENV_NAME \ --atomic \ -f overrides.yaml
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
- Incompatibilidade do certificado de Ingress