A página de registros do SIS exibe todos os registros do processo da interface do usuário (UI) para todas as integrações do Sistema de Informações do Aluno (SIS). Os arquivos de registro desempenham um papel importante na solução de problemas do sistema, bem como monitoram o progresso das transações do sistema. Definir o detalhamento de log durante a criação define o tipo e a profundidade do log mantido no sistema para a integração selecionada. Os logs estão ativos e podem ser filtrados, visualizados e removidos da tela Logs SIS.


Nível de log

Quatro tipos de níveis de log estão disponíveis, e cada integração do SIS informa um nível diferente de registro baseado na configuração da integração. Esta lista descreve o tipo de mensagens que cada integração deve publicar nos logs nos diferentes níveis.

  • Erro: Qualquer problema fatal ou que impeça as operações de criação, atualização, desativação ou remoção.
  • Aviso e acima: Qualquer problema que não seja fatal ou com um registro individual, ou qualquer operação bem-sucedida que exija a alteração do registro.
  • Mensagem e acima: Qualquer atividade bem-sucedida, incluindo tipos de registros e contagens, cronometragem e dados.
  • Depurar e acima: Todos os registros individuais e tentativas de transformação de dados.

Se você definir o Nível de detalhamento do log para Todas as mensagens de diagnóstico ou Todas as mensagens de diagnóstico e depuração ao criar ou editar uma integração do SIS, selecione um período na lista Ativar o registro de diagnóstico. O registro de diagnóstico é melhor usado para testes de curto prazo e pode causar problemas de desempenho se for deixado ativado. Após o tempo escolhido terminar, os registros gravarão os Erros e avisos. Recomendamos que você remova os registros ao terminar o teste.


Visualizar e filtrar entradas de registros

Os registros podem ser filtrados usando um método de busca avançado que inclui o tipo de erro, a integração e o intervalo de datas. Novos itens de log são facilmente visíveis com a contagem anexada ao tipo de item de log. Os logs podem ser atualizados para recuperar a última contagem e detalhes de cada tipo de log. A limpeza da contagem de log somente limpará o número associado ao tipo de log, mas não removerá os logs. A remoção de logs não pode ser desfeita e a solicitação de verificação é apresentada antes que os logs sejam permanentemente removidos. O botão Remover registro se aplica somente à integração selecionada. 

  1. No Painel do administrador, em Integrações, selecione Integração de dados.
  2. Selecione Integrações dos Sistemas de Informações do Aluno (SIS).
  3. Selecione Exibir todos os erros.
  4. Digite uma palavra de busca no campo Pesquisar. Serão exibidos resultados exatos.
  5. Selecione a integração no primeiro menu.
  6. Selecione o nível de detalhamento no segundo menu.
  7. Marque a caixa de seleção De para definir uma data inicial e faixa de horário. Digite as datas e as horas nas caixas ou utilize o pop-up Calendário para seleção de data e Menu de seleção de hora para selecionar as datas e as horas.
  8. Marque a caixa de seleção A para definir uma data final e faixa de horário. Digite as datas e as horas nas caixas ou utilize a janela pop-up do Calendário para seleção de data e do Menu de seleção de hora para selecionar as datas e as horas.

    Não é possível pesquisar por registros em um intervalo de data maior do que sete dias.

  9. Selecione Ir.
  10. Entradas de registros são listadas, junto com a integração, data, nível de log e descrição.
  11. Selecione o item de registro para visualizar detalhes do log.

Gerenciar entradas de registros

Você pode gerenciar seus entradas de registros para facilitar a localização de problemas de dados. Por exemplo, se você se depara com um erro específico, é mais fácil filtrar menos informações. Gerenciar entradas de registros também é benéfico para manter a quantidade de espaço usada no mínimo. Recomenda-se periodicamente remover os registros para manter as informações atualizadas.

  1. No Painel do administrador, em Integrações, selecione Integração de dados.
  2. Selecione Integrações dos Sistemas de Informações do Aluno (SIS).
  3. Selecione Exibir todos os erros.
  4. Selecione Atualizar para recuperar novos registros.
  5. Selecione Remover registro para remover as informações de registros para uma integração específica.

Local do arquivo de log

Para fins de gerenciamento de arquivos de log ou análise de dados do histórico, você pode localizar os arquivos de log de integração de dados no diretório de logs da ~blackboard:

~blackboard/logs/data-integration/<integration_type>/<integration_name>

onde:

<integration_type> é: bb-flatfile (Arquivo simples de instantâneo), bb-lis (LIS 2.0), bb-ss-xml (XML do instantâneo), bb-ims-vista-xml (IMS Enterprise Vista), ou bb-ims-xml (IMS Enterprise)

e

<integration_name> é o nome da sua integração, conforme especificado na configuração de integração.


Acessar registros via serviços da web REST

Na nova estrutura, você pode acessar esse relatório ivia serviços da web REST. Para acessar os logs, acrescente /learn/api/v1/logs/sis/{dataSetUid} ao domínio do Blackboard Learn. O sistema fornece um código de referência, dataSetUid, toda vez que um arquivo feed for processado. Esse parâmetro é necessário para retornar os resultados. As mensagens de erro e sucesso são registradas na tabela DATA_INTGR_LOG.

Parâmetros adicionais estão disponíveis para segmentar os dados:

  • Parâmetro do nível de log: /learn/api/v1/logs/sis/{dataSetUid}?logLevel=(DEBUG,WARNING,ERROR,INFORMATION).
  • Parâmetros de paginação padrão: /learn/api/v1/logs/sis/{dataSetUid}?limit=25&&offset=10. Por padrão, a solicitação padrão tem um limite de 20 páginas, a menos que você altere esse valor.

O processo para solucionar problemas de erros de registro nos serviços da web não é alterado do processo para solucionar problemas de registros de erros. Se você encontrar uma mensagem de erro "não encontrado", é possível que o dataSetUid não exista no sistema ou o arquivo de feed ainda esteja sendo processado.