Skip to main content

Collector Jobs

The Collector jobs button opens a drawer that lists collection jobs and their tasks across all networks in the organization. Use it to watch active jobs, review recently finished ones, drill into per-source progress, and cancel a job that is queued or running.

Opening the drawer

The Collector jobs button sits in the application toolbar in the top-right corner, near the notifications icon.

  • When no jobs are active, it shows a list icon labeled Collector jobs.

    Collector jobs button in the app toolbar

  • While jobs are running, it becomes a pill showing a spinner and the count, for example 4 jobs in progress.

    Collector jobs button showing jobs in progress

Click the button to open the Collector jobs drawer.

note

The button is visible to users with the Network Operator role or higher. It does not appear in Software Central deployments.

Active and history tabs

The drawer has two tabs, each with a count:

  • Active — jobs that are queued or in progress.
  • History — jobs that have finished, including completed, failed, timed-out, and canceled jobs.

Collector jobs drawer, Active tab

tip

Jobs are not always run in the order they were queued. Prioritization depends on the characteristics of each job.

Job table columns

The columns shown depend on the tab and on whether the organization uses multiple collectors per network.

ColumnTabDescription
Triggered atBothWhen the job was queued. Hover to see the exact timestamp.
Triggered byBothThe user who started the job.
NetworkBothThe network the job runs against.
CollectorBothThe collector running the job. Labeled Collectors when a network uses more than one.
Job typeBothThe kind of job (see Job types). Filterable.
TasksBothThe number of tasks (sources) the job covers.
StatusBothA progress bar for running jobs, or the final status for finished jobs.
TimeActiveRun time for a job in progress, or elapsed wait time for a queued job.
Queue timeHistoryHow long the job waited in the queue before starting.
Run timeHistoryHow long the job took to run.

The History tab replaces the Time column with separate Queue time and Run time columns:

Collector jobs drawer, History tab

Status values are queued, in progress, completed, failed, timed out, and canceled.

For a canceled job, click the Cancel details icon in the Status column to see who canceled it, when, and the reason given.

If a running job's collector is offline, a warning icon appears next to it: Collector is offline. No progress can be made until it's back online.

Job actions

Each row offers actions, subject to permissions:

ActionWhen availableResult
Job progressA running or finished job that has tasksOpens the Job progress drawer.
View logA running or finished job with no subtasksOpens the collection log in a new browser tab.
Cancel jobA queued or running jobOpens the cancel dialog.

Job progress

For a job with tasks, the Job progress action opens a drawer titled Job progress (or Job details once the job has finished).

Job progress drawer for a running job

Once the job finishes, the same drawer is titled Job details and shows each task's final status and run time:

Job details drawer for a finished job

The drawer shows:

  • A Task status summary with counts for queued, in-progress, completed, canceled, failed, and timed-out tasks.
  • A Tasks table listing each task. Queued tasks are excluded, and at most 1,000 tasks are shown.

The task table has these columns:

ColumnDescription
TaskThe task description, usually the source being collected.
StatusThe task's current status. Filterable.
CollectorThe collector running the task (shown only with multiple collectors per network).
NoteAny note recorded for the task, such as a cancellation reason.
Current operationThe step in progress (network-collection jobs only).
Start timeWhen the task started, or not started if it has not begun.
Run timeHow long the task has been running or took to run.

You can view the log for an individual task, or cancel a task that is queued or running.

Canceling a job

Selecting Cancel job opens a confirmation dialog titled Cancel this job?.

Cancel job confirmation dialog
  • Enter a Reason for the cancellation, then confirm with Yes, cancel job.
  • For a running network-collection job, you can instead choose Skip remaining sources to stop the pending sources while keeping the sources already collected, or Abort all to cancel everything.

Canceled jobs remain visible in the History tab for two days.

Permissions

CapabilityWho can do it
View the Collector jobs drawerNetwork Operator and above.
View job details, logs, or cancelOrg Admins, Network Admins of the job's network, or the user who started the job.

A user without the required permission sees a tooltip explaining that they can contact the job owner or an admin.

Job types

The Job type column can hold any of the following values:

Job typeDescription
collectionA network snapshot collection.
connectivity testA device connectivity test.
device discoveryDiscovery of devices for a network.
host discoveryMeraki host discovery, part of Cisco Meraki setup.
subnet scanAn end-host subnet scan.
collector upgradeA collector upgrade.
collector extensionInstalling or removing a collector extension.
end host scanner testA test of the end-host scanner.
http endpoint testA test of an HTTP endpoint.
dns connectivityA DNS connectivity check for a DNS zone transfer.
dns transferA DNS zone transfer.
apply certificatesApplying trusted certificates to a collector.

See also