Scheduled Reports

Scheduled reports are generated by the Syslog Watcher Server service, not by Manager. Use them for reports that repeat and when Manager is connected to a remote server. The Scheduled Reports tab lists upcoming reports and the history of finished ones.

Schedule a Report

  1. In the Messages section of the main toolbar, click Reports Reports → Show Scheduled Reports.

  2. On the Scheduled Reports tab, click Plus symbol Schedule New Report…​

  3. In the Schedule Report window, select a Report template.

  4. Select a Run option and fill in its time settings; see Run.

  5. Optionally set a Filter; see Filter.

  6. Click Schedule.

The report appears on the tab with the status Scheduled. When it is Completed, the file is in the server’s Output folder; click Open symbol Open Report to open it.

Reports are generated only while Generate on a schedule is on. It is on by default.

Schedule Report Window

Setting Description

Report template

Templates from the installation are listed as Installation: <name>.

Run

When the report runs; see Run. The time settings under it depend on the option you select.

Messages → Range

Time range of the stored messages; see Messages Range. Shown only for As soon as possible and Once; the other choices set the range themselves. TODAY and YESTERDAY are not offered here.

Filter

Optional; see Filter.

Run

Value Description

As soon as possible

Runs as soon as the server can start it. Messages sets the range.

Once

Runs once, at the date and time in At. Messages sets the range.

Recurring

Runs at First at, then again after each Repeat every interval. Each run covers the interval that has just ended; the first run covers the interval before First at.

Weekly

Runs at midnight on the weekday in Run on and covers the previous 7 days. If you schedule it on that weekday, the first run is on the same weekday next week.

Monthly

Runs at midnight on the day in Run on (month day) (1–28) and covers the time since the same day of the previous month.
If a Recurring, Weekly, or Monthly report ends with Error, it is not scheduled again. Fix the cause and use Reschedule…​ to restart it.

Scheduled Reports Tab

In the Messages section of the main toolbar, click Reports Reports → Show Scheduled Reports.

Toolbar

Plus symbol Schedule New Report…​

Schedule a new report; see Schedule a Report.
Pencil symbol Edit…​

Change a report that has not started; see Edit a Report.
Reschedule symbol Reschedule…​

Schedule a finished, failed, or canceled report again; see Reschedule a Report.
Delete / Cancel

Delete a finished report, or cancel one that has not started; see Cancel or Delete.
Show reports for:

How far back the list goes: Last 3 days to Last 365 days.
Open symbol Open Report

Open the file of a Completed report; see Open a Report.

Buttons that your role does not allow are unavailable.

Columns

Column Description

Date/Time

When the report runs or ran.

Status

Scheduled, …​processing…​, Completed (green row), Error (red row), or Canceled.

Report template

Template name; installation templates show as Installation: <name>.

Filter

✔ when the report has a filter, — when it has none.

Range

Message range: start, end, and length, or ENTIRE STORAGE.

Repeat

Every <interval>, Weekly (<weekday>), Monthly (on <day>), or — for a single report.

Messages

Number of messages analyzed; — before the report starts.

Result

For a Completed report, the file path; click it to open the file. For an Error, the error message. While the report runs, its speed in msg/s.

Edit a Report

Pencil symbol Edit…​ is available for Scheduled reports. It opens the Edit Scheduled Report window, where you can change:

  • Report template and Filter

  • Messages range, for As soon as possible and Once

  • At, for Once

Run and its schedule settings cannot be changed. To change them, cancel the report and use Reschedule…​

Reschedule a Report

Select a Completed, Error, or Canceled report and click Reschedule symbol Reschedule…​ The Schedule Report window opens with that report’s settings. Change what you need and click Schedule. This adds a new report; the old row stays in the history.

Cancel or Delete

  • Cancel (for Scheduled reports) stops the report from running. The row stays with the status Canceled.

  • Delete (for finished reports) removes the row from the history. For a Completed report it also deletes the file.

Both ask for confirmation. A report that is …​processing…​ cannot be canceled.

Open a Report

Select a Completed report and click Open symbol Open Report, double-click the row, or click the file path in Result.

  • Local server: Manager opens the file in the server’s Output folder.

  • Remote server: Manager downloads the file, asks where to save the copy, and opens it.

Server Configuration

In the Server section of the main toolbar, click Server Server → Server Configuration Server Configuration…​, then select Syslog Reports.

Setting Description

Generate on a schedule

Turns scheduled report generation on or off. On by default. When it is off, the settings below are hidden.

Concurrent tasks

How many reports can be generated at the same time (1–9, default 1). Other due reports stay Scheduled until a task is free.

Include folders

Optional folders for {{INCLUDE}} files, one path per line. They are searched after the ReportResources folder in the installation directory.

Output folder

Folder on the server computer for report files. Required when Generate on a schedule is on.

Keep reports (days)

How long finished reports and their files are kept (1–9999, default 30). Older ones are deleted automatically.

Related Topics