--- title: "Scheduling an alert details report using the CLI" slug: "scheduling-an-alert-details-report-using-the-cli-2" tags: ["Network Security (NX)", "Product Usage"] updated: 2026-09-02T17:27:05Z published: 2026-09-02T17:27:05Z canonical: "docs.trellix.com/scheduling-an-alert-details-report-using-the-cli-2" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.trellix.com/llms.txt > Use this file to discover all available pages before exploring further. # Scheduling an alert details report using the CLI Follow these steps to schedule an alert details report using the CLI. ### Command syntax You schedule an Alert Details report by using the `report schedule` command with the following command-line options `run <frequency>` where `<frequency>` specifies when the report is run: - `daily at <hh:mm>` Run the report daily, where `<hh:mm>` specifies the time to start based on a 24-hour clock. - `hourly at <mm>` Run the report hourly, where `<mm>` is the number of minutes into the hour. - `monthly on {<date> | end_of_month} at <hh:mm>` Run the report monthly, where `<date>` is the day of the month and `<hh:mm>` specifies the time to start based on a 24-hour clock. - `weekly every <day> at <hh:mm>` Run the report weekly, where `<day>` is the day of the week and `<hh:mm>` specifies the time to start based on a 24-hour clock **`type alert_details`** `report_format <format>` where `<format>` specifies the output file format: - `csv` - `json` - `text` - `xml` `report_detail <detail>` where `<detail>` specifies how much information to include in the report: - `concise` Basic information, such as alert type, alert ID, source IP address, malware name, hostname, and alert URL. - `normal` Concise information plus OS changes, callback details, and malware details, if available. - `extended` Normal information plus data-theft information (if any) and static analysis details. This format provides all details about files and objects modified during analysis. `time_frame <timeFrame>` where `<timeFrame>` the output file format: - `past_day` - `past_week` - `past_month` - `past_3_months` `alert_type <alertType>` where `<reportType>` the output file format: - `all` - `domain-match` - `infection-match` - `malware-callback` - `malware-object` - `web-infection` ### Note On a SmartVision Edition appliance, you can specify **malware-object** alerts only. `transport <transportType>` where `<transportType>` is the report distribution method: - `email` - `file` ### Prerequisites - The SMTP server or domain is configured and the email address of the report recipient is configured. - Admin or Operator access to the SmartVision appliance. To schedule an alert details report for automatic generation and email distribution: 1. Log in to the appliance CLI and go to configuration mode: ``` hostname > enable hostname # configure terminal ``` 2. Schedule an alert details report by using the following command: ``` report schedule run type alert_details report_format report_detail time_frame alert_type transport ``` The recurring report os assigned an identification number. The report ID, type, and specifications are added to the top of the scheduled reports list. ``` hostname (config) # report schedule run weekly every Sun at 2359 type alert_details report_format xml time_frame past_month report_detail extended alert_type malware-object transport file Created report schedule 2. ``` After the scheduled report runs, the report file is emailed using the configured email server and recipient list. 3. Verify the configuration for the report schedule. ``` hostname (config) # show report schedule    Periodicity  MonthDay         WeekDay  Time   Transport  Command    2 weekly       -              Sun      23:59   email     alert_details                                                             report_format json                                                             report_detail concise                                                             alert_type malware-object                                                             time_frame past_week    3 monthly      end-of-month   -        23:59   file      alert_details                                                             report_format xml                                                             alert_type malware-object                                                             report_detail extended                                                             time_frame past_month Total reporting jobs scheduled: 2. ``` :