Configurar uma Consulta em Segundo Plano

Você pode criar uma consulta, executá-la em segundo plano e ver os resultados da consulta posteriormente no Trace Explorer.

Criar uma consulta e executá-la em segundo plano é útil quando você tem uma consulta que pode levar algum tempo para ser executada. O status e os resultados da consulta podem ser recuperados posteriormente.

Para executar uma consulta em segundo plano:

Navegue até a página Trace Explorer.
Certifique-se de que o compartimento e o domínio do APM apropriados estejam selecionados.
Clique no menu suspenso localizado ao lado de Executar e selecione Executar consulta em segundo plano.

Figura 5-1 Executar consulta em segundo plano
A janela Executar em segundo plano é exibida com as seguintes opções:
Clique em Enviar depois de concluído.

Exibir Consultas em Segundo Plano

Após criar uma consulta em segundo plano, selecione Exibir consultas em segundo plano para exibir a lista de consultas inicializadas anteriormente e seus resultados.

Você pode ver informações sobre as consultas em segundo plano, como Instâncias, Status, Total de linhas, Programação e Expira.

Observação

Depois que o tempo de expiração for atingido, os resultados da consulta salvos de uma consulta em segundo plano não estarão mais acessíveis. O nome e o texto da consulta em segundo plano são preservados como uma consulta expirada.

Use o ícone Ações (

) para executar o seguinte:

Editar detalhes: Edite os detalhes de uma consulta em segundo plano. Por exemplo, se você precisar estender a data de expiração das consultas em segundo plano, atualize o campo Expira. O valor padrão Expira é 30 dias.
Obter resultados da consulta: Consulte um resultado da consulta em segundo plano.
Opção não disponível para Consulta Agregada.
Nova consulta de atributos: Refine os resultados de uma consulta em segundo plano fazendo alterações na consulta existente. Por exemplo, se quiser que os resultados retornem menos linhas, você poderá adicionar uma cláusula where com um atributo.
Além disso, os dados do resultado da consulta podem ser usados como a origem de outras consultas (semelhante às consultas aninhadas). Essa ferramenta pode ajudar a construir essas consultas.
Reexecutar consulta: Execute novamente uma consulta em segundo plano. Isso significa que os dados do resultado da consulta existente são excluídos e a nova consulta é criada usando o mesmo nome.
Excluir: Exclua uma consulta em segundo plano.

Execução única

Você pode criar uma única consulta para ser executada em segundo plano e obter os resultados da consulta salvos como uma consulta em segundo plano.

Use Execução única se você tiver uma consulta que pode levar algum tempo para ser executada e precisar executá-la apenas uma vez (você não precisa executá-la várias vezes).

Na guia Execução única, faça o seguinte:

Nome da Consulta: Informe um nome para a consulta.
Descrição: Como alternativa, informe uma descrição para a consulta.
Consulta: Crie uma nova consulta ou edite a existente.
Intervalo de tempo: Selecione o intervalo de tempo necessário.
Duração máxima da execução em minutos: Informe a duração máxima da execução em minutos.
Máximo de linhas por execução: Informe o máximo de linhas por execução.
Valor do tempo de expiração: Informe o valor do tempo de expiração.
Tipo de tempo de expiração: Informe o tipo de tempo de expiração.
Clique em Submeter.

Executar Repetição

Você pode criar uma consulta de repetição para ser executada em segundo plano usando uma programação personalizada e obter os resultados da consulta salvos como uma consulta em segundo plano.

Use Repetir execução se você tiver uma consulta que pode levar algum tempo para ser executada e precisar executá-la várias vezes em um intervalo específico. Use-o para atualizar o resultado da consulta em um intervalo conhecido. Por exemplo, um resumo dos dados da semana passada atualizados toda segunda-feira de manhã.

Os resultados da consulta são substituídos após cada execução.

Na guia Repetir execução, faça o seguinte:

Nome da Consulta: Informe um nome para a consulta.
Descrição: Como alternativa, informe uma descrição para a consulta.
Consulta: Crie uma nova consulta ou edite a existente.
Em Configuração, defina o seguinte:
- Primeiro tempo de execução: Selecione o tempo necessário para a primeira execução.
- Duração máxima da execução em minutos: Informe a duração máxima da execução em minutos.
- Máximo de linhas por execução: Informe o máximo de linhas por execução
Em Programação, selecione uma das seguintes opções:
- Intervalo de repetição
  1. Repetir a cada: Selecione o valor do tempo de repetição e especifique o Tipo de repetição para ele.
  2. Período de consulta relativo ao tempo de execução programado: Selecione o período de consulta relativo ao tempo de execução programado e especifique o Tipo de repetição para ele.
- Programação cron
  1. Expressão cron:
    Insira os valores para criar uma expressão cronjob com base em uma string de cinco campos separados por um espaço em branco com a seguinte sintaxe:
```
S1 S2 S3 S4 S5
```
    Por exemplo, a seguir mostra um cronjob que é executado às 23:10 no 15o dia de qualquer mês.
```
10 23 15 * *
```
  2. Período de consulta relativo ao tempo de execução programado: Especifique quando a consulta é iniciada.
Clique em Submeter.

Consulta Agregada

Você pode criar uma consulta agregada para ser executada em segundo plano usando uma consulta repetida e obter os resultados da consulta cumulativa salvos como uma consulta em segundo plano.

Use Consulta agregada se tiver uma consulta repetida que pode levar algum tempo para ser executada e precisar consultar continuamente os resultados cumulativos. Os resultados da consulta são adicionados ao resultado anterior após cada execução.

Use Consulta agregada para criar entidades personalizadas com base na agregação de intervalos ou rastreamentos. Isso é útil nos casos em que o volume de ingestão é muito alto e você precisa apresentar um resumo/agregação de milhões de intervalos em um painel de controle.

Nome da Consulta: Informe um nome para a consulta.
Descrição: Como alternativa, informe uma descrição para a consulta.
Consulta: Crie uma nova consulta ou edite a existente.
Em Configuração, defina o seguinte:
- Primeiro tempo de execução: Selecione o tempo necessário para a primeira execução.
- Duração máxima da execução em minutos: Informe a duração máxima da execução em minutos.
- Máximo de linhas por execução: Informe o máximo de linhas por execução.
Em Agregação, defina o seguinte:
1. Repetir a cada: Selecione o valor do tempo de repetição e especifique o Tipo de repetição para ele.
2. Dias para retenção de dados: Informe o número de dias para retenção de dados.
Clique em Submeter.

Exemplo:

A seguinte consulta agregada em segundo plano pode ser criada primeiro e usada para resumir dados por usuário:

show traces userName, time_bucket_start(60) as timeBucket, 
sum(ApdexScore) as apdex, sum(PageViews) as pageViews, 
count(*) as "count", 
sum(PageResponseTime) as totalResponseTime, percentile(PageResponseTime,90) as P90, 
count_distinct(sessionId) as sessions, sum(ErrorCount) as errorCount 
where pageViews > 0 and userName is not omitted 
group by userName, time_bucket_start(60)

Depois disso, você pode usar a seguinte consulta agregada para mapear o número médio de sessões por usuário ao longo do tempo:

show from query result User avg(sessions) 
timeseries time range using attribute timeBucket

Documentação do Oracle Cloud Infrastructure