Está a ver a documentação do Apigee e do Apigee Hybrid.
Ver documentação do
Apigee Edge.
A resolução de problemas é uma arte e uma ciência. O esforço constante das equipas de apoio técnico do Apigee tem sido desmistificar a arte e expor a ciência por detrás da identificação e resolução de problemas.
O que são manuais de instruções?
Desenvolvidos em colaboração com as equipas de apoio técnico do Apigee, os manuais de soluções do Apigee foram concebidos para oferecer soluções rápidas e eficazes para erros ou outros problemas que possa encontrar quando trabalha com produtos Apigee.
Público-alvo
Os manuais de resolução de problemas destinam-se a leitores com um conhecimento de alto nível do Apigee e da respetiva arquitetura, bem como algum conhecimento de conceitos básicos, como políticas e estatísticas.
Alguns problemas só podem ser diagnosticados e resolvidos por utilizadores do Apigee hybrid e podem exigir conhecimentos de componentes internos, como os arquivos de dados Cassandra e Postgres, os processadores de mensagens e os routers.
Se estiver no Apigee, especificamos claramente quando pode executar os passos de resolução de problemas indicados e quando tem de contactar o apoio ao cliente do Google Cloud para receber assistência.
Guias interativos
Esta secção descreve os manuais de soluções atuais.
Para filtrar esta tabela, faça uma ou mais das seguintes ações: selecione uma categoria, selecione um produto, escreva um termo de pesquisa ou clique no cabeçalho de uma coluna para ordenar.
| Categoria | Guia interativo/Descrição do problema | Mensagem de erro | Guia interativo aplicável a |
|---|---|---|---|
| Cassandra | Falha na validação do certificado TLS do Cassandra | Se o certificado da AC do Apigee não corresponder entre clusters, a validação do certificado TLS no Cassandra pode falhar. | Apenas Apigee Hybrid |
| Cassandra | Resolução de problemas do restauro do Cassandra | Durante o restauro do Cassandra no Apigee hybrid, podem ocorrer erros nos registos de restauro. | Apenas Apigee Hybrid |
| Apresentação automática de problemas | Sem conetividade de rede entre o plano de tempo de execução e o plano de controlo | As solicitações de gestão de APIs da Apigee falham:
|
Apenas Apigee Hybrid |
| Apresentação automática de problemas | Virtual host missing environment group | Depois de executar kubectl -n apigee get apigeeissues, é apresentado o erro
AIS_VIRTUALHOST_MISSING_ENVGROUP.
|
Apenas Apigee Hybrid |
| Apresentação automática de problemas | Seletor de anfitrião virtual em falta | Após executar kubectl -n apigee get apigeeissues, é apresentado o erro
AIS_VIRTUALHOST_MISSING_SELECTOR.
|
Apenas Apigee Hybrid |
| Apresentação automática de problemas | Ingress cert mismatch | Depois de executar kubectl -n apigee get apigeeissues, é apresentado o erro
AIS_INGRESS_CERT_MISMATCH.
|
Apenas Apigee Hybrid |
| Apresentação automática de problemas | Validade do certificado de entrada | Após a execução de kubectl -n apigee get apigeeissues, é apresentado o erro AIS_INGRESS_CERT_EXPIREY.
|
Apenas Apigee Hybrid |
| Apresentação automática de problemas | Validade do certificado da AC de mTLS de entrada | Após a execução de kubectl -n apigee get apigeeissues, é apresentado o erro AIS_INGRESS_MTLS_CA_CERT_EXPIREY.
|
Apenas Apigee Hybrid |
| Apresentação automática de problemas | Ingress mTLS CA cert invalid | Após a execução de kubectl -n apigee get apigeeissues, é apresentado o erro AIS_INGRESS_MTLS_CA_CERT_INVALID.
|
Apenas Apigee Hybrid |
| Cassandra | Falha na replicação de dados do Cassandra |
Quando replicar dados durante uma expansão multirregional, o estado CassandraDataReplication pode apresentar um estado de erro e a replicação de dados pode falhar.
|
Apenas Apigee Hybrid |
| Cassandra | Problemas de espaço de memória Java do Cassandra |
Os problemas de memória de processamento do Cassandra podem causar lentidão na execução do proxy híbrido do Apigee ou até mesmo erros Datastore. Por vezes, os registos são um indicador precoce, mesmo antes do início dos sintomas.
|
Apenas Apigee Hybrid |
| Cassandra | Os pods do Cassandra não são iniciados na região secundária |
Os pods do Cassandra não são iniciados numa das regiões numa configuração híbrida com várias regiões.
Pode ver uma mensagem de erro node already exists nos registos do pod do Cassandra ou
um aviso FailedPreStopHook no estado do pod do Cassandra.
|
Apenas Apigee Hybrid |
| Cassandra | Guia de resolução de problemas do Cassandra |
Quando usa kubectl para ver os estados dos pods, vê que um ou mais pods do Cassandra estão bloqueados. Este guia descreve o diagnóstico e a resolução de problemas com o armazenamento de dados do Cassandra.
|
Apenas Apigee Hybrid |
| Implementação | As implementações do proxy de API falham sem aviso de pods de tempo de execução ativos | O aviso Nenhum pod de tempo de execução ativo é apresentado na caixa de diálogo Detalhes junto à mensagem de erro Problemas de implementação em ENVIRONMENT: REVISION_NUMBER na página do proxy de API. | Apenas Apigee Hybrid |
| Ingressgateway | As chamadas API falham com erros de tempo limite |
curl: (7) Failed to connect to example.apis.com port 443: Operation timed out |
Apenas Apigee Hybrid |
| Ingressgateway | Chamadas da API a falhar com erros de TLS |
curl: (35) LibreSSL SSL_connect: SSL_ERROR_SYSCALL in connection to example.apis.com:443 |
Apenas Apigee Hybrid |
| Registo | Resolução de problemas de registos do Apigee em falta no Cloud Logging | Não são apresentadas mensagens de erro neste cenário. | Apigee e Apigee Hybrid |
| Gestão/IU | Dados inconsistentes/inexistentes observados para entidades na IU híbrida ou através das APIs Management | Não são apresentadas mensagens de erro neste cenário. | Apenas Apigee Hybrid |
| Configuração da rede | Aceda a problemas de encaminhamento com o Apigee |
Os clientes externos não conseguem aceder/estabelecer ligação ao Apigee da forma desejada. Estes incluem falhas de conetividade de rede
(a confirmação de TLS falha) ou respostas 4xx/5xx do Apigee.
|
Apigee e Apigee Hybrid |
| Configuração da rede | Problema de conetividade do Apigee com o PSC de saída |
A configuração do Private Service Connect de saída não está a funcionar conforme esperado e o estado do grupo de pontos finais da rede permanece em Pending.
|
Apenas Apigee |
| Configuração da rede | Problemas de conetividade do Apigee com destinos PSC a sul |
Um problema de ligação de rede ou um limite de tempo excedido de TCP entre o Apigee e o serviço de destino seria apresentado como uma resposta de erro 503 e apresentaria um erro semelhante ao abaixo se criasse uma sessão de depuração.
{"fault":{"faultstring":"The Service is temporarily unavailable","detail":{"errorcode":"messaging.adaptors.http.flow.ServiceUnavailable","reason":"TARGET_CONNECT_TIMEOUT"}}} |
Apenas Apigee |
| Outro | Expandir as contagens de réplicas de propriedades do Istio quando os nós estão a ser esvaziados | Quando esvazia os pods do Istio, alguns nós podem não ser esvaziados porque têm uma quantidade de réplicas de 1, enquanto são necessárias 3 ou mais réplicas. Para evitar esta situação, deve definir a quantidade mínima de réplicas para cada propriedade para, pelo menos, 3. | Apenas Apigee Hybrid |
| Outro | Guia de resolução de problemas do processador de mensagens |
Um ou mais pods apigee-runtime não estão no estado Ready.
Quando usa kubectl para descrever um pod com falhas
apigee-runtime, é apresentado o erro:
Readiness probe failed: HTTP probe failed with statuscode: 500 |
Apenas Apigee Hybrid |
| Outro | Imprimir informações de compilação |
A API buildinfo devolve informações sobre a compilação atual de um componente de tempo de execução. Estas informações podem ser úteis se
precisar de contactar o apoio técnico.
|
Apenas Apigee Hybrid |
| Outro | StreamingPull errors 100% |
Se vir no painel de controlo de métricas que o método
google.pubsub.vl.Subscriber.StreamingPull está a falhar com
100% de erros, pode ignorar o problema em segurança. Este comportamento é o esperado.
|
Apenas Apigee Hybrid |
| Implementação | A instância não está a comunicar o estado do grupo de ambientes | As implementações de proxies de API falham com o erro INSTANCE_NAME is not reporting status for environment group ENV_GROUP_NAME na IU híbrida do Apigee. | Apenas Apigee Hybrid |
| Implementação | As implementações de proxy de API falham com o erro apigee-serving-cert is not found ou expirou |
As implementações de proxy de API falham com mensagens de erro nos registos apigee-watcher.
|
Apenas Apigee Hybrid |
| Ingressgateway | Expanda as contagens de réplicas de propriedades do Istio para evitar problemas ao esgotar os nós do Istio |
Quando esvazia os pods do Istio, alguns nós podem não ser esvaziados porque têm um número de réplicas de 1, enquanto são necessárias 3 ou mais réplicas. Para evitar esta situação, deve definir o número mínimo de réplicas
para cada propriedade como, pelo menos, 3.
|
Apenas Apigee Hybrid |
| Configuração da rede | Resolução de problemas de espaço de endereços IP livre | Durante o aprovisionamento do Apigee, se selecionar um intervalo CIDR de rede que não esteja completamente livre, pode ver uma mensagem de erro. | Apigee e Apigee Hybrid |
| Configuração da rede | Erro 503 Serviço indisponível com TARGET_CONNECT_TIMEOUT (alvos de peering de VPC e Internet) | Este documento descreve como diagnosticar e corrigir erros "503 Service Unavailable" com TARGET_CONNECT_TIMEOUT quando usa destinos de peering de VPC ou da Internet. | Apigee |
| Configuração da rede | 504 Tempo limite do gateway - Tempo limite de leitura do destino | Este documento descreve como diagnosticar e corrigir erros "504 Tempo limite do gateway excedido" com o motivo TARGET_READ_TIMEOUT. | Apigee e Apigee Hybrid |
| Outro | Resolução de problemas do Apigee Hybrid bloqueado no estado de criação ou lançamento |
Este documento descreve como repor os componentes híbridos do Apigee quando
ficam bloqueados num estado creating ou releasing.
|
Apenas Apigee Hybrid |
| Instalação e atualização do Apigee Hybrid | Pods do Cassandra no estado CrashLoopBackOff | Os pods do Cassandra estão bloqueados num estado CrashLoopBackOff após a instalação ou a atualização. | Apenas Apigee Hybrid |
| Instalação e atualização do Apigee Hybrid | Os pods do gateway de entrada da Apigee mostram 1 de 2 contentores em execução |
Os seus pods apigee-ingressgateway mostram apenas 1 de 2 contentores em execução quando recebe a lista de pods. |
Apenas Apigee Hybrid |
| Instalação e atualização do Apigee Hybrid | Erro do agrupamento UDCA | Os pods do UDCA e do agente de ligação geram um erro de problema de autorização. | Apenas Apigee Hybrid |
| Instalação e atualização do Apigee Hybrid | Reposições de ligação durante o handshake TLS para clientes não SNI | São observadas reposições de ligação durante o handshake TLS para clientes não SNI. | Apenas Apigee Hybrid |
| Instalação e atualização do Apigee Hybrid | Espaço em disco insuficiente no Cassandra | O processo de instalação do Apigee hybrid falha devido a espaço em disco insuficiente para a base de dados Cassandra. | Apenas Apigee Hybrid |