Partager des vues personnalisées avec des URL paramétrables - Azure Time Series Insights

Article
10/02/2020

Note

Le service Time Series Insights sera mis hors service le 7 juillet 2024. Envisagez de migrer des environnements existants vers d’autres solutions dès que possible. Pour plus d’informations sur la dépréciation et la migration, consultez notre documentation .

Pour partager une vue personnalisée dans l’Explorateur Azure Time Series Insights, vous pouvez créer par programme une URL paramétrable de la vue personnalisée.

Azure Time Series Insights Explorer prend en charge les paramètres de requête d’URL pour spécifier des vues dans l’expérience directement à partir de l’URL. Par exemple, en utilisant uniquement l’URL, vous pouvez spécifier un environnement cible, un prédicat de recherche et un intervalle de temps souhaité. Lorsqu’un utilisateur sélectionne l’URL personnalisée, l’interface fournit un lien directement vers cette ressource dans le portail Azure Time Series Insights. Les stratégies d’accès aux données s’appliquent.

Pourboire

Lisez la documentation de l’Explorateur Azure Time Series Insights associée.

ID d’environnement

Le paramètre environmentId=<guid> spécifie l’ID d’environnement cible. Il s’agit d’un composant du nom de domaine complet d’accès aux données, et vous pouvez le trouver dans le coin supérieur droit de la vue d’ensemble de l’environnement dans le portail Azure. C’est tout ce qui précède env.timeseries.azure.com.

Un exemple de paramètre d’ID d’environnement est ?environmentId=10000000-0000-0000-0000-100000000108.

Heure

Vous pouvez spécifier des valeurs de temps absolues ou relatives avec une URL paramétrable.

Valeurs temporelles absolues

Pour les valeurs temporelles absolues, utilisez les paramètres from=<integer> et to=<integer>.

from=<integer> est une valeur en millisecondes de JavaScript du temps de début de l'intervalle de recherche.
to=<integer>est une valeur exprimée en millisecondes JavaScript de l'heure de fin de la plage de recherche.

Pourboire

Pour traduire facilement des dates en millisecondes JavaScript, essayez l'Époque & Convertisseur d’horodatage Unix.

Valeurs temporelles relatives

Pour une valeur de temps relative, utilisez relativeMillis=<value>, où valeur est en millisecondes JavaScript à partir de l’horodatage le plus récent reçu de l’API.

Par exemple, &relativeMillis=3600000 affiche les 60 dernières minutes de données.

Les valeurs acceptées correspondent à l’Explorateur Azure Time Series Insights menu chronologie rapide et incluent :

1800000 (30 dernières minutes)
3600000 (60 dernières minutes)
10800000 (dernières 3 heures)
21600000 (dernières 6 heures)
43200000 (dernières 12 heures)
86400000 (dernières 24 heures)
604800000 (7 derniers jours)
2592000000 (dernières 30 heures)

Paramètres facultatifs

Le paramètre timeSeriesDefinitions=<collection of term objects> spécifie les termes de prédicat qui apparaîtront dans une vue Azure Time Series Insights :

Paramètre	Élément d’URL	Description
nom	`\<string>`	Le nom du terme est.
séparé par	`\<string>`	Le nom de colonne à diviser par est.
nomDeLaMesure	`\<string>`	Nom de colonne de mesure.
prédicat	`\<string>`	La où clause pour le filtrage côté serveur.
useSum	`true`	Paramètre facultatif qui spécifie l’utilisation de la somme pour votre mesure.

Note

Si Events est la mesure useSum sélectionnée, le nombre est sélectionné par défaut. Si Events n’est pas sélectionné, la moyenne est sélectionnée par défaut. |

La paire clé-valeur multiChartStack=<true/false> permet l’empilement dans le graphique.
La paire clé-valeur multiChartSameScale=<true/false> permet d'avoir la même échelle de l'axe Y parmi les termes dans un contexte facultatif.
Le timeBucketUnit=<Unit>&timeBucketSize=<integer> vous permet d’ajuster le curseur d’intervalle pour fournir une vue plus granulaire ou plus fluide et plus agrégée du graphique.
Le paramètre timezoneOffset=<integer> vous permet de définir le fuseau horaire pour la consultation du graphique, en tant que décalage par rapport à l'UTC.

Paire(s)	Description
`multiChartStack=false`	`true` est activé par défaut, donc transmettez `false` à la pile.
`multiChartStack=false&multiChartSameScale=true`	L’empilement doit être activé pour utiliser la même échelle de l’axe Y entre les termes. Il est `false` par défaut, la transmission de `true` active cette fonctionnalité.
`timeBucketUnit=<Unit>&timeBucketSize=<integer>`	Unités = `days`, `hours`, `minutes`, `seconds`, `milliseconds`. Mettre toujours en majuscule l’unité. Définir le nombre d’unités en passant l’entier souhaité pour timeBucketSize.
`timezoneOffset=-<integer>`	L’entier est toujours en millisecondes.

Remarque

valeurs de timeBucketUnit peuvent être lissées jusqu’à 7 jours. timezoneOffset valeurs ne sont ni UTC ni heure locale.

Exemples

Pour ajouter des définitions de série chronologique à un environnement Azure Time Series Insights en tant que paramètre d’URL, ajoutez :

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

Utilisez les exemples de définitions de série chronologique pour :

ID d’environnement
Les 60 dernières minutes de données
Les termes (F1PressureID, F2TempStationet F3VibrationPL) qui comprennent les paramètres facultatifs

Vous pouvez construire l’URL paramétrable suivante pour une vue :

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

L’URL ci-dessus décrit et affiche la vue paramétrable de l’Explorateur Azure Time Series Insights.

Prédicats paramétrés.
Affichage de graphique complet partagé.

Étapes suivantes

Découvrez comment interroger des données en utilisant C#.
Découvrez l’Explorateur Azure Time Series Insights.

Partage via

ID d’environnement