Overview
Connect GitHub to see your organization's DevOps performance metrics in minutes—with no need for setup or services.
Over 250,000 developers at companies including Microsoft, Google, and GitHub are part of the Software.com ecosystem. By collecting data across the stack, we provide insights to engineering teams that help them measure and improve their DevOps performance.
When you sign up for a Software.com account and connect to GitHub, you will get access to your team’s key DevOps performance metrics, including delivery lead time and release frequency.
With our global DevOps benchmarks, you can see how your team compares to high performing engineering organizations and track your progress against other companies in the market.
With custom dashboards, you can create your own overview with our extensive library of visualizations. You can also schedule emails to deliver your custom dashboards directly to your inbox every day, week, or month.
The Software.com platform also integrates with other tools, such as code editors, Google Calendar, Microsoft Outlook, and collaboration tools like Slack, providing you with a more complete view of software development.
Connecting GitHub
Getting started with our GitHub integration is fast and easy. It only takes a few minutes and requires no commitment from your team.
If your GitHub organization has app access restrictions enabled, an Owner or App Manager must connect GitHub. Third-party app restrictions are enabled by default for all new GitHub organizations.
Once you connect, it will take about 5 minutes to process your data. When your data is done processing, you will get an email and an in-app notification that your DevOps metrics are ready.
Installation Troubleshooting
Having trouble? Follow these steps.
- Check that Software has not already been installed for your GitHub organization. Since an app can only be installed once per GitHub organization, we only support one Software organization per GitHub organization.
- Check that you have the right permissions. Members and Contributors will not be able to connect to GitHub. Only Owners and App Managers.
- Check that the app installation is not pending. Go to your organization's settings and click on Installed GitHub Apps. You will see a section of Pending GitHub Apps installation requests. If you're an Owner or App Manager, grant access to the Software app if it is pending.
- If none of the above works, please contact us at support@software.com.
Data We Collect
When you install the Software app on your GitHub organization, you will be able to see 7 days of data in just a few minutes. Within an hour, we backfill up to 90 days of history from GitHub so you can explore more of your historical DevOps performance.
Our GitHub integration only collects metadata about your organization’s activity. We never read, transmit, or store source code.
Some of the APIs we request permissions to access include:
- Repository contents (includes commits), pull requests, and issues
- Organization members and projects
After the initial sync, our app subscribes to ongoing GitHub webhook events to provide you with real-time insights. Some examples of the events that we subscribe to include:
- Push
- Pull request
- Pull request review
- Pull request comment
- Release
All of our permissions are read-only and we only request the permissions we need to build your organization's analytics dashboards.
When we update our app permissions, which we may do on a periodic basis as we add new features, you will receive a notification from GitHub with a note from us explaining the reason for the change.
Data Privacy and Security
Data privacy and security is our top priority. We've summarized a few important points below, but we also encourage you to check out our policy on data privacy and security.
- Individual data is always private. We're not building spyware. We believe that data should be used to build trust, not to destroy it.
- All of your organization's sensitive information is hashed and encrypted. That includes your organization's name, repository names, branch names, and anything else that is sensitive information.
- We do not read or store your code. We process events from GitHub such as pushes, pull requests, and issues. You can see the data in these event payloads in GitHub's API documentation.
- You can revoke access to our GitHub App at any time in the Installed GitHub Apps page in your organization settings. You have full control.
- Your data is stored in a highly-secure environment with strict access privileges, full audit logs, and end-to-end encryption.
Common Questions
How is Software different from analytics provided by GitHub, BitBucket, etc.?
Our platform helps you turn insight into action to improve the developer experience in your organization. Most out-of-the-box Git analytics solutions only provide basic metrics, usually per repository. We provide a 360-degree view across all repositories in your organization. We also integrate with other tools, such as code editors, providing more robust system-level insights across the stack.
How much does it cost?
Software offers a free Starter plan with up to 90 days of history and a paid Pro plan ($20 per developer per month) with unlimited data retention and advanced features, like custom dashboards and alerts. Learn more about our pricing.
Are there team size limits?
No. You can invite as many team members as you want. Certain data sources, such as Code Time, require at least 5 members before you will see data to protect developer privacy. GitHub does not require a minimum team size.
Data is always anonymized before it is aggregated.
What if I am already on a Software team?
You can connect GitHub to any organization at any time.
Do you support on-premise deployments?
No, we currently do not offer on-premise deployments.
How do I delete my data?
Send us an email at support@software.com with the subject line "Data Deletion Request."
