Document toolboxDocument toolbox

This article is for Timesheets for Cloud. Visit Data Center

Tempo Time Tracking for GitHub

Integrating GitHub and Timesheets by Tempo populates the Activities Feed in My Work with potential worklogs based on actions performed with GitHub. This allows team members to log the time they spend working on code quickly without needing to track their time manually.

The app reads data from the following events, captured through GitHub’s webhooks:

  • Create

  • Push

  • Commit

  • Pull Request

The data is used to associate the work with a Jira issue and to estimate how much time is spent working on coding tasks for the issue.

A GitHub admin must add the Tempo Time Tracking app to their GitHub organization. They can restrict the app to specific repositories or allow time tracking in all of the code bases. Members of the organization can then connect their accounts so their time can be tracked. Tempo Administrators can also enable time tracking in GitHub on behalf of team members.

We recommend that you include the Jira issue key in your commit messages to ensure that the app associates the work with the correct issue.

Before you begin

Connect Your GitHub Account

  1. Navigate to My Work.

  2. Open the Settings menu.

    ts-mywork-settings.jpg
  3. Under Activities, select Settings.

  4. Click the Edit icon next to GitHub.

    ts-provider-github.jpg
  5. When prompted, click Connect GitHub Account.

    You may be prompted to log in to your GitHub account.

  6. After you authenticate your account, you are prompted to authorize the Tempo Time Tracking app.

Your Activity Feed can now be populated with actions you perform with GitHub.

Verify Your Connection

  1. Navigate to My Work.

  2. Open the Settings menu, and select Settings.

  3. Click the Edit icon next to GitHub.

  4. The GitHub connection page displays your status if you’re connected.

Update Access

  1. Navigate to My Work.

  2. Open the Settings menu, and select Settings.

  3. Click the Edit icon next to GitHub.

  4. In the GitHub connection page, click Configure.

  5. Click Configure next to your organization.

  6. Authenticate your GitHub account.

  7. Modify the repositories that Tempo Time Tracking can access.

    1. If you want to leave the repository access as it is, close the browser window.

  8. When complete, update your access.

Disconnect Your Account

  1. Navigate to My Work.

  2. Open the Settings menu, and select Settings.

  3. Click the Edit icon next to GitHub.

  4. Click Disconnect.

After you’ve disconnected your account from GitHub, activities you perform with GitHub are no longer tracked and don’t appear in your Activities Feed. Worklogs you’ve created from a GitHub activity remain, but the activities are removed from your feed.