• Notice: Undefined variable: token in bb_coveo_search_ui_block_page_attachments() (line 53 of modules/custom/bb_widgets/bb_coveo_search_ui/bb_coveo_search_ui_block.module).
  • Warning: array_flip(): Can only flip STRING and INTEGER values! in Drupal\Core\Entity\EntityStorageBase->loadMultiple() (line 312 of core/lib/Drupal/Core/Entity/EntityStorageBase.php).

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