Registro-de-eventos.md•2.94 kB
### Registro de eventos
**Cenário:**
- A plataforma registra eventos de usuário e plataforma.
- Todos os eventos são armazenados em uma fila do Storage Account.
- O serviço Insights é utilizado para processar e rotear os eventos.
- Os eventos da plataforma são direcionados para o Application Insights por padrão.
- Os eventos seguem o padrão xAPI.
**Fluxo:**
**1. Geração de Eventos:**
- A plataforma registra eventos de usuário e plataforma.
- Cada evento contém as informações relevantes, como tipo de evento, timestamp, dados específicos do evento, etc.
- Os eventos são publicados em uma fila do Storage Account, garantindo armazenamento persistente e escalabilidade.
**2. Processamento de Eventos pelo Azure Functions Insights:**
Um Azure Function é acionado sempre que um novo evento é publicado na fila do Storage Account.
A função recupera o evento da fila e o processa da seguinte forma:
**Identificação do Contexto:**
- O serviço extrai informações do evento para identificar o contexto do evento, como diretório e projeto associados.
- Essa etapa é crucial para rotear o evento para os conectores corretos.
**Consulta de Conectores Relevantes:**
- Com base no contexto do evento, o serviço consulta todos os conectores relacionados que estão aptos a receber o evento (utilizam determinado interface).
**Roteamento de Eventos para Conectores:**
- Para cada conector encontrado, o serviço cria uma instância do conector.
- A instância do conector recebe o evento original.
- A instância do conector processa o evento de acordo com sua lógica específica, podendo enviar o evento para outros sistemas, armazená-lo em um banco de dados ou realizar outras ações.
**3. Direcionamento de Eventos da Plataforma para o Application Insights:**
- Por padrão, todos os eventos da plataforma, quando na Azure, são direcionados para o Application Insights.
- O Application Insights coleta e armazena os dados do evento, permitindo consultas e análises detalhadas por até dois anos diretamente por ele.
- Os dados do evento são arquivados no Storage Account para armazenamento de longo prazo ou futuras manipulações.
**4. Conformidade com o Padrão xAPI:**
- Os eventos da plataforma seguem o padrão xAPI, garantindo interoperabilidade e compatibilidade com diversos sistemas de aprendizagem e análise.
- A estrutura e os elementos dos eventos são compatíveis com o padrão xAPI, facilitando a integração com ferramentas e plataformas de terceiros.
**Conclusão:**
O fluxo de registro de eventos descrito oferece uma solução completa e robusta para capturar, processar e rotear eventos em uma plataforma utilizando Azure Functions. A combinação do Storage Account, Azure Functions Insights, Application Insights e conformidade com o padrão xAPI garante confiabilidade, escalabilidade, análise de dados e interoperabilidade.