Xray Audit
Un módulo completo de auditoría de sitios que genera informes detallados sobre varios aspectos de una instalación de Drupal, incluyendo contenido, configuración, base de datos, usuarios y módulos.
xray_audit
Instalar
composer require 'drupal/xray_audit:^2.0'
composer require 'drupal/xray_audit:^1.6'
Overview
Xray Audit es un potente módulo de auditoría e informes diseñado para administradores y desarrolladores de sitios Drupal. Proporciona un panel centralizado para analizar y comprender varios aspectos de una instalación de Drupal a través de categorías de informes organizadas.
El módulo utiliza una arquitectura basada en plugins con dos tipos principales de plugins: XrayAuditGroupPlugin para organizar categorías de informes y XrayAuditTaskPlugin para generar informes específicos. Esta arquitectura hace que el módulo sea extensible, permitiendo a los desarrolladores crear informes personalizados implementando nuevos plugins.
Los informes están organizados en grupos lógicos que cubren arquitectura del modelo de contenido, métricas de contenido, configuraciones de visualización, control de acceso, estructura del sitio (views y menús), paquetes instalados (módulos y themes), información de base de datos, layouts de bloques y webforms. Cada informe admite descarga en CSV para análisis externo e incluye caché para mejorar el rendimiento.
El submódulo opcional Xray Audit Insight se integra con el Informe de Estado de Drupal para mostrar advertencias y recomendaciones basadas en los datos de auditoría, como views sin caché o conteos excesivos de revisiones.
Features
- Panel de informes completo con categorías organizadas para modelo de contenido, métricas de contenido, configuraciones de visualización, control de acceso, estructura del sitio, paquetes, base de datos, layout y formularios
- Arquitectura basada en plugins que permite extensión fácil con informes personalizados
- Soporte de descarga CSV para todos los informes permitiendo análisis de datos externo
- Comandos Drush para informes basados en CLI (node_count, paragraph_count, usage_place)
- Sistema de caché para mejorar el rendimiento de generación de informes
- Informes de arquitectura de entidades mostrando content types, bundles y configuraciones de campos
- Informes de métricas de contenido con conteos por tipo, estado, idioma y períodos de tiempo
- Análisis de Views incluyendo configuración de caché, configuraciones de acceso y verificaciones de accesibilidad para usuarios anónimos
- Análisis de arquitectura de menús y navegación con visualización jerárquica
- Informes de estado de módulos y themes incluyendo información de versiones y actualizaciones recomendadas
- Análisis de tamaño de tablas de base de datos con umbrales de tamaño configurables
- Informes de configuración de layout de bloques con condiciones de visibilidad
- Análisis de usuarios y roles incluyendo conteos de usuarios por rol, estado y período de actividad
- Informes de configuración de modos de visualización para nodes, paragraphs, media, taxonomy y blocks
- Análisis de uso de estilos de imagen en modos de visualización, imágenes responsive y CKEditor
- Monitoreo de recursos externos (oEmbed) para entidades media
- Informes de configuración de Webform (cuando el módulo Webform está instalado)
- Soporte de procesamiento por lotes para operaciones con grandes volúmenes de datos
- Submódulo Insights para integración con Informe de Estado con advertencias configurables
Use Cases
Auditoría del Sitio Antes de Migración
Antes de migrar un sitio Drupal o realizar actualizaciones importantes, use Xray Audit para generar informes completos sobre content types, módulos y configuraciones. Exporte todos los informes como archivos CSV para documentación y propósitos de planificación.
Optimización de Rendimiento
Use el informe de Views para identificar views sin caché configurado, y el informe de Base de Datos para encontrar tablas sobredimensionadas. El submódulo Insight marcará automáticamente estos problemas en el Informe de Estado.
Inventario de Contenido
Genere informes detallados de métricas de contenido para entender la distribución de contenido a través de tipos, idiomas y períodos de tiempo. Útil para iniciativas de gobernanza y limpieza de contenido.
Revisión de Seguridad
Analice roles de usuario y permisos, identifique views de admin accesibles para usuarios anónimos, y revise condiciones de visibilidad de bloques para asegurar un control de acceso apropiado.
Limpieza de Módulos
Use el informe de Módulos para identificar módulos instalados pero no utilizados, y el módulo Insight los marcará en el Informe de Estado para consideración de limpieza.
Auditoría de Estilos de Imagen
Analice el uso de estilos de imagen en modos de visualización, configuraciones de imágenes responsive y ajustes de CKEditor para identificar estilos de imagen no utilizados que pueden eliminarse o consolidar estilos duplicados.
Generación de Documentación
Exporte todos los informes como archivos CSV para crear documentación de la configuración del sitio, útil para entregas a clientes o incorporación de equipos.
Tips
- Use la función 'Descargar Todos los Informes como ZIP' en el panel principal para exportar rápidamente todos los informes disponibles para análisis externo o documentación
- Configure los umbrales de revisiones en la configuración para que coincidan con el flujo de trabajo de gestión de contenido de su sitio - algunos sitios legítimamente tienen muchas revisiones
- El informe de Views resalta en rojo las views de admin accesibles para usuarios anónimos - revíselas cuidadosamente por posibles problemas de seguridad
- Exporte informes de módulos antes de actualizaciones importantes para tener un registro del estado previo a la actualización
- Use el submódulo Insight durante el mantenimiento regular del sitio para detectar problemas potenciales temprano
Technical Details
Admin Pages 3
/admin/reports/xray-audit
Panel principal que muestra todas las categorías de informes disponibles. Cada categoría enlaza a un grupo de informes relacionados que cubren diferentes aspectos de la instalación de Drupal.
/admin/config/development/xray_audit/settings
Página de configuración para establecer umbrales utilizados en informes e insights.
/admin/config/xray_audit_insight/settings
Configuración para el submódulo Insight, permitiendo personalización de qué insights aparecen en el Informe de Estado de Drupal.
Permisos 2
Drush Commands 3
drush xray_audit:node_count
Cuenta los nodes que están siendo utilizados (estado publicado)
drush xray_audit:paragraph_count
Cuenta los bundles de paragraph que están en uso a través del sitio
drush xray_audit:usage_place
Lista los nodes donde los bundles de entidad (node o paragraph) están siendo utilizados
Troubleshooting 4
Asegúrese de que las dependencias requeridas para informes específicos estén habilitadas (ej. módulo Paragraphs para informes de paragraph, Webform para informes de webform). Verifique que tiene los permisos apropiados para ver los datos.
Asegúrese de que su servidor permita descargas de archivos y que el directorio temporal sea escribible. Verifique los límites de memoria de PHP si genera informes grandes.
Verifique que el submódulo Xray Audit Insight esté habilitado y revise la configuración de Insight para asegurar que el insight específico no esté deshabilitado.
Limpie el caché de Xray Audit limpiando todos los cachés de Drupal o esperando la expiración del caché. Los datos del informe se almacenan en caché para rendimiento.
Security Notes 3
- Los permisos 'xray_audit access' y 'xray_audit administer configuration' están marcados como restringidos y solo deben otorgarse a administradores de confianza
- Los informes pueden exponer información sensible sobre la configuración del sitio, conteos de usuarios y estructura de la base de datos
- El módulo analiza el acceso de usuarios anónimos a views lo cual puede ayudar a identificar posibles problemas de seguridad