Delen via


Een aangepaste weergave delen via een geparameteriseerde URL

Notitie

De Time Series Insights-service wordt op 7 juli 2024 buiten gebruik gesteld. Overweeg om bestaande omgevingen zo snel mogelijk naar alternatieve oplossingen te migreren. Raadpleeg onze documentatie voor meer informatie over de afschaffing en migratie.

Als u een aangepaste weergave wilt delen in Azure Time Series Insights Explorer, kunt u programmatisch een geparameteriseerde URL van de aangepaste weergave maken.

Azure Time Series Insights Explorer ondersteunt URL-queryparameters om weergaven in de ervaring rechtstreeks vanuit de URL op te geven. U kunt bijvoorbeeld via de URL een doelomgeving, een zoekpredicaat en de gewenste tijdspanne opgeven. Wanneer een gebruiker de aangepaste URL selecteert, biedt de interface een rechtstreekse koppeling naar die asset in de Azure Time Series Insights-portal. Beleid voor gegevenstoegang wordt toegepast.

Tip

Omgevings-id

De parameter environmentId=<guid> geeft de id van de doelomgeving op. Het is een onderdeel van de FQDN voor gegevenstoegang en u vindt deze in de rechterbovenhoek van het omgevingsoverzicht in Azure Portal. Het is alles wat voorafgaat env.timeseries.azure.com.

Een voorbeeld van de parameter voor omgevings-id is ?environmentId=10000000-0000-0000-0000-100000000108.

Tijd

U kunt absolute of relatieve tijdwaarden opgeven met een geparameteriseerde URL.

Absolute tijdwaarden

Voor absolute tijdwaarden gebruikt u de parameters from=<integer> en to=<integer>.

  • from=<integer> is een waarde in JavaScript-milliseconden voor de begintijd van de tijdspanne voor zoeken.
  • to=<integer> is een waarde in JavaScript-milliseconden voor de eindtijd van de tijdspanne voor zoeken.

Tip

Als u datums eenvoudig wilt vertalen naar JavaScript milliseconden, probeert u het Epoch & Unix Timestamp Converter.

Relatieve tijdwaarden

Gebruik relativeMillis=<value>voor een relatieve tijdwaarde, waarbij de waarde zich in JavaScript milliseconden bevindt van de meest recente tijdstempel die is ontvangen van de API.

&relativeMillis=3600000 geeft bijvoorbeeld de afgelopen 60 minuten aan gegevens weer.

Geaccepteerde waarden komen overeen met het sneltijdmenu van Azure Time Series Insights Explorer en omvatten:

  • 1800000 (Afgelopen 30 minuten)
  • 3600000 (Afgelopen 60 minuten)
  • 10800000 (Afgelopen 3 uur)
  • 21600000 (Afgelopen 6 uur)
  • 43200000 (Afgelopen 12 uur)
  • 86400000 (Afgelopen 24 uur)
  • 604800000 (Afgelopen 7 dagen)
  • 2592000000 (Afgelopen 30 uur)

Optionele parameters

Met de timeSeriesDefinitions=<collection of term objects> parameter worden predicaattermen opgegeven die worden weergegeven in een Azure Time Series Insights-weergave:

Parameter URL-item Description
name \<string> De naam van het onderdeel.
splitBy \<string> De naam van de kolom waarop moet worden gesplitst.
measureName \<string> De kolomnaam van de meting.
predikaat \<string> De where-component voor filteren aan de serverzijde.
useSum true Een optionele parameter waarmee het gebruik van som voor uw meting wordt opgegeven.

Notitie

Als Events de geselecteerde useSum-meting is, wordt het aantal standaard geselecteerd. Als Events dit niet is geselecteerd, wordt het gemiddelde standaard geselecteerd. |

  • Met multiChartStack=<true/false> het sleutel-waardepaar kunt u stapelen in de grafiek.
  • Het multiChartSameScale=<true/false> sleutel-waardepaar maakt dezelfde Y-asschaal mogelijk voor termen binnen een optionele parameter.
  • Hiermee timeBucketUnit=<Unit>&timeBucketSize=<integer> kunt u de intervalschuifregelaar aanpassen om een gedetailleerdere of vloeiendere, meer geaggregeerde weergave van de grafiek te bieden.
  • Met timezoneOffset=<integer> de parameter kunt u de tijdzone instellen waarin de grafiek moet worden weergegeven als offset naar UTC.
Paar(en) Beschrijving
multiChartStack=false true is standaard ingeschakeld, dus pass false to stack.
multiChartStack=false&multiChartSameScale=true Stapelen moet zijn ingeschakeld om dezelfde schaling van de Y-as te gebruiken voor verschillende onderdelen. Dit is false standaard zo dat deze functionaliteit wordt doorgegeven true .
timeBucketUnit=<Unit>&timeBucketSize=<integer> Eenheden = days, hours, minutes, , seconds, . milliseconds Gebruik altijd een hoofdletter voor de eenheid.
Definieer het aantal eenheden door het gewenste gehele getal voor timeBucketSize door te geven.
timezoneOffset=-<integer> Het gehele getal is altijd in milliseconden.

Notitie

timeBucketUnit-waarden kunnen tot 7 dagen worden afgevlakt. tijdzoneOffset-waarden zijn geen UTC- of lokale tijd.

Voorbeelden

Als u tijdreeksdefinities wilt toevoegen aan een Azure Time Series Insights-omgeving als URL-parameter, voegt u het volgende toe:

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

Gebruik de voorbeelddefinities voor tijdreeksen voor:

  • De omgevings-id
  • De afgelopen 60 minuten aan gegevens
  • De termen (F1PressureID, F2TempStation en F3VibrationPL) die de optionele parameters vormen

U kunt de volgende geparameteriseerde URL maken voor een weergave:

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

Geparameteriseerde URL van Azure Time Series Insights Explorer

In de bovenstaande URL wordt de geparameteriseerde weergave azure Time Series Insights Explorer beschreven en weergegeven.

  • De geparameteriseerde predicaten.

    Azure Time Series Insights Explorer geparameteriseerde predicaten.

  • De gedeelde volledige grafiekweergave.

    De gedeelde volledige grafiekweergave.

Volgende stappen