This commit is contained in:
Laura Coursen 2021-08-25 13:36:35 -05:00 коммит произвёл GitHub
Родитель 9ac8edc6c4
Коммит 60b0d95f0d
Не найден ключ, соответствующий данной подписи
Идентификатор ключа GPG: 4AEE18F83AFDEB23
387 изменённых файлов: 76 добавлений и 10280 удалений

Двоичные данные
assets/images/help/insights/add-button.png

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 15 KiB

Двоичные данные
assets/images/help/insights/add-event.png

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 3.5 KiB

Двоичные данные
assets/images/help/insights/add-filter.png

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 8.3 KiB

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 15 KiB

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 13 KiB

Двоичные данные
assets/images/help/insights/app-id.png

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 3.6 KiB

Двоичные данные
assets/images/help/insights/auto-merge.png

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 15 KiB

Двоичные данные
assets/images/help/insights/cancel-button.png

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 20 KiB

Двоичные данные
assets/images/help/insights/choose-files.png

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 5.9 KiB

Двоичные данные
assets/images/help/insights/client-id.png

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 3.8 KiB

Двоичные данные
assets/images/help/insights/client-secret.png

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 4.4 KiB

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 5.8 KiB

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 8.5 KiB

Двоичные данные
assets/images/help/insights/contributors-tab.png

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 9.4 KiB

Двоичные данные
assets/images/help/insights/create-group.png

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 8.6 KiB

Двоичные данные
assets/images/help/insights/create-team.png

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 4.9 KiB

Двоичные данные
assets/images/help/insights/delete-group.png

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 11 KiB

Двоичные данные
assets/images/help/insights/delete-team.png

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 4.1 KiB

Двоичные данные
assets/images/help/insights/edit-contributor.png

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 5.7 KiB

Двоичные данные
assets/images/help/insights/edit-goal.png

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 15 KiB

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 6.4 KiB

Двоичные данные
assets/images/help/insights/edit-team.png

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 6.9 KiB

Двоичные данные
assets/images/help/insights/end-date.png

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 4.8 KiB

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 5.5 KiB

Двоичные данные
assets/images/help/insights/enterprise-tab.png

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 9.3 KiB

Двоичные данные
assets/images/help/insights/event-circles.png

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 16 KiB

Двоичные данные
assets/images/help/insights/events-tab.png

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 9.4 KiB

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 9.9 KiB

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 9.2 KiB

Двоичные данные
assets/images/help/insights/first-name.png

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 6.6 KiB

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 12 KiB

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 80 KiB

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 4.5 KiB

Двоичные данные
assets/images/help/insights/group-name.png

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 6.1 KiB

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 8.3 KiB

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 2.7 KiB

Двоичные данные
assets/images/help/insights/input-goal.png

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 16 KiB

Двоичные данные
assets/images/help/insights/installation-tgz.png

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 9.2 KiB

Двоичные данные
assets/images/help/insights/key-metrics-list.png

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 7.2 KiB

Двоичные данные
assets/images/help/insights/key-metrics-tab.png

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 5.4 KiB

Двоичные данные
assets/images/help/insights/last-name.png

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 6.9 KiB

Двоичные данные
assets/images/help/insights/merge-button.png

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 16 KiB

Двоичные данные
assets/images/help/insights/private-key.png

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 8.8 KiB

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 5.5 KiB

Двоичные данные
assets/images/help/insights/refresh-button.png

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 7.4 KiB

Двоичные данные
assets/images/help/insights/remove-button.png

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 7.5 KiB

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 6.5 KiB

Двоичные данные
assets/images/help/insights/rename-team.png

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 6.8 KiB

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 5.0 KiB

Двоичные данные
assets/images/help/insights/repo-groups-tab.png

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 10 KiB

Двоичные данные
assets/images/help/insights/reports-list.png

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 4.8 KiB

Двоичные данные
assets/images/help/insights/reports-tab.png

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 5.6 KiB

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 9.2 KiB

Двоичные данные
assets/images/help/insights/repositories-tab.png

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 9.8 KiB

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 6.9 KiB

Двоичные данные
assets/images/help/insights/save-goal.png

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 17 KiB

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 8.1 KiB

Двоичные данные
assets/images/help/insights/select-primary.png

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 8.0 KiB

Двоичные данные
assets/images/help/insights/select-repos.png

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 12 KiB

Двоичные данные
assets/images/help/insights/settings-tab.png

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 5.5 KiB

Двоичные данные
assets/images/help/insights/show-contributor.png

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 10 KiB

Двоичные данные
assets/images/help/insights/skip-contributor.png

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 8.1 KiB

Двоичные данные
assets/images/help/insights/skip-ssl.png

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 8.9 KiB

Двоичные данные
assets/images/help/insights/start-date.png

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 4.7 KiB

Двоичные данные
assets/images/help/insights/team-name.png

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 5.5 KiB

Двоичные данные
assets/images/help/insights/teams-tab.png

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 9.4 KiB

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 9.8 KiB

Двоичные данные
assets/images/help/insights/title-field.png

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 3.6 KiB

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 8.1 KiB

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 9.2 KiB

Двоичные данные
assets/images/help/insights/trashcan-button.png

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 2.8 KiB

Двоичные данные
assets/images/help/insights/uninstall-button.png

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 9.7 KiB

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 6.0 KiB

Двоичные данные
assets/images/help/insights/webhook-secret.png

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 6.6 KiB

Просмотреть файл

