{"meta":{"title":"Los registros no son lo suficientemente detallados","intro":"Aumente el detalle de los registros y genere artefactos de depuración cuando los registros carezcan de detalles de diagnóstico.","product":"Seguridad y calidad del código","breadcrumbs":[{"href":"/es/code-security","title":"Seguridad y calidad del código"},{"href":"/es/code-security/reference","title":"Referencia"},{"href":"/es/code-security/reference/code-scanning","title":"Análisis de código"},{"href":"/es/code-security/reference/code-scanning/troubleshoot-analysis-errors","title":"Solución de errores de análisis"},{"href":"/es/code-security/reference/code-scanning/troubleshoot-analysis-errors/logs-not-detailed-enough","title":"Registros no suficientemente detallados"}],"documentType":"article"},"body":"# Los registros no son lo suficientemente detallados\n\nAumente el detalle de los registros y genere artefactos de depuración cuando los registros carezcan de detalles de diagnóstico.\n\nSi los registros no son lo suficientemente detallados para solucionar un problema, hay varios pasos que puede seguir para obtener información adicional y hacer que los registros sean más útiles.\n\n## Habilitar el registro de depuración del paso\n\nEl registro de depuración del paso aumenta el nivel de detalle de los registros de un trabajo durante y después de la ejecución.\n\nPara habilitar el registro de depuración del paso:\n\n1. En el repositorio que contiene el flujo de trabajo, establezca el siguiente secreto o variable: `ACTIONS_STEP_DEBUG` en `true`. Si se establecen tanto el secreto como la variable, el valor del secreto tiene prioridad sobre la variable.\n2. Vuelva a ejecutar el flujo de trabajo o desencadene una nueva ejecución.\n\nDespués de establecer el secreto o la variable, se muestran más eventos de depuración en los registros de pasos. Consulta [Uso de registros de flujo de trabajo](/es/actions/how-tos/monitor-workflows/use-workflow-run-logs#viewing-logs-to-diagnose-failures).\n\nTambién puede usar el contexto `runner.debug` para ejecutar los pasos de manera condicional solo cuando el registro de depuración está habilitado. Consulta [Contextos de referencia](/es/actions/reference/workflows-and-actions/contexts#runner-context).\n\n## Creación de artefactos de depuración de CodeQL\n\n> \\[!WARNING]\n> Los artefactos de depuración de CodeQL contienen una copia del código fuente que analiza CodeQL, por lo que se recomienda compartir estos paquetes solo con personas autorizadas para acceder a ese código fuente.\n\nPuede obtener artefactos para ayudarle a depurar CodeQL.\nLos artefactos de depuración se cargarán en la ejecución de flujo como artefactos con nombres que empiezan con `debug-artifacts`. Si CodeQL analiza varios idiomas simultáneamente como parte de la ejecución del flujo de trabajo, habrá uno de estos artefactos para cada idioma. Los datos contienen los registros, CodeQL las CodeQL bases de datos, los archivos de código fuente extraídos y los archivos SARIF generados por el flujo de trabajo. Para obtener más información sobre cómo descargar artefactos de CodeQL, consulte [Descargar los artefactos del flujo de trabajo](/es/actions/how-tos/manage-workflow-runs/download-workflow-artifacts).\n\nEstos artefactos te ayudarán a depurar problemas con CodeQLcode scanning. Si se comunica con Soporte de GitHub, es posible que soliciten estos datos.\n\n### Creación de artefactos de depuración de CodeQL para la configuración predeterminada de CodeQL\n\nPuede crear artefactos de depuración de CodeQL habilitando el registro de depuración de pasos (consulte [Habilitación del registro de depuración de pasos](#enabling-step-debug-logging)) y desencadenando un nuevo análisis de CodeQL, por ejemplo, insertando una nueva confirmación en una rama de solicitud de incorporación de cambios.\n\nSi ha concedido CodeQL acceso a registros privados, habrá artefactos adicionales cuyos nombres empiecen por `proxy-log-file` estarán disponibles. Contienen registros del proxy de autenticación que se usa de forma predeterminada para CodeQL autenticar solicitudes a registros privados y se pueden usar para solucionar problemas de configuraciones del registro privado. Consulta [Conceder acceso a las características de seguridad a registros privados](/es/code-security/how-tos/secure-at-scale/configure-organization-security/manage-usage-and-access/giving-org-access-private-registries) para obtener más información.\n\n### Creación de artefactos de depuración de CodeQL para una configuración avanzada de CodeQL\n\nLos artefactos de depuración para la configuración avanzada de CodeQL se pueden obtener de varias formas.\n\n#### Volver a ejecutar trabajos con el registro de depuración habilitado\n\nLa forma más sencilla de crear artefactos de depuración para la configuración avanzada de CodeQL es volver a ejecutar trabajos con el registro de depuración activado. Para obtener más información sobre cómo volver a ejecutar GitHub Actions flujos de trabajo y trabajos, consulte [Volver a ejecutar flujos de trabajo y tareas](/es/actions/how-tos/manage-workflow-runs/re-run-workflows-and-jobs).\n\nAsegúrate de seleccionar **Habilitar registro de depuración**. Esta opción habilita el registro de diagnóstico del ejecutor y el registro de depuración de pasos para la ejecución. A continuación, podrá descargar artefactos de depuración de CodeQL para investigar más a fondo. No es necesario modificar el archivo de flujo de trabajo al crear artefactos de depuración de CodeQL al volver a ejecutar trabajos.\n\n#### Uso de una marca de flujo de trabajo\n\nPuede crear artefactos de depuración de CodeQL usando una opción en su flujo de trabajo. Para ello, debe modificar el `init` paso del Flujo de trabajo de análisis de CodeQL archivo y establecer `debug: true`.\n\n```yaml\n- name: Initialize CodeQL\n  uses: github/codeql-action/init@v4\n  with:\n    debug: true\n```\n\n#### Uso del registro de depuración de pasos de GitHub Actions\n\nSi habilita el registro de depuración de pasos de GitHub Actions, CodeQL también generará artefactos de depuración y los cargará como parte de la ejecución del flujo de trabajo. Para obtener instrucciones, consulte [Habilitación del registro de depuración de pasos](#enabling-step-debug-logging)."}