Investigação básica de problemas na Azion Web Platform

Aprenda como habilitar Debug Rules, usar Real-Time Events e consultar dados com GraphQL para entender por que ações específicas foram aplicadas às suas requisições.

Última atualização

Ver como Markdown Configurar agente

Use este guia para identificar comportamentos inesperados em aplicações na Azion Web Platform. Aprenda como habilitar Debug Rules, usar Real-Time Events e consultar dados com GraphQL para entender por que ações específicas foram aplicadas às suas requisições. Este guia inclui um exemplo prático que mostra como identificar quais regras foram executadas e por que uma requisição foi bloqueada.

Habilitando Debug Rules

Debug Rules podem ser habilitadas tanto em Applications quanto em Firewall. Elas mostram quais regras foram executadas para uma requisição e as ações que essas regras tomaram (bloquear é apenas um exemplo), ajudando você a entender por que uma ação específica foi aplicada.

Para habilitar Debug Rules para Applications:

  1. Acesse o Console.
  2. Vá para o Products menu > Applications.
  3. Selecione uma aplicação existente para ativar o debug.
  4. Na aba Main Settings, habilite a opção Debug Rules.
  5. Clique no botão Save.

Para habilitar Debug Rules para Firewalls:

  1. Acesse o Console.
  2. Vá para o Products menu > Firewalls.
  3. Selecione o firewall que você deseja configurar.
  4. Na aba Main Settings, habilite a opção Debug Rules.
  5. Clique no botão Save.

Real-Time Events

Para acessar o Real-Time Events, siga estes passos:

  1. Acesse o Console.
  2. No canto superior esquerdo, selecione Products menu > Real-Time Events.
  3. Selecione a aba HTTP Requests.
  4. Modifique o intervalo de tempo desejado e os filtros.
  5. Clique no botão Search.

GraphQL

Para acessar o playground Azion GraphQL, acessível através do menu Real Time Events, ou visitando este link.

Consulte a documentação da API GraphQL para mais informações.

Por padrão, todas as requisições são registradas usando o fuso horário UTC.

Um exemplo prático

Para este exemplo, usaremos uma aplicação de amostra na qual, ao acessar a URI /block, a requisição será bloqueada com um status 403. Portanto, se você tentasse acessar o site, receberia uma página de erro 403 parecida com esta:

Página de erro da Azion

Como você pode descobrir exatamente por que essa requisição foi bloqueada?

Para os passos abaixo, copie o Request ID exibido na página.

O Request ID é o mesmo identificador exibido na página de erro da Azion, na seção Error Details. Para uma descrição de todos os campos dessa página e o significado de cada código de status HTTP, consulte Códigos de Status de Erro HTTP.

No Real-Time Events

  1. Acesse o Real-Time Events
  2. Filtre pelo request id que você copiou.
  3. Selecione o corpo do log.
  4. Procure pelo campo stacktrace.

Você verá uma resposta semelhante a esta:

JSON
01{
02 "edge_application_request": [
03 "Default Rule",
04 "block"
05 ]
06}

O campo stacktrace informa que a regra de Application chamada block foi executada.

No GraphQL Playground

1.Acesse o GraphQL Playground. 2.Execute a query abaixo, substituindo os campos tsRange e requestIdEq pelos valores corretos.

GraphQL
01 query (
02 $tsRange_begin: DateTime!
03 $tsRange_end: DateTime!
04) {
05 httpEvents (
06 limit: 10
07 orderBy: [ts_DESC]
08 filter: {
09 tsRange: { begin: $tsRange_begin, end: $tsRange_end }
10 #hostEq:
11 #statusEq:
12 #requestIdEq:""
13 }
14 ) {
15 ts
16 requestId
17 #configurationId
18 host
19 #requestMethod
20 status
21 upstreamStatus
22 #upstreamResponseTime
23 #upstreamBytesSent
24 #sslProtocol
25 #wafLearning
26 #requestTime
27 #serverProtocol
28 upstreamCacheStatus
29 #httpReferer
30 remoteAddress
31 stacktrace
32 wafMatch
33 #serverPort
34 #sslCipher
35 wafEvheaders
36 #serverAddr
37 #scheme
38 httpUserAgent
39
40 }
41}

Você receberá uma resposta semelhante a esta:

JSON
01{
02 "data": {
03 "httpEvents": [
04 {
05 "configurationId": "xxx",
06 "host": "xxxxx.azionedge.net",
07 "requestId": "your_request_id_here",
08 "httpUserAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/26.1 Safari/605.1.15",
09 "requestMethod": "GET",
10 "status": 403,
11 "ts": "2026-01-22T21:10:38Z",
12 "stacktrace": "{\\\"edge_application_request\\\":[\\\"Default Rule\\\",\\\"block\\\"]}",
13 "upstreamBytesSent": 0,
14 "sslProtocol": "TLSv1.3",
15 "wafLearning": "-",
16 "requestTime": "0",
17 "serverProtocol": "HTTP/2.0",
18 "upstreamCacheStatus": "-",
19 "httpReferer": "-",
20 "remoteAddress": "xxxx",
21 "wafMatch": "-",
22 "serverPort": "443",
23 "sslCipher": "TLS_AES_256_GCM_SHA384",
24 "wafEvheaders": "-",
25 "serverAddr": "192.0.2.11",
26 "scheme": "https"
27 }
28 ]
29 }
30}

O campo stacktrace informa que a regra de Application chamada block foi executada.