Overview
Connect GitHub to visualize your organization's development data in minutes—with no need for setup or services.
Over 700,000 developers at companies around the world are part of the Software.com ecosystem. By collecting data across the stack, we provide insights to engineering teams that help them identify bottlenecks, remove blockers, and measure improvement over time.
How to connect GitHub
When you install the Software.com app to your GitHub organization, you will be able to see two weeks of data in just a few minutes. We continue to backfill your last three months of history over the next 30 minutes. When your data is done processing, you will get an email and an in-app notification that your data is ready to view.
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.
Installation Troubleshooting
Having trouble? Follow these steps.
- Check that Software.com 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.com 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.com app if it is pending.
- If none of the above works, please contact us at support@software.com.
Data we collect
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, deployment
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.com 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 Jira and Slack, improving productivity with better visibility and automation.
How does pricing work?
Software offers a free Starter plan with visibility into key metrics and a paid Business plan with advanced features, like comparisons and GitHub Copilot telemetry. A subscription to the Business plan is required to use our integrations for Jira and Slack.
You can get started with a free trial of the Business plan, no credit card required. Learn more about our pricing.
Is there a limit to how many members of my team I can invite to Software.com?
No. You can invite as many team members as you want without any additional cost. Our pricing model is based on the size of your GitHub organization.
How do I delete my data?
Send us an email at support@software.com with the subject line "Data Deletion Request."