@ -2,6 +2,66 @@
title: Enterprise administrator documentation
shortTitle: Enterprise administrators
intro: 'Documentation and guides for enterprise administrators, system administrators, and security specialists who {% ifversion ghes %}deploy, {% endif %}configure{% ifversion ghes %},{% endif %} and manage {% data variables.product.product_name %}.'
redirect_from:
- /github/installing-and-configuring-github-insights/exploring-your-usage-of-github-enterprise
- /github/installing-and-configuring-github-insights/metrics-available-with-github-insights
- /github/installing-and-configuring-github-insights/key-metrics-for-collaboration-in-pull-requests
- /github/installing-and-configuring-github-insights/viewing-and-filtering-key-metrics-and-reports
- /github/installing-and-configuring-github-insights/github-insights-and-data-protection-for-your-organization
- /enterprise-server@2.22/github/site-policy/github-insights-and-data-protection-for-your-organization
- /enterprise-server@2.21/github/site-policy/github-insights-and-data-protection-for-your-organization
- /enterprise-server@2.20/github/site-policy/github-insights-and-data-protection-for-your-organization
- /insights/installing-and-configuring-github-insights/configuring-the-connection-between-github-insights-and-github-enterprise
- /github/installing-and-configuring-github-insights/navigating-between-github-insights-and-github-enterprise
- /github/installing-and-configuring-github-insights/enabling-a-link-between-github-insights-and-github-enterprise
- /insights/installing-and-configuring-github-insights/enabling-a-link-between-github-insights-and-github-enterprise
- /insights/installing-and-configuring-github-insights/managing-permissions-in-github-insights
- /github/installing-and-configuring-github-insights/about-github-insights
- /insights/installing-and-configuring-github-insights/about-github-insights
- /github/installing-and-configuring-github-insights/installing-github-insights
- /insights/installing-and-configuring-github-insights/installing-github-insights
- /github/installing-and-configuring-github-insights/system-overview-for-github-insights
- /insights/installing-and-configuring-github-insights/system-overview-for-github-insights
- /github/installing-and-configuring-github-insights/updating-github-insights
- /insights/installing-and-configuring-github-insights/updating-github-insights
- /insights/installing-and-configuring-github-insights/about-data-in-github-insights
- /github/installing-and-configuring-github-insights/managing-data-in-github-insights
- /github/installing-and-configuring-github-insights/managing-settings-in-github-insights
- /insights/installing-and-configuring-github-insights/managing-available-metrics-and-reports
- /github/installing-and-configuring-github-insights/managing-contributors-and-teams
- /insights/installing-and-configuring-github-insights/managing-contributors-and-teams
- /github/installing-and-configuring-github-insights/creating-and-managing-events
- /insights/installing-and-configuring-github-insights/managing-events
- /github/installing-and-configuring-github-insights/creating-and-managing-goals
- /insights/installing-and-configuring-github-insights/managing-goals
- /github/installing-and-configuring-github-insights/managing-organizations
- /insights/installing-and-configuring-github-insights/managing-organizations
- /github/installing-and-configuring-github-insights/managing-repositories
- /insights/installing-and-configuring-github-insights/managing-repositories
- /insights/exploring-your-usage-of-github-enterprise
- /insights/exploring-your-usage-of-github-enterprise/metrics-available-with-github-insights
- /insights/exploring-your-usage-of-github-enterprise/navigating-between-github-enterprise-and-github-insights
- /insights/exploring-your-usage-of-github-enterprise/setting-your-timezone-for-github-insights
- /insights/exploring-your-usage-of-github-enterprise/viewing-key-metrics-and-reports
- /insights
- /insights/installing-and-configuring-github-insights/configuring-github-insights/configuring-the-connection-between-github-insights-and-github-enterprise
- /insights/installing-and-configuring-github-insights/configuring-github-insights/enabling-a-link-between-github-insights-and-github-enterprise
- /insights/installing-and-configuring-github-insights/configuring-github-insights
- /insights/installing-and-configuring-github-insights/configuring-github-insights/managing-permissions-in-github-insights
- /insights/installing-and-configuring-github-insights
- /insights/installing-and-configuring-github-insights/installing-and-updating-github-insights/about-github-insights
- /insights/installing-and-configuring-github-insights/installing-and-updating-github-insights
- /insights/installing-and-configuring-github-insights/installing-and-updating-github-insights/installing-github-insights
- /insights/installing-and-configuring-github-insights/installing-and-updating-github-insights/system-overview-for-github-insights
- /insights/installing-and-configuring-github-insights/installing-and-updating-github-insights/updating-github-insights
- /insights/installing-and-configuring-github-insights/managing-data-in-github-insights/about-data-in-github-insights
- /insights/installing-and-configuring-github-insights/managing-data-in-github-insights
- /insights/installing-and-configuring-github-insights/managing-data-in-github-insights/managing-available-metrics-and-reports
- /insights/installing-and-configuring-github-insights/managing-data-in-github-insights/managing-contributors-and-teams
- /insights/installing-and-configuring-github-insights/managing-data-in-github-insights/managing-events
- /insights/installing-and-configuring-github-insights/managing-data-in-github-insights/managing-goals
- /insights/installing-and-configuring-github-insights/managing-data-in-github-insights/managing-organizations
- /insights/installing-and-configuring-github-insights/managing-data-in-github-insights/managing-repositories
introLinks:
overview: '{% ifversion ghes %}/admin/overview/system-overview{% elsif ghae %}/admin/overview/about-github-ae{% endif %}'
changelog:

Просмотреть файл

@ -25,10 +25,6 @@ The Activity dashboard provides weekly, monthly, and yearly graphs of the number
![Activity dashboard](/assets/images/enterprise/activity/activity-dashboard-yearly.png)
{% ifversion ghes %}
For more analytics based on data from {% data variables.product.product_name %}, you can purchase {% data variables.product.prodname_insights %}. For more information, see "[About {% data variables.product.prodname_insights %}](/insights/installing-and-configuring-github-insights/about-github-insights)."
{% endif %}
## Accessing the Activity dashboard
1. At the top of any page, click **Explore**.

Просмотреть файл

