Skip to main content

Esta versão do GitHub Enterprise Server será descontinuada em 2024-03-07. Nenhum lançamento de patch será feito, mesmo para questões críticas de segurança. Para obter melhor desempenho, segurança aprimorada e novos recursos, atualize para a última versão do GitHub Enterprise Server. Para obter ajuda com a atualização, entre em contato com o suporte do GitHub Enterprise.

Fornecer dados para o GitHub Support

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

Quem pode usar esse recurso?

Site administrators and enterprise owners can provide data to Suporte do GitHub.

Sobre os arquivos de diagnóstico e pacotes de suporte

Para ajudar você a solucionar problemas com uma instância do GitHub Enterprise Server em seu ambiente, o Suporte do GitHub pode solicitar um ou mais tipos de dados.

DadosFormato de arquivoDescrição
Arquivo de diagnósticoTexto sem formataçãoContém informações sobre as configurações e o ambiente da instância.
Pacote de suporteArquivosPor padrão, contém um arquivo de diagnóstico e os arquivos de log corrigidos dos últimos dois dias.
Pacote de suporte estendidoArquivosContém um arquivo de diagnóstico e os arquivos de log corrigidos dos últimos oito 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.

Baixe o diagnóstico para sua instância do Console de Gerenciamento ou executando o utilitário de linha de comando ghe-diagnostics.

Criar um arquivo de diagnóstico no Console de Gerenciamento

Você pode criar um arquivo de diagnóstico do Console de Gerenciamento se não tiver acesso SSH no momento.

  1. Em uma conta administrativa no GitHub Enterprise Server, no canto superior direito de qualquer página, clique em .

  2. Se você ainda não estiver na página "Administração do site", no canto superior esquerdo, clique em Administração do site.

  3. Na barra lateral " Administrador do site", clique em Console de Gerenciamento .

  4. Se você tiver criado várias contas de usuário do Console de Gerenciamento, selecione Administrador do site raiz ou usuário do Console de Gerenciamento . Para obter mais informações sobre as contas de usuário do Console de Gerenciamento, confira "Como gerenciar o acesso ao Console de Gerenciamento."

  5. Digite suas credenciais do Console de Gerenciamento. Em seguida, clique em Continuar.

  6. Na barra de navegação superior, clique em Suporte.

    Captura de tela do cabeçalho do Console de Gerenciamento. Uma guia, rotulada como "Suporte", é realçada com um contorno laranja.

  7. Clique em 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 de linha de comando ghe-diagnostics para recuperar o diagnóstico para 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 os erros 500 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 do HAProxy
  • elasticsearch-logs/github-enterprise.log: logs do Elasticsearch
  • configuration-logs/ghe-config.log: logs de configuração GitHub Enterprise Server
  • collectd/logs/collectd.log: logs do Collectd
  • mail-logs/mail.log: logs de entrega de email SMTP

Para obter mais informações, confira "Sobre o log de auditoria da sua empresa".

Por padrão, os pacotes de suporte incluem os logs dos últimos dois dias. Você pode especificar uma duração exata em dias. Para fornecer os logs dos últimos oito dias, baixe um pacote de suporte estendido. Para obter mais informações, confira "Como criar e compartilhar pacotes de suporte estendido".

Dica: ao entrar em contato com o Suporte do GitHub, você receberá um email de confirmação que conterá 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. Em uma conta administrativa no GitHub Enterprise Server, no canto superior direito de qualquer página, clique em .

  2. Se você ainda não estiver na página "Administração do site", no canto superior esquerdo, clique em Administração do site.

  3. Na barra lateral " Administrador do site", clique em Console de Gerenciamento .

  4. Se você tiver criado várias contas de usuário do Console de Gerenciamento, selecione Administrador do site raiz ou usuário do Console de Gerenciamento . Para obter mais informações sobre as contas de usuário do Console de Gerenciamento, confira "Como gerenciar o acesso ao Console de Gerenciamento."

  5. Digite suas credenciais do Console de Gerenciamento. Em seguida, clique em Continuar.

  6. Na barra de navegação superior, clique em Suporte.

    Captura de tela do cabeçalho do Console de Gerenciamento. Uma guia, rotulada como "Suporte", é realçada com um contorno laranja.

  7. Clique em Baixar pacote de suporte.

  8. Se um engenheiro de suporte forneceu um link de carregamento para o pacote de suporte, use esse link. Caso contrário, acesse https://support.github.com/ e entre (se solicitado) em uma conta corporativa com direito a suporte.

  9. Acesse https://support.github.com/uploads e carregue seu pacote de suporte.

