Visão geral da extensão do Microsoft Azure

NOTE
O Adobe Experience Platform Launch foi reformulado como um conjunto de tecnologias de coleção de dados na Adobe Experience Platform. Como resultado, várias alterações de terminologia foram implementadas na documentação do produto. Consulte o seguinte documento para obter uma referência consolidada das alterações de terminologia.

No Microsoft Azure, o Event Hubs é um serviço de entrada de dados em tempo real altamente escalável que permite processar e analisar as grandes quantidades de dados produzidas pelos seus dispositivos e aplicativos conectados. Depois que os dados são coletados em um hub de eventos, eles podem ser transformados e armazenados usando qualquer provedor de análise em tempo real ou adaptadores de armazenamento/em lote.

A extensão Microsoft Azure encaminhamento de eventos aproveita Event Hubs para enviar eventos do Edge Network Adobe Experience Platform para Azure para processamento adicional. Este guia aborda como instalar a extensão e empregar seus recursos em uma regra de encaminhamento de eventos.

Pré-requisitos

Para usar essa extensão, você deve ter uma conta válida do Azure com acesso ao Event Hubs. Você também deve criar um hub de eventos usando o Azure portal antes de seguir as etapas abaixo.

Instalar a extensão

Para instalar a extensão Azure do Microsoft, navegue até a interface da Coleção de dados ou a interface do Experience Platform e selecione Encaminhamento de eventos na navegação à esquerda. Aqui, selecione uma propriedade à qual adicionar a extensão ou crie uma nova propriedade.

Depois de selecionar ou criar a propriedade desejada, selecione Extensões na navegação à esquerda e selecione a guia Catálogo. Procure o cartão Microsoft Azure e selecione Instalar.

O botão Instalar sendo selecionado para a extensão do Microsoft Azure na interface da Coleção de Dados.

Como a extensão não tem propriedades de configuração, ela é adicionada imediatamente à lista de extensões instaladas. Agora você pode começar a usar os tipos de ação Event Hub ao configurar as regras de encaminhamento de eventos.

Configurar uma regra de encaminhamento de eventos rule

Comece a criar uma nova regra de encaminhamento de eventos e configure as condições conforme desejado. Ao selecionar as ações para a regra, selecione Microsoft Azure para a extensão e Enviar Dados para os Hubs de Eventos para o tipo de ação.

O tipo de ação Enviar Dados para os Hubs de Eventos que está sendo selecionado para uma regra na Interface da Coleção de Dados.

O painel direito atualiza para mostrar as opções de configuração de como os dados devem ser enviados. Você deve atribuir elementos de dados às várias propriedades que representam sua configuração Event Hub.

As opções de configuração do tipo de ação Enviar Dados para os Hubs de Eventos mostradas na interface do usuário.

Detalhes do Hub de Eventos

Entrada
Descrição
Namespace
O nome do namespace Event Hubs que você criou ao configurar o hub de eventos.
Nome
O nome do hub de eventos.
Nome da Regra de Autorização SAS
O nome da regra de autorização de acesso compartilhado para todo o namespace Event Hubs ou a instância do hub de eventos específica para a qual você deseja enviar dados. Consulte a seção do apêndice sobre obtenção de valores de autorização SAS para obter mais informações.
Chave de Acesso SAS
A chave primária da regra de autorização de acesso compartilhado para todo o namespace Event Hubs ou a instância do hub de eventos específico para a qual você deseja enviar dados. Consulte a seção do apêndice sobre obtenção de valores de autorização SAS para obter mais informações.
ID da Partição
Event Hubs permite enviar eventos diretamente para partições específicas. Para aproveitar esse recurso, forneça a ID da partição que você deseja que receba os eventos.

Dados

Entrada
Descrição
Carga
Este campo contém os dados que serão encaminhados para o Event Hubs. Os dados podem ser um objeto JSON, uma string ou um elemento de dados.

Quando terminar, selecione Manter alterações para adicionar a ação à configuração de regra. Quando estiver satisfeito com a regra, selecione Salvar na biblioteca.

Finalmente, publique um novo encaminhamento de eventos build para habilitar as alterações na biblioteca.

Próximas etapas

Este guia abordou como enviar dados para Event Hubs usando a extensão de encaminhamento de eventos Microsoft Azure. Para obter mais informações sobre os recursos de encaminhamento de eventos do Experience Platform, consulte a visão geral do encaminhamento de eventos.

Apêndice: Obtenção de valores de autorização SAS sas

Os aplicativos externos recebem acesso a Event Hubs por meio de assinaturas de acesso compartilhado (SAS). Cada namespace e instância do hub de eventos Event Hubs tem uma regra de autorização SAS padrão automaticamente atribuída na criação, mas você também pode criar políticas adicionais para cada recurso, se desejar.

Ao configurar uma regra de encaminhamento de eventos usando a extensão Azure, você deve fornecer o nome e a chave primária da regra de autorização que rege o namespace ou o hub de eventos específico para o qual deseja enviar dados. Para obter detalhes sobre como obter esses valores do portal Azure, consulte as seguintes seções na documentação do Azure:

Depois de ter os valores necessários, o nome da regra de autorização pode ser fornecido diretamente como uma string na entrada de configuração ou você pode criar um elemento de dados do tipo string para referenciá-lo. No entanto, a chave primária deve primeiro estar contida dentro de um segredo de encaminhamento de eventos para que possa ser fornecida na configuração de regras para proteger sua segurança de dados.

Na interface do usuário do encaminhamento de eventos, crie um novo segredo e selecione Token como o tipo de segredo. Para o próprio valor do token, forneça a chave primária copiada anteriormente. Depois de criar o segredo, crie um elemento de dados do tipo Segredo e selecione o segredo Event Hubs na lista. Depois que o elemento de dados secreto for configurado, você poderá referenciá-lo no campo Chave de Acesso SAS.

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743