Estás consultando la documentación de Apigee y Apigee Hybrid.
Consulta la documentación de
Apigee Edge.
La solución de problemas es tanto un arte como una ciencia. El esfuerzo constante de los equipos de asistencia técnica de Apigee ha sido desmitificar el arte y exponer la ciencia que hay detrás de la identificación y la resolución de problemas.
¿Qué son las guías?
Desarrollados en colaboración con los equipos de Asistencia Técnica de Apigee, los manuales para solucionar problemas de Apigee se han diseñado para ofrecer soluciones rápidas y eficaces a los errores u otros problemas que puedan surgirte al trabajar con los productos de Apigee.
Audiencia
Los manuales de soluciones de problemas están dirigidos a lectores que tengan un conocimiento general de Apigee y su arquitectura, así como de algunos conceptos básicos, como las políticas y las analíticas.
Algunos problemas solo pueden diagnosticarlos y resolverlos los usuarios de Apigee Hybrid y pueden requerir conocimientos sobre componentes internos, como los almacenes de datos de Cassandra y Postgres, los procesadores de mensajes y los routers.
Si usas Apigee, especificamos claramente cuándo puedes seguir los pasos para solucionar problemas indicados y cuándo debes ponerte en contacto con el equipo de Asistencia de Google Cloud para obtener ayuda.
Guías
En esta sección se describen los cuadernos de estrategias actuales.
Para filtrar esta tabla, haga una o varias de las siguientes acciones: seleccione una categoría, seleccione un producto, escriba un término de búsqueda o haga clic en el encabezado de una columna para ordenar los datos.
| Categoría | Descripción de la guía o del problema | Mensaje de error | Guía aplicable a |
|---|---|---|---|
| Cassandra | No se ha podido verificar el certificado TLS de Cassandra | Si el certificado de la CA de Apigee no coincide en los clústeres, es posible que falle la verificación del certificado TLS en Cassandra. | Solo Apigee Hybrid |
| Cassandra | Solucionar problemas de restauración de Cassandra | Durante la restauración de Cassandra en Apigee hybrid, es posible que se produzcan errores en los registros de restauración. | Solo Apigee Hybrid |
| Detección automática de problemas | No hay conectividad de red entre el plano de ejecución y el plano de control | Las solicitudes de gestión de APIs de Apigee fallan:
|
Solo Apigee Hybrid |
| Detección automática de problemas | Falta el grupo de entorno del host virtual | Después de ejecutar kubectl -n apigee get apigeeissues, se muestra el error AIS_VIRTUALHOST_MISSING_ENVGROUP.
|
Solo Apigee Hybrid |
| Detección automática de problemas | Virtual host missing selector | Después de ejecutar kubectl -n apigee get apigeeissues, se muestra el error AIS_VIRTUALHOST_MISSING_SELECTOR.
|
Solo Apigee Hybrid |
| Detección automática de problemas | Ingress cert mismatch | Después de ejecutar kubectl -n apigee get apigeeissues, se muestra el error AIS_INGRESS_CERT_MISMATCH.
|
Solo Apigee Hybrid |
| Detección automática de problemas | Caducidad del certificado de entrada | Después de ejecutar kubectl -n apigee get apigeeissues, se muestra el error AIS_INGRESS_CERT_EXPIREY.
|
Solo Apigee Hybrid |
| Detección automática de problemas | Caducidad del certificado de AC de mTLS de entrada | Después de ejecutar kubectl -n apigee get apigeeissues, se muestra el error AIS_INGRESS_MTLS_CA_CERT_EXPIREY.
|
Solo Apigee Hybrid |
| Detección automática de problemas | Certificado de CA de mTLS de entrada no válido | Después de ejecutar kubectl -n apigee get apigeeissues, se muestra el error AIS_INGRESS_MTLS_CA_CERT_INVALID.
|
Solo Apigee Hybrid |
| Cassandra | Fallo en la réplica de datos de Cassandra |
Al replicar datos durante una expansión multirregional, el estado CassandraDataReplication puede mostrar un error y la replicación de datos puede fallar.
|
Solo Apigee Hybrid |
| Cassandra | Problemas de espacio de montículo de Java de Cassandra |
Los problemas con el montículo de Cassandra pueden provocar lentitud en la ejecución del proxy híbrido de Apigee o incluso errores Datastore. A veces, los registros son un indicador temprano, incluso antes de que aparezcan los síntomas.
|
Solo Apigee Hybrid |
| Cassandra | Los pods de Cassandra no se inician en la región secundaria |
Los pods de Cassandra no se inician en una de las regiones de una configuración híbrida multirregión.
Es posible que veas un mensaje de error node already exists en los registros del pod de Cassandra o
una advertencia FailedPreStopHook en el estado del pod de Cassandra.
|
Solo Apigee Hybrid |
| Cassandra | Guía de solución de problemas de Cassandra |
Cuando usas kubectl para ver los estados de los pods, observas que uno o varios pods de Cassandra están bloqueados. En esta guía se describe el diagnóstico y la resolución de problemas con el almacén de datos de Cassandra.
|
Solo Apigee Hybrid |
| Implementación | Los despliegues de proxies de APIs fallan y no hay advertencias activas de pods de entorno de ejecución | La advertencia No hay pods de entorno de ejecución activos se muestra en el cuadro de diálogo Detalles junto al mensaje de error Problemas de despliegue en ENVIRONMENT: REVISION_NUMBER en la página del proxy de API. | Solo Apigee Hybrid |
| Ingressgateway | Las llamadas a la API fallan con errores de tiempo de espera |
curl: (7) Failed to connect to example.apis.com port 443: Operation timed out |
Solo Apigee Hybrid |
| Ingressgateway | Llamadas a API fallidas con errores de TLS |
curl: (35) LibreSSL SSL_connect: SSL_ERROR_SYSCALL in connection to example.apis.com:443 |
Solo Apigee Hybrid |
| Almacenamiento de registros | Solucionar problemas de registros de Apigee que faltan en Cloud Logging | No se muestra ningún mensaje de error en este caso. | Apigee y Apigee Hybrid |
| Gestión e interfaz de usuario | No coinciden los datos de las entidades de la interfaz de usuario híbrida ni las usan las APIs Management | No se muestra ningún mensaje de error en este caso. | Solo Apigee Hybrid |
| Configuración de red | Problemas de acceso al enrutamiento con Apigee |
Los clientes externos no pueden acceder ni conectarse a Apigee de la forma deseada. Entre ellos, se incluyen fallos de conectividad de red (error de handshake de TLS) o respuestas 4xx/5xx de Apigee.
|
Apigee y Apigee Hybrid |
| Configuración de red | Problemas de conectividad de Apigee con destinos de PSC de salida |
Si se produce un problema de conexión de red o un tiempo de espera de TCP entre Apigee y el servicio de destino, se mostrará una respuesta de error 503 y un error similar al siguiente si creas una sesión de depuración.
{"fault":{"faultstring":"The Service is temporarily unavailable","detail":{"errorcode":"messaging.adaptors.http.flow.ServiceUnavailable","reason":"TARGET_CONNECT_TIMEOUT"}}} |
Apigee y Apigee Hybrid |
| Otro | Mostrar el número de réplicas de propiedades de Istio al drenar nodos | Al drenar pods de Istio, es posible que algunos nodos no se drenen porque tienen un número de réplicas de 1, mientras que se requieren 3 o más réplicas. Para evitarlo, debes definir un número mínimo de réplicas de al menos 3 para cada propiedad. | Solo Apigee Hybrid |
| Otro | Guía de solución de problemas del procesador de mensajes |
Uno o varios pods de apigee-runtime no están en el estado Ready.
Cuando usas kubectl para describir un pod apigee-runtime fallido, aparece el siguiente error:
Readiness probe failed: HTTP probe failed with statuscode: 500 |
Solo Apigee Hybrid |
| Otro | Mostrar información de la compilación |
La API buildinfo devuelve información sobre la compilación actual de un componente de tiempo de ejecución. Esta información puede ser útil si necesitas ponerte en contacto con el equipo de Asistencia.
|
Solo Apigee Hybrid |
| Otro | Errores de StreamingPull con una tasa de errores del 100% |
Si en el panel de control de métricas ves que el método google.pubsub.vl.Subscriber.StreamingPull falla y muestra un 100% de errores, puedes ignorar el problema. Es el comportamiento esperado.
|
Solo Apigee Hybrid |
| Implementación | La instancia no informa del estado del grupo de entornos | Los despliegues de proxies de API fallan y se muestra el error Instance INSTANCE_NAME is not reporting status for environment group ENV_GROUP_NAME (La instancia INSTANCE_NAME no informa del estado del grupo de entornos ENV_GROUP_NAME ) en la interfaz de usuario híbrida de Apigee. | Solo Apigee Hybrid |
| Implementación | Los despliegues de proxies de APIs fallan porque no se encuentra o ha caducado el certificado apigee-serving-cert |
Los despliegues de proxies de API fallan y se muestran mensajes de error en los registros apigee-watcher.
|
Solo Apigee Hybrid |
| Ingressgateway | Aumenta el número de réplicas de la propiedad de Istio para evitar problemas al drenar nodos de Istio |
Al drenar pods de Istio, es posible que algunos nodos no se drenen porque tienen un número de réplicas de 1, mientras que se necesitan 3 o más réplicas. Para evitarlo, debe definir el número mínimo de réplicas de cada propiedad en 3 como mínimo.
|
Solo Apigee Hybrid |
| Configuración de red | Solución de problemas de falta de espacio de direcciones IP libres | Durante el aprovisionamiento de Apigee, si seleccionas un intervalo CIDR de red que no esté completamente libre, es posible que veas un mensaje de error. | Apigee y Apigee Hybrid |
| Configuración de red | Error 503 (servicio no disponible) con TARGET_CONNECT_TIMEOUT (destinos de Internet y de peering de VPC) | En este documento se describe cómo diagnosticar y corregir los errores "503 Service Unavailable" con TARGET_CONNECT_TIMEOUT al usar destinos de Internet o de peering de VPC. | Apigee |
| Configuración de red | 504 Tiempo de espera de pasarela agotado: tiempo de espera de lectura de destino agotado | En este documento se describe cómo diagnosticar y corregir los errores "504 Gateway Timeout" con el motivo TARGET_READ_TIMEOUT. | Apigee y Apigee Hybrid |
| Otro | Solucionar problemas de Apigee Hybrid que se queda en el estado de creación o lanzamiento |
En este documento se describe cómo restablecer los componentes de Apigee hybrid cuando se quedan bloqueados en el estado creating o releasing.
|
Solo Apigee Hybrid |
| Instalación y actualización de Apigee Hybrid | Pods de Cassandra con el estado CrashLoopBackOff | Los pods de Cassandra se quedan en el estado CrashLoopBackOff después de la instalación o la actualización. | Solo Apigee Hybrid |
| Instalación y actualización de Apigee Hybrid | Error del pod de UDCA | Los pods de UDCA y Connect Agent devuelven un error de problema de permisos. | Solo Apigee Hybrid |
| Instalación y actualización de Apigee Hybrid | Se restablecen las conexiones durante la negociación de TLS para los clientes que no son de la SNI | Se observan restablecimientos de conexión durante el handshake TLS para clientes que no son de la SNI. | Solo Apigee Hybrid |
| Instalación y actualización de Apigee Hybrid | Espacio en disco insuficiente en Cassandra | El proceso de instalación de Apigee hybrid falla porque no hay suficiente espacio en disco para la base de datos de Cassandra. | Solo Apigee Hybrid |