Skip to main content

Esta versão do GitHub Enterprise foi descontinuada em 2022-06-03. Nenhum lançamento de patch será feito, mesmo para questões críticas de segurança. Para obter melhor desempenho, melhorar a segurança e novos recursos, upgrade to the latest version of GitHub Enterprise. Para ajuda com a atualização, contact GitHub Enterprise support.

Enviar dados ao suporte do GitHub

Uma vez que Suporte do GitHub não tem acesso ao seu ambiente, � s vezes exigimos alguma informação adicional sobre você.

Sobre os arquivos de diagnóstico e pacotes de suporte

Suporte do GitHub pode solicitar que você forneça dados adicionais na forma de arquivos de registro excluídos. Existem três tipos de arquivo de registro que podem ser solicitados que você forneça.

Os arquivos de diagnóstico contêm informações sobre as configurações e o ambiente de uma instância de GitHub Enterprise Server, os pacotes de suporte contêm diagnósticos e registros dos últimos dois dias, e pacotes de suporte estendidos também contêm diagnósticos e registros, mas dos últimos sete dias.

Sobre o arquivo de registro sanitização

Os tokens de autenticação, chaves e segredos são removidos dos arquivos de registro nos seguintes diretórios de registro contidos em um pacote de suporte ou arquivo de diagnóstico:

  • alambic-logs
  • babeld-logs
  • codeload-logs
  • enterprise-manage-logs
  • github-logs
  • hookshot-logs
  • lfs-server-logs
  • semiotic-logs
  • task-dispatcher-logs
  • pages-logs
  • registry-logs
  • render-logs
  • svn-bridge-logs

Criar e compartilhar arquivos de diagnóstico

Os arquivos de diagnóstico são uma visão geral das configurações e do ambiente de uma instância de GitHub Enterprise Server que contém:

  • Informações da licença do cliente, incluindo o nome da empresa, data de validade e número de licenças de usuário
  • Números de versão e SHAs;
  • Arquitetura de VMs;
  • Nome de host, modo privado, configurações de SSL;
  • Listagens de carga e processo;
  • Configurações de rede;
  • Método e detalhes de autenticação;
  • Número de repositórios, usuários e outros dados de instalação.

Você pode baixar o diagnóstico da sua instância no Console de gerenciamento ou executando o utilitário da linha de comando ghe-diagnostics.

Criar um arquivo de diagnóstico no Console de gerenciamento

Você pode usar esse método se não tiver sua chave SSH disponível no momento.

  1. From an administrative account on GitHub Enterprise Server, in the upper-right corner of any page, click .

    Screenshot of the rocket ship icon for accessing site admin settings

  2. If you're not already on the "Site admin" page, in the upper-left corner, click Site admin.

    Screenshot of "Site admin" link

  3. Na barra lateral esquerda, clique em Console de gerenciamento. Console de gerenciamento aba na barra lateral esquerda

  4. Se solicitado, digite sua senha do Console de gerenciamento. Console de gerenciamento desbloquear tela

  5. No canto superior direito do Console de gerenciamento, clique em Support (Suporte). Botão para acessar a área de Suporte

  6. Clique em Download diagnostics info (Baixar informações de diagnóstico).

Criar um arquivo de diagnóstico usando SSH

Você pode usar esse método sem entrar no Console de gerenciamento.

Use o utilitário da linha de comando ghe-diagnostics para recuperar o diagnóstico da sua instância.

$ ssh -p122 admin@hostname -- 'ghe-diagnostics' > diagnostics.txt

Criar e compartilhar pacotes de suporte

