Crie um template personalizado
Escolha as variáveis de cada linha de log do Data Stream com um template personalizado e use-o em um stream, no Azion Console ou pela Azion API.
Você pode criar um template personalizado do Data Stream no Azion Console ou pela Azion API e usá-lo em qualquer stream da sua conta. Para mudar a forma como um endpoint Standard HTTP/HTTPS POST une as linhas de log, consulte Personalize o payload do HTTP POST.
Um template predefinido envia todas as variáveis que contém, e você não pode mudar essas variáveis. Um template personalizado envia apenas as entradas do seu Data Set, um objeto JSON cujas chaves você nomeia e cujos valores são variáveis da fonte de dados do stream. Para o formato, consulte Templates personalizados.
Os exemplos criam status-analysis, um template com cinco variáveis de Applications para uma análise do status da resposta. Substitua-as pelas variáveis de que você precisa.
Escolha a interface em que você trabalha. Os pré-requisitos e as três tarefas seguem essa escolha.
Pré-requisitos
- A permissão Edit Data Stream. Com apenas View Data Stream, você vê templates e streams, mas não pode criá-los nem alterá-los. Para mais informações, consulte Configurações do stream.
- As variáveis que você quer em cada linha de log, da fonte de dados do stream que usa o template. Para cada variável e os templates predefinidos que a contêm, consulte Fontes de dados e variáveis.
- Para usar o template, um stream na sua conta. Para criar um, consulte Primeiros passos do Data Stream.
- Acesso ao Azion Console. Para entrar, consulte Como acessar o Azion Console.
- Uma conta com menos de 3.000 workloads. Com 3.000 workloads ou mais, o Console bloqueia os formulários de stream, que contêm o painel lateral de templates, e você gerencia os templates apenas pela API.
Crie o template
O Console cria templates em um painel lateral do formulário de stream, não em uma página própria. O template pertence à conta, então todo stream pode usá-lo.
Para criar o template com a API, envie uma requisição POST com name e data_set. O valor de data_set é o objeto JSON como string, com as aspas escapadas:
A API responde 201 com o template armazenado:
O template existe com custom: true. Guarde o valor de id, que um stream usa para indicar o template. Uma requisição GET para /v4/workspace/stream/templates lista o template ao lado dos templates predefinidos.
Use o template em um stream
Um stream indica um único template. Selecionar o template personalizado substitui o template predefinido ou o template que o stream usava antes.
Para usar o template em um stream com a API, defina transform[render_template].attributes.template como o id do template. Envie o array transform inteiro: o item render_template e o item filter_workloads ou sampling que o stream já tem. Sem um desses dois itens, a requisição falha com 32002. Substitua <stream-id> pelo ID do seu stream e <workload-id> por um workload do stream:
O stream armazenado indica o template 1234 em transform[render_template].attributes.template. Para usar o template em um stream que você cria, coloque o mesmo item render_template no corpo da criação. Para o corpo completo, consulte Configurações do stream.
Um stream com filtro de workloads, como no exemplo da API, mantém os outros streams em execução. Salvar um stream ativo que usa sampling desativa todos os outros streams da conta.
As linhas de log que o stream envia após a mudança contêm apenas as chaves do data set, como {"time": …, "host": …, "status": …, "request_uri": …, "upstream_status": …}. Para verificar a entrega, leia uma linha de log no endpoint. Cada envio também é registrado em Real-Time Events, com o código de status que o endpoint retornou.
Edite o template
Para adicionar ou remover uma variável em um stream em execução, mude o data set do template personalizado do stream. Um template predefinido não pode ser editado: duplique-o e use a cópia.
Para editar o template com a API, envie uma requisição PATCH apenas com as chaves que você muda. Este exemplo renomeia o template. Substitua <template-id> pelo id do template:
A API responde 200 com o template armazenado:
A resposta contém o name alterado e um last_modified posterior, e data_set mantém as cinco entradas. Para mudar as variáveis, envie data_set com o objeto JSON completo alterado como string escapada, como na criação. Uma requisição DELETE para o mesmo caminho remove o template e responde 200 com {"state":"executed"}.