Soporte

Esta página cubre el comando acs2md support, como contactar al equipo de soporte de Climakers y como enviar solicitudes de funcionalidades.

El comando support


acs2md support [flags]

Genera un paquete de diagnostico para compartir con el equipo de soporte.

El comando support recopila información del sistema, configuración, comprobaciones diagnosticas, variables de entorno y salida reciente del log en un unico archivo. Las credenciales presentes en la configuración y en las variables de entorno se anonimizan automáticamente. El contenido del log se incluye tal cual, asi que conviene revisarlo brevemente antes de compartirlo si tu configuración de logging puede capturar datos sensibles.

Flags

Flag	Short	Predeterminado	Descripcion
`--output`	`-o`	stdout	Escribe el paquete en un archivo en lugar de stdout
`--log-file`	`-l`	desde config	Ruta del archivo de log que se incluira en el paquete
`--log-lines`		`50`	Numero de lineas recientes del log que se incluiran

Contenido del paquete

El paquete de soporte incluye las siguientes secciones:

Seccion	Contenido
System	Nombre de la app, versión, versión de Go, SO/arquitectura, commit y fecha de compilacion
Configuration	Ruta del archivo de config, dominio y tipo de Confluence, 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 Confluence, conectividad API, archivo de licencia, ID de máquina, versión
Environment	Solo variables de entorno `ACS2MD_*`, con tokens y secretos anonimizados. Si no hay ninguna definida, la seccion lo indica explicitamente
Recent log	Las ultimas N lineas del archivo de log seleccionado. Si no hay archivo de log configurado, la seccion indica como habilitarlo

Ejemplo de salida

A continuacion se muestra la salida real de acs2md support, con valores sensibles anonimizados:


Support Bundle for acs2md
================================

Contact: support@climakers.com

--- System ---
App:                 acs2md
Versión:             v1.0.0
Go:                  go1.26.1
OS/Arch:             darwin/arm64
Git Commit:          4d17...ad42
Build Date:          2026-04-03T20:06:22Z

--- Configuration ---
Config File:         /Users/<user>/Library/Application Support/acs2md/config.yaml
Confluence Domain:   <tenant>.atlassian.net
Confluence Type:     cloud
API Token:           AT************************************************************3D
HTTP Max Retries:    3
HTTP Base Timeout:   10ms
HTTP Max Timeout:    100ms
Log Level:           debug
Log Format:          text
Log File:            (not set)

--- Diagnostics ---
  ✅  Configuration file       /Users/<user>/Library/Application Support/acs2md/config.yaml
  ✅  Confluence credentials   <tenant>.atlassian.net (user: <redacted>)
  ✅  Confluence API           connected (251ms)
  ✅  License file             loaded (LO*****5G)
  ✅  Machine ID               e2****25
  ✅  Versión                  acs2md v1.0.0 (darwin/arm64, built 2026-04-03T20:06:22Z)

--- Environment ---
(no ACS2MD_* environment variables set)

--- Recent Log (last 50 lines) ---
(no log file configured — re-run your command with --debug --log-file app.log)

================================

To get help, email support@climakers.com with subject:
  "acs2md support — <brief description of your issue>"
and include the output above in the email body.

Los tokens API, IDs de licencia, IDs de máquina y nombres de usuario se anonimizan automáticamente en la salida. Solo se muestran los primeros y ultimos caracteres para que soporte pueda identificar la credencial sin ver el valor completo.

Ejemplos


# Imprimir el paquete por stdout
acs2md support
 
# Guardar el paquete en un archivo
acs2md support --output bundle.txt
 
# Incluir mas contexto del log
acs2md support --log-file app.log --log-lines 200

Flujo recomendado

Reproduce primero el problema con logging en modo debug y despues genera el paquete:


# 1. Reproducir el problema con debug
acs2md space convert by-key MYSPACE --output-dir output --debug --log-file app.log
 
# 2. Generar el paquete de soporte
acs2md support --log-file app.log --output bundle.txt

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

Por que los equipos usan el comando support

Recopilar todo el contexto diagnostico 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 contraseñas
Incluir salida de log en modo debug junto con información del sistema y la configuración para una resolución mas rápida

Contactar con soporte

Para soporte tecnico, reportes de errores o solicitudes de funcionalidades, escribenos a support@climakers.com.

Nunca envies secretos ni contenido sensible. No compartas tokens API, contraseñas, cookies de sesion, claves de licencia, documentos privados de clientes, contenido confidencial exportado ni ningun material que no estes autorizado a divulgar. Anonimiza dominios, IDs, títulos de página, rutas de archivos, capturas de pantalla y argumentos de comandos cuando sea necesario.

Cuando contactar con soporte

La instalación, activacion o validacion 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 mas segura de ejecutar un flujo de trabajo
Una licencia necesita ser movida, restablecida o revisada

Que incluir en tu correo

El nombre del producto y la versión, por ejemplo acs2md 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 especifico
La salida de doctor si es relevante y ya esta anonimizada
El paquete de soporte generado cuando este disponible
Cualquier cambio reciente que pueda importar, como una nueva máquina, nuevo token, cambio de proxy o nueva activacion de licencia

Antes de escribir

Ejecuta acs2md doctor para comprobar tu configuración.
Confirma la versión instalada con acs2md --version.
Genera un paquete de soporte con acs2md support.
Reproduce el problema con el comando seguro mas pequeno que puedas compartir.
Anonimiza secretos, URLs privadas y contenido confidencial.

Ejemplo de solicitud de soporte


Asunto: acs2md v1.0.0 - space convert se detiene en macOS arm64

Producto: acs2md v1.0.0
Plataforma: macOS 15, arm64
Comando: acs2md space convert by-key MYSPACE --output-dir output
Problema observado: la conversion se detiene en la página 47 de 200 sin progreso
Reproducible: si, siempre para este espacio
Salida anonimizada: <pegar error anonimizado aqui>
Cambios recientes: ninguno
Adjunto: bundle.txt (generado con acs2md support)

Solicitudes de funcionalidades

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

Cuando 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 automatizacion o trabajo de migración
Un workaround manual repetido deberia convertirse en una funcionalidad compatible
Necesitas compatibilidad con otra plataforma, sistema o modelo operativo

Como solicitar una funcionalidad

Usa un asunto claro, por ejemplo Feature Request: acs2md export summary report.
Indica el nombre del producto y la versión que usas actualmente.
Describe el flujo de trabajo o problema de negocio, no solo el flag o la opción deseada.
Explica que haces ahora como workaround y por que es insuficiente.
Incluye un ejemplo anonimizado pequeno 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 reproduccion, salida de comandos anonimizada y detalles precisos de producto/versión reducen el intercambio de mensajes y normalmente llevan a una respuesta mas rápida.