Criando um widget de gráfico de linha IBM Cloud Logs

Você pode criar um widget de gráfico de linhas que pode ser incluído em painéis personalizados do IBM® Cloud Logs.

O gráfico de linhas exibe valores como uma série de pontos de dados.

Etapa 1: Digite o nome e a descrição

Conclua as etapas a seguir:

  1. Em um painel customizado, clique em Incluir Widget ícone Incluir Widget e arraste e solte o widget Gráfico de Linhas de sua barra lateral.

  2. Substitua New line chart pelo nome do widget.

  3. Insira uma descrição.

    Clique em Ícone de ação Ícone de ação. Em seguida, selecione Adicionar descrição.

  4. Defina onde os valores de legenda são exibidos. Os valores válidos são: Side, Bottom, Auto, e Hide.

    Clique em Ícone de ação Ícone de ação. Em seguida, selecione Legend Settings (Configurações de legenda ).

Etapa 2: Configure a consulta para definir o conjunto de dados

Conclua as etapas a seguir:

  1. Clique em Ícone de ação Ícone de ação. Em seguida, selecione o modo Editar.

  2. Para Query 1, conclua as etapas a seguir:

    Selecione o tipo de dados. Os valores válidos são: Logs, Metrics, e DataPrime.

    Selecione a fonte. As opções válidas são: Priority Insights e Analyze and Alert.

    Você pode renomear a consulta. Selecione o ícone de ação e clique em Renomear consulta.

  3. Digite a consulta.

    Quando o tipo de dados for DataPrime, insira uma consulta Dataprime no campo Query (Consulta).

    Quando o tipo de dados for Logs, insira uma consulta Lucene no campo Query (Consulta). Você pode aplicar filtros e agregações.

    Quando o tipo de dados for Metrics, especifique a métrica ou o PromQL desejado no campo Query (Consulta). Você pode aplicar filtros e agregações.

    Ao criar um gráfico de barras com métricas como o tipo de dados, as categorias especificadas na consulta PromQL aparecem automaticamente no campo Group By (Agrupar por). Você pode reordenar as categorias no campo Group By arrastando e soltando. Arraste e solte categorias do campo Category (Categoria) para o campo Stacking (Empilhamento), para empilhar por uma categoria específica.

  4. [Opcional] Adicione um ou mais filtros específicos ao widget para restringir os dados que são exibidos.

    Selecione um rótulo e seu valor correspondente.

    Os filtros são aplicados no nível do widget e funcionam junto com os filtros do painel. Se houver um conflito, os filtros do painel terão precedência sobre os filtros do widget.

  5. Adicionar uma função.

    Para uma consulta em que o tipo de dados é Logs, você pode mostrar um valor agregado usando uma das seguintes funções:

    Opção de agregação ao criar uma consulta quando o tipo de dados é Logs
    Agregação Descrição
    Contagem O número total de registros dentro do intervalo de tempo selecionado.
    contagem distinta O número de registros exclusivos dentro do intervalo de tempo selecionado.
    Soma A soma de todos os registros dentro do intervalo de tempo selecionado.
    Mín. O menor valor entre os registros dentro do intervalo de tempo selecionado.
    Máx. O maior valor entre os registros dentro do intervalo de tempo selecionado.
    Média O valor médio de todos os registros dentro do intervalo de tempo selecionado.
    Percentil XX Representa o valor abaixo do qual XX% dos registros caem. Por exemplo, Percentil 95 é o valor abaixo do qual 95% dos registros se enquadram.

    Para uma consulta em que o tipo de dados é Metrics, você pode mostrar um valor calculado usando uma das seguintes funções:

    Opção Cálculos ao criar uma consulta quando o tipo de dados é Métricas
    Cálculo Descrição
    Instantâneo O valor no momento atual.
    Último O valor mais recente dentro do intervalo de tempo selecionado.
    Mín. O menor valor dentro do intervalo de tempo selecionado.
    Máx. O maior valor dentro do intervalo de tempo selecionado.
    Méd. O valor médio de todos os pontos de dados dentro do intervalo de tempo selecionado.
    Soma A soma total de todos os pontos de dados dentro do intervalo de tempo selecionado.
    Nenhum Nenhum cálculo é aplicado. São usados dados brutos.

Etapa 3: Configurar o widget

Conclua as etapas a seguir:

  1. Clique em Ícone de ação Ícone de ação. Em seguida, selecione o modo Editar.

  2. Escolha uma opção de dica de ferramenta. Os valores válidos são: Show all series e Single View.

    Selecione se deseja ver todas as séries temporais ao passar o mouse sobre elas ou se deseja ver apenas a série temporal única sobre a qual você passa o mouse.

  3. Na seção Gerenciamento visual, escolha como deseja visualizar os dados. As opções são Absoluto e Relativo.

    Absolute exibe números específicos como o valor, enquanto Relative exibe valores relativos ao valor mínimo ou máximo.

  4. Na seção Time Bucket, escolha como deseja agrupar os pontos de dados. Você pode decidir agrupar os dados automaticamente ou escolher o intervalo de tempo exato manualmente.

    Você pode inserir um valor que deve ser mostrado como pontos de dados dentro de cada intervalo de tempo.

  5. Na seção Series Management, configure a opção Scale.

    Uma escala se refere à forma como os valores são exibidos ao longo do eixo x e do eixo y.

    As opções válidas são: linear, que define como os valores aumentam proporcionalmente, e logarithmic, em que o valor é definido por logaritmos em vez de intervalos lineares iguais.

    Por padrão, a configuração é linear. No entanto, se houver grandes diferenças entre os diferentes valores, pode ser útil mostrar a escala logarítmica. Por exemplo, se a maioria dos seus valores estiver abaixo de 1k e um valor for 10k, o uso da escala logarítmica mostrará um gráfico de barras mais fácil de ler do que a escala linear.

Etapa 4: Salvar o widget

Conclua as etapas a seguir:

  1. [Opcional] Defina a hora do painel do widget se você quiser usar um intervalo de tempo diferente do selecionado no Dashboard.

  2. Clique em Save (Salvar) para salvar o widget.

  3. [Opcional] Compartilhe um link direto para o widget. Clique em Ícone de ação Ícone de ação. Em seguida, selecione Share Widget URL e copie o endereço URL.

    Qualquer pessoa com acesso ao painel pode abrir o link compartilhado para visualizar o widget no contexto.

    Os URLs de widgets compartilhados sempre refletem a última versão salva do painel. Se você tiver feito alterações no widget ou no layout, salve o painel antes de compartilhar.

  4. [Opcional] Adicione uma ação personalizada. Para obter mais informações, consulte Uso de ações para integração com serviços de terceiros.