Adicionar uma origem de evento do hub IoT ao seu ambiente do Azure Time Series Insight
Nota
O serviço Time Series Insights será desativado em 7 de julho de 2024. Considere migrar ambientes existentes para soluções alternativas o mais rápido possível. Para obter mais informações sobre a substituição e a migração, visite nossa documentação .
Este artigo descreve como usar o portal do Azure para adicionar uma fonte de evento que lê dados do Hub IoT do Azure ao seu ambiente do Azure Time Series Insights.
Nota
As instruções neste artigo se aplicam tanto ao Azure Time Series Insights Gen 1 quanto aos ambientes do Azure Time Series Insight Gen 2.
Pré-requisitos
- Crie um ambiente Azure Time Series Insights.
- Crie um hub IoT usando o portal do Azure.
- O hub IoT deve ter eventos de mensagem ativos sendo enviados.
- Crie um grupo de consumidores dedicado no Hub IoT para o ambiente do Azure Time Series Insight do qual consumir. Cada fonte de evento do Azure Time Series Insight deve ter seu próprio grupo de consumidores dedicado que não seja compartilhado com nenhum outro consumidor. Se vários leitores consumirem eventos do mesmo grupo de consumidores, todos os leitores provavelmente apresentarão falhas. Para obter detalhes, leia o guia de desenvolvedor do Hub IoT do Azure.
Adicionar um grupo de consumidores ao hub IoT
Os aplicativos usam grupos de consumidores para extrair dados do Hub IoT do Azure. Para ler de forma confiável os dados do hub IoT, forneça um grupo de consumidores dedicado que é usado apenas por esse ambiente do Azure Time Series Insight.
Para adicionar um novo grupo de consumidores ao hub IoT:
No portal do Azure, localize e abra o hub IoT.
Em Configurações, selecione Pontos de Extremidade Integradose, em seguida, selecione o ponto de extremidade Eventos.
Em grupos de consumidores, insira um nome exclusivo para o grupo de consumidores. Use esse mesmo nome em seu ambiente do Azure Time Series Insight ao criar uma nova fonte de evento.
Selecione Salvar.
Adicionar uma nova fonte de evento
Acesse o portal do Azure
. No menu à esquerda, selecione Todos os recursos. Selecione seu ambiente do Azure Time Series Insight.
Em Configurações, selecione Fontes de Eventose, em seguida, selecione Adicionar.
No painel de origem de novo evento , para o nome de origem do evento , insira um nome exclusivo para este ambiente do Azure Time Series Insight. Por exemplo, insira o fluxo de eventos .
Para a origem , selecione o Hub IoT .
Selecione um valor para a opção de importação .
Se você já tiver um hub IoT em uma de suas assinaturas, selecione Usar o Hub IoT em assinaturas disponíveis. Essa opção é a abordagem mais fácil.
A tabela a seguir descreve as propriedades necessárias para a opção Usar o Hub IoT de assinaturas disponíveis:
Propriedade Descrição Subscrição A assinatura à qual o Hub IoT desejado pertence. Nome do hub IoT O nome do hub iot selecionado. Nome da política do hub IoT Selecione a política de acesso compartilhado. Você pode encontrar a política de acesso compartilhado na guia de configurações do Hub IoT. Cada política de acesso compartilhado tem um nome, permissões que você define e chaves de acesso. A política de acesso compartilhado do de origem do evento deve ter permissões de conexão de serviço. Chave de política do hub IoT A chave é pré-preenchida. Se o hub IoT for externo às suas assinaturas ou se você quiser escolher opções avançadas, selecione Fornecer configurações do Hub IoT manualmente.
A tabela a seguir descreve as propriedades necessárias para as configurações Fornecer Hub IoT manualmente:
Propriedade Descrição ID da assinatura A assinatura à qual o hub IoT desejado pertence. Grupo de recursos O nome do grupo de recursos no qual o hub IoT foi criado. Nome do hub IoT O nome do hub IoT. Quando você criou o hub IoT, inseriu um nome para o Hub IoT. Nome da política do hub IoT A política de acesso compartilhado. Você pode criar a política de acesso compartilhado na guia de configurações do Hub IoT. Cada política de acesso compartilhado tem um nome, permissões que você define e chaves de acesso. A política de acesso compartilhado para sua fonte de evento deve ter permissões de conexão de serviço. Chave de política do hub IoT A chave de acesso compartilhado usada para autenticar o acesso ao namespace da Service Bus do Azure. Insira a chave primária ou secundária aqui. Ambas as opções compartilham as seguintes opções de configuração:
Propriedade Descrição Grupo de consumidores do Hub IoT O grupo de consumidores que lê eventos do Hub de Internet das Coisas. É altamente recomendável que você use um grupo de consumidores dedicado para sua fonte de evento. Formato de serialização de eventos Atualmente, JSON é o único formato de serialização disponível. As mensagens de evento devem estar nesse formato ou nenhum dado pode ser lido. Nome da propriedade Timestamp Para determinar esse valor, você precisa entender o formato da mensagem dos dados de mensagem enviados para o Hub IoT. Esse valor é o nome da propriedade de evento específica nos dados da mensagem que você deseja usar como o carimbo de data/hora do evento. O valor é sensível a maiúsculas e minúsculas. Se for deixado em branco, o tempo de enfileiramento de evento na origem do evento será utilizado como o timestamp do evento.
Adicione o nome do grupo de consumidores dedicado do Azure Time Series Insight que você adicionou ao hub IoT.
Selecione Criar.
Depois de criar a origem do evento, o Azure Time Series Insight inicia automaticamente o streaming de dados para seu ambiente.
Próximas etapas
Definir políticas de acesso a dados para proteger os dados.
Enviar eventos para a origem do evento.