Criar um Widget Baseado em Consulta Usando Rastreamentos

Você pode criar um widget baseado em consulta usando rastreamentos do serviço Application Performance Monitoring.

Você pode usar os muitos recursos disponíveis no construtor de widgets baseado em consulta para criar um widget que exiba uma expressão TQL (Trace Query Language). O construtor de widgets baseado em consulta fornece opções e funcionalidades para visualizar e monitorar dados de rastreamento. Por exemplo, você pode exibir transações com desempenho baixo quando usadas por muitos clientes, tornando essas transações dignas de esforços de melhoria de desempenho.

Para criar um widget baseado em consulta que exiba dados de rastreamento:

  1. Vá para a página Painéis de Controle.
  2. Clique em Criar painel de controle para criar um novo painel de controle ou abrir um existente no modo de edição.
  3. Na guia Widgets, clique no ícone Adicionar grupo de widgets e widgets (Adicionar grupo de widgets e widgets) e clique em Criar widget baseado em consulta....
    O construtor de widget baseado em consulta é exibido.
  4. Opcionalmente, clique no ícone Abrir/fechar painel de filtros (Abrir/fechar painel de filtro) para exibir os filtros já adicionados ao painel de controle e fazer alterações, se necessário.

    Observe que ao criar um widget baseado em consulta para adicioná-lo a um novo painel de controle, um filtro de Compartimento é adicionado automaticamente e a entrada do compartimento para o novo widget que está sendo criado é vinculada a esse filtro recém-adicionado.

  5. No canto superior direito, selecione um período para o qual você deseja exibir dados no widget.
  6. Selecione Rastreamentos na lista drop-down Origem de dados.
    Se um filtro de domínio do APM não for adicionado ao painel de controle, ele será adicionado automaticamente quando Rastreamentos for selecionado.
  7. Edite a consulta padrão exibida no campo Consulta ou informe uma nova consulta e clique em Executar.

    Use a sintaxe TQL para criar consultas e recuperar dados de rastreamento do Application Performance Monitoring. Para obter informações sobre TQL, consulte Trabalhar com Consultas.

    Os dados de rastreamento são exibidos em formato tabular com o nome do serviço e outros detalhes. Abaixo do gráfico de tabelas, outra tabela com os dados brutos retornados pela consulta de rastreamento é exibida e você pode clicar em Ocultar dados brutos para ocultá-los.

  8. Use as seguintes guias no lado direito para executar tarefas como adicionar um nome para o widget e personalizar a visualização de dados no widget:
    Observação

    Você pode clicar em JSON no canto superior direito para editar os metadados JSON do widget diretamente. O editor JSON oferece maior flexibilidade e mais opções para visualizar dados no widget. No entanto, é recomendável usá-lo apenas se você estiver familiarizado com a edição do widget JSON. Para obter mais informações sobre o editor JSON, entre em contato com o Suporte Técnico da Oracle.
    • Sobre: Digite um nome para o widget, selecione o compartimento no qual você deseja que o widget resida e adicione uma descrição para o widget.

      Opcionalmente, clique em Mostrar opções avançadas para adicionar tags de formato livre ou definidas ao widget. Se você tiver as permissões necessárias para criar um widget, também terá permissões para adicionar tags de formato livre. Para adicionar uma tag definida, você deverá ter permissões para usar o namespace de tag. Para obter informações sobre:

    • Visualização: Selecione um tipo de gráfico e personalize a visualização especificando ou modificando opções adicionais.

      Se você selecionar Tabela como o tipo de gráfico, terá a opção de remover algumas das colunas ou marcar a caixa de seleção Todas as colunas para exibir todas as colunas. Os tipos de gráfico que têm eixos X e Y, como o gráfico de Linha, têm uma combinação das seguintes opções de visualização adicionais:

      • Eixo X: Selecione o atributo de dados que você deseja projetar no eixo X.
      • Eixo Y: Selecione o atributo de dados que você deseja projetar no eixo Y. O eixo Y suporta atributos de dados numéricos e somente eles são listados.
      • Série: Selecione o atributo de dados que você deseja plotar em séries separadas no gráfico. Essa opção também está disponível para um gráfico de Pizza.
      • Tamanho: Selecione um atributo de dados cujos valores você deseja designar ao tamanho. Essa opção só está disponível para um gráfico de Bolha.
      • Cor por: Selecione o atributo de dados a cujos valores você deseja atribuir cores distintas. Geralmente, a opção Colorir por é usada com a opção Series para atribuir cores distintas à série separada. Essa opção também está disponível para um gráfico de Pizza.
      • Título do eixo X: Especifique um título para o atributo de dados projetado no eixo X.
      • Título do eixo Y: Especifique um título para o atributo de dados projetado no eixo Y.
      • Legenda: Especifique o local da legenda no widget. Essa opção também está disponível para um gráfico de Pizza.
      • Instruções de ferramenta correlacionadas: selecione esta opção para correlacionar as dicas de ferramentas em todos os widgets baseados em consulta no painel de controle.
      • Cursor de dados: Selecione esta opção para exibir a dica de ferramenta quando passar o mouse sobre o widget.
      • Empilhado: Selecione essa opção se quiser empilhar os atributos de dados exibidos no gráfico, por cor.
      • Usar cor sólida: Quando você usa um gráfico de Área para visualização, a área que representa a presença de dados é coberta pela cor sólida. Esta opção é selecionada por padrão.

      Para obter mais informações sobre as opções de visualização em um construtor de widget baseado em consulta, consulte Sobre Opções de Visualização.

    • Definições: Revise e edite entradas de widget, se necessário.
  9. Clique em Salvar para salvar o widget na biblioteca de widgets e adicioná-lo ao painel de controle.

Veja um cenário no qual as 5 principais transações no período especificado são exibidas usando um gráfico de linhas. No construtor de widgets baseado em consulta:

  1. Certifique-se de que o período esteja selecionado no canto superior direito.
  2. Na lista suspensa Origem de dados, selecione Rastreamentos.
  3. No campo Consulta, digite o rastreamento a seguir e clique em Executar.
    show traces OperationName as Transaction, avg(traceDuration) as Duration where pageviews > 0 group by OperationName order by count(*) first 5 rows timeseries
  4. Especifique o seguinte na guia Visualização:
    1. Selecione o gráfico de Linha como o Tipo de gráfico.
    2. Selecione timeseries.Duration na lista drop-down Eixo Y.
    3. Selecione timeseries.date na lista drop-down Eixo X.
    4. Selecione Transação na lista drop-down Série.
    5. Selecione Transação na lista drop-down Colorir por.

Um gráfico de linhas com as 5 principais transações é exibido.

Widget de Rastreamento Baseado em Consulta