Skip to main content

Registros de integração de SIA

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

Níveis logarítmicos

Quatro tipos de níveis de registro estão disponíveis, e cada integração do SIA 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 registros nos diferentes níveis.

  • Erro: Qualquer problema fatal, qualquer problema que impeça operações de criar, atualizar, desabilitar ou purgar.

  • Aviso e acima: Qualquer problema não fatal, qualquer problema com um registro individual ou qualquer operação bem-sucedida que tenha exigido alteração no registro.

  • Mensagem e Acima: Qualquer atividade bem-sucedida, incluindo tipos e contagens de registros, tempo e dados.

  • Depuração e Acima: Todos os registros individuais e tentativas de transformação de dados.

Se você definir Log Verbosity para Todas as Mensagens de Diagnóstico ou Todas as Mensagens de Diagnóstico e Depuração ao criar ou editar uma integração com o Sistema de informações do aluno (SIA), clique em um horário na lista de Registro Ativo de Diagnóstico. O registro de diagnóstico é melhor usado para testes de curto prazo e pode causar problemas de desempenho se for deixado habilitado. Após o tempo escolhido, os registros registrarão Erros e Avisos. Recomendamos que você exclua os registros ao terminar o teste.

Visualizar e filtrar as entradas do log

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 registro são facilmente visíveis com a contagem anexada ao tipo de item de log. Os registros podem ser atualizados para recuperar a última contagem e detalhes de cada tipo de log. A limpeza da contagem de registro somente limpará o número associado ao tipo de log, mas não excluirá os logs. A remoção de registros não pode ser desfeita e a solicitação de verificação é apresentada antes que os registros sejam permanentemente excluídos. O botão Excluir registro se aplica somente à integração selecionada.

  1. No Painel do Administrador, em Integrações, clique em Integração de Dados.

  2. Clique em Integrações dos Sistemas de Informação do aluno (SIA).

  3. Clique em Ver Todos os Erros.

  4. Digite uma palavra de busca no campo Buscar. Serão exibidos resultados exatos.

  5. Clique na integração no primeiro menu.

  6. Clique no nível de detalhamento no segundo menu.

  7. Clique na caixa de seleção De para definir uma data e faixa de tempo de início. Digite datas e horários nas caixas ou use o pop-up Calendário de Seleção de Datas e Menu de Seleção de Hora para selecionar datas e horários.

  8. Clique na caixa de seleção Para para definir uma data e intervalo de tempo para o término. Digite datas e horários nas caixas ou use o pop-up Calendário de Seleção de Datas e Menu de Seleção de Hora para selecionar datas e horários.

    Nota

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

  9. Clique em Go.

  10. Entradas de registros são listadas, junto com a integração, data, nível de registro e descrição.

  11. Clique no item de registro para visualizar detalhes do log.

Gerenciar entradas de registro

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 excluir os registros para manter as informações atualizadas.

  1. No Painel do Administrador, em Integrações, clique em Integração de Dados.

  2. Clique em Integrações dos Sistemas de Informação do aluno (SIA).

  3. Clique em Ver Todos os Erros.

  4. Clique em Atualizar para recuperar novos logs.

  5. Clique em Purgar Log para excluir as informações do registro de uma integração específica.

Local do arquivo de log

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

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

onde:

<integration_type> é um dos seguintes: bb-flatfile (arquivo simples de captura de tela), bb-lis (LIS 2.0), bb-ss-xml (XML de captura de tela), bb-ims-vista-xml (IMS Enterprise Vista) ou bb-ims-xml (IMS Enterprise)</integration_type>

e

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

Logs de acesso via REST Web Services

Na nova estrutura, você pode acessar esse relatório via serviços da web REST. Para acessar os logs, adicione /learn/api/v1/logs/sis/{dataSetUid} ao seu domínio 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 logLevel: /learn/api/v1/logs/sis/{dataSetUid}?logLevel=(DEBUG,WARNING,ERROR,INFORMATION).

  • Parâmetros padrão de paginaçã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.