Compartilhar uma exibição personalizada usando uma URL parametrizada

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.

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 ao 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'"}]

URL parametrizada do Gerenciador do Azure Time Series Insights

Dica

Confira o Gerenciador em atividade usando o exemplo de URL acima.

A URL acima descreve e mostra a exibição parametrizada do Gerenciador do Azure Time Series Insights.

  • Os predicados parametrizados.

    Predicados parametrizados do Gerenciador do Azure Time Series Insights.

  • A exibição de gráfico completa compartilhada.

    A exibição de gráfico completa compartilhada.

Próximas etapas