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 fazer o download dos arquivos conforme necessário ou usar permissões de arquivo para compartilhar com outras pessoas.  Consulte o relatório de informações para determinar quanto espaço em disco é usado pelos registros.

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 e depois Registros. 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. O atraso refere-se ao tempo que os Registros levam para ser gerados e disponibilizados na interface gráfica do usuário.

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 Registros e depois Registros do sistema. Você encontrará as instruções para fazer o download e executar o roteiro.