: Generate, Schedule, and Email Reports
Focus
Focus

Generate, Schedule, and Email Reports

Table of Contents

Generate, Schedule, and Email Reports

You can configure reports to run immediately or schedule them to run at specific intervals. You can save and export the reports or email them to specific recipients. Emailing is particularly useful if you want to share reports with administrators who do not have access to Panorama. Panorama supports the same report types as the Palo Alto Networks firewall.
Beginning with Panorama 10.0.2 and Cloud Services plugin version 1.8.0, you can generate scheduled reports on Strata Logging Service data. This setting is disabled by default and must be manually enabled on Panorama. This setting status (enabled or disabled) persists across PAN-OS upgrades, downgrades, and if you uninstall the Cloud Services plugin. To generate reports from Strata Logging Service data, you must first enable the feature from the Panorama CLI.
It is recommended that you install matching software releases on Panorama and the firewalls for which you will generate reports. For example, if the Panorama management server runs Panorama 10.0, install PAN-OS 10.1 on its managed firewalls before generating the reports. This practice avoids issues that might occur if you create reports that include fields supported in the Panorama release but not supported in an earlier PAN-OS release on the firewalls.
  1. Enable scheduled reports on Panorama.
    1. Enable the scheduled reports setting.
      admin> request plugins cloud_services logging-service sched-report-enable
    2. Commit the configuration change.
      admin> configure
      admin# commit force
    3. Verify the scheduled report setting is enabled.
      admin> show system state | match sched-report
      The output displays cfg.report.lcass-sched-reports-enabled: True if enabled.
      The output displays cfg.report.lcass-sched-reports-enabled: False or will not return an output if disabled.
  2. Configure Panorama predefined reports.
    1. Select PanoramaSetupManagement and edit Logging and Reporting.
    2. Select Log Export and Reporting and enable (check) Use Data for Pre-Defined Reports to offload hourly report aggregation to Log Collectors.
      (Strata Logging Service only) This step is required to generate scheduled reports for logs stored on Strata Logging Service.
      Enabling this setting is recommended for VM-50, VM-50 Lite and PA-200 firewalls. Enabling this setting is optional for all other managed firewall models.
    3. Select Pre-Defined Reports and enable (check) predefined reports to push from Panorama.
    4. Select CommitCommit to Panorama and Commit your configuration changes.
    5. (VM-50, VM-50 Lite, and PA-200 firewalls only) Access the firewall CLI to enable predefined reports.
      This command must be run on each VM-50, VM-50 Lite, and PA-200 firewall.
      admin> debug run-panorama-predefined-report yes
  3. Configure Panorama to receive and store user and user group information that it receives from firewalls.
    Required to generate reports based on usernames and groups instead of just IP addresses.
    1. If you want Panorama to include user group information in reports, upgrade the managed firewalls to PAN-OS 8.1 or a later release. Panorama cannot synchronize group information from firewalls running earlier releases.
    2. Select PanoramaSetupManagement, edit the Panorama Settings, and Enable reporting and filtering on groups.
    3. Add a Device Group if you haven’t already. For each device group:
      • Select a Master Device, which is the firewall that provides user and user group information to Panorama.
      • Enable Panorama to Store users and groups from Master Device.
  4. Generate reports.
    Scheduled and Run Now summary reports for the same database and timeframe have discrepancies in the data displayed in each report. This is due to how Log Collectors and firewalls aggregate logs during hourly aggregation.
    The steps to generate a report depend on the type.
    • Custom report:
      1. Select MonitorManage Custom Reports and Add the report.
      2. Enter a Name to identify the report.
      3. Select a Database for the report.
        You can base the report on Summary Databases or Detailed Logs databases.
        To base the report on logs stored on the Panorama management server and Log Collectors, select Panorama Data (recommended for faster performance).
        To base the reports on logs stored on the managed firewalls, select Remote Device Data. This option is for cases where the firewalls might have logs that were not yet forwarded to Panorama. However, because Panorama must query the firewalls directly, this option is slower.
      4. Select Scheduled.
      5. Define your log filtering criteria by selecting the Time Frame, Sort By order, Group By preference, and the columns (log attributes) that the report will display.
        Selecting the Sort By order is required in order to generate an accurate report. If you do not select a Sort By order, the generated custom report is populated with the most recent log matches for the selected database.
      6. From the Available Columns list, select the columns that you want to display in the report, and add them to the Selected Columns list.
        The columns that you add, appear in the Selected Column list. You must add at least one column to save or run the report.
        To generate scheduled reports, ensure that you add the field you selected in the Sort By list to the Selected Columns list.
      7. (Optional) Use the Query Builder to further refine the log filtering criteria based on log attributes.
      8. To test the report settings, select Run Now. If necessary, modify the settings to change the information that the report displays.
      9. Click OK to save the custom report.
    • PDF Summary Report:
      1. Select MonitorPDF ReportsManage PDF Summary and add the report.
      2. Enter a Name to identify the report.
      3. Use the drop-down for each report group and select one or more of the elements to design the PDF Summary Report. You can include up to 18 elements.
      4. Click OK to save the settings.
  5. Configure a Report Group.
    It can include predefined reports, PDF Summary reports, and custom reports. Panorama compiles all the included reports into a single PDF.
    1. Select MonitorPDF ReportsReport Groups and Add a report group.
    2. Enter a Name to identify the report group.
    3. (Optional) Select Title Page and add a Title for the PDF output.
    4. Select reports in the Predefined Report, Custom Report, and PDF Summary Report lists.
    5. Add the selected reports to the report group.
    6. Click OK to save the settings.
  6. Configure an Email server profile.
    The profile defines how the firewall connects to the server and sends email.
    1. Select PanoramaServer ProfilesEmail and Add a server profile.
    2. Enter a Name to identify the profile.
    3. Add up to four SMTP servers and Add the following information for each one:
      • Name—A name to identify the SMTP server (1 to 31 characters). This field is just a label and doesn’t have to be the hostname of an existing server.
      • Email Display Name—The name to display in the From field of the email.
      • From—The email address where notification emails will be sent from.
      • To—The email address to which notification emails will be sent.
      • Additional Recipient—To send notifications to a second account, enter the additional address here.
      • Email Gateway—The IP address or hostname of the SMTP gateway to use to send the emails.
    4. Click OK to save the profile.
  7. Schedule the report for email delivery.
    1. Select MonitorPDF ReportsEmail Scheduler and Add an email scheduler profile.
    2. Enter a Name to identify the profile.
    3. Select the Report Group, the Email server profile you just created (Email Profile), and the Recurrence for the report (default is Disable).
    4. Send test email to verify that the email settings are accurate.
    5. Click OK to save your changes.
    6. Select CommitCommit to Panorama and Commit your changes.