Compartilhar uma exibição personalizada usando uma URL parametrizada
Observação
O serviço Time Series Insights será desativado em 7 de julho de 2024. Considere migrar ambientes existentes para soluções alternativas o mais rápido 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
- 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'"}]
A URL acima descreve e mostra a exibição parametrizada do Gerenciador do Azure Time Series Insights.
Os predicados parametrizados.
A exibição de gráfico completa compartilhada.
Próximas etapas
Saiba como consultar dados usando C#.
Saiba mais sobre o Gerenciador do Azure Time Series Insights.