Soporte

Esta página cubre el comando ajat support, cómo capturar logs de depuración, cómo contactar al equipo de soporte de Climakers y cómo enviar solicitudes de funcionalidades.

El comando support


ajat support [flags]

Genera un paquete de diagnóstico para compartir con el equipo de soporte.

El comando support recopila información del sistema, la configuración efectiva, comprobaciones diagnósticas, variables de entorno y salida reciente del log en un único archivo. Los nombres de usuario de Jira, los tokens API y otros valores tipo secreto presentes en la configuración y en las variables de entorno se anonimizan automáticamente, de modo que el paquete es seguro de compartir. El contenido del log se incluye tal cual, así que conviene revisarlo brevemente antes de compartirlo si tu configuración de logging puede capturar datos sensibles.

Flags

Flag	Short	Predeterminado	Descripción
`--output`	`-o`	stdout	Escribe el paquete en un archivo en lugar de stdout
`--log-file`	`-l`	desde config	Ruta de un archivo de log que se incluirá en el paquete
`--log-lines`		`50`	Número de líneas recientes del log que se incluirán
`--output-dir`		`—`	Directorio de salida para comprobar permisos de escritura

Contenido del paquete

El paquete de soporte incluye las siguientes secciones:

Sección	Contenido
System	Nombre de la app, versión, versión de Go, SO/arquitectura, commit y fecha de compilación
Configuration	Ruta del archivo de config, dominio y tipo de Jira, token API (anonimizado), reintentos HTTP y timeouts, nivel de log, formato de log, ruta del archivo de log
Diagnostics	Las mismas comprobaciones que `doctor`: archivo de configuración, credenciales de Jira, conectividad API, archivo de licencia, ID de máquina, versión
Environment	Solo variables de entorno `AJAT_*`, con tokens y secretos anonimizados. Si no hay ninguna definida, la sección lo indica explícitamente
Recent log	Las últimas N líneas del archivo de log seleccionado. Si no hay archivo de log configurado, la sección indica cómo habilitarlo

Los nombres de usuario de Jira, los tokens API, los IDs de licencia y los IDs de máquina se anonimizan automáticamente en el paquete. Solo se muestran los primeros y últimos caracteres, para que soporte pueda identificar una credencial sin ver su valor completo.

Ejemplos


# Imprimir el paquete por stdout
ajat support
 
# Guardar el paquete en un archivo
ajat support --output support-bundle.txt
 
# Incluir más contexto del log
ajat support --log-file ./ajat.log --log-lines 200

Captura primero los logs de depuración

Por defecto, ajat no escribe un archivo de log — los eventos de log estructurados se descartan. Para fallos que necesitan más contexto, vuelve a ejecutar el comando que falla con logging de depuración y un archivo de log primero, y luego incluye ese log en el paquete:


# 1. Reproducir el problema con logging de depuración y un archivo de log
ajat --debug --log-file ./ajat.log export --output-dir ./jira-automations-backup
 
# 2. Generar el paquete de soporte con ese log adjunto
ajat support --log-file ./ajat.log --output support-bundle.txt

Los valores especiales stdout y stderr para el archivo de log envían los logs a esos flujos en lugar de a un archivo. Usa --log-format json cuando necesites logs estructurados para una traza de revisión en entornos regulados.

El paquete ya incluye información del sistema, contexto de configuración, comprobaciones tipo doctor, variables de entorno con secretos anonimizados y líneas recientes del log. Normalmente es la forma más rápida de dar al soporte suficiente contexto sin un largo intercambio de correos.

Por qué los equipos usan el comando support

Recopilar todo el contexto diagnóstico en un solo paso al abrir un caso de soporte
Compartir detalles de configuración y entorno de forma segura sin exponer tokens API ni credenciales
Incluir salida de log en modo depuración junto con información del sistema y la configuración para una resolución más rápida

Orden de escalado

Cuando algo falla, sigue estos pasos en orden antes de escalar. Cada paso resuelve el problema o reúne el contexto que necesita el siguiente:

ajat doctor — valida la configuración, la licencia, las credenciales y el acceso básico a la API.
Troubleshooting — revisa los problemas habituales de licencia, autenticación, límite de tasa, informes y logging en el manual del producto antes de abrir un caso.
Logs de depuración — reproduce con ajat --debug --log-file ./ajat.log <command> para capturar logs estructurados del fallo.
Paquete de soporte — ejecuta ajat support --log-file ./ajat.log --output support-bundle.txt y adjúntalo cuando contactes con Climakers.

