파일 전송 하위 시스템 메트릭
아래에 설명된 대로 파일 전송 모니터링 메트릭이 업데이트됩니다. 다음 메트릭은 /Metrics 끝점 아래의 파일 전송 하위 시스템에 있으며 파일 전송을 시작한 후에 사용할 수 있습니다.
이전 메트릭에는 레이블이 없었기 때문에 상태와 세부 정보를 파악하기 위해 여러 메트릭이 필요했습니다. 새 메트릭에는 사용자가 필요에 따라 구성할 수 있는 레이블 구성이 있으며, 하나의 메트릭을 사용하여 모든 작업 세부 정보를 얻을 수 있습니다. 각 메트릭에는 해당 속성에 따라 작업을 분류하는 구성 가능 레이블이 있습니다. 예를 들어, 대상 저장소, 소스 저장소 및 상태가 있습니다. 모든 끝점에 다음 레이블을 사용할 수 있습니다.
• LABEL_KEY: 카테고리를 정의합니다. 예를 들어, target, source, state입니다.
• LABEL_DESCRIPTION: 레이블의 용도를 설명합니다.
• LABEL_VALUE_TYPE: 허용되는 값의 유형을 정의합니다. 예를 들어, string입니다.
• LABEL_VALUES: 레이블에 대한 유효한 값을 지정합니다.
• CATCH-ALL : 인식할 수 없는 입력에 대한 대체 값을 제공합니다.
|
이전 메트릭
|
새 메트릭
|
설명
|
|---|---|---|
|
• uploadFailedTransfers
• uploadStartedTransfers
• uploadCompletedTransfers
• uploadCancelledTransfers
|
thingworx_file_transfer_upload_total
|
이 메트릭은 파일 업로드 작업을 캡처합니다.
정의 시점에 포함된 필터는 Target 및 State입니다.
|
|
• downloadCompletedTransfers
• downloadCancelledTransfers
• downloadFailedTransfers
• downloadStartedTransfers
|
thingworx_file_transfer_download_total
|
이 메트릭은 파일 다운로드 작업을 캡처합니다.
정의 시점에 포함된 필터는 Source 및 State입니다.
|
|
• acrossRepoStartedTransfers
• acrossRepoCancelledTransfers
• acrossRepoFailedTransfers
• acrossRepoCompletedTransfers
|
thingworx_file_transfer_acrossrepo_total
|
이 메트릭은 저장소 간의 파일 전송을 캡처합니다.
정의 시점에 포함된 필터는 Source, Target 및 State입니다.
|
레이블을 구성하려면 플랫폼 하위 시스템에서 ConfigureMetricsAttributeFiltering 서비스를 사용합니다.
예를 들어 업로드하는 동안 metricName은 thingworx_file_transfer_upload 및 metricAttributesValueBasedFilterConfig여야 합니다. JSON은 다음과 같을 수 있습니다.
{
"labelConfig": [
{
"LABEL_NAME": "target",
"ALLOWED_VALUES": [
"SystemRepository",
"SupportRepository"
],
"DEFAULT_VALUE": "otherrepository"
}
]
}
"labelConfig": [
{
"LABEL_NAME": "target",
"ALLOWED_VALUES": [
"SystemRepository",
"SupportRepository"
],
"DEFAULT_VALUE": "otherrepository"
}
]
}
여기서 파일이 ALLOWED_VALUES의 저장소가 아닌 다른 저장소에서 전송된 경우 대상은 otherrepository를 해당 값으로 갖게 됩니다. 해당 레이블이 있는 다운로드 및 복사 작업에 대해서도 동일한 동작이 관찰될 수 있습니다. labelConfig 내부에 쉼표(,)로 구분하여 여러 레이블 구성을 추가할 수 있습니다.
이전 메트릭 비활성화
ThingWorx Platform 9.7.x를 새로 설치하는 경우 새 메트릭만 사용할 수 있습니다. ThingWorx Platform 9.6.x에서 ThingWorx Platform 9.7.x로 업그레이드하는 사용자의 경우 이전 메트릭을 사용할 수 있습니다. PTC에서는 업그레이드한 사용자에게 새 메트릭을 사용할 것을 강력히 권장합니다.
새 설치의 경우
설치 관리자를 사용하는 동안 이전 파일 전송 메트릭은 /Metrics 및 /GetPerformanceMetrics 끝점에서 사용할 수 없습니다. 새 파일 전송 메트릭만 사용할 수 있습니다.
업그레이드의 경우
설치 관리자를 사용하는 동안 이전 및 새 파일 전송 메트릭을 사용할 수 있습니다.
 |