Depois do envio da sua solicitação de suporte, podemos pedir que você compartilhe um pacote de suporte com a nossa equipe. O pacote de suporte é um arquivo tar compactado com gzip que inclui diagnósticos e logs importantes da sua instância, como:

  • Logs relacionados �  autenticação que podem ser úteis na solução de problemas de erros de autenticação, ou na configuração de LDAP, CAS ou SAML;
  • Log do Console de gerenciamento;
  • github-logs/exceptions.log: informações sobre 500 erros encontrados no site;
  • github-logs/audit.log: logs de auditoria do GitHub Enterprise Server;
  • babeld-logs/babeld.log: logs de proxy do Git;
  • system-logs/haproxy.log: logs de HAProxy;
  • elasticsearch-logs/github-enterprise.log: logs de ElasticSearch;
  • configuration-logs/ghe-config.log: logs de configuração do GitHub Enterprise Server;
  • collectd/logs/collectd.log: logs coletados;
  • mail-logs/mail.log: logs de entrega de e-mail por SMTP;

Para obter mais informações, consulteSobre o log de auditoria para sua empresa".

Os pacotes de suporte incluem logs dos últimos dois dias. Para obter logs dos últimos sete dias, você pode baixar um pacote de suporte estendido. Para obter mais informações, consulte "Criar e compartilhar pacotes de suporte estendidos".

Dica: ao entrar em contato com o Suporte do GitHub, você receberá um e-mail de confirmação com um link de referência do tíquete. Se o Suporte do GitHub solicitar o upload de um pacote de suporte, você pode usar o link de referência do tíquete para fazer o upload requisitado.

Criar um pacote de suporte no Console de gerenciamento

Você pode usar essas etapas para criar e compartilhar um pacote de suporte se conseguir acessar o Console de gerenciamento e se tiver acesso �  internet.

  1. From an administrative account on GitHub Enterprise Server, in the upper-right corner of any page, click .

    Screenshot of the rocket ship icon for accessing site admin settings

  2. If you're not already on the "Site admin" page, in the upper-left corner, click Site admin.

    Screenshot of "Site admin" link

  3. Na barra lateral esquerda, clique em Console de gerenciamento. Console de gerenciamento aba na barra lateral esquerda

  4. Se solicitado, digite sua senha do Console de gerenciamento. Console de gerenciamento desbloquear tela

  5. No canto superior direito do Console de gerenciamento, clique em Support (Suporte). Botão para acessar a área de Suporte

  6. Clique em Download support bundle (Baixar pacote de suporte).

  7. If a support engineer has given you an upload link for your support bundle, use this link. Otherwise, visit https://support.github.com/ and sign in (if prompted) to an enterprise account that is entitled to support.

  8. Acesse https://support.github.com/uploads e faça upload do seu pacote de suporte.

Criar um pacote de suporte usando SSH

Você pode usar esses passos para criar e compartilhar um pacote de suporte se você tiver acesso de SSH ao your GitHub Enterprise Server instance e tiver acesso �  internet de saída.

Nota: se você estiver usando uma configuração de replicação geográfica ou GitHub Enterprise Clustering, você deve usar o comando ghe-cluster-support-bundle para recuperar o pacote de suporte. Para obter mais informações, consulte "Command-line utilities."

  1. Baixe o pacote de suporte via SSH:
    $ ssh -p 122 admin@hostname -- 'ghe-support-bundle -o' > support-bundle.tgz
    Para obter mais informações sobre o comando ghe-support-bundle, consulte "Utilitários da linha de comando".
  2. If a support engineer has given you an upload link for your support bundle, use this link. Otherwise, visit https://support.github.com/ and sign in (if prompted) to an enterprise account that is entitled to support.
  3. Acesse https://support.github.com/uploads e faça upload do seu pacote de suporte.

