Help Center


Knowledge Base


[DOC:Netmail Documentation]

Documentation for Netmail Archive 5.4.
Documentation for [Netmail Archive 5.3] and [earlier versions of Netmail] is also available.

Skip to end of metadata
Go to start of metadata


Job Reports can be viewed in the Netmail Administration Console both on the Clusters > <Cluster Name> > Report tab and on the Report tab of specific jobs. These Netmail Administration Console views automatically collate data from the logging database into reports for administrators to use.

On this page:

 

The Report tab on the Cluster object provides information about the System Address Book Sync job. The Report tab of a specific agent's job provides information on that specific job.

Job Reports

By default, when you click on the Report tab, you see summary reports from the last two executions of the job in question (assuming there have been two). If you wish to see information from older executions, click Edit Filter to select the date range for which you want to view reports.

Note: You will only be able to see data for executions that date back as far as the logging database settings for keeping job execution data are configured. Check your Configuration > Purge log after setting, and adjust it if you want to keep data for a longer period of time.

Along with allowing you to select a specified date range, the Edit Filter button also allows you to narrow the reporting scope down to only show data pertaining to specific users and/or only those users experiencing errors.

Report Content

If a job has run against multiple accounts, the default summary report line will show the cumulative statistics (in both numbers and percentages) for all accounts.

Clicking on the + symbol in the Time column will expand the view to show the statistics for each individual account against which that job was executed.

If a particular account experienced errors, you can also expand that entry to show the error details. For errors associated with a particular mail item, details will be provided in the error messages to help identify the items in question and facilitate further investigation.

Note: A single error count may have multiple error messages and information lines associated with it, as in the previous figure where a broken attachment on a single Exchange item has generated multiple error lines.

Any accounts that could not be processed at all will show a status of Started, but will be counted in the Failed accounts count in the job summary line. An example of this is shown in the figure below, where the corresponding Exchange account is disabled and so the archive job cannot open it.

Report Counters

The columns and counts shown in the summary report vary slightly in meaning depending on the job type. This section explains the meaning for each of the most common job types.

Address Book Sync Jobs

CounterMeaning
EligibleNumber of entries read from the mail system address book
SucceedNumber of entries successfully created or matched to Netmail Archive accounts in eDirectory
ErrorsNumber of entries failing to create or match
WarningsNumber of non-critical problems encountered when processing the address book or writing entries to eDirectory
IndexedN/A
Index ErrorsN/A
TransactedN/A
Tran ErrorsN/A

Archive Jobs

CounterMeaning
EligibleNumber of items in the source mail account or native archive found matching the policy assigned to the job
SucceedNumber of items successfully submitted to the archive store
ErrorsNumber of items having major problems, at any stage, when being processed by the job
WarningsNumber of non-critical problems encountered when writing archives, the most common of which is when items already exist in the archive
IndexedNumber of items submitted to the Index Server if real-time indexing is enabled on the job
Index ErrorsNumber of items with errors when submitted for indexing
TransactedNumber of items successfully marked as published in the mail system once archived
Tran ErrorsNumber of items failing when trying to mark them as published in the mail system (usually due to index errors in the mail system failing to locate the item via its message ID)

ILM Groom Jobs

CounterMeaning
EligibleNumber of items in source location found matching the policy
SucceedNumber of items successfully moved to the destination archive location
ErrorsNumber of items having major problems, at any stage, when being processed by the job
WarningsNumber of non-critical problems encountered when writing archives, the most common of which is when items already exist in the archive
IndexedNumber of items submitted to the Index Server if real-time indexing is enabled on the job
Index ErrorsNumber of items with errors when submitted for indexing
TransactedN/A
Tran ErrorsN/A

ILM Delete Jobs

CounterMeaning
EligibleNumber of items in target location found matching the policy
SucceedNumber of items successfully deleted
ErrorsNumber of items having major problems, at any stage, when being processed by the job
WarningsNumber of non-critical problems encountered when deleting the archives
IndexedN/A
Index ErrorsN/A
TransactedN/A
Tran ErrorsN/A

Index Agent Re-create Index Jobs

CounterMeaning
EligibleNumber of items in the specified location
SucceedNumber of items successfully processed for indexing
ErrorsNumber of items having major problems, at any stage, when being processed by the job
WarningsNumber of non-critical problems encountered when submitting the items for indexing
IndexedThe same as the Succeed count
Index ErrorsThe same as the Errors count
TransactedN/A
Tran ErrorsN/A

Utility Agent Reduce Jobs

CounterMeaning
EligibleNumber of items in the mail system found matching the policy
SucceedNumber of items successfully deleted from the mail system
ErrorsNumber of items having major problems, at any stage, when being processed by the job
WarningsNumber of non-critical problems encountered when attempting to delete the items
IndexedN/A
Index ErrorsN/A
TransactedSame as the Succeed count
Tran ErrorsN/A

Attachment Management Agent Stripping Jobs

CounterMeaning
EligibleThe item had one or more attachment and met the size criterion stipulated in the job
SucceedThe item was successfully stripped of its attachments
ErrorsN/A
WarningsN/A
IndexedN/A
Index ErrorsN/A
TransactedA link or table of links was successfully created
Tran ErrorsSomething went wrong at the time of creating the link or table of links

Attachment Management Agent Re-attachment Jobs

CounterMeaning
EligibleThe item was found to have one or more links to stripped attachment(s)
SucceedItem(s) was successfully re-attached
ErrorsN/A
WarningsN/A
IndexedN/A
Index ErrorsN/A
TransactedN/A
Tran ErrorsN/A

Download Reports

In addition to the summary information available in the Report tab, it is also possible to download the same information and more in .csv file format by clicking Download Report on the Report tab of a job.

These .csv files can be useful if you need to provide job report information to a third party or if you want to pull Netmail Archive job report information into your own custom reporting tools. Furthermore, the job report provides details for any job Warnings, which are not shown on the summary screen, and gives you access to Trace reports, if trace logging has been enabled for troubleshooting purposes.

Note: The .csv file contains the relevant information for each job execution currently shown on the Report tab. If you have not clicked the Edit Filter button to change the scope, the two most recent job executions will be presented in the .csv file. If you have modified the scope, those job executions obtained from the filtered results will appear on the Report tab and therefore in the downloaded reports.

The full list of reports available by clicking the Download Reports button for a job is as follows:

  • Summary Report: The downloadable summary report contains the same information as shown in the main report screen within the job totals line (i.e., it contains the start and stop times of the job, the number of accounts processed, and totals for each of the counters.
  • Summary Report with detail list: The downloadable summary report with detail list is the same as the summary report for a job, but it contains an additional line for each account processed by the job and the corresponding individual counter statistics (as with an expanded entry on the Reports screen).
  • Error Report: This report contains all error information for the selected executions.
  • Warning Report: This report contains the details for any warning counts within the selected job executions.

Note: This is the only place where detail on warnings can be viewed. This detail is not provided in the main Reports window as it is regarded as non-critical.

  • Trace Report: Within the Log Settings of a job, it is possible to enable Trace Logging. Enabling this option results in the job logging additional information to the logging database. Typically, this information is used only for troubleshooting purposes. As a result, Trace Logging should only be enabled under specific instruction from Netmail Support or if you have a specific issue which you are troubleshooting. Leaving Trace Logging enabled on jobs which run regularly can result in a very large logging database and can adversely affect reporting speed.

The downloadable trace report provides a .csv file containing all of the additional trace logging detail for the job executions currently selected. This report can be provided to Netmail Support upon request or inspected to find additional information for troubleshooting purposes.

  • No labels
Write a comment…