Information for: DEVELOPERS   PARTNERS

Task logs in Acquia Cloud Site Factory

Task logs, also known as Work Pool logs or Work In Progress (wip) logs, are detailed records of all the actions your Factory is performing. These include, but aren’t limited to, background tasks for website management and domain management, and tasks initiated by users (such as code deploys and website installations).

Tasks are assigned to groups, enabling you to both view all tasks of a particular type and identify recurring problems.

Acquia Cloud Site Factory offers several levels of task log retention, which you can configure by using the Task log settings webpage.

Accessing task logs in Acquia Cloud Site Factory

To access an overview of task logs, complete the following steps:

  1. Sign in to the Site Factory Management Console.
  2. In the admin menu, click Administration.
  3. In the Logs section, click the Task log link.

The At a glance section provides the following information about the website update process:

The At A Glance section displays information about the website update process

  • Not Started: Number of tasks queued
  • In Progress: Number of tasks in progress or waiting to complete
  • Error: Number of tasks not completing due to an error. Click the number to view a detailed list of errors
  • Warning: Number of tasks completed with warnings. Click the number to view a detailed list of warnings
  • Completed: Number of tasks completed with no issues

Task groups

To help you identify patterns or recurring issues with your subscription, tasks are assigned to groups. Although groups typically contain several tasks of a specific type, tasks may be related by how they’re called, rather than the function they perform. For example, the tasks in the DrushCommand group can contain cache-rebuilding tasks due to the tasks being executed by Drush.

When you view task logs in Acquia Cloud Site Factory, you can filter to a single group of tasks by clicking Group in the At a Glance section, and then selecting the group of tasks that you want to view.

Select a group from the Group select box to view it

To clear your filter selection and view all tasks, click Reset.

Viewing detailed information about a task

To view more details about a task, complete the following steps:

  1. Go to the Task log webpage, and then identify the task you want to examine in more detail.

  2. To display statistics about this task, click the Information icon next to the start time of the task to display statistics about this task.

    Detailed list of statistics about an in-progress task

    The task’s statistics include the following values:

    • ID: A unique identifier for the task.
    • Object ID: A link to all lines in the log file for the task.
    • Parent: If spawned by another task, the parent task’s Object ID.
    • Group Name: The group to which the task belongs, used with Concurrency to protect resources.
    • Added: A UNIX timestamp showing when the task was created.
    • Wake: If the task may not proceed, a UNIX timestamp indicating when the task may resume.
    • Taken: A lock indicating if the task is being processed.
    • Completed: A UNIX timestamp showing when the task completed. The item is blank if the task is still in progress.
    • Priority: The numerical importance of the task, between 1 and 3, with smaller numbers having greater priority. The default value is 2. Internal use only.
    • Lease: The number of seconds the task is expected to take. If exceeded, the task may be restarted. Defaults to 180.
    • Max run-time: The number of seconds the task will be locked, with Taken.
    • Concurrency: The number of tasks from the group that may be executed at the same time.

    Note

    When contacting Acquia Support about a task, be sure to include the ID or the Object ID.

  3. To view detailed logs for a task, click its Actions menu, and then click View Logs.

Pausing or terminating tasks

If necessary, you can pause or end tasks to help you reconcile or troubleshoot issues. To pause or end a task from the Acquia Cloud Site Factory interface, complete the following steps:

  1. Go to the Task log settings webpage.

  2. In the At a Glance section, click the In Progress link.

    The In Progress link can be found in the At A Glance section

  3. Identify the task you want to pause or end.

  4. Click the task’s Actions menu, and then click either Pause or Terminate, based on your needs.

    The Actions select box, displaying all available actions

  5. Depending on the action you are attempting to complete, use the appropriate process from the following list:

    • Pausing a task: In the Reason field, enter a reason for pausing the task, and then click Pause. Acquia Cloud Site Factory will add the reason to the action’s audit log entry.
    • Terminating a task: In the confirmation window that appears, click Ok.

Important

Terminating a task can cause unpredictable results up to and including data loss. Contact Acquia Support if you need help.

Restarting tasks

If a task failure was due to a temporary issue, failed tasks may provide a Restart option. Restarting a task will repeat the actions performed in the original task.

Important

Restarting a failed task may cause unpredictable results, up to and including data loss. Contact Acquia Support if you need help.

To restart a task from the Acquia Cloud Site Factory interface, complete the following steps:

  1. Go to the Task log settings webpage.

  2. In the At a Glance section, click the In Progress link.

    The In Progress link can be found in the At A Glance section

  3. Identify the task you want to restart.

  4. Click the task’s Actions menu, and then click Unpause:

    The Actions select box with options (including Unpause) displayed

  5. In the confirmation window that appears, click Ok.

Soft-paused tasks

If tasks are in progress at the beginning of a maintenance window, Acquia Cloud Site Factory will soft-pause the tasks until the maintenance work is complete, allowing current tasks to complete without allowing other tasks to start until the soft-pause is removed. When tasks are soft-paused, a message will display at the top of the webpage when signing in to the Site Factory Management Console, such as the following:

The following classes are currently soft paused:Acquia\SfBackup\SiteArchiveD8,
Acquia\SfBackup\SiteArchiveV2, Acquia\SfBackup\SiteArchiveV2D8,
Acquia\SfBackup\SiteRestoreD8, Acquia\SfSiteCollection\SiteGuardSite,
Acquia\SfSiteCollection\SiteGuardSiteCollection, Acquia\SfSite\DomainModifyV2,
Acquia\SfSite\SiteDuplicateD8, Acquia\SfSite\SiteInstallD8.

Soft-paused tasks will start after maintenance is complete. For more information about a soft-paused task, or if you need help restarting a soft-paused task, contact Acquia Support.