Carregar um pacote de suporte usando sua conta corporativa

  1. Navegue até o GitHub.com.

  2. No canto superior direito de GitHub.com, clique na sua foto de perfil e, em seguida, clique em Suas empresas. "Suas empresas" no menu suspenso para a foto do perfil em GitHub Enterprise Server

  3. Na lista de empresas, clique na empresa que você deseja visualizar. Nome de uma empresa na lista das suas empresas

  4. Na barra lateral da conta corporativa, clique em Settings. Aba de configurações na barra lateral de contas corporativas

  5. Na barra lateral esquerda, clique em Enterprise licensing (Licenciamento Empresarial). Captura de tela que mostra o link do "licenciamento da empresa" na barra lateral de configurações da conta corporativa.

  6. Em "Ajuda de GitHub Enterprise", clique em Fazer upload de um pacote de suporte. Captura de tela que mostra o "Link para fazer o upload de um pacote de suporte".

  7. Em "Selecione uma conta corporativa", selecione a conta associada ao pacote de suporte no menu suspenso. Captura de tela que mostra o menu suspenso para selecionar a conta corporativa do pacote de suporte.

  8. Em "Fazer upload de um pacote de suporte para Suporte do GitHub Enterprise", selecione seu pacote de suporte, clique Escolher arquivo ou arraste seu arquivo de pacote de suporte para Escolher arquivo. Captura de tela que mostra o botão o "Escolher arquivo" para fazer o upload de um arquivo de pacote.

  9. Clique em Fazer upload.

Fazer upload de um pacote de suporte usando SSH

Você pode fazer upload diretamente de um pacote de suporte para o nosso servidor nas seguintes situações:

  • Você tem acesso de SSH a your GitHub Enterprise Server instance.
  • São permitidas conexões HTTPS de saída sobre a por meio da porta TCP 443 de your GitHub Enterprise Server instance para enterprise-bundles.github.com e esbtoolsproduction.blob.core.windows.net.
  1. Faça upload do pacote para o nosso servidor de pacotes de suporte:
    $ ssh -p122 admin@hostname -- 'ghe-support-bundle -u'

Criar e compartilhar pacotes de suporte estendidos

Os pacotes de suporte incluem logs dos últimos dois dias, enquanto os pacotes de suporte estendidos incluem logs dos últimos sete dias. Se os eventos que o Suporte do GitHub está investigando tiverem ocorrido há mais de dois dias, poderemos solicitar que você compartilhe um pacote de suporte estendido. Você precisará do acesso SSH para baixar um pacote estendido, e não é possível baixar um pacote estendido no Console de gerenciamento.

Para evitar que fiquem grandes demais, os pacotes só têm logs que não passaram por rotação nem compactação. A rotação de arquivos de log no GitHub Enterprise Server acontece em várias frequências (diária ou semanalmente) para diferentes arquivos, dependendo das expectativas de tamanho dos logs.

Criar um pacote de suporte estendido usando SSH

Você pode usar essas etapas para criar e compartilhar um pacote de suporte estendido se você tiver acesso de SSH ao your GitHub Enterprise Server instance e tiver acesso �  internet de saída.

  1. Baixe o pacote de suporte estendido via SSH adicionando o sinalizador -x ao comando ghe-support-bundle:
    $ ssh -p 122 admin@hostname -- 'ghe-support-bundle -o -x' > support-bundle.tgz
  2. If a support engineer has given you an upload link for your support bundle, use this link. Otherwise, visit https://support.github.com/ and sign in (if prompted) to an enterprise account that is entitled to support.
  3. Acesse https://support.github.com/uploads e faça upload do seu pacote de suporte.

Fazer upload de um pacote de suporte estendido usando SSH

Você pode fazer upload diretamente de um pacote de suporte para o nosso servidor nas seguintes situações:

  • Você tem acesso de SSH a your GitHub Enterprise Server instance.
  • São permitidas conexões HTTPS de saída sobre a por meio da porta TCP 443 de your GitHub Enterprise Server instance para enterprise-bundles.github.com e esbtoolsproduction.blob.core.windows.net.
  1. Faça upload do pacote para o nosso servidor de pacotes de suporte:
    $ ssh -p122 admin@hostname -- 'ghe-support-bundle -u -x'

Leia mais