Os administradores costumam ter a tarefa de solucionar problemas no ambiente do Blackboard Learn de sua instituição. Para ajudar você a ter uma visão completa do que está acontecendo durante um problema, o Blackboard Learn gera logs para você consultar. Esses logs são salvos no armazenamento de arquivos local da sua instituição para consulta rápida e armazenamento confiável. Você pode baixar os arquivos conforme necessário ou usar permissões de arquivo para compartilhar com outras pessoas. Consulte o relatório de insight para determinar a quantidade de espaço em disco utilizada pelos logs.

Acessar logs

Você pode acessar logs do sistema na Coleção de conteúdo. No Painel do administrador, selecione Gerenciar conteúdo, na seção Gerenciamento de conteúdo. Selecione Interno > Logs. Os logs são armazenados em uma estrutura de pastas por ano, mês, dia e hora. Navegue pela árvore de pastas para encontrar o log exato que você está procurando.

Transferência e retenção de log

A pasta hora usa o Tempo Universal Coordenado (UTC). Os logs são transferidos para o sistema de arquivos local uma vez por hora, mas com um atraso de quatro horas. Por exemplo, se a hora atual for 4, então durante essa hora os logs da hora 0 serão transferidos.

Os logs são mantidos no armazenamento de arquivos local da sua instituição, para que você possa determinar e aplicar suas próprias políticas de retenção de logs.

Formato de log

Os logs contêm uma hora de dados de logs por nó do Blackboard Learn e são armazenados em um formato compactado. Se três nós forem executados em uma hora, você verá três arquivos.

Os logs são compactados usando o gzip. Você pode descompactar esses arquivos com ferramentas como o 7Zip para Windows ou descompactar no Mac ou Linux. Quando descompactado, o resultado é um arquivo de texto contendo eventos de log armazenados em objetos JSON. Cada objeto JSON inicia e termina com uma chave e possui os seguintes campos:

  • caminho, que mostra o arquivo no servidor do Blackboard Learn no qual o evento foi originado
  • carimbo de data e hora, a hora em que o evento ocorreu
  • código do cliente
  • versão
  • host, o endereço IP do nó do Blackboard Learn em que o evento foi originado
  • mensagem, as informações do Blackboard Learn incluídas no arquivo de log sobre o evento

Formatar logs para ficarem mais legíveis

Os arquivos de log são armazenados como arquivos JSON, o que pode dificultar a leitura se você não estiver familiarizado com o formato. Você pode reformatar o arquivo para torná-lo mais legível.

Antes de começar, baixe e instale o Python 3. Se você estiver usando um Mac ou Linux, talvez já tenha o Python 3 instalado.

Para verificar qual versão do Python você pode ter instalado, abra o Terminal e execute o comando python --version. Se você receber um erro ou uma versão anterior do Python estiver instalada, tente python3 --version.

Se python ou python3 funcionar, use-o no comando abaixo.

Para começar, faça download do script convertLogs.py usando o link abaixo. O anexo é um arquivo de texto simples. Para usá-lo como um script do Python, edite a extensão do arquivo para usar .py depois que você o baixar no seu computador. Anote onde o script foi salvo, por exemplo, ~/Downloads/scripts. Você precisará saber o caminho quando executar o script nas etapas abaixo.

Se você estiver usando o Windows, use o terminal Powershell nas etapas abaixo.

Para baixar e converter uma hora de logs:

  1. Faça logon no Blackboard Learn como administrador.
  2. Acesse Painel do administrador > Gerenciar conteúdo.
  3. Localize a pasta de logs que você deseja fazer download. Por exemplo, /internal/logs/2019/03/03/12.
  4. Faça download de um arquivo de log de uma das pastas de hora.
  5. Na janela do terminal, execute o script. Execute python ~/Downloads/scripts/convertLogs.py -f ~/Downloads/Logs -o ~/LearnLogs.
    • O parâmetro –f deve ser um caminho de pasta. É onde os logs não formatados são salvos atualmente.
    • O parâmetro –o deve ser uma pasta vazia. É onde os logs formatados serão salvos. O script criará a pasta se ela não existir.

Para baixar e converter várias horas de logs:

  1. Faça logon no Blackboard Learn como administrador.
  2. Acesse Painel do administrador > Gerenciar conteúdo.
  3. Localize a pasta de logs que você deseja fazer download. Por exemplo, /internal/logs/2019/03/03/12.
  4. Selecione as horas que você deseja fazer download, por exemplo 11, 12, 13.
  5. Selecione Baixar pacote e salve-o em uma pasta local. Isto criará um arquivo zip com logs.
  6. Extraia o arquivo zip usando o programa de descompressão integrado do seu computador. Para Windows. Clique com o botão direito do mouse no arquivo zip e escolha Extrair tudo.
  7. Na janela do terminal, execute o script. Execute python ~/Downloads/scripts/convertLogs.py -f ~/Downloads/Logs -o ~/LearnLogs.
    • O parâmetro –f deve ser um caminho de pasta. É onde os logs não formatados são salvos atualmente.
    • O parâmetro –o deve ser uma pasta vazia. É onde os logs formatados serão salvos. O script criará a pasta se ela não existir.