Primera respuesta ante un error:
Cuando te enfrentas a un error, ya sea en STELA UI o durante una ejecución, hay algunas acciones importantes que debes considerar inicialmente. La primera es confirmar si el error fue un incidente aislado.
Si el error ocurre en STELA UI, la recomendación es salir de la aplicación, volver a ingresar y repetir el proceso. Este paso no solo ayuda a confirmar si el error persiste, sino que también proporciona la oportunidad de grabar evidencia del problema, por ejemplo en formato video. Es crucial estar seguro de que el error no fue un evento único antes de informarlo para evitar reportar un falso negativo.
En el caso de una ejecución, la sugerencia es realizar nuevamente la descarga y volver a intentar la ejecución. Esto permite verificar si el error se reproduce y proporciona la oportunidad de corregir cualquier problema temporal. Por lo tanto, al encontrarte con un error, la primera respuesta consiste en repetir la acción para confirmar la consistencia del problema y evitar posibles informes incorrectos.
¿Qué podemos hacer si persiste el problema?
Si el problema aún persiste es necesario que se ponga en contacto con el equipo de soporte enviando un correo electrónico a la siguiente dirección: soporte@stela.ai.
Para facilitar una solución rápida y eficaz, le pedimos que proporcione toda la información detallada que se indica a continuación. Esto agilizará la resolución del problema y evitará la necesidad de solicitar cada acción detallada en el artículo posterior.
- Grabar video de evidencia:
Es crucial proporcionar contexto al informar sobre problemas o errores, especialmente cuando se busca ayuda. Enviar mensajes del tipo «no me funciona» con solo una captura de pantalla puede generar confusiones y, probablemente, resultar en la necesidad de solicitar más información.
Al brindar desde el principio una explicación clara de lo que estás intentando hacer, indicar dónde ocurrió el error y, si es posible, acompañarlo con un video explicativo, se establece un contexto valioso. Esto no solo facilita la comprensión del problema, sino que también agiliza el proceso de respuesta al evitar intercambios innecesarios de información.
Una forma de grabar rápidamente la pantalla en Windows es utilizando la combinación de teclas Win + Alt + R
2. Identificar la causa del problema:
Es crucial buscar relaciones con las interacciones que están generando el problema. Si, por ejemplo, no es posible crear un objeto, es útil hacerse preguntas como las siguientes:
- ¿El problema afecta a cualquier objeto o solo a este específico que estoy intentando crear con cierta información?
- ¿Se presenta en todos los proyectos o únicamente en este en el que estoy trabajando?
- ¿El inconveniente ocurre tanto al crear desde la automatización como desde el dashboard, o es exclusivo de una de estas opciones?
Estas mismas preguntas deben aplicarse a cualquier problema que surja. Si hay dificultades para iniciar sesión, es importante preguntarse si el problema es individual o afecta a todos los usuarios. En el caso de descargas que no funcionan, es relevante determinar si el problema se extiende a todas las descargas o si es específico de alguna en particular.
Esta línea de cuestionamientos proporciona información adicional al problema y contribuye a reducir las posibles causas, agilizando así el proceso de análisis. En suma, comprender el alcance y la variabilidad del problema es fundamental para una identificación eficiente de la causa subyacente.
3. Logs de STELA:
STELA genera registros (logs) en todos sus servidores, y por defecto, estos se almacenan en las siguientes rutas:
- Windows: C:\STELA_UI\logs
- Linux: /opt/stela/logs
Los registros se organizan por fecha, con una carpeta dedicada a cada día.
Es fundamental obtener los registros correspondientes al día en que ocurrió el error para examinar si contienen información relevante que pueda indicar la causa del problema. Los logs de STELA ofrecen una cantidad significativa de información técnica y son una fuente valiosa para comprender los eventos que llevaron a cualquier incidente.
Cuando se enfrenta a un problema dentro de STELA UI, la obtención de los logs suele ser una contribución valiosa al informar sobre el problema. Proporcionar estos registros facilita a los equipos de soporte y desarrollo tener una visión detallada de los eventos y ayuda en el proceso de identificación y resolución de cualquier problema técnico.
4. Reproducir errores:
Para reproducir los errores de manera efectiva, el equipo de soporte debe establecer conexión con la aplicación que están automatizando, donde se presentan los problemas. En situaciones en las que surgen inconvenientes durante las ejecuciones, resulta fundamental para el equipo de soporte poder replicar los errores en sus propios sistemas. Esta práctica agiliza el proceso de identificación y resolución de problemas, permitiendo una respuesta más eficiente a los desafíos encontrados.
Para llevar a cabo esta reproducción, es necesario verificar si las ejecuciones pueden ejecutarse en los sistemas del equipo de soporte. En caso de necesitar permisos o acceso especial, es importante gestionarlos para asegurarse de contar con la autorización necesaria. Además, es fundamental tener acceso al archivo de la ejecución (ZIP) para poder ejecutarlo y observar el comportamiento, lo que permite una evaluación precisa del problema.
La capacidad de reproducir errores en los sistemas del equipo es crucial para comprender y abordar eficientemente las consultas de los usuarios. Asegurarse de tener los permisos adecuados y acceso a los archivos de ejecución contribuye a una resolución rápida y efectiva de los problemas.
A nivel de STELA UI, es beneficioso buscar reproducir cualquier error reportado, ya sea en nuestros propios entornos o en los de los clientes. Esto se vuelve especialmente valioso en entornos de prueba, ya que facilita tanto el proceso de corrección como la validación de la solución implementada.
Por ejemplo, si un usuario informa que no puede crear un objeto, intentar reproducir el problema en diversos entornos, especialmente en entornos de prueba, permite confirmar si la funcionalidad presenta algún problema no detectado previamente. Es importante tener en cuenta que un problema que persiste en una versión podría ya estar resuelto en nuestros ambientes, en una versión más reciente. Reproducir y validar el error en nuestros sistemas nos brinda la confirmación necesaria para asegurarnos de que la corrección ha sido efectiva.
5. Errores a nivel de ejecución:
Si se detecta un comportamiento inesperado durante la ejecución, especialmente si se sospecha que puede deberse a un error, se recomienda activar el Modo de Depuración y capturar la salida completa de la consola. Es crucial enviar esa información, ya que puede contener datos relevantes que faciliten el diagnóstico del error, especialmente si el comando está generando mensajes de error.
Para configurar el debug mode puedes ingresar al siguiente enlace que indicará cómo hacerlo: https://www.stela.ai/wiki/configuracion-de-ejecuciones/