Manage and Monitor Bots from the Log Navigator

The log navigator provides access to information about your bots and the integrations they’ve performed. You can edit, delete, and create bots from the log navigator, and you can initiate and cancel any of their integrations. By selecting bots and their integrations in the log viewer, you can view information about them in the editor area of the Xcode workspace, where you can also edit and delete a bot, initiate an integration, and download its archives.

Manage Bots in the Log Navigator

In Xcode on your development Mac, choose View > Navigators > Show Log Navigator. Click By Group to see status information gathered under each of the bots. Control-click a bot to display a shortcut menu that allows you to:

You can also create a bot from the shortcut menu in the log navigator.

Monitor and Manage Bots in the Bot Viewer

You can view summaries of a bot’s integrations by selecting it in the log navigator.

To view a summary of integration results for a bot

  1. Click By Group at the top of the log navigator.

    Status information is gathered for each of the bots.

  2. Select the bot whose integrations you want to view.

    In the editor area of the workspace window, the bot viewer displays a summary of the integrations it has performed along with any build errors and warnings, static analyzer problems, and unit test failures.

    ../art/bot_viewer-summary_2x.png

You can perform these operations in the bot viewer:

In the editor area, the Summary pane of the bot viewer displays these elements:

The Tests pane of the bot viewer provides a tabulated list of the unit test results.

../art/bot_viewer-tests_2x.png

The Tests pane displays these elements:

Review Integration Details in the Integration Viewer

You can view details about an integration by selecting it in the log navigator.

To view details about an integration

  1. Click By Group at the top of the log navigator.

    Status information is collapsed under each of the bots.

  2. Select the bot whose integrations you want to view.

  3. Click the disclosure triangle to the left of the bot to display its integrations.

    You can quickly check the status of an integration. To the right of each integration listed in the log navigator, Xcode displays an icon that indicates whether there was an error, a warning, a static analysis issue, or an integration failure.

  4. Select a specific integration.

    In the editor area of the workspace window, the integration viewer displays a summary of the integration’s results.

    The number of errors, warnings, static analysis issues, and test-case failures for that integration are summarized in the Integration Results section. The Integration Details section provides details about each of the integration issues. If the integration contains errors, warnings, static analysis issues, or test failures, click Tests or Logs to view their details.

    ../art/integration_viewer-summary_2x.png
  5. Click Tests to view a list of unit tests and their pass or fail status.

    If you have multiple test devices, you can compare their results across columns.

    ../art/integration_viewer-tests_2x.png../art/integration_viewer-tests_2x.png
  6. Click Commits to view details about the new commits included in the integration.

    By clicking the “Show modified files” button, you can view the files that are part of the commit.

  7. Click Logs to view the logs of the actions that are part of the integration.

    ../art/integration_viewer-logs_2x.png../art/integration_viewer-logs_2x.png