Você pode criar um widget baseado em consulta usando as métricas do serviço Oracle Cloud Infrastructure Monitoring.

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. Opcionalmente, adicione o filtro Dimensão de métrica ao painel de controle.

   Você pode usar o filtro Dimensão de métrica para especificar a entrada da dimensão de métrica para um widget baseado em consulta. Para obter informações, consulte Usar o Filtro de Dimensão de Métrica.

4. Na guia Widgets, clique no ícone Adicionar grupo de widgets e widgets () e clique em Criar widget baseado em consulta....
   O construtor de widget baseado em consulta é exibido.
5. Opcionalmente, clique no ícone Abrir/fechar painel de filtros () para exibir os filtros 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 Compartimento é adicionado automaticamente e a entrada do compartimento para o novo widget que está sendo criado é vinculada a esse filtro recém-adicionado. Além disso, a caixa de seleção Subcompartimentos é exibida no filtro Compartimento e você pode selecioná-la para exibir dados de métrica de todos os subcompartimentos dentro do compartimento raiz. A opção para exibir dados de métrica dos subcompartimentos só poderá ser usada se o compartimento raiz estiver selecionado no filtro Compartimento.

6. No canto superior direito, selecione um período para o qual você deseja exibir dados no widget.
7. Selecione Monitoramento no campo Origem de dados.
8. Especifique os seguintes detalhes da métrica do serviço Monitoring:
   1. Namespace: Selecione o namespace aplicável.
   2. Grupo de recursos: Se preferir, selecione um grupo de recursos, se disponível. Grupo de recursos é uma string personalizada fornecida com uma métrica personalizada e pode ser usada como um filtro ou para agregar resultados.
   3. Consulta: Edite a consulta padrão exibida neste campo ou informe uma nova consulta para recuperar as informações de métrica que você deseja exibir no widget.

      As consultas usadas para criar widgets baseados em consulta usam a sintaxe MQL (METRIC[auto].grouping().mean()), que controla expressões para consultar métricas publicadas no serviço Monitoring. Para obter informações, consulte Referência do Monitoring Query Language (MQL).

   4. Clique em Executar.

   A consulta é executada e os dados da métrica são exibidos em um formato tabular com o nome da métrica, o timestamp e o valor. Abaixo do gráfico de tabelas, outra tabela com os dados brutos retornados pela consulta é exibida e você pode clicar em Ocultar dados brutos para ocultá-los.

9. Opcionalmente, adicione parâmetros de entrada para tornar o widget reutilizável, fornecendo valores diferentes desse parâmetro. Por exemplo, os parâmetros de entrada podem ser configurados para filtrar os dados por uma dimensão específica, em que o valor é fornecido por meio do parâmetro. Se você estiver criando um widget baseado em consulta para o serviço Database Management (namespace oracle_oci_database) para exibir a utilização da CPU (métrica CpuUtilization), poderá adicionar um parâmetro de entrada usando a dimensão resourceName e configurar valores de dimensão para exibir os dados de utilização da CPU para recursos específicos no widget.
   1. Na guia Definições, clique em Adicionar entrada +.
   2. Na caixa de diálogo Configurar entrada para widget sem título (opcional) :
      1. Nome da entrada: Digite um nome para o parâmetro de entrada. Por exemplo, se você quiser adicionar a dimensão resourceName como um parâmetro de entrada para o widget, o Nome da entrada poderá ser resourcename. Observe que o nome de entrada é obrigatório ao adicionar uma expressão de espaço reservado à consulta.
      2. Label de entrada: Informe um nome para exibição para a entrada. O nome de entrada é exibido neste campo por padrão e você pode alterá-lo para torná-lo mais amigável.
      3. Definições padrão: Revise e faça alterações nas definições padrão, se necessário.
         Observação
         
         Se você atualizar as Definições padrão para configurar o parâmetro de entrada, as mesmas definições serão aplicadas sempre que esse widget for adicionado a outro painel de controle. Para configurar um parâmetro de entrada cujo valor possa ser editado depois que o widget for criado e adicionado à biblioteca de widgets, use as opções na seção Configurar entrada de widget dessa caixa de diálogo.
         • Obrigatório: Selecione para indicar que essa é uma entrada de widget obrigatória. Se você marcar essa caixa de seleção e não configurar o parâmetro de entrada, os dados não serão exibidos no widget.
         • Permitir vários valores: Selecione para permitir que vários valores sejam configurados para o parâmetro de entrada.
         • Permitir que os usuários do widget vinculem a entrada <name> com um filtro: Desmarque essa caixa de seleção para especificar apenas um valor de parâmetro de entrada fixo. Essa caixa de seleção é marcada por padrão e, se você desmarcá-la, os campos disponíveis para vincular a entrada a um filtro não serão exibidos na caixa de diálogo.
         • Permitir que os usuários do widget especifiquem a entrada <name>: Desmarque essa caixa de seleção para vincular apenas a entrada a um filtro. Essa caixa de seleção é marcada por padrão e, se você desmarcá-la, os campos disponíveis para especificar um valor de parâmetro de entrada fixo não serão exibidos na caixa de diálogo.
      4. Configurar entrada do widget: Selecione entre as seguintes opções para configurar o parâmetro de entrada:
         • Link the input with an existing filter: Selecione para vincular o parâmetro de entrada a um filtro existente no widget.
         • Especificar a entrada: Selecione um valor de parâmetro de entrada fixo, que será usado somente no contexto desse widget.
         • Não configurado: Selecione para deixar a entrada desconfigurada.
   3. Adicione um espaço reservado à consulta para exibir os dados do parâmetro de entrada adicional no widget, usando a seguinte expressão:

      {<dimension>=$(params.<input_name>)}

      Usando o mesmo exemplo mencionado no início da etapa 8, depois que um parâmetro de entrada foi adicionado para a dimensão resourceName, a seguinte expressão de espaço reservado (em negrito) deve ser adicionada à consulta CpuUtilization para filtrar dados por recurso no widget:

      CpuUtilization[auto]{resourceName=$(params.resourcename)}.mean()

10. 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:

      • Conceitos de tags e as permissões necessárias para trabalhar com tags. Consulte Visão Geral do Serviço Tagging.
      • Como adicionar uma tag durante a criação do recurso, consulte Para adicionar uma tag durante a criação do recurso.
    • 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. No eixo X, você pode optar por exibir o nome da métrica, do namespace etc.
      • 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. Por exemplo, adicione a cláusula groupBy com uma dimensão na consulta e exiba séries separadas para os vários valores dessa dimensão. Na consulta a seguir, a métrica de utilização de CPU no namespace oracle_oci_database é agrupada pela dimensão resourceName e séries separadas são exibidas para cada um dos recursos.

        CpuUtilization[auto].groupBy(resourceName).mean()

        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.
11. Clique em Salvar para salvar o widget na biblioteca de widgets e adicioná-lo ao painel de controle.