Apresentação automática de problemas

Vista geral

A apresentação automatizada de problemas (AIS) fornece informações rápidas sobre problemas em curso detetados no seu cluster híbrido. Estas informações incluem links para documentação para resolução de problemas e resolução. A apresentação automática de problemas procura apenas problemas conhecidos, comuns e detetáveis pelo sistema e não consegue detetar todos os problemas num cluster.

A partir do Apigee hybrid v1.10, o componente de monitorização do runtime do Apigee analisa automaticamente o estado do plano de controlo e do servidor da API Kubernetes para determinar se existem problemas de configuração. Por predefinição, a análise ocorre a cada 60 segundos. Pode alterar o intervalo ou desativar a procura, se preferir.

Quando o AIS deteta um problema, cria uma nova instância de ApigeeIssue no servidor da API Kubernetes. Estas instâncias contêm informações sobre os problemas e links para documentação sobre os problemas específicos.

Quando resolve problemas, estes são automaticamente eliminados do servidor da API Kubernetes quando a análise determina que já não estão a ocorrer.

Usar a apresentação automática de problemas.

Verifique se existem 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 tem de 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: 

Alterar o intervalo de análise

Por predefinição, o Watcher procura problemas no plano de controlo uma vez a cada 60 segundos. Para alterar o intervalo de análise, especifique o novo intervalo em segundos com a propriedade watcher.args.issueScanInterval no ficheiro de substituições. Por exemplo:

watcher:
  args:
    issueScanInterval: 120

Aplique a configuração.

Atualize o gráfico apigee-env para cada ambiente do Apigee.

helm upgrade $ORG_NAME apigee-org/ \
  --namespace APIGEE_NAMESPACE \
  -f OVERRIDES_FILE 

Desativar a apresentação automática de problemas

Pode desativar a apresentação automática de problemas definindo a propriedade watcher.args.enableIssueScanning como false no ficheiro de substituições. Por exemplo:

watcher:
  args:
    enableIssueScanning: false

Aplique a configuração.

Atualize o gráfico apigee-env para cada ambiente do Apigee.

helm upgrade $ORG_NAME apigee-org/ \
  --namespace APIGEE_NAMESPACE \
  -f OVERRIDES_FILE 
A apresentação automática de problemas pode fornecer links diretamente para os guias de resolução de problemas, incluindo: Consulte a Introdução ao Apigee X e aos manuais do Apigee Hybrid para ver uma vista geral e uma lista de guias de resolução de problemas do Apigee.