매개 변수가 있는 URL을 사용하여 사용자 지정 보기 공유 - Azure Time Series Insights

아티클
02/13/2024

참고 항목

TSI(Time Series Insights) 서비스는 2025년 3월 이후에 더 이상 지원되지 않습니다. 가급적 빨리 기존 TSI 환경을 대체 솔루션으로 마이그레이션하는 것이 좋습니다. 사용 중단 및 마이그레이션에 대한 자세한 내용은 설명서를 참조하세요.

Azure Time Series Insights 탐색기에서 사용자 지정 보기를 공유하려면 사용자 지정 보기의 매개 변수가 있는 URL을 프로그래밍 방식으로 만들면 됩니다.

Azure Time Series Insights 탐색기는 URL에서 바로 환경의 보기를 지정할 수 있는 URL 쿼리 매개 변수를 지원합니다. 예를 들어 URL만 사용하여 대상 환경, 검색 조건자 및 원하는 시간 범위를 지정할 수 있습니다. 사용자가 사용자 지정 URL을 선택하면 인터페이스에서 Azure Time Series Insights 포털의 해당 자산과 직접 연결되는 링크를 제공합니다. 데이터 액세스 정책이 적용됩니다.

팁

무료 Azure Time Series Insights 데모를 확인합니다.
함께 제공되는 Azure Time Series Insights 탐색기 설명서를 참조하세요.

환경 ID

environmentId=<guid> 매개 변수는 대상 환경 ID를 지정합니다. 데이터 액세스 FQDN의 구성 요소로, Azure Portal의 환경 개요 오른쪽 위에서 찾을 수 있습니다. env.timeseries.azure.com 앞에 있는 모든 것이 환경 ID입니다.

예를 들어 ?environmentId=10000000-0000-0000-0000-100000000108은 환경 ID 매개 변수입니다.

Time

매개 변수가 있는 URL을 사용하여 절대 또는 상대 시간 값을 지정할 수 있습니다.

절대 시간 값

절대 시간 값의 경우 from=<integer> 및 to=<integer> 매개 변수를 사용합니다.

from=<integer>는 검색 범위에 대한 시작 시간의 JavaScript 밀리초 값입니다.
to=<integer>는 검색 범위에 대한 종료 시간의 JavaScript 밀리초 값입니다.

팁

날짜를 JavaScript 밀리초로 쉽게 변환하려면 Epoch 및 Unix 타임스탬프 변환기를 사용해 보세요.

상대 시간 값

상대 시간 값의 경우 relativeMillis=<value>를 사용합니다. 여기서 value는 API에서 받은 가장 최근 타임스탬프의 JavaScript 밀리초입니다.

예를 들어 &relativeMillis=3600000은 최근 60분의 데이터를 표시합니다.

허용되는 값은 Azure Time Series Insights 탐색기 빠른 시간 메뉴에 해당하며 다음을 포함합니다.

1800000(지난 30분)
3600000(지난 60분)
10800000(지난 3시간)
21600000(지난 6시간)
43200000(지난 12시간)
86400000(지난 24시간)
604800000(지난 7일)
2592000000(지난 30시간)

선택적 매개 변수

timeSeriesDefinitions=<collection of term objects> 매개 변수는 Azure Time Series Insights 보기에 표시되는 조건자 조건을 지정합니다.

매개 변수	URL 항목	설명
이름	`\<string>`	조건의 이름입니다.
splitBy	`\<string>`	분할의 기준이 되는 열 이름입니다.
measureName	`\<string>`	측정값의 열 이름입니다.
predicate	`\<string>`	서버 쪽 필터링에 대한 where 절입니다.
useSum	`true`	측정값에 합계를 사용하도록 지정하는 선택적 매개 변수입니다.

참고 항목

Events가 선택한 useSum 측정값이면 기본적으로 count가 선택됩니다. Events를 선택하지 않은 경우 기본적으로 average가 선택됩니다. |

multiChartStack=<true/false> 키-값 쌍은 차트에서 누적을 사용하도록 설정합니다.
multiChartSameScale=<true/false> 키-값 쌍은 선택적 매개 변수 내의 조건에서 동일한 Y축 눈금을 사용하도록 설정합니다.
timeBucketUnit=<Unit>&timeBucketSize=<integer>를 사용하면 간격 슬라이더를 조정하여 보다 세부적이거나 부드럽고 더 집계된 차트 보기를 제공할 수 있습니다.
timezoneOffset=<integer> 매개 변수를 사용하면 차트가 표시될 표준 시간대를 UTC에 대한 오프셋으로 설정할 수 있습니다.

쌍	설명
`multiChartStack=false`	기본적으로 `true`가 사용하도록 설정되어 있으므로 스택에 `false`를 전달합니다.
`multiChartStack=false&multiChartSameScale=true`	용어 전체에서 동일한 Y-축 눈금 사용하려면 스택을 사용하도록 설정해야 합니다. 기본적으로 `false`이므로 `true`를 전달하면 이 기능을 사용할 수 있습니다.
`timeBucketUnit=<Unit>&timeBucketSize=<integer>`	단위는 `days`, `hours`, `minutes`, `seconds`, `milliseconds`입니다. 단위는 항상 대문자로 시작합니다. timeBucketSize에 대해 원하는 정수를 전달하여 단위 수를 정의합니다.
`timezoneOffset=-<integer>`	정수는 항상 밀리초 단위입니다.

참고 항목

timeBucketUnit 값을 최대 7일까지 다듬을 수 있습니다. timezoneOffset 값은 UTC 및 현지 시간이 아닙니다.

예제

Azure Time Series Insights 환경에 시계열 정의를 URL 매개 변수로 추가하려면 다음을 추가합니다.

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

다음에 대한 예제 시계열 정의를 사용합니다.

환경 ID
지난 60분 동안의 데이터
선택적 매개 변수를 구성하는 조건(F1PressureID, F2TempStation, F3VibrationPL)

보기에 대해 매개 변수가 있는 다음 URL을 생성할 수 있습니다.

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