Esto mantiene juntos el diagnóstico, la reproducción y la recopilación de evidencia en lugar de enviar un reporte poco detallado que necesita varias rondas de aclaración.

Contactar con soporte

Para soporte técnico, reportes de errores o solicitudes de funcionalidades, escríbenos a support@climakers.com.

Nunca envíes secretos ni contenido sensible. No compartas tokens API, contraseñas, cookies de sesión, claves de licencia, contenido privado de reglas de automatización, JSON exportado, informes de inventario ni ningún material que no estés autorizado a divulgar. Anonimiza dominios, IDs, nombres de reglas, URLs de webhook, rutas de archivos, capturas de pantalla y argumentos de comandos cuando sea necesario.

Cuándo contactar con soporte

La instalación, activación o validación falla
doctor reporta un problema de configuración, máquina o conectividad
Un comando devuelve un error inesperado o se comporta de forma incorrecta
La salida es incompleta, malformada o inconsistente con la documentación
Necesitas ayuda para entender la forma más segura de ejecutar un flujo de mutación
Una licencia necesita ser movida, restablecida o revisada

Qué incluir en tu correo

El nombre del producto y la versión, por ejemplo ajat v1.0.0
Tu sistema operativo y arquitectura, por ejemplo macOS arm64 o Linux amd64
El comando exacto que ejecutaste, con valores sensibles eliminados
El mensaje de error completo o el comportamiento inesperado observado
Si el problema ocurre siempre o solo en un caso específico
La salida de doctor si es relevante y ya está anonimizada
El paquete de soporte generado cuando esté disponible
Cualquier cambio reciente que pueda importar, como una nueva máquina, nuevo token, cambio de proxy o nueva activación de licencia

Antes de escribir

Ejecuta ajat doctor para comprobar tu configuración.
Confirma la versión instalada con ajat version.
Reproduce el problema con el comando seguro más pequeño que puedas compartir, usando --debug --log-file ./ajat.log.
Genera un paquete de soporte con ajat support --log-file ./ajat.log --output support-bundle.txt.
Anonimiza secretos, URLs privadas y contenido confidencial.

Ejemplo de solicitud de soporte


Asunto: ajat v1.0.0 - la exportación se estanca con 429 repetidos en macOS arm64

Producto: ajat v1.0.0
Plataforma: macOS 15, arm64
Comando: ajat export --output-dir ./jira-automations-backup --workers 16
Problema observado: la exportación se pausa repetidamente por Retry-After y el rendimiento se estanca
Reproducible: sí, en este tenant
Salida anonimizada: <pegar error anonimizado aquí>
Cambios recientes: ninguno
Adjunto: support-bundle.txt (generado con ajat support --log-file ./ajat.log)

Solicitudes de funcionalidades

Usa la misma dirección support@climakers.com cuando quieras solicitar una nueva funcionalidad.

Cuándo enviar una solicitud

El conjunto actual de comandos no cubre un flujo de trabajo real que necesitas
Un flag o formato de salida existente bloquea automatización o trabajo de gobierno
Un workaround manual repetido debería convertirse en una funcionalidad compatible
Necesitas compatibilidad con otra plataforma, sistema o modelo operativo

Cómo solicitar una funcionalidad

Usa un asunto claro, por ejemplo Feature Request: ajat report export summary.
Indica el nombre del producto y la versión que usas actualmente.
Describe el flujo de trabajo o problema de gobierno, no solo el flag o la opción deseada.
Explica qué haces ahora como workaround y por qué es insuficiente.
Incluye un ejemplo anonimizado pequeño de la entrada, salida o flujo de comandos cuando sea útil.

Expectativas de respuesta

El equipo de soporte de Climakers revisa las solicitudes entrantes y responde lo antes posible. Pasos claros de reproducción, salida de comandos anonimizada y detalles precisos de producto/versión reducen el intercambio de mensajes y normalmente llevan a una respuesta más rápida.

Páginas relacionadas

Licencia para activación, validación y archivos de licencia vinculados a la máquina.
Preguntas y respuestas para preguntas comunes y soluciones rápidas.