Esta é a documentação da Apigee e da Apigee híbrida.
Veja a documentação da Apigee
Edge.
O ato de solucionar problemas é uma arte e uma ciência. O esforço constante das equipes de suporte técnico da Apigee tem sido desmistificar o conhecimento e expor a ciência por trás da identificação e da resolução de problemas.
O que são manuais?
Desenvolvida em colaboração com as equipes de suporte técnico da Apigee, os playbooks de solução de problemas da Apigee foram projetados para oferecer soluções rápidas e eficazes para erros ou outros problemas que você pode encontrar ao trabalhar com produtos da Apigee.
Público-alvo
A solução de problemas do Google Play é voltada para leitores com entendimento avançado da Apigee e da arquitetura dela, além de alguns conceitos básicos, como políticas e análises.
Alguns problemas podem ser diagnosticados e resolvidos somente pelos usuários híbridos da Apigee e podem exigir conhecimento de componentes internos, como armazenamentos de dados do Cassandra e Postgres, processadores de mensagens e roteadores.
Se você usa a Apigee, especificamos claramente quando é possível realizar etapas de solução de problemas indicadas e quando é possível entrar em contato com o Cloud Customer Care para receber ajuda.
Manuais
Nesta seção, descrevemos os playbooks atuais.
Para filtrar a tabela, realize uma ou mais destas ações: selecione uma categoria, selecione um produto, digite um termo de pesquisa ou clique no cabeçalho de uma coluna para classificar.
| Categoria | Descrição do playbook/problema | Mensagem de erro | Playbook aplicável para |
|---|---|---|---|
| Cassandra | Solução de problemas na restauração do Cassandra | Durante a restauração do Cassandra na Apigee híbrida, talvez você encontre erros nos registros de restauração. | Somente híbrido da Apigee |
| Descoberta automatizada de problemas | Sem conectividade de rede entre o plano do ambiente de execução e o plano de controle | As solicitações de gerenciamento da API Apigee falham:
|
Somente híbrido da Apigee |
| Descoberta automatizada de problemas | Grupo de ambiente virtual ausente no host | Depois de executar kubectl -n apigee get apigeeissues, o
erro AIS_VIRTUALHOST_MISSING_ENVGROUP é exibido.
|
Somente híbrido da Apigee |
| Descoberta automatizada de problemas | Seletor ausente do host virtual | Depois de executar kubectl -n apigee get apigeeissues, o erro
AIS_VIRTUALHOST_MISSING_SELECTOR é exibido.
|
Somente híbrido da Apigee |
| Descoberta automatizada de problemas | Incompatibilidade do certificado de Ingress | Depois de executar kubectl -n apigee get apigeeissues, o erro AIS_INGRESS_CERT_MISMATCH será exibido.
|
Somente híbrido da Apigee |
| Descoberta automatizada de problemas | Validade do certificado de entrada | Depois de executar kubectl -n apigee get apigeeissues, o erro AIS_INGRESS_CERT_EXPIREY será exibido. |
Somente híbrido da Apigee |
| Descoberta automatizada de problemas | Validade do certificado de CA mTLS de entrada | Depois de executar kubectl -n apigee get apigeeissues, o
erro AIS_INGRESS_MTLS_CA_CERT_EXPIREY é exibido.
|
Somente híbrido da Apigee |
| Descoberta automatizada de problemas | Certificado de CA mTLS de entrada inválido | Depois de executar kubectl -n apigee get apigeeissues, o
erro AIS_INGRESS_MTLS_CA_CERT_INVALID é exibido.
|
Somente híbrido da Apigee |
| Cassandra | Falha na replicação de dados do Cassandra |
Ao replicar dados durante uma expansão multirregional, o status
CassandraDataReplication pode mostrar um estado de erro e a replicação de dados
pode falhar.
|
Somente híbrido da Apigee |
| Cassandra | Problemas de espaço do heap do Java no Cassandra |
Problemas do heap do Cassandra podem causar lentidão na execução de proxy da Apigee híbrida
ou até mesmo erros de Datastore. Às vezes, os registros são um
indicador, mesmo antes do início dos sintomas.
|
Somente híbrido da Apigee |
| Cassandra | Pods do Cassandra não iniciados na região secundária |
Os pods do Cassandra não são iniciados em uma das regiões em uma configuração híbrida multirregional.
Você pode ver uma mensagem de erro node already exists nos registros do pod do Cassandra ou
um aviso FailedPreStopHook no status do pod do Cassandra.
|
Somente híbrido da Apigee |
| Cassandra | Guia de solução de problemas do Cassandra |
Ao usar kubectl para visualizar os estados dos pods, você verá que
um ou mais pods do Cassandra estão travados. Neste guia, descrevemos o diagnóstico e a resolução de problemas com o repositório de dados do Cassandra.
|
Somente híbrido da Apigee |
| Implantação | As implantações de proxy de API falham sem aviso ativo de pods do ambiente de execução | O aviso Nenhum cluster de ambiente de execução ativo é exibido na caixa de diálogo Detalhes ao lado da mensagem de erro Problemas de implantação em ENVIRONMENT: REVISION_NUMBER na página de proxy da API. | Somente híbrido da Apigee |
| Gateway de entrada | As chamadas de API falham com erros de tempo limite |
curl: (7) Failed to connect to example.apis.com port 443: Operation timed out |
Somente híbrido da Apigee |
| Gateway de entrada | Chamadas de API com erros de TLS |
curl: (35) LibreSSL SSL_connect: SSL_ERROR_SYSCALL in connection to example.apis.com:443 |
Somente híbrido da Apigee |
| Logging | Solução de problemas de registros da Apigee ausentes do Cloud Logging | Nenhuma mensagem de erro é conhecida no cenário. | Apigee e Apigee híbrida |
| IU/Gerenciamento | Dados inconsistentes/sem dados observados para entidades na IU híbrida ou por meio das APIs Management | Nenhuma mensagem de erro é conhecida no cenário. | Somente híbrido da Apigee |
| Configuração de rede | Problemas de roteamento de acesso com a Apigee |
Os clientes externos não conseguem acessar/se conectar à Apigee da maneira desejada. Isso inclui falhas de conectividade de rede (falha no handshake de TLS) ou respostas 4xx/5xx da Apigee.
|
Apigee e Apigee híbrida |
| Configuração de rede | Problemas de conectividade da Apigee com destinos PSC vinculados ao sul |
Se você criar uma sessão de depuração, um erro de conexão de rede ou tempo limite de TCP entre a Apigee e o
serviço de destino, 503 será exibido como uma resposta de erro,
exibindo um erro semelhante ao mostrado abaixo.
{"fault":{"faultstring":"The Service is temporarily unavailable","detail":{"errorcode":"messaging.adaptors.http.flow.ServiceUnavailable","reason":"TARGET_CONNECT_TIMEOUT"}}} |
Apigee e Apigee híbrida |
| Outro | Como expandir as contagens de réplica de propriedade do Istio ao esvaziar os nós | Ao esvaziar os pods do Istio, alguns nós podem não ser drenados porque têm uma contagem de réplicas de 1, enquanto três ou mais réplicas são necessárias. Para evitar isso, é preciso definir a contagem mínima de réplicas de cada propriedade como no mínimo três. | Somente híbrido da Apigee |
| Outro | Guia de solução de problemas do processador de mensagens |
Um ou mais pods do ambiente de execução da Apigee não estão no estado Ready.
Ao usar kubectl para descrever um pod apigee-runtime com falha, você verá o erro:
Readiness probe failed: HTTP probe failed with statuscode: 500 |
Somente híbrido da Apigee |
| Outro | Imprimir informações da versão |
A API buildinfo retorna informações sobre a versão atual de um componente de ambiente de execução. Essas informações podem ser úteis se você precisar entrar em contato com o suporte.
|
Somente híbrido da Apigee |
| Outro | 100% de erros de StreamingPull |
Se você ver no painel de métricas que o método google.pubsub.vl.Subscriber.StreamingPull
está falhando com 100% de erros, ignore o problema. Esse comportamento é esperado.
|
Somente híbrido da Apigee |
| Implantação | A instância não está relatando o status do grupo de ambientes | As implantações de proxies de API falham com a instância INSTANCE_NAME não está relatando o status do erro do grupo de ambiente ENV_GROUP_NAME na interface da Apigee híbrida. | Somente híbrido da Apigee |
| Implantação | As implantações do proxy de API falham indicando que o apigee-serving-cert não foi encontrado ou está expirado |
As implantações do proxy de API falham com mensagens de erro nos registros apigee-watcher.
|
Somente híbrido da Apigee |
| Gateway de entrada | Expanda as contagens de réplicas de propriedade do Istio para evitar problemas ao reduzir os nós do Istio |
Ao esvaziar os pods do Istio, alguns nós podem não ser drenados porque têm uma contagem de réplicas de 1, enquanto 3 ou
mais réplicas são necessárias. Para evitar isso, é preciso definir a contagem mínima de réplicas de cada
propriedade como no mínimo 3.
|
Somente híbrido da Apigee |
| Configuração de rede | Solução de problemas quando não há espaço de endereço IP disponível | Durante o provisionamento da Apigee, se você selecionar um intervalo CIDR de rede que não esteja completamente disponível, uma mensagem de erro poderá ser exibida. | Apigee e Apigee híbrida |
| Configuração de rede | Erro de serviço indisponível do peering de VPC 503 com TARGET_CONNECT_TIMEOUT | Neste documento, mostramos como diagnosticar e corrigir erros do tipo "503 Service Unavailable" com TARGET_CONNECT_TIMEOUT ao usar o peering de VPC. | Apigee |
| Configuração de rede | 504 Gateway Timeout - Tempo limite de leitura de destino | Neste documento, mostramos como diagnosticar e corrigir erros do tipo "504 Gateway Timeout" com um motivo TARGET_READ_TIMEOUT. | Apigee e Apigee híbrida |
| Outro | Solução de problemas da Apigee híbrida travada na criação ou liberação de estado | Neste documento, descrevemos como redefinir os componentes da Apigee híbrida quando eles estão presos no estado creating ou releasing. |
Somente híbrido da Apigee |