...
Integrating GitHub and Timesheets by Tempo
...
Timesheets by Tempo lets you log your time faster in Jira by using your GitHub activity to provide suggestions in Timesheets.
When you commit or checkout with git, the Tempo Time Tracking Extension posts an event to the Tempo API containing the current branch name and timestamp. If you commit files, a commit message is also posted.
This activity feed records the time you spend on coding activities and any changes made to files in your git repositories, leading to better suggestions for logging time in Tempo Timesheets.
| Tip |
|---|
We recommend including an issue key in the branch name or the commit message. |
Before you begin
You must have one of the following roles in your GitHub organization:
The app manager role or
An organization owner role
Install Tempo Time Tracking on GitHub
Select Apps in the Tempo sidebar.
In the GitHub Integration tile, click Install. You are redirected to the GitHub Marketplace to install the app.
Follow the onscreen directions to install the Tempo Time Tracking app in GitHub.
When installed, individuals in your organization can connect to GitHub in their My Work settings to link their GitHub and Tempo accounts and receive suggestions based on their GitHub activities. See Connecting and Disconnecting Your Activity Providers for more informationpopulates 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
The Tempo Time Tracking app must be installed in GitHub for the organization.
You must have a GitHub account that is part of your organization.
Connect Your GitHub Account
Navigate to My Work.
Open the Settings menu.
Under Activities, select Settings.
Click the Edit icon next to GitHub.
When prompted, click Connect GitHub Account.
You may be prompted to log in to your GitHub account.
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
Navigate to My Work.
Open the Settings menu, and select Settings.
Click the Edit icon next to GitHub.
The GitHub connection page displays your status if you’re connected.
Update Access
Navigate to My Work.
Open the Settings menu, and select Settings.
Click the Edit icon next to GitHub.
In the GitHub connection page, click Configure.
Click Configure next to your organization.
Authenticate your GitHub account.
Modify the repositories that Tempo Time Tracking can access.
If you want to leave the repository access as it is, close the browser window.
When complete, update your access.
Disconnect Your Account
Navigate to My Work.
Open the Settings menu, and select Settings.
Click the Edit icon next to GitHub.
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.