Descoberta automatizada de problemas

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.

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

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