@ -108,12 +108,9 @@ For more information on enabling and configuring {% data variables.product.prodn
{% data reusables.getting-started.github-pages-enterprise %}
## Part 5: Connecting with other {% data variables.product.prodname_dotcom %} resources
You can use {% data variables.product.prodname_github_connect %} and {% data variables.product.prodname_insights %} to share resources and understand and improve your processes.
You can use {% data variables.product.prodname_github_connect %} to share resources.
### 1. Enabling {% data variables.product.prodname_github_connect %}
If you are the owner of both a {% data variables.product.product_name %} instance and a {% data variables.product.prodname_ghe_cloud %} organization or enterprise account, you can enable {% data variables.product.prodname_github_connect %}. {% data variables.product.prodname_github_connect %} allows you to share specific workflows and features between {% data variables.product.product_location %} and {% data variables.product.prodname_ghe_cloud %}, such as unified search and contributions. For more information, see "[Connecting {% data variables.product.prodname_ghe_server %} to {% data variables.product.prodname_ghe_cloud %}](/admin/configuration/managing-connections-between-github-enterprise-server-and-github-enterprise-cloud/connecting-github-enterprise-server-to-github-enterprise-cloud)."
### 2. Using {% data variables.product.prodname_insights %}
{% data variables.product.prodname_insights %} is a standalone application that provides analytic reports and metrics based on data from {% data variables.product.product_location %}. You can use these reports to understand and improve your software delivery process. For more information, see "[About {% data variables.product.prodname_insights %}](/insights/installing-and-configuring-github-insights/installing-and-updating-github-insights/about-github-insights)."
## Part 6: Using {% data variables.product.prodname_dotcom %}'s learning and support resources
Your enterprise members can learn more about Git and {% data variables.product.prodname_dotcom %} with our learning resources, and you can get the support you need when setting up and managing {% data variables.product.product_location %} with {% data variables.product.prodname_dotcom %} Enterprise Support.

Просмотреть файл

@ -1,48 +0,0 @@
---
title: GitHub Insights and data protection for your organization
intro: '{% data variables.product.prodname_insights %} analyzes your {% data variables.product.prodname_ghe_server %} data. This data could include personal data of individuals in your organization who may have the right to understand how such personal data is being used.'
redirect_from:
- /github/installing-and-configuring-github-insights/github-insights-and-data-protection-for-your-organization
- /enterprise-server@2.22/github/site-policy/github-insights-and-data-protection-for-your-organization
- /enterprise-server@2.21/github/site-policy/github-insights-and-data-protection-for-your-organization
- /enterprise-server@2.20/github/site-policy/github-insights-and-data-protection-for-your-organization
versions:
fpt: '*'
topics:
- Policy
- Legal
---
For the avoidance of doubt, none of the foregoing information should be considered legal advice provided by {% data variables.product.prodname_dotcom %}. You are responsible for securing your own legal analysis of the information provided herein and for your compliance with privacy and data protection laws. It is up to you whether to use {% data variables.product.prodname_insights %} to process your employees and users data, and if you do so, you are solely responsible for conducting such processing in compliance with applicable law.
## The organizations roles and responsibilities
When using {% data variables.product.prodname_insights %}, your organization is the data controller because your organization determines whether, how, and why {% data variables.product.prodname_insights %} will process any individuals personal data. Your organization is solely responsible for ensuring that you are complying with all applicable laws in processing data with {% data variables.product.prodname_insights %}.
## Data privacy recommendations
You have full control over which metrics, reports, repositories, and contributors to include before beginning use of {% data variables.product.prodname_insights %}. The data you process with {% data variables.product.prodname_insights %} can only be pulled from your installation of {% data variables.product.prodname_ghe_server %}. Consider balancing the risks versus the benefits of analyzing personal data.
- **Develop a clear analysis plan**: You must understand clearly what you want to analyze and why, and then consider how {% data variables.product.prodname_insights %} may help you find those answers.
- **Consider a data protection impact assessment**: If your proposed use of {% data variables.product.prodname_insights %} involves processing personal data, consider completing a data protection impact assessment or otherwise completing formal legal analysis of your planned use.
## Decide what data to use
- **Decide which repositories to include**: Before you start an analysis in {% data variables.product.prodname_insights %}, consider which repositories to include. Administrators can include repositories when adding organizations and can enable and disable repositories at any time. For more information on adding organizations to {% data variables.product.prodname_insights %}, see "[Managing organizations](/insights/installing-and-configuring-github-insights/managing-organizations)." For more information on enabling and disabling repositories, see "[Managing repositories](/insights/installing-and-configuring-github-insights/managing-repositories)."
- **Decide which metrics and reports to include**: Administrators can enable and disable metrics and reports available for all users at any time. Administrators control the {% data variables.product.prodname_insights %} data that users have access to in your installation of {% data variables.product.prodname_ghe_server %}. For more information, see "[Managing available metrics and reports](/insights/installing-and-configuring-github-insights/managing-available-metrics-and-reports)."
- **Decide which contributors to include**: Administrators can disable a specific contributors data from being processed in the metrics and reports. For more information on managing contributor data, see "[Managing contributors and teams](/insights/installing-and-configuring-github-insights/managing-contributors-and-teams)."
## User rights
Under various data protection regulations, such as the General Data Protection Regulation (GDPR), users may have the right to request exclusion from processing, access, and correction, or to request deletion of their personal data. As the data controller, your organization should evaluate whether a particular user request is valid and, if appropriate, take action to fulfill the request.
- **Exclusion of processing**: Users may have the right to have their personal data excluded from being processed. Administrators have the ability to remove a contributors data from being processed in {% data variables.product.prodname_insights %}, and the resulting reports and metrics will exclude the contributors data accordingly. For more information, see "[Managing contributors and teams](/insights/installing-and-configuring-github-insights/managing-contributors-and-teams)."
- **Access**: Users may have the right to demand to see what personal data is being processed. Each metric and report has a detailed description of what personal data is being processed. For more information, see "[Metrics available with {% data variables.product.prodname_insights %}](/insights/exploring-your-usage-of-github-enterprise/metrics-available-with-github-insights)." Raw data is available through the {% data variables.product.prodname_enterprise %} API. Your organization is responsible for any decisions to process personal data and for fulfilling any such requests.
- **Correction and deletion**: Users may have the right to rectify or delete their personal data. The data used in {% data variables.product.prodname_insights %} is derived from the existing data you add to or generate from your {% data variables.product.prodname_ghe_server %} installation. Correction and deletion should follow your organization's existing process to correct and delete data from {% data variables.product.prodname_ghe_server %}.
- **Transparency regarding processing**: Each metric and report has a detailed description of what personal data is being processed. For more information, see "[Metrics available with {% data variables.product.prodname_insights %}](/insights/exploring-your-usage-of-github-enterprise/metrics-available-with-github-insights)."

Просмотреть файл

@ -14,7 +14,6 @@ children:
- /github-privacy-statement
- /github-data-protection-agreement-non-enterprise-customers
- /global-privacy-practices
- /github-insights-and-data-protection-for-your-organization
- /github-sponsors-additional-terms
- /github-codespaces-privacy-statement
- /github-terms-for-additional-products-and-features

Просмотреть файл

@ -29,7 +29,6 @@ children:
- rest
- graphql
- github-cli
- insights
- discussions
- sponsors
- communities

Просмотреть файл

@ -1,15 +0,0 @@
---
title: Exploring your usage of GitHub Enterprise
shortTitle: Exploring your usage
intro: You can use metrics and reports to understand and improve your software delivery process through data.
redirect_from:
- /github/installing-and-configuring-github-insights/exploring-your-usage-of-github-enterprise
versions:
ghes: '*'
children:
- /metrics-available-with-github-insights
- /viewing-key-metrics-and-reports
- /setting-your-timezone-for-github-insights
- /navigating-between-github-enterprise-and-github-insights
---

Просмотреть файл

@ -1,76 +0,0 @@
---
title: Metrics available with GitHub Insights
intro: '{% data variables.product.prodname_insights %} includes a variety of metrics to give you visibility into your team''s software delivery process.'
redirect_from:
- /github/installing-and-configuring-github-insights/metrics-available-with-github-insights
- /github/installing-and-configuring-github-insights/key-metrics-for-collaboration-in-pull-requests
versions:
ghes: '*'
shortTitle: Metrics in GitHub Insights
---
## About metrics in {% data variables.product.prodname_insights %}
{% data reusables.github-insights.key-metrics-and-reports %}
{% data reusables.github-insights.about-key-metrics %} You can set and measure goals for each key metric. For more information, see "[Managing goals](/insights/installing-and-configuring-github-insights/managing-goals)."
{% data reusables.github-insights.about-reports %}
{% data reusables.github-insights.manage-metrics %}
## Key metrics for collaboration in pull requests
Key metrics for collaboration in pull requests help teams remove bottlenecks in process, improve collaboration, and deliver projects faster, with higher quality. Improving these metrics results in a more productive team.
- [Code review distribution](#code-review-distribution)
- [Code review turnaround](#code-review-turnaround)
- [Time to open](#time-to-open)
- [Pull request size](#pull-request-size)
- [Work in progress](#work-in-progress)
### Code review distribution
Measures the distribution of code reviews across a team or organization. A value closer to 1 indicates a more equal distribution. Includes members who have previously opened, reviewed, or commented on a pull request, or committed to a branch.
The index is equal to 1 minus the Gini coefficient of code reviews for an organization or team. For more information, see [Gini coefficient](https://en.wikipedia.org/wiki/Gini_coefficient) on Wikipedia.
### Code review turnaround
The time elapsed between a review assignment and a completed review.
To counteract code reviews as a blocker for teams, organizations can optimize their review assignment process and set goals for turnaround time.
### Time to open
The time elapsed between a user's first commit to a branch and opening a pull request for that branch.
Decreasing this period of time allows contributors to receive feedback earlier in the process and allows more time for collaboration and iteration.
### Pull request size
Total diff size of a pull request (total of lines added, removed, and changed).
Large pull requests carry more risk when deploying to production and are more difficult to review, merge, and release. Deploying pull requests of a reasonable size enables your team to review and ship new features at a faster cadence and with greater confidence
### Work in progress
The number of open pull requests for a given team or organization, expressed as a total as well as a ratio of open pull requests to developer.
A large pull request backlog means work may be out of date, indicating wasted effort from your team. This metric helps keep your team focused while ensuring no one on the team is blocked or overburdened.
## Reports
| Metric | Description |
| ------ | ----------- |
| Activity | An activity is any one of the following:<ul><li>Committing to a branch</li><li>Opening a pull request</li><li>Closing a pull request</li><li>Merging a pull request</li><li>Commenting on a pull request</li><li>Approving a pull request</li></ul> |
| Activity, hour | An hour with activity is any hour in which at least one contributor records an activity. |
| Churn code | Churn code is code changed within three weeks of being added or last changed. This includes lines of code that were overwritten by the author or by another contributor. |
| Lines of code added and changed | Total count of new lines of code added plus lines of code changed. You can include or exclude churn code. |
| Ownership | Percentage breakdown of lines of code added and changed by the last contributor to add or change each line of code. |
| Pairings | Contributors who modify or remove another contributor's code. |
| Percentage of codebase changed | Lines of code added or changed in the codebase as a percentage of total lines of code in the codebase. |
| Percentage of new and changed code vs churn code | Lines of code added and changed, excluding churn code, as a percentage of total lines of code added and changed, including churn code. |
| Pull requests open | The count of all pull requests which are open at the end of the period selected or the time interval displayed on the chart. |
| Retention | Percentage of lines of code persisting in the codebase after each week, grouped by the week the lines were created. |
| Time to merge | Time between the first commit on a branch and the merge action of a pull request on that branch. The timestamp of the first commit on a branch is subtracted from the timestamp on the merge action of the pull request. |

Просмотреть файл

@ -1,13 +0,0 @@
---
title: Navigating between GitHub Enterprise and GitHub Insights
intro: ''
permissions: 'Anyone with access to {% data variables.product.prodname_insights %} can navigate between {% data variables.product.prodname_enterprise %} and {% data variables.product.prodname_insights %}.'
versions:
ghes: '*'
shortTitle: GitHub Enterprise & Insights
---
Before you can navigate between {% data variables.product.prodname_enterprise %} and {% data variables.product.prodname_insights %}, a site administrator must enable a link between {% data variables.product.prodname_insights %} and {% data variables.product.prodname_enterprise %}. For more information, see "[Enabling a link between {% data variables.product.prodname_insights %} and {% data variables.product.prodname_enterprise %}](/insights/installing-and-configuring-github-insights/enabling-a-link-between-github-insights-and-github-enterprise)."
1. In the upper-right corner of any page, click your profile photo, then click **GitHub Insights**.
![Link to GitHub Insights](/assets/images/help/insights/github-insights-link.png)

Просмотреть файл

@ -1,15 +0,0 @@
---
title: Setting your timezone for GitHub Insights
intro: 'You can set the timezone for metrics you view in {% data variables.product.prodname_insights %}.'
permissions: 'Anyone with access to {% data variables.product.prodname_insights %} can set their own timezone.'
versions:
ghes: '*'
shortTitle: Set timezone GitHub Insights
---
Your timezone setting only affects how you see data in {% data variables.product.prodname_insights %}. The setting does not apply to other users.
{% data reusables.github-insights.settings-tab %}
2. Use the "Timezone" drop-down menu, and select your timezone.
![Timezone drop-down menu](/assets/images/help/insights/timezone-drop-down.png)
3. Click **Save Changes**.

Просмотреть файл

@ -1,43 +0,0 @@
---
title: Viewing key metrics and reports
intro: You can view and filter key metrics and reports to help you understand and improve your software delivery process through data.
redirect_from:
- /github/installing-and-configuring-github-insights/viewing-and-filtering-key-metrics-and-reports
permissions: 'Anyone with access to {% data variables.product.prodname_insights %} can view key metrics and reports.'
versions:
ghes: '*'
shortTitle: View metrics & reports
---
## About metrics and reports
{% data reusables.github-insights.key-metrics-and-reports %} For more information about available metrics, see "[Metrics available with {% data variables.product.prodname_insights %}](/insights/exploring-your-usage-of-github-enterprise/metrics-available-with-github-insights)."
You can view goals and success rates for each key metric. For more information, see "[Managing goals](/insights/installing-and-configuring-github-insights/managing-goals)"
You will only have access to the {% data variables.product.prodname_insights %} data which you also have access to in {% data variables.product.prodname_enterprise %}.
You can filter the data included in key metrics or reports by teams, repositories, or date range.
## Viewing key metrics
{% data reusables.github-insights.navigate-to-key-metrics %}
{% data reusables.github-insights.choose-key-metric %}
{% data reusables.github-insights.filter-reports %}
{% data reusables.github-insights.view-events %}
## Viewing reports
1. In {% data variables.product.prodname_insights %}, click **{% octicon "file" aria-label="The file icon" %} Reports**.
![Reports tab](/assets/images/help/insights/reports-tab.png)
2. Under **{% octicon "file" aria-label="The file icon" %} Reports**, click the name of the report you want to view.
![List of reports](/assets/images/help/insights/reports-list.png)
{% data reusables.github-insights.filter-reports %}
{% data reusables.github-insights.view-events %}
## Further reading
- "[Managing contributors and teams](/insights/installing-and-configuring-github-insights/managing-contributors-and-teams)"
- "[Managing repositories](/insights/installing-and-configuring-github-insights/managing-repositories)"
- "[Managing organizations](/insights/installing-and-configuring-github-insights/managing-organizations)"
- "[Managing events](/insights/installing-and-configuring-github-insights/managing-events)"

Просмотреть файл

@ -1,22 +0,0 @@
---
title: GitHub Insights Documentation
shortTitle: GitHub Insights
intro: 'Understand and improve your software delivery process through data with {% data variables.product.prodname_insights %}. You can view customized reports based on data from {% data variables.product.prodname_enterprise %}.'
featuredLinks:
gettingStarted:
- /insights/installing-and-configuring-github-insights/about-github-insights
- /insights/installing-and-configuring-github-insights/system-overview-for-github-insights
- /insights/installing-and-configuring-github-insights/installing-github-insights
- /insights/exploring-your-usage-of-github-enterprise/viewing-key-metrics-and-reports
popular:
- /insights/installing-and-configuring-github-insights/about-data-in-github-insights
- /insights/exploring-your-usage-of-github-enterprise/metrics-available-with-github-insights
redirect_from:
- /github/installing-and-configuring-github-insights
versions:
ghes: '*'
children:
- /installing-and-configuring-github-insights
- /exploring-your-usage-of-github-enterprise
---

Просмотреть файл

@ -1,23 +0,0 @@
---
title: Configuring the connection between GitHub Insights and GitHub Enterprise
intro: 'You can manage how {% data variables.product.prodname_insights %} connects to {% data variables.product.prodname_enterprise %}.'
permissions: 'People with admin permissions to {% data variables.product.prodname_insights %} can configure the connection to {% data variables.product.prodname_enterprise %}.'
versions:
ghes: '*'
redirect_from:
- /insights/installing-and-configuring-github-insights/configuring-the-connection-between-github-insights-and-github-enterprise
shortTitle: Connect Insights to Enterprise
---
{% data reusables.github-insights.settings-tab %}
2. Under {% octicon "gear" aria-label="The gear icon" %} Settings, click **Enterprise**.
![Enterprise tab](/assets/images/help/insights/enterprise-tab.png)
{% data reusables.github-insights.enterprise-api-url %}
{% data reusables.github-insights.app-id %}
{% data reusables.github-insights.client-id %}
{% data reusables.github-insights.client-secret %}
{% data reusables.github-insights.private-key %}
{% data reusables.github-insights.webhook-secret %}
{% data reusables.github-insights.skip-ssl %}
10. Click **Save**.
{% data reusables.github-insights.insights-license %}
11. Click **Update License**.

Просмотреть файл

@ -1,33 +0,0 @@
---
title: Enabling a link between GitHub Insights and GitHub Enterprise
intro: 'You can enable a link that will allow users to navigate from {% data variables.product.prodname_ghe_server %} to {% data variables.product.prodname_insights %}.'
permissions: 'Site administrators for {% data variables.product.prodname_ghe_server %} can enable a link between {% data variables.product.prodname_ghe_server %} and {% data variables.product.prodname_insights %}.'
redirect_from:
- /github/installing-and-configuring-github-insights/navigating-between-github-insights-and-github-enterprise
- /github/installing-and-configuring-github-insights/enabling-a-link-between-github-insights-and-github-enterprise
- /insights/installing-and-configuring-github-insights/enabling-a-link-between-github-insights-and-github-enterprise
versions:
ghes: '*'
shortTitle: Link Insights & Enterprise
---
After you enable the link, each user can navigate directly from {% data variables.product.prodname_ghe_server %} to {% data variables.product.prodname_insights %}. For more information, see "[Navigating between {% data variables.product.prodname_enterprise %} and {% data variables.product.prodname_insights %}](/insights/exploring-your-usage-of-github-enterprise/navigating-between-github-enterprise-and-github-insights)."
1. Connect to the administrative shell for {% data variables.product.prodname_ghe_server %}. For more information, see "[Accessing the administrative shell (SSH)](/enterprise/{{ currentVersion }}/admin/guides/installation/accessing-the-administrative-shell-ssh/)."
2. Run the following command.
```shell
ghe-config 'app.github.insights-available' 'true' && ghe-config-apply
```
3. Return to {% data variables.product.prodname_ghe_server %}.
{% data reusables.enterprise-accounts.access-enterprise %}
{% data reusables.enterprise-accounts.settings-tab %}
7. Under {% octicon "gear" aria-label="The Settings gear" %} **Settings**, click **{% data variables.product.prodname_insights %}**.
{% note %}
**Note:** It takes several minutes after you run the configuration command for this option to become available in {% data variables.product.prodname_enterprise %}. If you don't see **{% data variables.product.prodname_insights %}**, wait, or restart {% data variables.product.prodname_enterprise %}.
{% endnote %}
![{% data variables.product.prodname_insights %} tab](/assets/images/help/business-accounts/github-insights-tab.png)
3. Under "{% data variables.product.prodname_insights %} instance URL", type the URL of the server your company uses for {% data variables.product.prodname_insights %}.
![{% data variables.product.prodname_insights %} instance URL](/assets/images/help/business-accounts/insights-instance-url.png)
4. Click **Save**.

Просмотреть файл

@ -1,12 +0,0 @@
---
title: Configuring GitHub Insights
shortTitle: Configuring
intro: 'You can manage the connection between {% data variables.product.prodname_insights %} and {% data variables.product.prodname_enterprise %} and manage permissions for {% data variables.product.prodname_insights %} users.'
versions:
ghes: '*'
children:
- /configuring-the-connection-between-github-insights-and-github-enterprise
- /managing-permissions-in-github-insights
- /enabling-a-link-between-github-insights-and-github-enterprise
---

Просмотреть файл

@ -1,15 +0,0 @@
---
title: Managing permissions in GitHub Insights
intro: 'You can update a user''s permissions in {% data variables.product.prodname_insights %}.'
permissions: 'People with admin permissions to {% data variables.product.prodname_insights %} can manage permissions.'
versions:
ghes: '*'
redirect_from:
- /insights/installing-and-configuring-github-insights/managing-permissions-in-github-insights
shortTitle: Manage permissions in Insights
---
{% data reusables.github-insights.permissions-levels %}
If you want to give admin permissions to someone who is not a site administrator in {% data variables.product.prodname_enterprise %}, contact {% data variables.contact.github_support %}. For more information, see {% ifversion fpt %}"[Submitting a ticket](/github/working-with-github-support/submitting-a-ticket)."{% else %}"[Reaching {% data variables.contact.github_support %}](/enterprise/{{ currentVersion }}/admin/enterprise-support/reaching-github-support)."{% endif %}
To remove a user's access from {% data variables.product.prodname_insights %}, you must remove the user from {% data variables.product.prodname_enterprise %}.

Просмотреть файл

@ -1,12 +0,0 @@
---
title: Installing and configuring GitHub Insights
shortTitle: Installing and configuring
intro: You can start using GitHub Insights by installing and configuring the application.
versions:
ghes: '*'
children:
- /installing-and-updating-github-insights
- /configuring-github-insights
- /managing-data-in-github-insights
---

Просмотреть файл

@ -1,27 +0,0 @@
---
title: About GitHub Insights
intro: '{% data variables.product.prodname_insights %} provides metrics and analytical reports to help engineering teams understand and improve their software delivery process.'
redirect_from:
- /github/installing-and-configuring-github-insights/about-github-insights
- /insights/installing-and-configuring-github-insights/about-github-insights
versions:
ghes: '*'
---
## About {% data variables.product.prodname_insights %}
{% data variables.product.prodname_insights %} is a standalone application that provides analytic reports based on data from {% data variables.product.product_location %} to help you understand and improve your software delivery process. You can use these metrics to remove bottlenecks in process, improve collaboration, and deliver projects faster, with higher quality.
{% data variables.product.prodname_insights %} is hosted on a machine and interfaces with {% data variables.product.prodname_enterprise %}. For more information, see "[System overview for {% data variables.product.prodname_insights %}](/insights/installing-and-configuring-github-insights/system-overview-for-github-insights)."
Anyone with access to {% data variables.product.prodname_insights %} can view and interact with metrics, using team and repository filters to contextualize data. For more information, see "[Exploring your usage of {% data variables.product.prodname_enterprise %}](/insights/exploring-your-usage-of-github-enterprise)."
People with admin permissions to {% data variables.product.prodname_insights %} can choose which metrics are displayed and which organizations, repositories, and people are included in those metrics. They can also add context to metrics by managing events. For more information, see "[About data in {% data variables.product.prodname_insights %} ](/insights/installing-and-configuring-github-insights/about-data-in-github-insights)."
## Contacting support
You can receive support for {% data variables.product.prodname_insights %} from {% data variables.contact.github_support %}. For more information, see {% ifversion fpt %}"[Submitting a ticket](/github/working-with-github-support/submitting-a-ticket)."{% else %}"[Reaching {% data variables.contact.github_support %}](/enterprise/{{ currentVersion }}/admin/enterprise-support/reaching-github-support)."{% endif %}
## Further reading
- "[Installing {% data variables.product.prodname_insights %}](/insights/installing-and-configuring-github-insights/installing-github-insights)"
- "[Configuring {% data variables.product.prodname_insights %}](/insights/installing-and-configuring-github-insights/configuring-github-insights)"

Просмотреть файл

@ -1,13 +0,0 @@
---
title: Installing and updating GitHub Insights
shortTitle: Installing and updating
intro: 'You can install the {% data variables.product.prodname_insights %} application and update the application to the latest version.'
versions:
ghes: '*'
children:
- /about-github-insights
- /system-overview-for-github-insights
- /installing-github-insights
- /updating-github-insights
---

Просмотреть файл

@ -1,112 +0,0 @@
---
title: Installing GitHub Insights
intro: 'You can install {% data variables.product.prodname_insights %} and connect the standalone application to {% data variables.product.prodname_ghe_server %}.'
redirect_from:
- /github/installing-and-configuring-github-insights/installing-github-insights
- /insights/installing-and-configuring-github-insights/installing-github-insights
permissions: 'Organization owners in {% data variables.product.prodname_enterprise %} with read permissions to the `github/insights-releases` repository and administrative access to the application server can install {% data variables.product.prodname_insights %}.'
versions:
ghes: '*'
shortTitle: Install GitHub Insights
---
## Prerequisites
- You must have a {% data variables.product.prodname_enterprise %} license file that includes {% data variables.product.prodname_insights %}. After you purchase {% data variables.product.prodname_insights %}, you can download the updated license file in the [{% data variables.product.prodname_enterprise %} web portal](https://enterprise.github.com/download).
- {% data reusables.github-insights.requires-machine %} For more information, see "[System overview for {% data variables.product.prodname_insights %}](/github/installing-and-configuring-github-insights/system-overview-for-github-insights#requirements-for-running-github-insights)."
- You must install dependencies on the application server.
- [Docker](https://docs.docker.com/install/) 1.13.0+
- [Docker Compose](https://docs.docker.com/compose/install/) v1.17.0+
- [netcat](http://netcat.sourceforge.net/), available via apt for [Debian](https://packages.debian.org/search?keywords=netcat) and [Ubuntu](https://packages.ubuntu.com/search?keywords=netcat&searchon=names)
{% note %}
**Note:** {% data reusables.github-insights.docker-requirements %}
{% endnote %}
## Creating a {% data variables.product.prodname_github_app %}
To connect {% data variables.product.prodname_insights %} to {% data variables.product.prodname_enterprise %}, you must create a {% data variables.product.prodname_github_app %} in an organization on {% data variables.product.prodname_enterprise %}. A slugged version of your app's name will be shown on {% data variables.product.prodname_enterprise %} when your integration takes an action.
{% data reusables.enterprise_site_admin_settings.sign-in %}
2. Navigate to the organization you'd like to connect to {% data variables.product.prodname_insights %}.
{% data reusables.organizations.org_settings %}
{% data reusables.organizations.github-apps-settings-sidebar %}
5. Click **New {% data variables.product.prodname_github_app %}**.
![New GitHub App button](/assets/images/github-apps/github_apps_new.png)
6. Under "{% data variables.product.prodname_github_app %} name", type a name for the app. Your app cannot have the same name as an existing user or organization, unless the name is your own user or organization name.
![GitHub App name field](/assets/images/github-apps/github_apps_app_name.png)
7. Under "Homepage URL", type the URL of the application server for {% data variables.product.prodname_insights %}. For more information, see "[System overview for {% data variables.product.prodname_insights %}](/insights/installing-and-configuring-github-insights/system-overview-for-github-insights#requirements-for-running-github-insights)."
![Homepage URL field](/assets/images/github-apps/github_apps_homepage_url.png)
8. Under "User authorization callback URL", type the following, replacing `<application-server-url>` with the URL of the application server.
```
<application-server-url>/public/applogin
```
![User authorization callback field](/assets/images/github-apps/github_apps_user_authorization.png)
9. Under "Setup URL", type `<application-server-url>/public/setup`.
![Setup URL field](/assets/images/help/apps/github-apps-setup-url.png)
9. Under "Webhook URL", type `<application-server-url>/webhooks`.
![Webhook URL field](/assets/images/github-apps/github_apps_webhook_url.png)
10. Under "Webhook secret", type a secret, then record the secret for later reference.
![Webhook secret field](/assets/images/github-apps/github_apps_webhook_secret.png)
11. Under "Permissions", use the drop-down menus and configure the following permissions for the app.
- Repository:
- Contents: **Read-only**
- Metadata: **Read-only**
- Pull requests: **Read-only**
- Commit statuses: **Read-only**
- Organization:
- Members: **Read-only**
- Projects: **Read-only**
![Permissions drop-down menus](/assets/images/help/apps/github_apps_new_permissions_post2dot13.png)
12. Under "Subscribe to events", select:
- Member
- Pull request
- Push
- Repository
- Team
![Subscribe to events checkboxes](/assets/images/help/apps/github_apps_subscribe_to_events_pr_push_repository.png)
13. To enable the {% data variables.product.prodname_github_app %} to access data from any user or organization in {% data variables.product.product_location %}, under "Where can this {% data variables.product.prodname_github_app %} be installed?", select **Any account**.
![Radio buttons to enable access to any account](/assets/images/help/apps/github_apps_installation_options_any_account.png)
14. Click **Create {% data variables.product.prodname_github_app %}**.
![Create GitHub App button](/assets/images/github-apps/github_apps_create_github_app.png)
15. Review your app's configuration.
16. Under "Private keys", click **Generate a private key**.
![Generate a private key button](/assets/images/help/apps/generate-private-key.png)
17. Save the resulting PEM file for later reference.
18. Make note of the following information about your app for later reference.
- App ID
- Client ID
- Client secret
- Private key
- Webhook secret
## Installing {% data variables.product.prodname_insights %}
{% data reusables.github-insights.download-latest-release %}
{% data reusables.github-insights.install-script %}
{% data reusables.github-insights.run-script %}
## Configuring {% data variables.product.prodname_insights %}
To configure {% data variables.product.prodname_insights %} to connect to {% data variables.product.prodname_ghe_server %}, you must provide the information you recorded in previous steps.
1. In your browser, navigate to `<application-server-url>/setup`.
{% data reusables.github-insights.enterprise-api-url %}
{% data reusables.github-insights.insights-license %}
{% data reusables.github-insights.app-id %}
{% data reusables.github-insights.client-id %}
{% data reusables.github-insights.client-secret %}
{% data reusables.github-insights.private-key %}
{% data reusables.github-insights.webhook-secret %}
{% data reusables.github-insights.skip-ssl %}
11. Click **Submit**.
12. Click **Log in with {% data variables.product.prodname_dotcom %}**.
13. To authorize the {% data variables.product.prodname_github_app %} and access {% data variables.product.prodname_insights %}, click **Authorize {% data variables.product.prodname_github_app %}**.
## Further reading
- "[Managing repositories](/insights/installing-and-configuring-github-insights/managing-repositories)"
- "<a href="/github/site-policy/github-insights-and-data-protection-for-your-organization" class="dotcom-only">{% data variables.product.prodname_insights %} and data protection for your organization</a>"

Просмотреть файл

@ -1,55 +0,0 @@
---
title: System overview for GitHub Insights
intro: '{% data variables.product.prodname_insights %} is a standalone application which interfaces with {% data variables.product.prodname_enterprise %}.'
redirect_from:
- /github/installing-and-configuring-github-insights/system-overview-for-github-insights
- /insights/installing-and-configuring-github-insights/system-overview-for-github-insights
versions:
ghes: '*'
shortTitle: System overview
---
## Requirements for running {% data variables.product.prodname_insights %}
{% data variables.product.prodname_insights %} requires a supported version of {% data variables.product.prodname_ghe_server %}.
{% data reusables.github-insights.requires-machine %} Standard type machines with a base OS of Debian Buster, Debian Stretch, or any LTS versions of Ubuntu 16.04+ are supported.
To provision {% data variables.product.prodname_insights %}, the application server must be able to run certain dependencies, including Docker. {% data reusables.github-insights.docker-requirements %} For more information, see "[Installing {% data variables.product.prodname_insights %}](/insights/installing-and-configuring-github-insights/installing-github-insights#prerequisites)."
The application server should meet minimum specifications.
| Specification | Minimum |
| --------|-----------|
| vCPUs | 16 |
| RAM | 64GB |
| Disk | 250GB |
If you'll use {% data variables.product.prodname_insights %} to import large amounts of data, we recommend greater minimum specifications. For more information, see "[Managing repositories](/github/installing-and-configuring-github-insights/managing-repositories#about-import-times)."
## Security and authentication for {% data variables.product.prodname_insights %}
{% data variables.product.prodname_insights %} runs on your infrastructure and is governed by your existing information security controls. {% data variables.product.prodname_insights %} uses existing user accounts in {% data variables.product.prodname_enterprise %} for authentication and access permissions.
### Network Security
{% data variables.product.prodname_insights %}'s internal firewall restricts network access to the application server's services. Only services necessary for the application server to function are available over the network.
{% data variables.product.prodname_insights %} requires the following ports to be open for inbound and outbound traffic.
| Port | Service | Protocol |
| ----------|--------------|-----------------|
| 22 | SSH USER | TCP |
| 80 | HTTP USER | TCP |
| 443 | HTTPS USER | TCP |
### Authentication and access permissions
Authentication for {% data variables.product.prodname_insights %} is handled through {% data variables.product.prodname_enterprise %}. During installation, you will create a {% data variables.product.prodname_github_app %}, which allows {% data variables.product.prodname_insights %} to authorize users. The {% data variables.product.prodname_github_app %} is also used to interact with {% data variables.product.prodname_enterprise %} within the scope of the user and apps permissions.
{% data reusables.github-insights.permissions-levels %}
Data access in {% data variables.product.prodname_insights %} is restricted according to each user's data access in {% data variables.product.prodname_enterprise %}. A user will never see data in {% data variables.product.prodname_insights %} for repositories the user does not have access to in {% data variables.product.prodname_enterprise %}.
## Architecture of {% data variables.product.prodname_insights %}
![System architecture](/assets/images/help/insights/github-isights-system-diagram.png)

Просмотреть файл

@ -1,35 +0,0 @@
---
title: Updating GitHub Insights
intro: 'You can update to the latest version of {% data variables.product.prodname_insights %} to benefit from improvements and bug fixes.'
redirect_from:
- /github/installing-and-configuring-github-insights/updating-github-insights
- /insights/installing-and-configuring-github-insights/updating-github-insights
permissions: 'People with read permissions to the `github/insights-releases` repository and administrative access to the application server can update {% data variables.product.prodname_insights %}.'
versions:
ghes: '*'
---
## About {% data variables.product.prodname_insights %} updates
Before you update {% data variables.product.prodname_insights %}, you can check the version that you're currently using in the lower-right corner of any page.
The update process will take up to 10 minutes. During this time, users cannot access {% data variables.product.prodname_insights %}.
## Updating from {% data variables.product.prodname_insights %} 0.4.0+
To update {% data variables.product.prodname_insights %} from 0.4.0+, you can install the latest version. {% data variables.product.prodname_insights %} will ask to use the previous installation configuration.
{% data reusables.github-insights.download-latest-release %}
4. Run the shell script `install.sh`.
5. If SSL was previously enabled, {% data variables.product.prodname_insights %} will find an existing SSL certificate. Enter "Y" to accept or "n" to change the SSL certificate or disable SSL.
6. If SSL was previously enabled, {% data variables.product.prodname_insights %} will find an existing SSL key. Enter "Y" to accept or "n" to change the SSL key.
5. {% data variables.product.prodname_insights %} will find an existing hostname. Enter "Y" to accept or "n" to enter a different hostname. The hostname is the same URL you used for the application server when creating the {% data variables.product.prodname_github_app %}.
6. The installation will take a few minutes to run. When complete, you will see a message printed to the terminal.
```
Installation complete
Run /opt/insights/scripts/start.sh to start GitHub Insights
```
{% data reusables.github-insights.run-script %}
## Updating from {% data variables.product.prodname_insights %} 0.3.1 or lower
{% data variables.product.prodname_insights %} versions 0.3.1 or lower are incompatible with versions 0.4.0+. To update from {% data variables.product.prodname_insights %} 0.3.1 or lower, install and configure {% data variables.product.prodname_insights %} on a new application server.

Просмотреть файл

@ -1,23 +0,0 @@
---
title: About data in GitHub Insights
intro: 'The data included in {% data variables.product.prodname_insights %} metrics is highly customizable.'
permissions: ''
versions:
ghes: '*'
redirect_from:
- /insights/installing-and-configuring-github-insights/about-data-in-github-insights
shortTitle: Data in GitHub Insights
---
{% data variables.product.prodname_insights %} displays data about your team's work in key metrics and reports. You can choose which of these metrics are displayed. For more information, see "[Managing available metrics and reports](/insights/installing-and-configuring-github-insights/managing-available-metrics-and-reports)."
You can manage which organizations in {% data variables.product.prodname_enterprise %} are included in metrics. For more information, see "[Managing organizations](/insights/installing-and-configuring-github-insights/managing-organizations)."
After you add an organization to {% data variables.product.prodname_insights %}, you can choose which of that organization's repositories are included in metrics. {% data reusables.github-insights.repository-groups %} For more information, see "[Managing repositories](/insights/installing-and-configuring-github-insights/managing-repositories)."
You can choose which contributors are included in metrics and create teams of contributors. For more information, see "[Managing contributors and teams](/insights/installing-and-configuring-github-insights/managing-contributors-and-teams)."
{% data reusables.github-insights.events %} For more information, see "[Managing events](/insights/installing-and-configuring-github-insights/managing-events)."
## Further reading
- "[Metrics available with {% data variables.product.prodname_insights %}](/insights/exploring-your-usage-of-github-enterprise/metrics-available-with-github-insights)"
- "<a href="/github/site-policy/github-insights-and-data-protection-for-your-organization" class="dotcom-only">{% data variables.product.prodname_insights %} and data protection for your organization</a>"

Просмотреть файл

@ -1,18 +0,0 @@
---
title: Managing data in GitHub Insights
shortTitle: Managing data
intro: 'You can choose which metrics are displayed in {% data variables.product.prodname_insights %} and which organizations, repositories, and people are included in those metrics. You can set targets for and add context to metrics.'
redirect_from:
- /github/installing-and-configuring-github-insights/managing-data-in-github-insights
versions:
ghes: '*'
children:
- /about-data-in-github-insights
- /managing-available-metrics-and-reports
- /managing-contributors-and-teams
- /managing-repositories
- /managing-organizations
- /managing-goals
- /managing-events
---

Просмотреть файл

@ -1,18 +0,0 @@
---
title: Managing available metrics and reports
intro: 'You can enable and disable specific metrics across {% data variables.product.prodname_insights %}.'
redirect_from:
- /github/installing-and-configuring-github-insights/managing-settings-in-github-insights
- /insights/installing-and-configuring-github-insights/managing-available-metrics-and-reports
permissions: 'People with admin permissions to {% data variables.product.prodname_insights %} can manage available metrics and reports.'
versions:
ghes: '*'
shortTitle: Manage metrics & reports
---
When you disable a metric, the metric will not be visible for any user, anywhere on {% data variables.product.prodname_insights %}.
{% data reusables.github-insights.settings-tab %}
2. Under **{% octicon "gear" aria-label="The gear icon" %} Settings**, click **Toggle reports**.
![Toggle reports tab](/assets/images/help/insights/toggle-reports-tab.png)
3. To the right of the metric you want to manage, use the **Enabled** or **Disabled** drop-down menu.
![Drop-down menu to toggle metric](/assets/images/help/insights/toggle-report-drop-down.png)

Просмотреть файл

@ -1,135 +0,0 @@
---
title: Managing contributors and teams
intro: You can manage the people and teams included in metrics and reports.
redirect_from:
- /github/installing-and-configuring-github-insights/managing-contributors-and-teams
- /insights/installing-and-configuring-github-insights/managing-contributors-and-teams
permissions: 'People with admin permissions in {% data variables.product.prodname_insights %} can manage contributors and teams.'
miniTocMaxHeadingLevel: 3
versions:
ghes: '*'
shortTitle: Manage contributors & teams
---
## About contributors and teams in {% data variables.product.prodname_insights %}
A contributor in {% data variables.product.prodname_insights %} is an entity associated with {% data variables.product.prodname_enterprise %} data. You can edit and hide contributors.
Sometimes, the same person can appear as more than one contributor. For example, if one person has used multiple commit email addresses in Git, there will be a unique contributor for each email address in {% data variables.product.prodname_insights %}. You can merge multiple contributors to combine all the data from one person.
You can also group contributors into teams. You can use teams as a filter on reports. For more information, see "[Viewing key metrics and reports](/insights/exploring-your-usage-of-github-enterprise/viewing-key-metrics-and-reports)."
## Editing a contributor
You can edit a contributor's display name in {% data variables.product.prodname_insights %}.
{% data reusables.github-insights.settings-tab %}
{% data reusables.github-insights.contributors-tab %}
{% data reusables.github-insights.edit-contributor %}
4. Under "First Name", type the contributor's first name.
![First Name field](/assets/images/help/insights/first-name.png)
5. Under "Last Name", type the contributor's last name.
![Last Name field](/assets/images/help/insights/last-name.png)
6. Click **Rename**.
## Managing contributor visibility
Hiding a contributor excludes all data associated with that contributor from all metrics.
{% data reusables.github-insights.settings-tab %}
{% data reusables.github-insights.contributors-tab %}
{% data reusables.github-insights.edit-contributor %}
3. Select or deselect **Show contributor**.
![Checkbox to show or hide contributor](/assets/images/help/insights/show-contributor.png)
4. Click **Done**.
## Merging contributor data
When you merge two or more contributors, the {% data variables.product.prodname_insights %} data for those contributors becomes associated with one primary contributor. All of the merged contributor data belongs to the primary contributor in metrics.
You can merge contributors manually or automatically, based on contributors {% data variables.product.prodname_insights %} has detected with matching names.
### Auto-merging contributors
{% data reusables.github-insights.settings-tab %}
{% data reusables.github-insights.contributors-tab %}
3. Under "All Contributors", click **Auto-Merge**
![Auto-Merge button](/assets/images/help/insights/auto-merge.png)
4. Optionally, to exclude a contributor from being merged, to the right of the contributor, click **Skip**.
![Skip button](/assets/images/help/insights/skip-contributor.png)
5. For each group, select a primary contributor.
![Radio buttons to select primary contributor](/assets/images/help/insights/select-primary.png)
6. Click **Merge All**.
### Manually merging contributors
{% data reusables.github-insights.settings-tab %}
{% data reusables.github-insights.contributors-tab %}
3. Select the contributors you want to merge.
![Select contributors](/assets/images/help/insights/select-contributors.png)
4. Under "All Contributors", click **Merge**.
![Merge button](/assets/images/help/insights/merge-button.png)
5. Select a primary contributor.
![Radio buttons to select primary contributor](/assets/images/help/insights/select-primary.png)
6. Click **Merge accounts**.
### Unmerging a contributor
{% data reusables.github-insights.settings-tab %}
{% data reusables.github-insights.contributors-tab %}
4. To the right of the contributor, click **Unmerge**.
![Unmerge button](/assets/images/help/insights/unmerge-contributor.png)
## Managing teams in {% data variables.product.prodname_insights %}
There are two types of teams in {% data variables.product.prodname_insights %}: teams imported from {% data variables.product.product_name %} and custom teams.
When an organization is added to {% data variables.product.prodname_insights %}, all of the organization's teams are imported from {% data variables.product.product_name %}. You can search and filter by these teams in {% data variables.product.prodname_insights %}. You can manage the teams in {% data variables.product.product_name %}.
You can create and manage custom teams in {% data variables.product.prodname_insights %}. Custom teams may include members from multiple organizations in {% data variables.product.product_name %}.
### Creating a custom team
{% data reusables.github-insights.settings-tab %}
{% data reusables.github-insights.teams-tab %}
2. To the right of "Teams", click **Create Team**.
![Create Team button](/assets/images/help/insights/create-team.png)
3. Under "Team Name", type a unique name for your team.
![Team Name field](/assets/images/help/insights/team-name.png)
4. Click **Create**.
### Adding contributors to a custom team
{% data reusables.github-insights.settings-tab %}
{% data reusables.github-insights.teams-tab %}
{% data reusables.github-insights.edit-team %}
3. Under "Contributors", use the drop-down menu and select a contributor.
![Contributors drop-down](/assets/images/help/insights/contributors-drop-down.png)
4. Click **Done**.
### Removing a contributor from a custom team
{% data reusables.github-insights.settings-tab %}
{% data reusables.github-insights.teams-tab %}
{% data reusables.github-insights.edit-team %}
3. To the right of the contributor you'd like to remove, click {% octicon "trash" aria-label="The trash icon" %}.
![trash button](/assets/images/help/insights/contributor-trashcan.png)
### Renaming a custom team
{% data reusables.github-insights.settings-tab %}
{% data reusables.github-insights.teams-tab %}
{% data reusables.github-insights.edit-team %}
3. Under "Team Name", type a unique name for your team.
![Team Name field](/assets/images/help/insights/rename-team.png)
4. Click **Rename**.
![Rename button](/assets/images/help/insights/rename-button-team.png)
5. Click **Done**.
### Deleting a custom team
{% data reusables.github-insights.settings-tab %}
{% data reusables.github-insights.teams-tab %}
{% data reusables.github-insights.edit-team %}
3. Click **Delete Team**.
![Delete Team button](/assets/images/help/insights/delete-team.png)
4. Click **Confirm**.

Некоторые файлы не были показаны из-за слишком большого количества измененных файлов Показать больше