Tracking activity progress


 A running command is called an activity in n3phele. On the right hand side of the main window a summary of the most recently started activities are shown. You can also click on the Activities tab to see a history of all your activities in n3phele. This list is periodically trimmed, so that the oldest activities are removed from this list.






Recent Activities 

This panel shows up to ten most recently started activities. Each list element has an icon representing the activity state, followed by the activity name.  Completed activities will show a check mark icon. Activities that had execution errors show with a "x" icon and the activity name. Activities that are still in progress show as a bar representing an estimate of their progress.
Clicking on any of these activties will display details of the activity progress in the main screen window. To return to your previous display, press the browser back button.







Activities List

Selecting the activities tab on the left hand side, brings up a historical list of activities. Each list entry contains the status icon, as described above in Recent Activities, the activity name, and the last narrative message associated with that activity. If you hover at the end of the activity line of a running activity, you will see a red "x" that if selected will give you an option to cancel that running activity.
Clicking on any of these activities will display details of the activity progress in the main screen window.





Activity Detail

The activity detail display is shown in Figure 3. The display shows the activity name, its status icon, as explained in the Recent Activities section, the name of the command being executed, and the command description. The display shows as well the start and end times of the activity and the estimated execution duration. Following this is a narrative list of actions associated with the activity execution. Each narrative line contains an icon representing the severity of the narrative, with "i" for informational, "!" for warning and "x" for error. This is followed by the timestamp associated with the message, the action that created the narrative message, and then the narrative message itself.
Informational narratives are never a cause for concern. For example, at the start of many command executions, you will see an informative message informing that n3phele is waiting for an agent. This is not unusual. Warning messages may need review. For example, when commands execute any text that is sent to the error channel (stderr) is included in the narrative with the warning status. In the QIIME commands, you frequently see a message "bash: not job control for this shell", which again is not a major concern. Messages however that show with a failed status represent problems with procressing and will usually be associated with analysis failures. These need to be carefully reviewed to understand the problem that occured.
Some common errors are also discussed here.


Figure 1. Recent Activities Panel

Figure 2. Activities List
Figure 3. Activity Detail