Entender y resolver errores recibidos de WebHCat en HDInsight
Obtener información acerca de los errores recibidos al utilizar WebHCat con HDInsight y cómo resolverlos. Las herramientas de cliente como Azure PowerShell y Data Lake Tools para Visual Studio usan WebHCat internamente.
¿Qué es WebHCat?
WebHCat es una API de REST para HCatalog, una tabla y una capa de administración de almacenamiento para Apache Hadoop. WebHCat está habilitado de forma predeterminada en los clústeres de HDInsight y se usa en varias herramientas para enviar trabajos, obtener el estado del trabajo, etc., sin iniciar sesión en el clúster.
Modificación de la configuración
Algunos de los errores que se muestran en este documento se producen porque se ha superado un máximo configurado. Cuando el paso de resolución mencione que puede cambiar un valor, use Apache Ambari (web o API de REST) para modificar el valor. Para más información, consulte Administración de HDInsight mediante Apache Ambari
Configuración predeterminada
Si se superan los siguientes valores predeterminados, puede degradar el rendimiento de WebHCat o provocar errores:
| Configuración | Qué hace | Valor predeterminado |
|---|---|---|
| [yarn.scheduler.capacity.maximum-applications][maximum-applications] | El número máximo de trabajos que pueden estar activos de manera simultánea (pendientes o en ejecución) | 10 000 |
templeton.exec.max-procs |
El número máximo de solicitudes que se pueden atender de manera simultánea | 20 |
| [mapreduce.jobhistory.max-age-ms][max-age-ms] | El número de días que se conservará el historial de trabajos | siete días |
Demasiadas solicitudes
Código de estado HTTP: 429
| Causa | Solución |
|---|---|
| Ha superado el número máximo de solicitudes simultáneas atendidas por WebHCat por minuto (el valor predeterminado es 20) | Reduzca la carga de trabajo para asegurarse de que no envía más del número máximo de solicitudes simultáneas o aumenta el límite de solicitudes simultáneas al modificar templeton.exec.max-procs. Consulte Modificación de la configuración para más información. |
Servidor no disponible
Código de estado HTTP: 503
| Causa | Solución |
|---|---|
| Este código de estado suele producirse durante la conmutación por error entre el nodo principal primario y secundario para el clúster. | Espere dos minutos y vuelva a intentar la operación. |
Contenido de solicitud incorrecta: no se encontró el trabajo
Código de estado HTTP: 400
| Causa | Solución |
|---|---|
| Los detalles del trabajo se han limpiado por el limpiador del historial de trabajos | El período de retención predeterminado para el historial de trabajos es de siete días. El período de retención predeterminado puede cambiarse modificando mapreduce.jobhistory.max-age-ms. Consulte Modificación de la configuración para más información. |
| Trabajo eliminado debido a una conmutación por error | Vuelva a intentar el envío de trabajos durante un tiempo máximo de dos minutos |
| Se usó un identificador de trabajo no válido | Compruebe si el identificador de trabajo es correcto |
Puerta de enlace incorrecta
Código de estado HTTP: 502
| Causa | Solución |
|---|---|
| La recolección de elementos no utilizados internos se está produciendo en el proceso de WebHCat | Espere a que termine la recolección de elementos no utilizados o reinicie el servicio de WebHCat |
| Tiempo de espera de una respuesta desde el servicio de Resource Manager. Este error se puede producir cuando el número de aplicaciones activas alcanza el máximo configurado (el valor predeterminado es 10.000) | Espere a que finalice los trabajos actualmente en ejecución o aumente el límite de trabajos simultáneos modificando yarn.scheduler.capacity.maximum-applications. Consulte Modificación de la configuración para más información. |
Al intentar recuperar todos los trabajos a través de la llamada GET /jobs mientras Fields está establecido en * |
No recupere todos los detalles del trabajo. En su lugar, use jobid para recuperar detalles de trabajos solo mayores que un id. de trabajo determinado. O bien, no use Fields |
| El servicio de WebHCat está inactivo durante la conmutación por error del nodo principal | Espere dos minutos y vuelva a intentar la operación |
| Hay más de 500 trabajos pendientes enviados a través de WebHCat | Espere hasta que hayan finalizado los trabajos pendientes actualmente antes de enviar más trabajos |
Pasos siguientes
Si su problema no aparece o es incapaz de resolverlo, visite uno de nuestros canales para obtener ayuda adicional:
Obtenga respuestas de expertos de Azure mediante el soporte técnico de la comunidad de Azure.
Póngase en contacto con @AzureSupport, la cuenta oficial de Microsoft Azure para mejorar la experiencia del cliente. Esta cuenta pone en contacto a la comunidad de Azure con los recursos adecuados: respuestas, soporte técnico y expertos.
Si necesita más ayuda, puede enviar una solicitud de soporte técnico desde Azure Portal. Seleccione Soporte técnico en la barra de menús o abra la central Ayuda + soporte técnico. Para obtener información más detallada, revise Creación de una solicitud de soporte técnico de Azure. La suscripción a Microsoft Azure incluye acceso al soporte técnico para facturación y administración de suscripciones. El soporte técnico se proporciona a través de uno de los planes de soporte técnico de Azure.