Paquete de diagnóstico
Genera un zip en un clic con inspect, eventos, logs y estadísticas de un contenedor o stack Compose.
El paquete de diagnóstico mete en un solo .zip inspect, eventos, logs y estadísticas de un contenedor o stack Compose. Compártelo con alguien, adjúntalo a un issue o guárdalo como referencia.
Qué contiene el paquete
| Archivo | Contenido |
|---|---|
manifest.json | Marca de tiempo de generación, versión de Dockerman, tipo de host, inventario de archivos, número de valores ocultados y cualquier error encontrado |
system.json | Versión de Docker e información del sistema. Se elimina el usuario del registro, pero no hay una limpieza general de secretos. |
events.json | Eventos de Docker filtrados por la ventana de tiempo seleccionada y los contenedores de destino |
inspect.json | Datos de inspect de contenedor, imagen, red y volumen. Por defecto solo se ocultan los valores cuyo nombre coincide con la lista Env de la configuración del contenedor. Incluye State.Health. |
logs.txt | Logs de contenedor con marcas de tiempo dentro de la ventana seleccionada |
stats.json | Muestras de uso de recursos del almacén de series temporales (muestras en crudo de 5 segundos si hay, si no agregados de 5 minutos en ventanas más largas, o un snapshot actual si no hay series temporales) |
Si el destino es un stack Compose, el paquete incluye un subdirectorio por contenedor del stack.
Generar un paquete
Abre el menú de acciones del contenedor y selecciona Paquete de diagnóstico.
Abre el menú overflow del stack Compose y selecciona Paquete de diagnóstico.
Abre Spotlight y busca "paquete de diagnóstico", luego selecciona el destino.
Elige la ventana de tiempo
Elige cuánto historial incluir de logs, eventos y estadísticas. Ventanas más largas producen paquetes más grandes.
Revisa la configuración de redacción
Las variables de entorno que coinciden con TOKEN, PASSWORD, SECRET, KEY, CREDENTIAL o AUTH (sin distinguir mayúsculas de minúsculas) se reemplazan por ***REDACTED*** por defecto. Desactívalo si necesitas los valores en claro.
Elige una ubicación de guardado
Elige dónde guardar el .zip en el sistema de archivos local.
Espera la generación
Un indicador muestra el estado del empaquetado. Un solo contenedor suele tardar menos de 10 segundos.
Abre el resultado
Al terminar, haz clic en Mostrar en Finder (macOS) o el equivalente para ir al archivo guardado.
Redacción de datos sensibles
Por defecto, los valores de variables de entorno que coinciden con este patrón se reemplazan por ***REDACTED***:
(?i)(TOKEN|PASSWORD|SECRET|KEY|CREDENTIAL|AUTH)Esto se aplica a los inspect.json del paquete. Puedes desactivar la redacción en el diálogo si necesitas los valores en claro para depurar por tu cuenta.
La redacción es limitada. El entorno de la imagen, las etiquetas, los comandos, las rutas de montaje, el inspect de redes y volúmenes y los logs todavía pueden contener secretos o rutas privadas. Revisa todos los archivos antes de compartir el paquete.
Consejos
- Adjunta un paquete cuando pidas ayuda en issues de GitHub o foros. El zip estructurado ayuda a quien revise la configuración.
- Las estadísticas del paquete dependen de que el programador de tareas en segundo plano haya recogido series temporales. Si lo habilitaste hace poco, la sección de estadísticas puede ser solo un snapshot actual.
- En stacks Compose con muchos contenedores el paquete crece. Acorta la ventana de tiempo para mantener un tamaño razonable.