Primeiros passos com Real-Time Events

• Acesso ao Azion Console. Para entrar, consulte Como acessar o Azion Console.

• Um personal token, para uma consulta enviada de um terminal. Para criar um, consulte Personal Tokens.

A API GraphQL serve os mesmos registros em https://api.azion.com/v4/events/graphql. Esse endereço também serve o GraphiQL Playground em um navegador: entre no Azion Console em https://console.azion.com e depois abra o endpoint. Toda consulta abaixo roda ali.

Uma consulta enviada de um terminal carrega, em vez disso, um cabeçalho Authorization: Token [TOKEN VALUE]. Para esse caminho, consulte Primeiros passos da API GraphQL.

O Playground é onde cada consulta das etapas abaixo é escrita e enviada.

Para abrir a página, acesse Azion Console > Products menu > Observe > Real-Time Events.

A página apresenta quatro controles:

• Data Sources seleciona o produto cujos registros a busca lê.
• Time Filter delimita o período que a busca cobre.
• Filter by reduz o resultado aos registros que correspondem a um valor.
• Refresh, que executa a busca de novo com a fonte de dados e o período selecionados.

Esses quatro controles são toda a superfície de busca, e uma busca é uma combinação deles.

Na API GraphQL, a fonte de dados HTTP Requests é o dataset workloadEvents, e os controles do Azion Console são argumentos dele:

• tsRange carrega o período, como um timestamp begin e um end.
• orderBy define a ordem em que as linhas voltam, como [ts_DESC] para as mais recentes primeiro.
• limit limita quantas linhas a consulta retorna.

Esses três argumentos são o que a próxima etapa envia. Para o dataset ao qual cada fonte de dados corresponde, consulte Fontes de dados, e para os campos que cada dataset carrega, Campos da API GraphQL do Real-Time Events.

Para ler os registros de uma fonte de dados no Azion Console:

Os registros desse período aparecem em uma tabela, uma linha por requisição.

Data Sources oferece uma entrada por produto que escreve registros. Para cada uma delas e as variáveis que ela carrega, consulte Fontes de dados.

Um argumento de filtro reduz o dataset da mesma maneira. statusIn recebe uma lista de códigos de status, portanto a condição que a busca do Console expressa como status='400' se escreve statusIn: [400] aqui.

Para retornar o registro mais recente que correspondeu:

A linha que a consulta retorna:

A linha é um registro de evento, e seu requestId identifica a requisição que o produziu.

Para reduzir o resultado no Azion Console:

A tabela agora carrega apenas os registros cujo Status é 400.

Filter by lê SQL. key='value' corresponde a um valor exato, key like '%value%' corresponde a um valor parecido e AND, OR e NOT combinam termos. Para a sintaxe completa e mais exemplos, consulte Filtrar eventos.

Para abrir o registro inteiro no Azion Console, selecione uma linha na tabela de resultados.

A visualização More details abre, com todas as variáveis da fonte de dados selecionada para aquele único registro. Você passa a ter os valores que uma requisição escreveu, variável por variável.

Para o significado de cada variável, fonte de dados por fonte de dados, consulte Fontes de dados. Para saber como ler os valores de um registro, consulte Ler um registro de evento.

Uma resposta carrega os campos que a consulta selecionou e nenhum outro, portanto ler mais de um registro significa nomear mais campos. Filtre pelo requestId que a etapa anterior retornou e amplie o conjunto de seleção:

A linha carrega um valor por campo nomeado:

Você passa a ter o registro de uma requisição, campo por campo. upstreamStatus lê 0 porque a requisição nunca chegou a uma origem. Para todos os campos que workloadEvents carrega, e os campos dos outros datasets, consulte Campos da API GraphQL do Real-Time Events.