Criar um pacote de suporte usando SSH

Será possível seguir essas etapas para criar e compartilhar um pacote de suporte se você tiver acesso via SSH ao sua instância do GitHub Enterprise Server e acesso de saída à Internet.

Observação: se o sua instância do GitHub Enterprise Server estiver em uma configuração de replicação geográfica ou se a sua instância for um cluster, use o comando ghe-cluster-support-bundle para recuperar o pacote de suporte. Para obter mais informações, confira "Utilitários de linha de comando".

  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, confira "Utilitários de linha de comando".

  2. Se um engenheiro de suporte forneceu um link de carregamento para o pacote de suporte, use esse link. Caso contrário, acesse https://support.github.com/ e entre (se solicitado) em uma conta corporativa com direito a suporte.

  3. Acesse https://support.github.com/uploads e carregue seu pacote de suporte.

Carregar um pacote de suporte usando sua conta corporativa

  1. Navegue até o GitHub.com.

  2. No canto superior direito do GitHub.com, clique na foto do seu perfil e em Suas empresas.

  3. Na lista de empresas, clique na empresa que você deseja visualizar.

  4. Na barra lateral da conta corporativa, clique em Configurações.

  5. Em Configurações, clique em Licença .

  6. Em "Ajuda do GitHub Enterprise", clique em Carregar um pacote de suporte.

    Captura de tela da seção "Ajuda do GitHub Enterprise" da página de configurações da empresa. O botão "Carregar um link de pacote de suporte" está realçado com um retângulo laranja escuro.

  7. Em "Selecione uma conta corporativa", use o menu suspenso para selecionar a conta associada ao pacote de suporte.

  8. Em "Carregar um pacote de suporte para o Suporte do GitHub Enterprise", para selecionar o pacote de suporte, clique em Escolher arquivo ou arraste o arquivo de pacote de suporte para Escolher arquivo.

  9. Clique em Carregar.

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 via SSH ao sua instância do GitHub Enterprise Server.
  • Conexões HTTPS de saída pela porta TCP 443 são permitidas do sua instância do GitHub Enterprise Server com 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

Por padrão, os pacotes de suporte incluem os logs dos últimos dois dias, enquanto os pacotes de suporte estendidos incluem os logs dos últimos oito 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 fazer o download de 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 registro no GitHub Enterprise Server acontece em várias frequências (diária ou semanalmente) para diferentes arquivos, dependendo das expectativas de tamanho dos registros.

Criar um pacote de suporte estendido usando SSH

Será possível seguir essas etapas para criar e compartilhar um pacote de suporte estendido se você tiver acesso via SSH ao sua instância do GitHub Enterprise Server e acesso de saída à Internet.

  1. Baixe o pacote de suporte estendido por meio do SSH adicionando o sinalizador -x ao comando ghe-support-bundle:

    ssh -p 122 admin@HOSTNAME -- 'ghe-support-bundle -o -x' > support-bundle.tgz
    
  2. Se um engenheiro de suporte forneceu um link de carregamento para o pacote de suporte, use esse link. Caso contrário, acesse https://support.github.com/ e entre (se solicitado) em uma conta corporativa com direito a suporte.

  3. Acesse https://support.github.com/uploads e carregue 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 via SSH ao sua instância do GitHub Enterprise Server.
  • Conexões HTTPS de saída pela porta TCP 443 são permitidas do sua instância do GitHub Enterprise Server com 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'
    

Leitura adicional