업그레이드 시 비활성화 메트릭 목록을 변경하여 이전 메트릭을 비활성화할 수 있습니다. platform-settings.json 파일에서 DisabledMetricsList를 사용하여 메트릭을 비활성화합니다. 자세한 내용은 메트릭 비활성화 옵션 및 platform-settings.json 구성 세부 정보를 참조하십시오.
|
마이그레이션
마이그레이션 후에는 이전 파일 전송 메트릭을 사용할 수 없습니다. 새 파일 전송 메트릭만 사용할 수 있습니다.
히스토그램 메트릭
다음 히스토그램 메트릭을 사용하여 파일 전송 크기 및 파일 전송 기간을 확인할 수 있습니다.
이러한 메트릭은 파일 전송 작업이 완료된 후에만 /Metrics 끝점 아래의 파일 전송 하위 시스템에서 사용할 수 있습니다.
|
메트릭
|
설명
|
|---|---|
|
thingworx_file_transfer_size_bytes
|
이 메트릭은 전송되는 파일의 총 크기를 표시합니다.
이 메트릭에는 operation 레이블이 있습니다. 수행되는 작업의 유형에 따라 값은 UPLOAD, DOWNLOAD, ACROSSREPO가 될 수 있습니다.
이 메트릭에는 기본 버킷 집합(<1KB, 10KB, 100KB, 1M, 10M, 100M, 1G, >1G)이 있습니다.
|
|
thingworx_file_transfer_duration_ms
|
이 메트릭은 파일이 전송되는 기간을 표시합니다.
이 메트릭에는 operation 레이블이 있습니다. 수행되는 작업의 유형에 따라 값은 UPLOAD, DOWNLOAD, ACROSSREPO가 될 수 있습니다.
이 메트릭에는 기본 버킷 집합(100ms, 1s, 10s, 100s, 1000s, >1000s)이 있습니다.
|
히스토그램 버킷은 다음과 같은 방식으로 증분됩니다.
• 파일 전송 시간 히스토그램의 경우 - 전송에 시간이 100ms 이상, 1s 이하가 걸리는 경우 1s 버킷과 다른 해당 버킷으로 떨어집니다.
• 파일 전송 크기 히스토그램의 경우 - 전송에 파일 크기가 1KB 이상, 10KB 이하인 경우 10KB 버킷과 다른 해당 버킷으로 떨어집니다.
예를 들어 thingworx_file_transfer_duration_ms에서 [200 ,2000, 20000, 200000]으로, thingworx_file_transfer_size_bytes에서 [2048, 20480, 204800, 2097152, 20971520]으로 사용자 정의하기 위해 기본 버킷 크기를 변경하려면 다음을 업데이트합니다.
온프레미스의 경우
다음과 같이 platform-settings.json 파일을 업데이트합니다.
"PlatformSettingsConfig"
{
"MetricsSettings":
{
"HistogramMetricsBucketSizeList":
{
"thingworx_file_transfer_duration_ms":[200 ,2000, 20000, 200000],
"thingworx_file_transfer_size_bytes ":[2048, 20480, 204800, 2097152, 20971520]
}
}
}
{
"MetricsSettings":
{
"HistogramMetricsBucketSizeList":
{
"thingworx_file_transfer_duration_ms":[200 ,2000, 20000, 200000],
"thingworx_file_transfer_size_bytes ":[2048, 20480, 204800, 2097152, 20971520]
}
}
}
Docker의 경우
다음 파일을 업데이트합니다.
◦ 사용할 수 없는 경우 .env 파일에 다음을 추가합니다.
HISTOGRAM_BUCKET_SIZE_LIST: '
{
"thingworx_file_transfer_duration_ms":[200,2000,20000,200000],
"thingworx_file_transfer_size_bytes ":[2048,20480, 204800,2097152,20971520]
}'
{
"thingworx_file_transfer_duration_ms":[200,2000,20000,200000],
"thingworx_file_transfer_size_bytes ":[2048,20480, 204800,2097152,20971520]
}'
◦ 사용할 수 없는 경우 docker-compose 파일에 다음을 추가합니다.
HISTOGRAM_BUCKET_SIZE_LIST: ${HISTOGRAM_BUCKET_SIZE_LIST}