Enviar dados ao suporte do GitHub
Como o Suporte do GitHub não tem acesso ao seu ambiente, precisamos que você nos envie algumas informações adicionais.
Neste artigo:
Criar e compartilhar arquivos de diagnóstico
Os diagnósticos são uma visão geral das configurações e do ambiente de uma instância do GitHub Enterprise Server. Os diagnósticos contêm:
- Informações de licença do cliente, como nome da empresa, data de vencimento e número de disponíveis;
- 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.
-
In the upper-right corner of any page, click .
-
In the left sidebar, click Console de gerenciamento.
-
If prompted, type your Console de gerenciamento password.
-
In the upper right of the Console de gerenciamento, click Support.
-
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;hookshot-logs/exceptions.log
: erros de entrega por webhook.
Para obter mais informações, consulte "Gerar logs de auditoria".
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.
-
In the upper-right corner of any page, click .
-
In the left sidebar, click Console de gerenciamento.
-
If prompted, type your Console de gerenciamento password.
-
In the upper right of the Console de gerenciamento, click Support.
-
Clique em Download support bundle (Baixar pacote de suporte).
-
Acesse https://enterprise.github.com/support e entre (se solicitado).
-
Acesse https://enterprise.github.com/support/bundles/new e faça upload do seu pacote de suporte.
Criar um pacote de suporte usando SSH
Você pode usar estas etapas para criar e compartilhar um pacote de suporte se tiver acesso SSH ao seu appliance do Console de gerenciamento e se tiver acesso à internet.
Note: If you are using a Geo-replication configuration, or GitHub Enterprise Clustering, you should use the ghe-cluster-support-bundle
command to retrieve the support bundle. For more information, see "Command-line utilities."
-
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". -
Acesse https://enterprise.github.com/support e entre (se solicitado).
-
Acesse https://enterprise.github.com/support/bundles/new e faça upload do seu pacote de suporte.
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:
- Se você tiver acesso SSH ao seu appliance do GitHub Enterprise Server;
- Se as conexões de saída HTTPS na porta TCP 443 forem permitidas no seu appliance do GitHub Enterprise Server.
-
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 tiver acesso SSH ao seu appliance do GitHub Enterprise Server e se tiver acesso à internet.
-
Baixe o pacote de suporte estendido via SSH adicionando o sinalizador
-x
ao comandoghe-support-bundle
:$ ssh -p 122 admin@hostname -- 'ghe-support-bundle' -o -x > support-bundle.tgz
-
Acesse https://enterprise.github.com/support e entre (se solicitado).
-
Acesse https://enterprise.github.com/support/bundles/new 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:
- Se você tiver acesso SSH ao seu appliance do GitHub Enterprise Server;
- Se as conexões de saída HTTPS na porta TCP 443 forem permitidas no seu appliance do GitHub Enterprise Server.
-
Faça upload do pacote para o nosso servidor de pacotes de suporte:
$ ssh -p122 admin@hostname -- 'ghe-support-bundle -u -x'