Consulte dados de usuários conectados com GraphQL

Este guia explicará como consultar dados do dataset connectedUsersMetrics usando o playground GraphiQL.

Ver como Markdown

O conjunto de dados connectedUsersMetrics permite que você obtenha dados agregados em tempo real, fornecidos pelo Live Ingest da Azion, relacionados ao número de usuários conectados às suas aplicações com transmissões ao vivo. Este conjunto de dados faz parte da GraphQL API do Real-Time Metrics.

Essas informações podem ser acessadas através da GraphQL API, permitindo que você transfira esses dados para uma plataforma de terceiros, possibilitando uma análise e revisão mais aprofundadas da atividade e engajamento dos usuários. Além disso, os dados estão disponíveis por até 2 anos.

Este guia explicará como consultar dados de usuários conectados usando o playground GraphiQL.

Para obter esses dados, você deve ter a subscrição do Live Ingest da Azion e usar a GraphQL API.

Consulte dados por host

Para consultar seus dados por host, siga os seguintes passos:

  1. Acesse o GraphiQL Playground nesse link https://api.azion.com/v4.
    • Você deve estar logado na sua conta Azion. Caso contrário, você receberá uma mensagem de erro.
  2. Envie uma query seguindo este formato:
query ConnectedUsers {
connectedUsersMetrics(
limit: 10000,
filter: {
tsRange:{
begin: "2024-04-10T00:00:00",
end: "2024-04-11T00:00:00"
}
},
groupBy: [ts,host]
orderBy: [ts_DESC]
) {
ts,
host,
uniqueSessions
}
}

Onde:

CampoDescrição
limitEspecifica o número máximo de resultados a serem retornados. Máximo do sistema: 10000
filterDefine os critérios usados para filtrar os dados retornados pela consulta
tsRangeUm subcampo de filter. Especifica um intervalo de tempo para filtrar os dados. Inclui os campos begin e end para definir os timestamps de início e fim. Formato: "YYYY-MM-DDTHH:mm:ss"; exemplo: "2024-04-11T00:00:00"
groupByEspecifica os campos pelos quais os resultados da consulta devem ser agrupados. Exemplo: [ts]
orderByEspecifica a ordem em que os resultados devem ser retornados. Valores aceitos: [ts_DESC], para ordem decrescente, e [ts_ASC], para ordem crescente
tsUm campo no conjunto de resultados representando o timestamp do ponto de dados
hostUm campo no conjunto de resultados representando o host de onde os dados foram coletados
uniqueSessionsUm campo no conjunto de resultados representando o número de sessões únicas registradas pelo host
  1. Você receberá uma resposta JSON semelhante a esta:
{
"data": {
"connectedUsersMetrics": [
{
"ts": "2024-04-10T00:00:00",
"host": "example.net",
"uniqueSessions": 120
},
{
"ts": "2024-04-10T00:00:00",
"host": "example.net",
"uniqueSessions": 175
},
{
"ts": "2024-04-10T00:00:00",
"host": "example.net",
"uniqueSessions": 136
},
{
"ts": "2024-04-10T00:00:00",
"host": "example.net",
"uniqueSessions": 100
}
]
}
}

Onde:

CampoDescrição
tsTimestamp de quando o evento foi criado
hostInformações do host enviadas na linha de requisição. Armazena: nome do host da linha de requisição, ou nome do host do campo de cabeçalho “Host”, ou o nome do servidor que corresponde a uma requisição
uniqueSessionsSessões únicas calculadas para um determinado host

Consulte dados totais

Para consultar valores totais, sem filtrar por host, você deve usar o campo uniqueSessionsTotal:

  1. Acesse o GraphiQL Playground
    • Você deve estar logado na sua conta Azion. Caso contrário, você receberá uma mensagem de erro.
  2. Envie uma query seguindo este formato:
query ConnectedUsers {
connectedUsersMetrics(
limit: 10000,
filter: {
tsRange:{
begin: "2024-04-10T00:00:00",
end: "2024-04-11T00:00:00"
}
},
groupBy: [ts]
orderBy: [ts_DESC]
) {
ts,
uniqueSessionsTotal
}
}

Onde:

CampoDescrição
limitEspecifica o número máximo de resultados a serem retornados. Máximo do sistema: 10000
filterDefine os critérios usados para filtrar os dados retornados pela consulta
tsRangeUm subcampo de filter. Especifica um intervalo de tempo para filtrar os dados. Inclui os campos begin e end para definir os timestamps de início e fim. Formato: "YYYY-MM-DDTHH:mm:ss"; exemplo: "2024-04-11T00:00:00"
groupByEspecifica os campos pelos quais os resultados da consulta devem ser agrupados. Exemplo: [ts]
orderByEspecifica a ordem em que os resultados devem ser retornados. Exemplo: [ts_DESC], para ordem decrescente, e [ts_ASC], para ordem crescente
tsUm campo no conjunto de resultados representando o timestamp do ponto de dados
uniqueSessionsTotalUm campo no conjunto de resultados representando o número de sessões únicas registradas entre todos os hosts para o intervalo de tempo especificado
  1. Você receberá uma resposta JSON semelhante a esta:
{
"data": {
"connectedUsersMetrics": [
{
"ts": "2024-04-10T00:00:00",
"uniqueSessionsTotal": 169
},
{
"ts": "2024-04-10T00:00:00",
"uniqueSessionsTotal": 175
},
{
"ts": "2024-04-10T00:00:00",
"uniqueSessionsTotal": 120
},
{
"ts": "2024-04-10T00:00:00",
"uniqueSessionsTotal": 100
}
]
}
}

Onde:

CampoDescrição
tsTimestamp de quando o evento foi criado
uniqueSessionsTotalTotal de sessões únicas calculadas entre todos os hosts