Estás viendo la documentación de Apigee y Apigee Hybrid.
Consulta la documentación de Apigee Edge.
El acto de solucionar problemas es un arte y una ciencia. El esfuerzo constante de los equipos de asistencia técnica de Apigee consiste en desmitificar el arte y exponer la ciencia detrás de la identificación y resolución de problemas.
¿Qué son las guías?
Las guías de solución de problemas de Apigee, que se desarrollaron en colaboración con los equipos de asistencia al cliente de Apigee, se diseñaron para proporcionar soluciones rápidas y eficaces a errores o a otros problemas que puedes encontrar cuando trabajas con productos de Apigee.
Público
Las guías de solución de problemas están destinadas a los lectores con una comprensión sólida de Apigee y su arquitectura, así como comprender algunos conceptos básicos, como políticas y estadísticas.
Solo los usuarios de Apigee Hybrid pueden diagnosticar y resolver algunos problemas y estos pueden requerir conocimiento de componentes internos, como almacenes de datos de Cassandra y Postgres, procesadores de mensajes y routers.
Si usas Apigee, especificamos con claridad cuándo puedes seguir los pasos indicados para solucionar problemas y cuándo necesitas comunicarte con el equipo de Atención al cliente de Google Cloud para obtener ayuda.
Guías
En esta sección, se describen las guías actuales.
Para filtrar esta tabla, realiza una o más de las siguientes acciones: selecciona una categoría, selecciona un producto, escribe un término de búsqueda o haz clic en el encabezado de una columna para ordenar.
| Categoría | Descripción del problema o la guía | Mensaje de error | Guía aplicable para |
|---|---|---|---|
| Cassandra | Soluciona problemas de restablecimiento de Cassandra | Durante el restablecimiento de Cassandra en Apigee Hybrid, puedes encontrar errores en los registros de restablecimiento. | Solo Apigee hybrid |
| Presentación automática de problemas | No hay conectividad de red entre el plano de entorno de ejecución y el plano de control | Las solicitudes de administración de APIs de Apigee fallan:
|
Solo Apigee hybrid |
| Presentación automática de problemas | Falta el grupo de entornos del host virtual | Después de ejecutar kubectl -n apigee get apigeeissues, se muestra el error AIS_VIRTUALHOST_MISSING_ENVGROUP.
|
Solo Apigee hybrid |
| Presentación automática de problemas | Falta el selector de host virtual | Después de ejecutar kubectl -n apigee get apigeeissues, se muestra el error AIS_VIRTUALHOST_MISSING_SELECTOR.
|
Solo Apigee hybrid |
| Presentación automática de problemas | Discrepancia en el certificado de entrada | Después de ejecutar kubectl -n apigee get apigeeissues, se muestra el error AIS_INGRESS_CERT_MISMATCH.
|
Solo Apigee hybrid |
| Presentación automática de problemas | Vencimiento del certificado de entrada | Después de ejecutar kubectl -n apigee get apigeeissues, se muestra el error AIS_INGRESS_CERT_EXPIREY. |
Solo Apigee hybrid |
| Presentación automática de problemas | Vencimiento del certificado de la 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 |
| Presentación automática de problemas | El certificado de la AC de mTLS de entrada no es 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 | Error de replicación de datos de Cassandra |
Cuando se replican datos durante una expansión multirregional, el estado CassandraDataReplication puede mostrar un estado de error y la replicación de datos puede fallar.
|
Solo Apigee hybrid |
| Cassandra | Problemas de espacio de montón de Java de Cassandra |
Los problemas de montón de Cassandra pueden causar lentitud en la ejecución del proxy de Apigee Hybrid o incluso errores Datastore. A veces, los registros son un indicador anticipado, incluso antes de la aparición de los síntomas.
|
Solo Apigee Hybrid |
| Cassandra | Los pods de Cassandra que no se inician en la región secundaria |
Los pods de Cassandra no pueden iniciarse en una de las regiones de una configuración multirregional de Apigee Hybrid.
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, verás que uno o más Pods de Cassandra están atascados. En esta guía, se describe el diagnóstico y la resolución de los problemas con el almacén de datos de Cassandra.
|
Solo Apigee hybrid |
| Implementación | Las implementaciones de proxies de API fallan con una advertencia "Sin pods del entorno de ejecución activos" | La advertencia Sin Pods del entorno de ejecución activos se muestra en el diálogo Detalles junto al mensaje de error Problemas de implementación en ENVIRONMENT: REVISION_NUMBER en la página del proxy de API. | Solo Apigee hybrid |
| Ingressgateway | Llamadas a la API que 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 la API que fallan con errores de TLS |
curl: (35) LibreSSL SSL_connect: SSL_ERROR_SYSCALL in connection to example.apis.com:443 |
Solo Apigee Hybrid |
| Logging | Soluciona problemas con los registros de Apigee que faltan en Cloud Logging | No se conocen mensajes de error en esta situación. | Apigee y Apigee Hybrid |
| Administración/IU | Datos incoherentes o sin datos para entidades en la IU híbrida o las API de administración | No se conocen mensajes de error en esta situación. | Solo Apigee hybrid |
| Configuración de red | Accede a los problemas de enrutamiento con Apigee |
Los clientes externos no pueden acceder a Apigee ni conectarse a él de la manera deseada. Esto incluye las fallas de conectividad de red (errores de protocolo de enlace TLS) o las respuestas 4xx/5xx de Apigee.
|
Apigee y Apigee Hybrid |
| Configuración de red | Problemas de conectividad de Apigee con destinos de PSC descendente |
Un problema de conexión de red o un tiempo de espera de TCP entre Apigee y el servicio de destino se mostraría como una respuesta de error 503 y mostraría 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 | Expandir los recuentos de réplicas de Istio cuando se vacían los nodos | Cuando vacías los pods de Istio, es posible que algunos nodos no se vacíen porque tienen 1 réplica, cuando que se requieren 3 o más réplicas. Para evitar esto, debes establecer la cantidad mínima de réplicas para cada propiedad en al menos 3. | Solo Apigee hybrid |
| Otro | Guía de solución de problemas del procesador de mensajes |
Uno o más Pods del entorno de ejecución de Apigee no están en el estado Ready.
Cuando usas kubectl para describir un Pod de apigee-runtime con errores, verás el siguiente error:
Readiness probe failed: HTTP probe failed with statuscode: 500 |
Solo Apigee hybrid |
| Otro | Imprime información sobre la compilación |
La API buildinfo muestra información sobre la compilación actual para un componente del entorno de ejecución. Esta información puede ser útil si necesitas comunicarte con el equipo de asistencia:
|
Solo Apigee hybrid |
| Otro | StreamingPull tiene una tasa de errores del 100% |
Si ves en el panel de métricas que el método google.pubsub.vl.Subscriber.StreamingPull falla con errores del 100%, puedes ignorar el problema de forma segura. Se prevé que esto suceda.
|
Solo Apigee hybrid |
| Implementación | La instancia no informa el estado del grupo de entornos | Las implementaciones de las fallas de proxies de API con la instancia INSTANCE_NAME no informan el estado del error del grupo de entornos ENV_GROUP_NAME en la IU híbrida de Apigee. | Solo Apigee hybrid |
| Implementación | No se encontraron o vencieron las implementaciones de proxies de API con apigee-serving-cert |
Las implementaciones de proxy de API fallan con mensajes de error en los registros de apigee-watcher.
|
Solo Apigee hybrid |
| Ingressgateway | Expande las cantidades de réplicas de las propiedades de Istio para evitar problemas cuando se vacíen los nodos de Istio |
Cuando vacías los pods de Istio, es posible que algunos nodos no se vacíen porque tienen 1 réplica, cuando que se requieren 3 o más réplicas. Para evitar esto, debes establecer la cantidad mínima de réplicas para cada propiedad en al menos 3.
|
Solo Apigee hybrid |
| Configuración de red | Solución de problemas de espacio de direcciones IP libre | Durante el aprovisionamiento de Apigee, si seleccionas un rango de 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 de servicio no disponible del intercambio de tráfico entre VPC con TARGET_CONNECT_TIMEOUT | En este documento, se describe cómo diagnosticar y corregir errores “503 Servicio no disponible” con TARGET_CONNECT_TIMEOUT cuando se usa el intercambio de tráfico entre VPC. | Apigee |
| Configuración de red | 504 Tiempo de espera de la puerta de enlace: Objetivo de tiempo de espera de lectura | En este documento, se describe cómo diagnosticar y corregir errores "504 Tiempo de espera de la puerta de enlace" con un motivo TARGET_READ_TIMEOUT. | Apigee y Apigee Hybrid |
| Otro | Solución de problemas de Apigee Hybrid atascado en la creación o el lanzamiento del estado | En este documento, se describe cómo restablecer los componentes híbridos de Apigee cuando se atascan en un estado creating o releasing.
|
Solo Apigee hybrid |