Log Report
On This Page
Overview
The Log maintains an audit log of activity for every item identified in a job. It allows you to view both informational and error activity for items grouped by date and time.
Filtering Activity
By default, all activity displays. You can filter the lists to display specific activity or errors.
Filtering the Log Timeline
The Log defaults to show the full activity history (From all time). You can use the other preset filters to view activity for last week, yesterday, or today.
If preferred, you can use the From and To fields to specify a custom date and time filter.
Sorting the Log
The list sorts the activity from newest to oldest, but you can select to sort from oldest to newest as needed.
Viewing Log Details
For each item in the log, the screen displays the activity level and more information about the reason the item falls into this category. You can hover on long descriptions and view the full information.
Invalid Path Errors
If there is an error for an invalid path, the error will take the following form: Invalid path <full_path>: Reason.
The reason will vary based on what triggered the error. The reason may include a general error message, or it may include the segment part of the path that caused the error and/or additional information that caused the error based on job parameters. Some examples of reason text that will display are listed below.
Segment <path_segment> contains double period
Segment <path_segment> is in the list of excluded constants
Segment <path_segment> starts with a space
Segment <path_segment> ends with a period
Segment <path_segment> ends with a space
Segment <path_segment> ends with a tilde
Segment <path_segment> ends with an underscore
Path <path_segment> exceeds maximum total length of <MaxTotalLength>
Segment <path_segment> exceeds maximum segment depth of <MaxSegmentDepth>
Segment <path_segment> exceeds maximum segment length of <MaxSegmentLength>
Segment <path_segment> contains invalid characters
Segment <path_segment> starts with a period
Segment <path_segment> starts with a tilde
Segment <path_segment> starts with an underscore
Segment <path_segment> contains an extension which is excluded
Segment <path_segment> empty after sanitizing
Segment <path_segment> is not well formed
Directory navigation characters are invalid
<path1> is not a parent of <path2>
Non-root segment cannot be null or empty
Path is null or empty
Not allowed to delete well known folder
Not allowed to rename well known folder
Path is longer than the system-defined maximum length
Unable to enumerate the contents of <path>
Unable to parse system file info for <path>
Unable to build duplicate file name
Exporting the Log
Use the Export this log link to export the activity log to a csv file. The export will reflect any filters used to view the log. The export contains the following information.
Field | Description |
|---|---|
job_id | The ID assigned to the job in the DryvIQ Platform |
execution_id | The ID assigned to the specific job run |
recorded_on | Date and timestamp when the record was recorded |
level | The log level being used (error, warn, info, or trace). |
type | The type of log entry. This indicates what occurred with the item. |
direction | Indicates if the audit record applies to the source (>) or destination (<-) |
reason | The reason for the failure or warning |
source_path | The source path for the item. |
destination_path | The destination path for the item. |
bytes | The size of the item in bytes |
version | The version number for the item |
hash | The item’s unique hash value |
item_type | Indicates if the item is a file or folder/directory |
Microsoft Excel has a maximum limit of 1,048,576 rows. When opening the export file, Excel will display a message to warn you if your file exceeds the maximum supported rows, and the excess content will not be displayed. See Microsoft’s Excel specifications and limits for more information. Refer to Exporting Large Data Sets in Chunks if you need to export more than the maximum limit.
Log Report | REST API
Job audit for all transfers
GET {{url}}v1/transfers/auditingJob audit for all jobs showing only errors
GET {{url}}v1/transfers/auditing?level=errorJob audit for a job
GET {{url}}v1/transfers/{{job}}/auditing?include=allJob audit for a job showing only warnings
GET {{url}}v1/transfers/{{job}}/auditing?level=warnJob audit for a job showing only errors
GET {{url}}v1/transfers/{{job}}/auditing?level=error