Guía

Guide

ReportesReports

El Gestor de reportes convierte los datos de tu flota en documentos presentables —inventario, parches, alertas, antivirus y más—. Los reportes vienen listos de fábrica: los generas, los descargas en PDF o HTML, los programas y los envías por correo. ¿Necesitas uno a medida? Lo pides al área de Soporte.

The report manager turns your fleet data into presentable documents —inventory, patches, alerts, antivirus, and more—. Reports come ready out of the box: you generate them, download them as PDF or HTML, schedule them, and email them. Need a custom one? Request it from Support.

Cómo funciona la reportería, por dentroHow reporting works, under the hood

El dato nace en el agente de cada equipo: sus chequeos, actualizaciones de Windows, inventario de software y datos del sistema viajan al servidor por dos canales —el check-in por NATS (el servicio natsapi escribe el estado del equipo) y los envíos HTTP de apiv3— y se recolectan de toda la flota en la base de datos PostgreSQL observerrmm. Cuando pides un reporte desde la Consola (frontend), la API Django invoca el motor de reportería (ee.reporting): consulta esos datos con el ORM (solo los modelos permitidos), arma la plantilla con Jinja + Markdown y produce la salida —HTML, o PDF con WeasyPrint y gráficos rendidos por Kaleido—. Para programar, Celery Beat dispara cada minuto al worker, que genera el reporte, guarda el historial y, si corresponde, lo envía por correo vía SMTP a los destinatarios.

The data originates in each machine's agent: its checks, Windows updates, software inventory, and system data travel to the server over two channels —the NATS check-in (the natsapi service writes the machine's state) and apiv3 HTTP posts— and are collected across the whole fleet into the PostgreSQL observerrmm database. When you request a report from the Console (frontend), the Django API invokes the reporting engine (ee.reporting): it queries that data through the ORM (only the allowed models), assembles the template with Jinja + Markdown, and produces the output —HTML, or PDF via WeasyPrint with charts rendered by Kaleido—. For scheduling, Celery Beat triggers the worker every minute, which generates the report, saves the history and, when configured, emails it over SMTP to the recipients.

Lo que cubre esta guía, en orden:

What this guide covers, in order:

1. Generar un reporte — abrir o descargar cualquier plantilla de fábrica en PDF o HTML.
2. Qué reportes vienen de fábrica — el catálogo curado, agrupado por tema.
3. Programar y enviar por correo — automatizar la generación y el envío, y el historial.
4. Reportes personalizados — cómo solicitarlos a Soporte.

1. Generate a report — open or download any factory template as PDF or HTML.
2. Which reports ship ready — the curated catalog, grouped by topic.
3. Schedule and email — automate generation and delivery, and the history.
4. Custom reports — how to request them from Support.

1. Generar un reporte1. Generate a report

No necesitas diseñar nada. Observer trae un conjunto de plantillas curadas listas para usar: eliges una, indicas sobre qué equipos aplicarla y obtienes un PDF (o HTML) con datos reales.

You don't need to design anything. Observer ships a set of ready-to-use curated templates: you pick one, tell it which machines to cover, and get a PDF (or HTML) with real data.

Desde el Gestor de reportesFrom the report manager

1. Abre el menú Reportes → Gestor de reportes.
2. En la lista, cada fila muestra el Nombre, el Tipo de plantilla y sus Dependencias (qué necesita para ejecutarse).
3. Haz clic con el botón derecho sobre la plantilla que quieras y elige Abrir reporte PDF / Abrir reporte HTML (lo ves en el navegador) o Descargar reporte PDF / Descargar reporte HTML (lo guardas en tu equipo). Un doble clic sobre la fila también abre el reporte.
4. Si la plantilla pide dependencias, aparece el diálogo «Seleccionar dependencias del reporte»: elige el Cliente, Sitio o Agente correspondiente y pulsa Enviar.
5. El reporte se genera con los datos reales de tu flota y se abre o se descarga.

1. Open the Reports → Report manager menu.
2. In the list, each row shows the Name, the Template type, and its Dependencies (what it needs to run).
3. Right-click the template you want and choose Open report PDF / Open report HTML (view it in the browser) or Download report PDF / Download report HTML (save it to your machine). Double-clicking the row also opens the report.
4. If the template asks for dependencies, the «Select report dependencies» dialog appears: pick the matching Client, Site, or Agent and click Submit.
5. The report is generated with your fleet's real data and opens or downloads.

Entender la columna «Dependencias»Understanding the «Dependencies» column

La columna Dependencias te dice qué debes indicar antes de ejecutar una plantilla:

The Dependencies column tells you what you must provide before running a template:

• cliente, sitio o agente — la plantilla se acota a ese cliente, sitio o equipo; te lo pedirá al ejecutar.
• Sin dependencias — la plantilla corre sobre toda la flota y se ejecuta de inmediato, sin diálogo previo.

• client, site, or agent — the template is scoped to that client, site, or machine; it will ask you when you run it.
• No dependencies — the template runs over the whole fleet and executes right away, with no prompt.

2. Qué reportes vienen de fábrica2. Which reports ship ready

Estas son las plantillas curadas que trae Observer, agrupadas por tema. Cualquiera se genera con los pasos de arriba:

These are the curated templates Observer ships, grouped by topic. Any of them generates with the steps above:

