Como instalar a integração Add Request ID através do Azion Marketplace

A integração Add Request ID da Azion permite que você adicione um cabeçalho adicional no objeto da requisição recebida, atribuindo um identificador único a cada requisição HTTP atendida pela Plataforma de Edge da Azion.

Esse identificador facilita o rastreamento e a identificação de requisições individuais, além de permitir que você analise logs e identifique problemas. Dessa forma, você pode cruzar dados de produtos de observabilidade, como Data Stream e Real-Time Events da Azion, com os logs internos da sua infraestrutura.

Obtenha a integração

Para instalar a Add Request ID da Azion:

Acesse o Azion Console > Marketplace.
Na página inicial do Marketplace, selecione o card da Add Request ID.
Na página de integração, clique no botão Install.

Você verá uma mensagem indicando que sua integração foi instalada com sucesso.

Configure a integração

Configure um edge firewall

Siga estes passos:

No canto superior esquerdo, abra o Products menu e selecione Edge Firewall na seção Secure.
Clique no botão + Edge Firewall.
Dê um nome fácil de lembrar ao seu edge firewall.
Selecione os domínios que deseja proteger com a função.
Ative a opção Edge Functions na seção Modules.
Clique no botão Save.

Pronto. Agora você instanciou o edge firewall para sua função e tem acesso a edge functions em seu edge firewall.

Configure a função

Ainda na página do Edge Firewall:

Selecione a aba Functions Instances.
Clique no botão + Function Instance.
Dê um nome fácil de lembrar para sua instância.
No menu suspenso, selecione a função Add Request ID.
- Esta ação carregará a aba Arguments.

Neste caso, a função Add Request ID pode ser usada sem argumentos. No entanto, ela possui um único argumento opcional que pode ser usado para modificar o nome do cabeçalho onde o Request ID será inserido.

Chave JSON Args	Nome da Variável de Ambiente	Tipo de Dados	Valor Padrão	Descrição
`header_name`	`AZION_REQUEST_ID_HEADER_NAME`	String	`x-azn-request-id`	O nome do cabeçalho onde a função irá inserir o Request ID. Se o argumento não for uma string não vazia, a função usará o valor padrão.

Quando terminar, clique no botão Save.

Selecione a aba Functions.
Clique no botão Add Function.
Dê um nome fácil de lembrar para sua instância.
No menu suspenso, selecione a função Add Request ID.

Esta ação irá carregar a função, mostrando um formulário com o código da função e, logo acima, duas abas: Code e Args.

Ao clicar na aba Code, você poderá navegar pelo código-fonte, mas não alterá-lo.

Na aba Args, você passará suas variáveis. Neste caso, a função Add Request ID pode ser usada sem argumentos. No entanto, ela possui um único argumento opcional que pode ser usado para modificar o nome do cabeçalho onde o Request ID será inserido.

Chave JSON Args	Nome da Variável de Ambiente	Tipo de Dados	Valor Padrão	Descrição
`header_name`	`AZION_REQUEST_ID_HEADER_NAME`	String	`x-azn-request-id`	O nome do cabeçalho onde a função irá inserir o Request ID. Se o argumento não for uma string não vazia, a função usará o valor padrão.

Quando terminar, clique no botão Save.

Configure o Rules Engine

Para finalizar, você precisa configurar o Rules Engine para definir o criteria (critério) e o behavior (comportamento) para executar a função.

Ainda na página do Edge Firewall:

Selecione a aba Rules Engine.
Clique no botão + Rule Engine.
Dê um nome fácil de lembrar para a regra.
- Você pode adicionar uma descrição, mas é um passo opcional.
Selecione um criteria para executar e capturar os domínios em que você deseja executar a integração.
Logo, selecione o behavior Run Function.
Selecione a função adequada de acordo com o nome que você deu a ela na etapa de instanciação.
Clique no botão Save.

Pronto. Você agora configurou a integração Add Request ID e começará a receber o cabeçalho.