Skip to main content

Fornecer dados para o GitHub Support

Uma vez que GitHub Support 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

GitHub Support 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.

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

Criar um arquivo de diagnóstico no Management Console

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

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

    Captura de tela do ícone de foguete para acesso às configurações de administração do site

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

    Captura de tela do link "Administração do site" 1. Na barra lateral à esquerda, clique em Management Console . Guia Management Console na barra lateral esquerda 1. Se solicitado, digite sua senha do Management Console. Tela de desbloqueio do Management Console 4. No canto superior direito do Management Console, clique em Suporte. Botão para acessar a área de suporte

  3. 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 Management Console.

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 Management Console;
  • 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 do 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 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, confira "Como criar e compartilhar pacotes de suporte estendido".

Dica: ao entrar em contato com o GitHub Support, você receberá um email de confirmação que conterá um link de referência do tíquete. Se o GitHub Support 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 Management Console

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

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

    Captura de tela do ícone de foguete para acesso às configurações de administração do site

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

    Captura de tela do link "Administração do site" 1. Na barra lateral à esquerda, clique em Management Console . Guia Management Console na barra lateral esquerda 1. Se solicitado, digite sua senha do Management Console. Tela de desbloqueio do Management Console 4. No canto superior direito do Management Console, clique em Suporte. Botão para acessar a área de suporte

  3. Clique em Baixar pacote de suporte.

  4. 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. 1. 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 your GitHub Enterprise Server instance e acesso de saída à Internet.

Observação: se você estiver usando uma configuração de replicação geográfica ou o Clustering do GitHub Enterprise, 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. 1. 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. "Suas empresas" no menu suspenso na foto de perfil no GitHub Enterprise Server

  3. Na lista de empresas, clique na empresa que você deseja visualizar. Nome de uma empresa na lista das suas empresas 1. Na barra lateral da conta corporativa, clique em Configurações. Guia Configurações na barra lateral das contas corporativas

  4. Na barra lateral esquerda, clique em Licenciamento da empresa. Captura de tela que mostra o link "Licenciamento da empresa" na barra lateral das configurações da conta corporativa.

  5. Em "Ajuda do GitHub Enterprise", clique em Carregar um pacote de suporte. Captura de tela que mostra "Carregar um link de pacote de suporte".

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

  7. Em "Carregar um pacote de suporte para o GitHub Enterprise Support", para selecionar o pacote de suporte, clique em Escolher arquivo ou arraste o arquivo de pacote de suporte para Escolher arquivo. Captura de tela que mostra o botão "Escolher arquivo" para carregar um arquivo de pacote de suporte.

  8. 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 your GitHub Enterprise Server instance.
  • Conexões HTTPS de saída pela porta TCP 443 são permitidas do your GitHub Enterprise Server instance 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

Os pacotes de suporte incluem os logs dos últimos dois dias, enquanto os pacotes de suporte estendidos incluem os logs dos últimos sete dias. Se os eventos que o GitHub Support 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 Management Console.

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 your GitHub Enterprise Server instance 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. 1. 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 your GitHub Enterprise Server instance.
  • Conexões HTTPS de saída pela porta TCP 443 são permitidas do your GitHub Enterprise Server instance 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