• Equipos e inventario — Inventario de Agentes · Especificaciones de Equipos · Agentes por Cliente y Sitio · Reporte Integral de Equipos · Distribución de Sistemas Operativos · Tiempo de Actividad de Equipos · Equipos con Reinicio Pendiente · Fecha de Instalación del Agente.
• Software — Inventario de Software · Software por Cliente · Cobertura de Antivirus.
• Parches y actualizaciones — Actualizaciones de Windows Pendientes · Actualizaciones Pendientes por Sitio · Últimas Actualizaciones Instaladas · Panorama de Parches.
• Monitoreo y alertas — Estado de la Flota · Estado de Chequeos · Panel de Alertas · Registro de Auditoría.

• Machines & inventory — Agent Inventory · Machine Specifications · Agents by Client and Site · Comprehensive Machine Report · Operating System Distribution · Machine Uptime · Machines Pending Reboot · Agent Installation Date.
• Software — Software Inventory · Software by Client · Antivirus Coverage.
• Patches & updates — Pending Windows Updates · Pending Updates by Site · Latest Installed Updates · Patch Overview.
• Monitoring & alerts — Fleet Status · Checks Status · Alerts Panel · Audit Log.

3. Programar y enviar por correo3. Schedule and email

En vez de generar un reporte a mano cada vez, puedes programarlo para que se genere y se envíe por correo solo, de forma recurrente. Y en el historial encuentras todo lo que ya se generó.

Instead of generating a report by hand every time, you can schedule it so it's generated and emailed automatically on a recurring basis. And in the history you'll find everything already generated.

3.1 Programaciones3.1 Schedules

Desde la pestaña Programaciones de reportes, pulsa Nuevo y completa:

From the Report schedules tab, click New and fill in:

1. Plantilla de reporte — cuál se generará. Si tiene Dependencias (cliente/sitio/agente), las fijas aquí para que corran siempre igual.
2. Formato — PDF, HTML o Texto plano (o CSV).
3. Programación — elige una existente o usa Crear nueva programación. El editor de recurrencia es visual, no requiere sintaxis: eliges el Tipo de ejecución (Diaria, Semanal o Mensual), la Hora:Minuto y, según el caso, los días de la semana, los días del mes o los meses.
4. Zona horaria — la hora se interpreta en esta zona; si la dejas en blanco se usa la zona horaria por defecto de la plataforma.
5. Habilitado — deja la programación activa (o desactívala sin borrarla).

1. Report template — which one is generated. If it has Dependencies (client/site/agent), you fix them here so runs are always consistent.
2. Format — PDF, HTML, or Plain text (or CSV).
3. Schedule — pick an existing one or use Create new schedule. The recurrence editor is visual, no syntax needed: you choose the Run type (Daily, Weekly, or Monthly), the Hour:Minute and, as applicable, the weekdays, days of month, or months.
4. Timezone — the time is interpreted in this zone; leave it blank to use the platform's default timezone.
5. Enabled — leave the schedule active (or disable it without deleting).

Envío por correoEmail delivery

Con Enviar reporte por correo activo, defines los Destinatarios de correo con Agregar correo. Si no agregas ninguno, se usan los destinatarios por defecto de la configuración global; los que agregues aquí anulan ese valor por defecto. Con Personalizar contenido del correo puedes fijar el Asunto, el Cuerpo, el nombre y la extensión del adjunto (p. ej. csv) e incluir un enlace directo para ver el reporte en línea.

With Send report by email on, you set the Email recipients using Add email. If you add none, the default recipients from the global settings are used; the ones you add here override that default. With Customize email content you can set the Subject, the Body, the attachment name and extension (e.g. csv), and include a direct link to view the report online.

3.2 Historial3.2 History

La pestaña Historial de ejecución de reportes guarda cada reporte generado —manual o programado—. Para cada entrada ves la Plantilla, el Tipo de plantilla y la Fecha de creación, y puedes Abrir o Descargar el PDF (o el formato correspondiente) sin volver a generarlo.

The Report run history tab keeps every generated report —manual or scheduled—. For each entry you see the Template, the Template type, and the Date created, and you can Open or Download the PDF (or the matching format) without regenerating it.

4. Reportes personalizados4. Custom reports

Los reportes los diseña y mantiene BrainCorp: así salen consistentes y probados para toda la flota. Si el catálogo de fábrica no cubre exactamente lo que necesitas —otros campos, otro formato, un filtro distinto, el logo de tu institución en el encabezado—, solicítalo al área de Soporte. Lo diseñamos y lo sumamos al Gestor de reportes, donde queda disponible junto al resto.

Reports are designed and maintained by BrainCorp: that keeps them consistent and tested across the whole fleet. If the factory catalog doesn't cover exactly what you need —different fields, a different format, a different filter, your organization's logo in the header—, request it from Support. We design it and add it to the report manager, where it becomes available alongside the rest.

En resumenIn summary

• ¿Solo quieres un reporte? Usa una plantilla de fábrica: elígela, indica el cliente/sitio/agente y ábrela o descárgala en PDF o HTML.
• ¿Cuáles hay? Revisa el catálogo de fábrica, agrupado por tema.
• ¿Que salga solo? Prográmalo y envíalo por correo a quien corresponda.
• ¿Necesitas uno a medida? Pídelo a Soporte y lo sumamos al Gestor.

• Just want a report? Use a factory template: pick it, choose the client/site/agent, and open or download it as PDF or HTML.
• Which ones exist? Check the factory catalog, grouped by topic.
• Hands-free? Schedule it and email it to the right people.
• Need a tailored one? Ask Support and we'll add it to the manager.