{"meta":{"title":"向GitHub支持提供数据","intro":"由于 GitHub 支持 无权访问你的环境，我们有时需要你提供一些额外的信息。","product":"GitHub支持","breadcrumbs":[{"href":"/zh/enterprise-server@3.19/support","title":"GitHub支持"},{"href":"/zh/enterprise-server@3.19/support/contacting-github-support","title":"联系支持部门"},{"href":"/zh/enterprise-server@3.19/support/contacting-github-support/providing-data-to-github-support","title":"提供数据"}],"documentType":"article"},"body":"# 向GitHub支持提供数据\n\n由于 GitHub 支持 无权访问你的环境，我们有时需要你提供一些额外的信息。\n\n## 关于诊断文件和支持包\n\n为了帮助你排查环境中的GitHub Enterprise Server实例问题，GitHub 支持可能会请求一种或多种类型的数据。\n\n| 数据 | 文件格式 | 说明 |\n| :------ | :--- | :------------------------- |\n| 诊断文件 | 纯文本 | 包含有关实例设置和环境的信息。 |\n| 支持捆绑包 | 存档 | 包含过去两天（默认）的诊断文件和经过清理的日志文件。 |\n| 扩展支持捆绑包 | 存档 | 包含过去八天的诊断文件和经过清理的日志文件。 |\n\n## 关于日志文件净化\n\n身份验证令牌、密钥和机密将从支持包或诊断文件中包含的以下日志目录中的日志文件中删除：\n\n* `alambic-logs`\n* `babeld-logs`\n* `codeload-logs`\n* `enterprise-manage-logs`\n* `github-logs`\n* `hookshot-logs`\n* `lfs-server-logs`\n* `semiotic-logs`\n* `task-dispatcher-logs`\n* `pages-logs`\n* `registry-logs`\n* `render-logs`\n* `svn-bridge-logs`\n\n## 创建和共享诊断文件\n\n诊断文件概述 GitHub Enterprise Server 实例的设置和环境，其中包含：\n\n* 客户端许可信息，包括公司名称、到期日期和用户许可数量\n* 版本号和 SHA\n* VM 架构\n* 主机名、私有模式、SSL 设置\n* 加载和处理列表\n* 网络设置\n* 身份验证方法和详情\n* 仓库数量、用户数量及其他安装数据\n\n您可以从管理控制台下载实例诊断，也可以通过运行`ghe-diagnostics`命令行实用工具来下载。\n\n### 从 管理控制台 创建诊断文件\n\n如果当前没有 SSH 访问权限，可以从 管理控制台 中创建诊断文件。\n\n1. 在 GitHub Enterprise Server 上的管理帐户中，在任一页面的右上角，单击“”。\n2. 如果你尚未在“站点管理员”页上，请在左上角单击“站点管理员”。\n3. 在“ 站点管理”边栏中，单击“管理控制台”\\*\\*\\*\\*。\n4. 如果你创建了多个 管理控制台 用户帐户，请选择“根站点管理员”或“管理控制台 用户” 。 有关 管理控制台 用户帐户的详细信息，请参阅“[管理对管理控制台的访问](/zh/enterprise-server@3.19/admin/configuration/administering-your-instance-from-the-management-console/managing-access-to-the-management-console)”。\n5. 输入你的 管理控制台 凭据。 然后单击“继续”。\n6. 在顶部导航栏中，单击“支持”。\n\n \n7. 单击“下载诊断信息”。\n\n### 使用 SSH 创建诊断文件\n\n您可以在不登录管理控制台的情况下使用此方法。\n\n使用 [ghe-diagnostics](/zh/enterprise-server@3.19/admin/configuration/configuring-your-enterprise/command-line-utilities#ghe-diagnostics) 命令行实用程序检索实例的诊断。\n\n```shell\nssh -p122 admin@HOSTNAME -- 'ghe-diagnostics' > diagnostics.txt\n```\n\n## 创建和共享支持包\n\n您提交支持请求后，我们可能会要求您与我们团队共享支持包。 支持包是一个 gzip 压缩的 tar 存档，其中包含来自您的实例的诊断和重要日志，例如：\n\n* 在对身份验证错误进行故障排查或者配置 LDAP、CAS 或 SAML 时，与身份验证相关的日志可能会十分有用\n\n* ```\n 管理控制台 日志\n ```\n\n* ```\n `github-logs/exceptions.log`：关于站点上遇到的 500 个错误的信息\n ```\n\n* ```\n `github-logs/audit.log`： GitHub Enterprise Server 审核日志\n ```\n\n* ```\n `babeld-logs/babeld.log`：Git 代理日志\n ```\n\n* ```\n `system-logs/haproxy.log`：HAProxy 日志\n ```\n\n* ```\n `elasticsearch-logs/github-enterprise.log`：Elasticsearch 日志\n ```\n\n* ```\n `configuration-logs/`： GitHub Enterprise Server 配置日志\n ```\n\n* ```\n `collectd/logs/collectd.log`：收集的日志\n ```\n\n* ```\n `mail-logs/mail.log`：SMTP 电子邮件传递日志\n ```\n\n有关详细信息，请参阅“[企业审核日志](/zh/enterprise-server@3.19/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/about-the-audit-log-for-your-enterprise)”。\n\n支持包默认包含过去两天的日志。 可以以天为单位指定确切的时段。 若要提供过去八天的日志，可以下载外延支持包。 有关详细信息，请参阅[创建和共享扩展支持包](#creating-and-sharing-extended-support-bundles)。\n\n> \\[!TIP]\n> 联系 GitHub 支持时，你将收到一封确认电子邮件，其中包含票证参考链接。 如果 GitHub 支持 要求上传支持捆绑包，则可以使用票证参考链接上传支持捆绑包。\n\n### 创建支持捆绑包从 管理控制台\n\n如果可以访问基于 web 的管理控制台平台，并且具有出站 internet 访问权限，则可以使用这些步骤来创建和共享支持捆绑包。\n\n1. 在 GitHub Enterprise Server 上的管理帐户中，在任一页面的右上角，单击“”。\n2. 如果你尚未在“站点管理员”页上，请在左上角单击“站点管理员”。\n3. 在“ 站点管理”边栏中，单击“管理控制台”\\*\\*\\*\\*。\n4. 如果你创建了多个 管理控制台 用户帐户，请选择“根站点管理员”或“管理控制台 用户” 。 有关 管理控制台 用户帐户的详细信息，请参阅“[管理对管理控制台的访问](/zh/enterprise-server@3.19/admin/configuration/administering-your-instance-from-the-management-console/managing-access-to-the-management-console)”。\n5. 输入你的 管理控制台 凭据。 然后单击“继续”。\n6. 在顶部导航栏中，单击“支持”。\n\n \n7. 单击“下载支持包”。\n8. 如果支持工程师为你提供了支持包的上传链接，请使用此链接。 否则，请访问 并登录有权获得支持的企业帐户（如果出现提示）。\n9. 访问 并上传支持捆绑包。\n\n### 使用 SSH 创建支持包\n\n如果您具备 SSH 访问权限，并且具有互联网出向访问权限 你的 GitHub Enterprise Server 实例 ，则可以按照这些步骤创建并共享支持包。\n\n> \\[!NOTE]\n> 如果 你的 GitHub Enterprise Server 实例 采用异地复制配置，或者实例是群集，则应使用 `ghe-cluster-support-bundle` 命令检索支持包。 有关详细信息，请参阅“[命令行实用程序](/zh/enterprise-server@3.19/admin/configuration/configuring-your-enterprise/command-line-utilities#ghe-cluster-support-bundle)”。\n\n1. 通过 SSH 下载支持包：\n\n ```shell\n ssh -p 122 admin@HOSTNAME -- 'ghe-support-bundle -o' > support-bundle.tgz\n ```\n\n 有关 `ghe-support-bundle` 命令的详细信息，请参阅“[命令行实用程序](/zh/enterprise-server@3.19/admin/configuration/configuring-your-enterprise/command-line-utilities#ghe-support-bundle)”。\n2. 如果支持工程师为你提供了支持包的上传链接，请使用此链接。 否则，请访问 并登录有权获得支持的企业帐户（如果出现提示）。\n3. 访问 并上传支持捆绑包。\n\n### 使用您的企业帐户上传支持包\n\n1. 导航至 GitHub Enterprise Cloud。\n2. 在 GitHub 的右上角，单击你的个人资料图片。\n3. 根据环境，单击“ **企业**”，或单击“ **企业** ”，然后单击要查看的企业。\n4. 在页面顶部，单击 “Settings”\\*\\*\\*\\*\\*\\*\\*\\*。\n5. 在“ Settings”下，单击“License”\\*\\*\\*\\*\\*\\*\\*\\*。\n6. 在“GitHub Enterprise 帮助”下，单击“ **上传支持捆绑包**”。\n\n \n7. 在“选择企业帐户”下，使用下拉菜单选择支持包的关联帐户。\n8. 在“上传支持捆绑包” GitHub Enterprise 支持下，若要选择支持捆绑包，请单击 **“选择文件**”，或将支持捆绑文件拖动到 **“选择文件**”。\n9. 单击“上载” 。\n\n### 使用 SSH 直接上传支持包\n\n在以下情况下您可以直接将支持包上传到我们的服务器：\n\n* 你有 SSH 访问权限 你的 GitHub Enterprise Server 实例.\n* 允许从 你的 GitHub Enterprise Server 实例 到 *enterprise-bundles.github.com* 和 *esbtoolsproduction.blob.core.windows.net* 通过 TCP 端口 443 进行出站 HTTPS 连接。\n\n1. 将包上传到我们的支持包服务器：\n\n ```shell\n ssh -p122 admin@HOSTNAME -- 'ghe-support-bundle -u'\n ```\n\n## 创建和共享扩展支持包\n\n支持包包括过去两天（默认）的日志，而外延支持包包括过去八天的日志。 如果 GitHub 支持 调查的事件发生在两天前，我们可能会要求你共享扩展的支持包。 需要使用 SSH 访问权限才能下载扩展捆绑包 - 无法从 管理控制台 下载扩展捆绑包。\n\n为避免体积变得太大，支持包只包含尚未轮换和压缩的日志。 不同日志文件的日志轮换可能发生在不同的频率（如每日或每周），这取决于我们对日志大小的预期。\n\n### 使用 SSH 创建扩展支持包\n\n如果具有 SSH 访问权限且具有出站 Internet 访问权限 你的 GitHub Enterprise Server 实例 ，则可以使用以下步骤创建和共享扩展支持捆绑包。\n\n1. 将 `-x` 标记添加到 `ghe-support-bundle` 命令，通过 SSH 下载扩展支持包：\n\n ```shell\n ssh -p 122 admin@HOSTNAME -- 'ghe-support-bundle -o -x' > support-bundle.tgz\n ```\n\n2. 如果支持工程师为你提供了支持包的上传链接，请使用此链接。 否则，请访问 并登录有权获得支持的企业帐户（如果出现提示）。\n\n3. 访问 并上传支持捆绑包。\n\n### 使用 SSH 直接上传扩展支持包\n\n在以下情况下您可以直接将支持包上传到我们的服务器：\n\n* 你有 SSH 访问权限 你的 GitHub Enterprise Server 实例.\n* 允许从 你的 GitHub Enterprise Server 实例 到 *enterprise-bundles.github.com* 和 *esbtoolsproduction.blob.core.windows.net* 的出站 HTTPS 连接通过 TCP 端口 443。\n\n1. 将包上传到我们的支持包服务器：\n\n ```shell\n ssh -p122 admin@HOSTNAME -- 'ghe-support-bundle -u -x'\n ```\n\n## 其他阅读材料\n\n* ```\n [AUTOTITLE](/support/learning-about-github-support/about-github-support)\n ```\n* ```\n [AUTOTITLE](/enterprise-server@latest/admin/enterprise-management/monitoring-your-appliance/generating-a-health-check-for-your-enterprise)\n ```"}