Partager une vue personnalisée à l’aide d’une URL paramétrable
Remarque
Le service Time Series Insights (TSI) ne sera plus pris en charge après le mois de mars 2025. Pensez à migrer dès que possible les environnements TSI existants vers d’autres solutions. 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 programmation, une URL paramétrable de la vue personnalisée.
Cet Explorateur prend en charge les paramètres de requête d’URL pour spécifier des vues dans l’expérience et ce, directement à partir de l’URL. Par exemple, en utilisant l’URL uniquement, vous pouvez spécifier un environnement cible, un prédicat de recherche et la durée désirée. Lorsqu’un utilisateur sélectionne l’URL personnalisée, l’interface fournit directement un lien vers la ressource dans le portail Azure Time Series Insights. Les stratégies d’accès aux données s’appliquent.
Conseil
- Affichez la démonstration Azure Time Series Insights gratuite.
- Lisez la documentation Explorateur Azure Time Series Insights connexe.
ID environnement
Le paramètre environmentId=<guid>
spécifie l’ID de l’environnement cible. Il s’agit d’un composant du nom de domaine complet pour l’accès aux données. Vous le trouverez dans l’angle supérieur droit de l’écran présentation de l’environnement, sur le portail Azure. Il correspond à tout ce qui précède env.timeseries.azure.com
.
Exemple de paramètre d’ID de l’environnement : ?environmentId=10000000-0000-0000-0000-100000000108
.
Temps
Vous pouvez spécifier des valeurs de temps absolues ou relatives avec une URL paramétrable.
Valeurs de temps absolues
Pour les valeurs de temps absolues, utilisez les paramètres from=<integer>
et to=<integer>
.
from=<integer>
est une valeur JavaScript, en millisecondes, qui définit l’heure de début de la période de recherche.to=<integer>
est une valeur JavaScript, en millisecondes, qui définit l’heure de fin de la période de recherche.
Conseil
Pour traduire facilement les dates en quelques millisecondes JavaScript, essayez le convertisseur d’horodatage Epoch & Unix.
Valeurs de temps relatives
Dans le cas d’une valeur de temps relative, utilisez l’élément relativeMillis=<value>
, où la valeur est exprimée en millisecondes JavaScript à partir de l’horodateur le plus récent reçu de l’API.
Par exemple, l’élément &relativeMillis=3600000
affiche les dernières 60 minutes de données.
Les valeurs acceptées correspondent au menu Quick Time de l’Explorateur Azure Time Series Insights, notamment :
1800000
(30 dernières minutes)3600000
(60 dernières minutes)10800000
(3 dernières heures)21600000
(6 dernières heures)43200000
(12 dernières heures)86400000
(24 dernières heures)604800000
(7 derniers jours)2592000000
(30 dernières heures)
Paramètres facultatifs
Le paramètre timeSeriesDefinitions=<collection of term objects>
spécifie les termes de prédicat qui s’affichent dans une vue Azure Time Series Insights :
Paramètre | Élément d’URL | Description |
---|---|---|
name | \<string> |
nom du terme ; |
splitBy | \<string> |
nom de colonne pour le fractionnement ; |
measureName | \<string> |
nom de colonne de mesure ; |
prédicat | \<string> |
clause where pour le filtrage côté serveur. |
useSum | true |
Paramètre facultatif qui spécifie l’utilisation de la somme pour la mesure. |
Remarque
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 la même échelle de l’axe des ordonnées entre les termes au sein d’un paramètre facultatif. timeBucketUnit=<Unit>&timeBucketSize=<integer>
permet d’ajuster le curseur intervalle pour générer une vue plus granulaire, plus simple, ou plus globale du graphique.- Le paramètre
timezoneOffset=<integer>
vous permet de définir le fuseau horaire pour le graphique afin qu’il s’affiche en tant qu’offset de fuseau horaire UTC.
Paire(s) | Description |
---|---|
multiChartStack=false |
true est activée par défaut donc passez sur false pour empiler. |
multiChartStack=false&multiChartSameScale=true |
L’empilement doit être activé pour pouvoir utiliser la même échelle de l’axe des ordonnées entre les termes. false est activé par défaut, donc passer sur true pour activer cette fonctionnalité. |
timeBucketUnit=<Unit>&timeBucketSize=<integer> |
Unités = days , hours , minutes , seconds , milliseconds . Mettez toujours les unités en majuscules. Définissez le nombre d’unités en passant l’entier souhaité pour timeBucketSize. |
timezoneOffset=-<integer> |
L’entier est toujours en millisecondes. |
Remarque
Les valeurs timeBucketUnit peuvent être lissées jusqu’à 7 jours. Les valeurs timezoneOffset ne sont ni UTC ni heure locale.
Exemples
Pour ajouter des définitions de série chronologique dans un environnement Azure Time Series Insights en tant que paramètre 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 ces exemples de définitions de série chronologique pour :
- l’ID de l’environnement,
- les 60 dernières minutes de données,
- les termes (F1PressureID, F2TempStation et F3VibrationPL) qui composent des 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'"}]
Conseil
Voir l’Explorateur live à l’aide de l’URL ci-dessus.
L’URL ci-dessus décrit et affiche la vue paramétrée de l’Explorateur Azure Time Series Insights.
Étapes suivantes
Découvrez comment interroger des données avec C#.
En savoir plus sur l’Explorateur Azure Time Series Insights.