Compartilhar exibições personalizadas com URLs parametrizadas – Azure Time Series Insights

Artigo
06/01/2023

Observação

O serviço TSI (Time Series Insights) não terá mais suporte após março de 2025. Considere migrar os ambientes existentes do TSI para soluções alternativas assim que possível. Para obter mais informações sobre a substituição e a migração, visite nossa documentação.

Para compartilhar uma exibição personalizada no Gerenciador do Azure Time Series Insights, você poderá criar programaticamente uma URL parametrizada da exibição personalizada.

O Gerenciador do Azure Time Series Insights dá suporte aos parâmetros de consulta de URL para especificar exibições na experiência diretamente da URL. Por exemplo, usando apenas a URL, você pode especificar um ambiente de destino, um predicado de pesquisa e um período de tempo desejado. Quando um usuário seleciona a URL personalizada, a interface fornece um link diretamente para esse ativo no portal do Azure Time Series Insights. Aplicam-se políticas de acesso a dados.

Dica

Confira a demonstração gratuita do Azure Time Series Insights.
Leia a documentação do Gerenciador do Azure Time Series Insights anexada.

ID do Ambiente

O parâmetro environmentId=<guid> especifica a ID do ambiente de destino. Ele é um componente do FQDN de acesso a dados e pode ser encontrado no canto superior direito da visão geral do ambiente no portal do Azure. É tudo o que precede env.timeseries.azure.com.

Um parâmetro de ID do ambiente de exemplo é ?environmentId=10000000-0000-0000-0000-100000000108.

Hora

Você pode especificar valores de tempo relativos ou absolutos com uma URL parametrizada.

Valores de tempo absolutos

Para valores de tempo absolutos, use os parâmetros from=<integer> e to=<integer>.

from=<integer> é um valor em milissegundos de JavaScript da hora de início para o alcance de pesquisa.
to=<integer> é um valor em milissegundos de JavaScript da hora de término para o alcance de pesquisa.

Dica

Para converter datas facilmente em milissegundos do JavaScript, experimente o Epoch & Unix Timestamp Converter.

Valores de tempo relativos

Para um valor de tempo relativo, use relativeMillis=<value>, em que value está em milissegundos do JavaScript do carimbo de data/hora mais recente recebido da API.

Por exemplo, &relativeMillis=3600000 exibe os 60 minutos mais recentes dos dados.

Os valores aceitos correspondem ao menu de tempo rápido do Gerenciador do Azure Time Series Insights e incluem:

1800000 (Últimos 30 minutos)
3600000 (Últimos 60 minutos)
10800000 (Últimas 3 horas)
21600000 (Últimas 6 horas)
43200000 (Últimas 12 horas)
86400000 (Últimas 24 horas)
604800000 (Últimos 7 dias)
2592000000 (Últimas 30 horas)

Parâmetros opcionais

O parâmetro timeSeriesDefinitions=<collection of term objects> especifica os termos de predicado que aparecerão em uma exibição do Azure Time Series Insights:

Parâmetro	Item da URL	Descrição
name	`\<string>`	O nome do termo.
splitBy	`\<string>`	O nome da coluna para dividido por.
measureName	`\<string>`	O nome da coluna de medida.
predicate	`\<string>`	O cláusula where para filtragem do lado do servidor.
useSum	`true`	Um parâmetro opcional que especifica o uso de soma para a medida.

Observação

Se Events for a medida useSum selecionada, a contagem será selecionada por padrão. Se Events não estiver selecionado, a média será selecionada por padrão. |

O par chave-valor multiChartStack=<true/false> habilita o empilhamento no gráfico.
O par chave-valor multiChartSameScale=<true/false> habilita a mesma escala do eixo Y entre os termos dentro de um parâmetro opcional.
O timeBucketUnit=<Unit>&timeBucketSize=<integer> permite que você ajuste o controle deslizante de intervalo para fornecer uma exibição mais granular ou mais uniforme e agregada do gráfico.
O parâmetro timezoneOffset=<integer> permite definir a exibição do fuso horário no gráfico, como uma contrapartida ao UTC.

Par(es)	Descrição
`multiChartStack=false`	`true` é habilitado por padrão, portanto, passe `false` para a pilha.
`multiChartStack=false&multiChartSameScale=true`	O empilhamento deve estar habilitado para usar a mesma escala de eixo Y entre os termos. Ele é `false` por padrão, portanto, passar `true` habilitará essa funcionalidade.
`timeBucketUnit=<Unit>&timeBucketSize=<integer>`	Unidades = `days`, `hours`, `minutes`, `seconds`, `milliseconds`. Sempre colocar em maiuscula a unidade. Defina o número de unidades passando o inteiro desejado para timeBucketSize.
`timezoneOffset=-<integer>`	O inteiro é sempre em milissegundos.

Observação

Os valores de timeBucketUnit podem ser uniformizados para até sete dias. Os valores de timezoneOffset não estão em UTC nem no horário local.

Exemplos

Para adicionar definições de série temporal a um ambiente do Azure Time Series Insights como um parâmetro de URL, anexe:

&timeSeriesDefinitions=[{"name":"F1PressureId","splitBy":"Id","measureName":"Pressure","predicate":"'Factory1'"},{"name":"F2TempStation","splitBy":"Station","measureName":"Temperature","predicate":"'Factory2'"},
{"name":"F3VibrationPL","splitBy":"ProductionLine","measureName":"Vibration","predicate":"'Factory3'"}]

Use as definições de série temporal de exemplo para:

A ID do ambiente
Os últimos 60 minutos de dados
Os termos (F1PressureID, F2TempStation e F3VibrationPL) que incluem os parâmetros opcionais

Você pode construir a seguinte URL parametrizada para uma exibição:

https://insights.timeseries.azure.com/classic/samples?environmentId=10000000-0000-0000-0000-100000000108&relativeMillis=3600000&timeSeriesDefinitions=[{"name":"F1PressureId","splitBy":"Id","measureName":"Pressure","predicate":"'Factory1'"},{"name":"F2TempStation","splitBy":"Station","measureName":"Temperature","predicate":"'Factory2'"},{"name":"F3VibrationPL","splitBy":"ProductionLine","measureName":"Vibration","predicate":"'Factory3'"}]