Introdução aos playbooks da Apigee e da Apigee híbrida

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:

  • Os produtos de API, desenvolvedores e aplicativos não são preenchidos na interface da Apigee.
  • As implantações de proxy de API não foram concluídas.
  • 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