Skip to content

Latest commit

 

History

History
52 lines (40 loc) · 4.2 KB

exporting-data-from-security-overview.md

File metadata and controls

52 lines (40 loc) · 4.2 KB
title shortTitle intro permissions product versions type topics redirect_from
Exporting data from security overview
Export data
From security overview, you can export CSV files of the data used for your organization or enterprise's overview, risk, coverage, and {% data variables.product.prodname_codeql %} pull request alerts pages.
{% data reusables.permissions.security-overview %}
{% data reusables.gated-features.security-overview-fpt-both %}
feature
security-overview-export-data
how_to
Security overview
Code Security
Secret Protection
Alerts
Organizations
Teams
/code-security/security-overview/exporting-data-from-the-risk-and-coverage-pages

About exporting your security overview data

{% data reusables.security-overview.download-csv-files %}

The overview page contains data about security alerts across your organization or enterprise, while the risk and coverage pages contain data about repositories and how they are affected by security alerts or covered by security features. The {% data variables.product.prodname_codeql %} pull request alerts page contains data about {% data variables.product.prodname_codeql %} alerts that were caught in pull requests merged to the default branch.

The CSV file you download will contain data corresponding to the filters you have applied to security overview. For example, if you add the filter dependabot-alerts:enabled, your file will only contain data for repositories that have enabled {% data variables.product.prodname_dependabot_alerts %}.

Note

In the "Teams" column of the CSV file, each repository will list a maximum of 20 teams with write access to that repository. If more than 20 teams have write access to a repository, the data will be truncated.

Exporting overview, coverage, and risk data from your organization's security overview

{% data reusables.profile.access_org %}

  1. In the "Organizations" section, select the organization for which you would like to download security overview data. {% data reusables.organizations.security-overview %}

  2. In the "Security" sidebar, choose the page that you want to export data from by clicking on {% octicon "graph" aria-hidden="true" %}Overview, {% octicon "meter" aria-hidden="true" %} Coverage, {% octicon "shield" aria-hidden="true" %} Risk or {% octicon "graph" aria-hidden="true" %} {% data variables.product.prodname_codeql %} pull request alerts.

  3. Next to the search bar, click {% octicon "download" aria-hidden="true" %} Export CSV.

    It may take a moment for {% data variables.product.github %} to generate the CSV file of your data. Once the CSV file generates, the file will automatically start downloading, and a banner will appear confirming your report is ready. If you are downloading the CSV from the overview page, you will also receive an email when your report is ready, containing a link to download the CSV.

Note

The summary views ("Overview", "Coverage" and "Risk") show data only for default alerts. {% data variables.product.prodname_code_scanning_caps %} alerts from third-party tools, and {% data variables.product.prodname_secret_scanning %} alerts for non-provider patterns or for ignored directories are all omitted from these views. Consequently, files exported from the summary views do not contain data for these types of alert.

Exporting overview, coverage, and risk data from your enterprise's security overview

{% ifversion ghes %}{% data reusables.enterprise-accounts.access-enterprise-ghes %}{% else %}{% data reusables.enterprise-accounts.access-enterprise-on-dotcom %}{% endif %} {% data reusables.code-scanning.click-code-security-enterprise %}

  1. Choose the page that you want to export data from by clicking on Overview, Risk, or Coverage.

  2. Next to the search bar, click {% octicon "download" aria-hidden="true" %} Export CSV.

    It may take a moment for {% data variables.product.github %} to generate the CSV file of your data. Once the CSV file generates, the file will automatically start downloading, and a banner will appear confirming your report is ready. If you are downloading the CSV from the overview page, you will also receive an email when your report is ready, containing a link to download the CSV.