Visualizar eventos

Defina e filtre consultas em eventos do CDF e anote-os nos gráficos em seu painel do Grafana. Você pode personalizar o intervalo de tempo, os eventos a serem exibidos e as colunas de acordo com as suas necessidades.

Trabalhar com eventos em uma tabela

Abra a guia Evento no Grafana para trabalhar com eventos em uma tabela.

Definir uma consulta

A consulta events usa o ponto de extremidade de eventos/lista para recuperar os dados.

Formato: events{someFilter=number, otherFilter="string"}

Exemplo:

events{externalIdPrefix='WORKORDER', assetSubtreeIds=[{id=12}, {externalId='ext_id'}]}

Você pode filtrar usando estas propriedades: externalIdPrefix, metadata, assetIds, assetExternalIds, rootAssetIds, assetSubtreeIds, dataSetIds, source, type e subtype.

Por padrão, a consulta retorna eventos ativos no intervalo de tempo. Mas você pode personalizá-la com filtros de tempo extra: startTime, endTime, activeAtTime, createdTime e lastUpdatedTime.

Este exemplo retorna todos os eventos concluídos que começaram no intervalo de tempo atual:

events{startTime={min=$__from}, endTime={isNull=false}}

Este exemplo retorna apenas eventos finalizados:

events{endTime={isNull=false}}

Filtragem do lado do cliente

Especifique mais filtragens do lado do cliente com os operadores =~, !~ e !=. Uma vírgula entre vários filtros age como um AND lógico.

Formato:

• =~ — igualdade de regex: Retorna os resultados que atendem à expressão regular.

• !~ — desigualdade de regex: Exclui os resultados que atendem à expressão regular.

• != — desigualdade estrita: Retorna itens em que uma propriedade não é igual ao valor dado.

Exemplo:

events{type='WORKORDER', subtype=~'SUB.*'}

OBSERVAÇÃO

Não use os filtros do lado do cliente como método principal de filtragem. o Grafana aplica os filtros depois que os itens retornam do CDF. Talvez nem todos os dados apareçam se o CDF retornar o número máximo de itens (1.000).

Criar modelos

Crie modelos usando a sintaxe $variable_name.

Exemplo:

events{type='WORKORDER', subtype=$variable}

Renomear e organizar os campos

Selecione a guia Transformar para renomear e organizar os campos.

Anotar gráficos com eventos

Use anotações para sobrepor informações detalhadas de eventos do CDF em gráficos no Grafana.

1. Acesse as configurações do painel e selecione Anotações.
2. Selecione seu projeto do CDF no campo Fonte de dados.

1. Especifique a consulta para buscar e filtrar eventos do CDF. Por exemplo:

   events{type="some", subtype=~"sub.*"}

   A consulta acima solicita eventos com o parâmetro type="some" e filtra os resultados por subtype que corresponda a sub.*.

   • Para obter uma lista completa de parâmetros válidos, consulte a documentação da API.

   • Aprenda a filtrar**** os resultados.