Introduction
The export activity logs page in a VIDIZMO Portal contains all the information regarding the executions or activities performed by the Export applications. VIDIZMO users can view the logs to gain insight into the details of these activities, such as when they began, who initiated them, their progress, and which export app is executing them.
By tracking this information, Moderator+ can stay informed of all export activities on their Portal. Monitoring these activities not only helps them diagnose export-related issues but also gives them the opportunity to analyze the usage patterns of export apps.
Concept
Whenever an export activity is performed on the VIDIZMO Portal, the system generates a log for that activity and adds it to the activity logs page. Each log created on the activity logs page represents the export activity performed on a single specific portal content. For example, if three videos are undergoing export activity, then three logs will be created on the activity logs page. Each of these three logs provides the export activity status for the three videos individually. In addition, the way the export activity is carried out on the Portal content influences how the logs are generated on the activity logs page.
Logging of Automatic Export Activities
In the case of automatic processing, the logs or entries created in the export activity logs correspond to the Portal content that meets the export criteria set in the AWS Export app. When an export app with automatic processing is enabled after the user finishes configurations, the VIDIZMO system will create logs on the page according to the export-eligible content queued for or undergoing an export activity. If there is multiple content, then the logs are added in bulk.
Note: The "System" text under the User column indicates the logs created by the automatic export activity.
Logging of On-Demand Export Activities
In manual export, the logs are created according to the content the user has selected for the export activity. When a user manually queues a single Portal content for an export activity, a log for that content is generated on the logs page. If the user chooses to perform bulk export activity on multiple Portal content, the logs are instantly generated for each content that the user has selected for export.
Cases with On-Demand Export
If a user performs a manual or on-demand export on content that has already gone through an export activity, the system will create a log for this activity. The system creates a log on the activity logs page every time the export command or activity is initiated. This means that performing a manual export multiple times on the same file will generate multiple entries in the activity logs.
This functionality is in place to log the export details of Portal content that obtained new content files after being processed by another activity.
Example
When a user performs a manual export on a video that has four content files, a log for this export activity is created on the export activity logs, and it indicates that all four content files have been exported.
The video then undergoes a processing activity, which generates two additional content files. If the user performs a manual export on this video again, a new log is created on the activity logs page, indicating that six content files have been exported.
Suppose the user exports the video manually again (with no new content files being generated). In that case, a log like the last one is created, showing that six content files were exported.
Explaining Export Activity Log Columns
The export activity logs page uses the following columns to display information about all export activities carried out on the Portal.
1. Title
The title column displays the name of the Portal content that underwent export activity. The column also displays a tag next to the name indicating which application was used to carry out the export activity.
For instance, if a video named "ABC.mp4" was exported by an app called "AWS Export App," then the "AWS Export App" tag will appear next to "ABC" on the log under Title for this export activity.
2. Date and Time
The Date and Time column denotes when the export activity was initiated on the Portal content. The information provided under date and time shows when this specific log was added to the activity logs page. If multiple contents are queued for the export activity, then the logs created for each of them have the same date and time.
3. User
The user column includes the names of users who have manually initiated the export activity using an export application. For logs created by automatic export activities, the user is listed as "System."
4. Status
The Status column provides information regarding the status of the export activity on specific Portal content. A tag indicates the status of the export activity; it can have the following states:
- Processing: indicates that the export activity is currently in progress.
- Completed: indicates that the export activity is completed.
- Failed: indicates that the export activity could not be completed.
- Content not Found: indicates that the export activity could not be completed because the Portal Content could not be found or accessed while the Export Activity was initialized.
- Pending indicates that the export activity is in queue and awaiting confirmation for processing.
- Rejected indicates that the request to carry out the export activity was rejected. This error can occur due to an invalid export criteria or when an export activity is performed again on already exported content that had no updates to its files.
5. Exported File(s) Count
In this column, you can track the progress of exporting Portal content in terms of the number of content files. The column displays the number of files that have been exported, the number of files left to export, and the overall total number of files that need to be exported to complete the activity. The format of this progress is as follows:
Number of Content Files Exported / Total Number of Content Files to be Exported
Note: The total number of content files is determined by the "Content Files" selected in the Export App's configuration.
The logs with the "Failed" status are labeled with "Error Details." The user can click this text to open a window providing information regarding what errors occurred and which files could not be exported.
Export Details in the Activity Logs
You can track the progress of your current and past export activities via the Activity Logs. The logs added here correspond to the content undergoing (or that has undergone) a manual or automatic export activity. As the logs regarding Export are added, their information, such as the progress, will be shown and updated accordingly.
1. Click "Activity Logs" to navigate to the page and see the details of all export activity on your Portal. The Activity Logs page can also be accessed via the Portal’s side menu.
2. On the Activity Logs Page, you have several options to perform a variety of actions and searches. Use the search bar to perform a basic search of the logs.
3. Click the "Search" icon to reveal more options for advanced search. You can use these options to create search criteria for the logs you want specifically.
4. Specify a Start Date to view all export activity logs added after that date.
5. Specify an End Date to view all export activity logs added before that date. You can use both "Start Date" and "End Date" to set a time period and view all the export activity logs in that period.
6. Add Portal users to bring logs of manual export activity that they initiated or carried out. A log created via an Automatic Export activity has "System" as a user, while the logs created via Manual Export have the user's name.
7. Search or filter the logs using the status of the export activity. Refer to Export Flow for the concepts.
8. Enter the name of the application(s) added to the Integration App page to bring logs specific to them. Currently only AWS Export App is available.
9. Click the Apply button to bring the logs according to the search criteria you have created.
10. Use the Refresh button to refresh the Activity Logs page and see the latest entries.
11. Clicking the "Errors" icon on a log with the status "Failed" or "Completed with Error" opens a modal that tells you which files failed and what error was encountered.
12. Lastly, you can purge or permanently delete the records from the export activity logs via the “Delete Log(s)” button.
13. Specify the period for removing logs on the "Purge Activity Logs" window. If you want to remove all logs, select" Purge All Logs." To proceed with the action, click the" Delete" button.
Conclusion
The Export Activity Logs page in a VIDIZMO Portal contains a record of all the export activities carried out through the configured applications. These logs are generated for every mashup processed either automatically or manually using any application classified as an Export App. Each entry or "log" on the activity logs page provides details about the export activity performed on a single specific Portal content. The details include the activity's status, progress, time, and username. Lastly, the search options allow users to find or filter specific logs easily. They can also use the advanced search options to create more defined search criteria to get the activity logs they require.