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
  • tag de log
  • 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.

Para atingir esse objetivo, selecione a guia Administração do sistema. Na seção Ferramentas e utilitários, selecione Logs e Logs do sistema. Você encontrará as instruções a seguir para fazer o download e executar o script.