Overview
The Activities table contains a list of all the activities run in JetPatch.
Each activity represents an action performed in your environment in real time - this could be a pre- or post-patching activity, a patching action, or a task being run. Navigate to Endpoints → Activities from the left menu.
Activities is a great page for viewing actions in your environment at a very granular level. By using the filters, you can find specific activities and understand issues better through detailed reports and exit codes.
| Tip: It is highly recommended to pause and try out the filters and columns yourself as you follow along with this guide. |
Activity Types
Activities are divided into several task types:
| Task Type | Description |
| Patch | The actual patching activity. |
| Pre Patch | Activities that were running in pre-patching tasks, as part of the chosen Workflow. |
| Post Patch | Activities that were running in post-patching tasks, as part of the chosen Workflow. |
| User | Activities that the user started manually. |
| User Scheduled | Pending activities that the user initialized. Once they run, the type will change to “User”. |
| System | JetPatch system tasks that constantly run to check for endpoint and patch updates. |
Activity Statuses
Activity statuses are displayed with relevant colors in the table:
| Status | Description |
| Queued | The activity is in the queue. JetPatch is waiting for the previous activity to finish running on the endpoint, or for the scheduled time to arrive. |
| In Progress | The activity is currently running on the endpoint. |
| Succeeded | The activity finished and received a successful exit code based on the script configuration. If special exit codes were not configured, the default success code is 0. |
| Error | JetPatch could not run the activity on the endpoint. |
| Failed | The activity finished running and received a failure exit code based on the script configuration. If special exit codes were not configured, the default is any non-zero code. |
| Canceled | The activity was canceled by a user before it completed. |
Filters
If you are searching for a specific activity, it is best to use the filters at the top of the page:
- Search – Filter by keyword, activity name, or endpoint name.
- Task – Filter by the name of a specific task. This can include tasks involved in Workflows or tasks that were run independently.
- Task Type – Filter by the high-level type of task being run (e.g., Pre Patch, Patch, Post Patch, System).
- Remediation Plan – Sort all the tasks associated with a specific Remediation Plan.
- Endpoint Group – Sort on all tasks that relate to the endpoints in a specific Endpoint Group.
- Activity Status – Filter by the outcome of activities. Useful for sorting on errors or failures (see Activity Statuses above).
- Started By – Filter by who planned or ran the activity.
- More Filters:
- Exit Code
- Operating System (of the endpoint)
- Start Date
- End Date
Columns
The Activities table contains the following columns:
- Activity – The name of the activity that took place.
- Endpoint Name – The name of the endpoint on which the activity ran.
- Type – The high-level task type (e.g., Patch, Post Patch, System).
- Remediation Plan – The Remediation Plan was a task that was part of it, if applicable.
- Status – The outcome of the activity.
- Start Time – The exact time the activity started.
- End Time – The exact time the activity ended.
- Exit Code – The exit code returned by the activity. This is especially important when things do not go as planned. By selecting the ⓘ icon, you can gain very detailed information about where the failure took place.
When an activity fails, a link at the top of the details panel provides a list of exit codes with an explanation of what each one means. For more information, see the What do these exit codes mean article.
View Task Details
For more information about a task or patch, click View Details in the last column of the table.
- The activity details can be copied or downloaded directly from the details panel.
If the Activity Status is failed, you can find more information about the failure with the What do these exit codes mean article
Cancel Activities
You can cancel activities, but only if they are in Queued status. Activities that are already In Progress cannot be canceled.
Rerun an Activity
Users can rerun an activity that ended either successfully or unsuccessfully, without the need to navigate to another screen or go through a large number of clicks.
When clicking the Retry button on a specific activity, the following behavior applies:
- The same task will be re-run immediately on the relevant endpoint.
- Support: “Run as Unmanaged Task” (if configured).
- Ignore: “Run at specific time” (if configured) - the rerun will execute immediately regardless.
- A new activity row will be added to the table for the rerun.
RBAC
| Note: The Rerun option is displayed only for users with “Run Tasks” permissions or Administrators. |
Reports
Reports can be downloaded by clicking on the Download Reports icon at the bottom left of the page. If the page is filtered, the report will also be filtered accordingly.
The available reports are:
- Full Activities Report (CSV) – Downloads extended information on the filtered activities.
- Activities Report without Details – Downloads the same report as above, but without the activity details.
| Note: If you open the CSV in Excel, some Output text may be cut off by default. To show all the text, highlight the entire Output column and apply Wrap Text (Home → Wrap Text). |
Comments
0 comments
Please sign in to leave a comment.