Egyéni nézetek megosztása paraméteres URL-címekkel – Azure Time Series Elemzések

Cikk
01/10/2024

Megjegyzés:

A Time Series Elemzések (TSI) szolgáltatás 2025 márciusa után már nem támogatott. Fontolja meg a meglévő TSI-környezetek migrálását alternatív megoldásokba a lehető leghamarabb. Az elavulással és a migrálással kapcsolatos további információkért tekintse meg dokumentációnkat.

Ha egyéni nézetet szeretne megosztani az Azure Time Series Elemzések Explorerben, programozott módon létrehozhatja az egyéni nézet paraméteres URL-címét.

Az Azure Time Series Elemzések Explorer támogatja az URL-lekérdezési paramétereket, hogy közvetlenül az URL-címről adjon meg nézeteket a felhasználói felületen. Például kizárólag az URL-cím használatával adhatja meg a célkörnyezetet, a keresési predikátumot és a kívánt időtartományt is. Amikor egy felhasználó kiválasztja a testreszabott URL-címet, a felület közvetlenül az adott objektumra mutató hivatkozást biztosít az Azure Time Series Elemzések portálon. Adathozzáférési szabályzatok érvényesek.

Tipp.

Tekintse meg az ingyenes Azure Time Series Elemzések bemutatót.
Olvassa el az Azure Time Series Elemzések Explorer dokumentációját.

Környezet azonosítója

A célkörnyezet azonosítóját az environmentId=<guid> paraméter adja meg. Ez az adathozzáférési teljes tartománynév egyik összetevője, és az Azure Portalon a környezet jobb felső sarkában található. Ez minden, ami megelőzi env.timeseries.azure.com.

Példa környezetazonosító paraméterre: ?environmentId=10000000-0000-0000-0000-100000000108.

Idő

Paraméteres URL-cím esetében abszolút vagy relatív időértékeket is megadhat.

Abszolút időértékek

Abszolút időértékek megadásához használja a következő paramétereket: from=<integer> és to=<integer>.

A from=<integer> egy olyan érték, amely JavaScript-ezredmásodpercben adja meg a keresés kezdési időpontját.
A to=<integer> egy olyan érték, amely JavaScript-ezredmásodpercben adja meg a keresés befejezési időpontját.

Tipp.

A dátumok JavaScript-ezredmásodpercre való egyszerű lefordításához próbálja ki az Epoch & Unix Időbélyeg konvertert.

Relatív időértékek

Relatív időérték esetén használja relativeMillis=<value> a JavaScript-ezredmásodpercben az API-tól kapott legutóbbi időbélyeget.

A &relativeMillis=3600000 például a legutóbbi 60 perc adatait jeleníti meg.

Az elfogadott értékek az Azure Time Series Elemzések Explorer gyorsidő menüjének felelnek meg, és tartalmazzák a következőket:

1800000 (Utolsó 30 perc)
3600000 (Utolsó 60 perc)
10800000 (Az elmúlt 3 órában)
21600000 (Az elmúlt 6 órában)
43200000 (Az elmúlt 12 órában)
86400000 (Az elmúlt 24 órában)
604800000 (Az elmúlt 7 napban)
2592000000 (Az elmúlt 30 órában)

Választható paraméterek

A timeSeriesDefinitions=<collection of term objects> paraméter az Azure Time Series Elemzések nézetben megjelenő predikátumkifejezéseket adja meg:

Paraméter	URL-címelem	Leírás
név	`\<string>`	A kifejezés neve.
splitBy	`\<string>`	A felosztás alapjául szolgáló oszlop neve.
measureName	`\<string>`	A mérték oszlopneve.
Predikátum	`\<string>`	A kiszolgálóoldali szűrés where záradéka.
useSum	`true`	Nem kötelező paraméter, amely a mérték összegének használatát határozza meg.

Megjegyzés:

Ha Events a kiválasztott useSum mérték, a darabszám alapértelmezés szerint ki van jelölve. Ha Events nincs kiválasztva, alapértelmezés szerint az átlag van kiválasztva. |

A multiChartStack=<true/false> kulcs-érték pár lehetővé teszi a halmozást a diagramon.
A multiChartSameScale=<true/false> kulcs-érték pár lehetővé teszi ugyanazt az Y tengely skálázását a feltételek között egy opcionális paraméteren belül.
Ez timeBucketUnit=<Unit>&timeBucketSize=<integer> lehetővé teszi az intervallumcsúszka beállítását, hogy részletesebb vagy simább, összesítettebb nézetet biztosítson a diagramról.
A timezoneOffset=<integer> paraméterrel beállíthatja, hogy a diagram időzónája utc-eltolásként legyen megadva.

Pár(ok)	Leírás
`multiChartStack=false`	`true` alapértelmezés szerint engedélyezve van, ezért adja át `false` a veremnek.
`multiChartStack=false&multiChartSameScale=true`	A rétegezést engedélyeznie kell az azonos Y tengely irányú skálázás több feltételben való használatához. Ez alapértelmezés szerint így `false` a továbbítás `true` lehetővé teszi ezt a funkciót.
`timeBucketUnit=<Unit>&timeBucketSize=<integer>`	Egységek = `days`, `hours`, `minutes`, `secondsmilliseconds`. Az egység nevét mindig nagybetűvel írja. Adja meg az egységek számát a timeBucketSize kívánt egész számának átadásával.
`timezoneOffset=-<integer>`	Az egész számot mindig ezredmásodpercben kell megadnia.

Megjegyzés:

A timeBucketUnit értékek legfeljebb 7 napig simíthatók. A timezoneOffset értékek sem UTC, sem helyi idő.

Példák

Ha url-paraméterként szeretne idősordefiníciókat hozzáadni egy Azure Time Series Elemzések környezethez, fűzze hozzá a következőt:

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

Használja a példa idősor-definíciókat a következőhöz:

A környezet azonosítója
Az utolsó 60 percnyi adat
Az opcionális paramétereket tartalmazó kifejezések (F1PressureID, F2TempStation és F3VibrationPL)

A nézethez a következő paraméteres URL-címet állíthatja össze:

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