Usar o Filtro de Dimensão de Métrica

Você pode usar o filtro Dimensão de métrica para especificar a entrada de métrica do serviço Oracle Cloud Infrastructure Monitoring para um widget.

O filtro Dimensão de métrica pode ser usado para filtrar dados de métrica por valores de dimensão. Um cenário comum para o uso desse filtro seria adicioná-lo como um parâmetro de entrada adicional para fornecer diferentes valores de dimensão a um widget baseado em consulta e reutilizar o widget.

Veja um exemplo em que o filtro Dimensão de métrica é adicionado como uma entrada adicional a um widget de Gerenciamento de Banco de Dados baseado em consulta que usa métricas. Para a finalidade deste exemplo, o namespace oracle_oci_database, a métrica CpuUtilization e a dimensão resourceName estão sendo usados. Observe que este exemplo não detalha todos os campos e opções disponíveis no construtor de widget baseado em consulta. Para obter mais informações, consulte Criar um Widget Baseado em Consulta Usando Métricas.

  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 Filtros, digite Dimensão de métrica no campo de pesquisa e clique no filtro Dimensão de métrica para adicioná-la ao painel de controle.

    Ao adicionar o filtro, especifique os seguintes detalhes nas caixas de diálogo Configurar entrada de <nome> para dimensão Métrica (obrigatório):

    1. Namespace: Selecione oracle_oci_database.
    2. Nome da métrica: Selecione CpuUtilization.
    3. Nome da dimensão: Selecione resourceName.
    Observação

    O filtro Dimensão de métrica também requer a entrada do compartimento para determinar em qual compartimento a métrica reside. No entanto, a entrada do compartimento é automaticamente configurada para usar o filtro Compartimento. Você pode fazer alterações na entrada configurada automaticamente, se necessário.
  4. Na lista drop-down do filtro Dimensão de métrica no painel de controle, selecione um recurso de banco de dados no compartimento.
  5. 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.
  6. Clique no ícone Abrir/fechar painel de filtro (Abrir/fechar painel de filtro) para confirmar se os filtros de Dimensão de métrica e Compartimento foram adicionados.
  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 selecionado no filtro Dimensão da métrica, oracle_oci_database.
    2. Consulta: Edite a consulta padrão exibida neste campo ou informe uma nova consulta para recuperar as informações da métrica CpuUtilization.
    3. Clique em Executar.
  9. Execute as seguintes etapas para adicionar um parâmetro de entrada adicional e vinculá-lo ao filtro Dimensão de métrica:
    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, 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. Configurar entrada de widget: Selecione Vincular a entrada a um filtro existente e vincule o parâmetro de entrada ao filtro Dimensão de métrica.
  10. Edite a consulta e adicione um espaço reservado para exibir os dados do filtro Dimensão de métrica no widget, usando a seguinte expressão:
    {<dimension>=$(params.<input_name>)}

    Para a finalidade deste exemplo, veja a seguir como será o espaço reservado na consulta:

    CpuUtilization[auto]{resourceName=$(params.resourcename)}.mean()
  11. Na guia 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.
  12. Na guia Visualização, selecione um tipo de gráfico e personalize a visualização especificando ou modificando opções adicionais.
  13. Clique em Salvar para salvar o widget na biblioteca de widgets e adicioná-lo ao painel de controle.
Depois que o widget baseado em consulta for adicionado ao painel de controle e à biblioteca de widgets, você poderá alterar o valor da dimensão resourceName no filtro Dimensão da métrica para exibir a métrica CpuUtilization para diferentes recursos do banco de dados.