Metriche del sottosistema Trasferimento file
Le metriche di monitoraggio del trasferimento file sono state aggiornate come descritto di seguito. Le metriche riportate di seguito si trovano nel sottosistema Trasferimento file nell'endpoint /Metrics e sono disponibili dopo l'avvio del trasferimento di file.
Le metriche precedenti non avevano etichette, pertanto era necessario un numero maggiore di metriche per conoscere lo stato e i dettagli. Con le nuove metriche, gli utenti possono configurare le etichette in base alle esigenze e ottenere tutti i dettagli delle operazioni utilizzando un'unica metrica. Ogni metrica presenta etichette configurabili, che categorizzano le operazioni in base alle relative proprietà. Ad esempio: repository di destinazione, repository di origine e stato. Le etichette riportate di seguito sono disponibili per tutti gli endpoint.
• LABEL_KEY: definisce la categoria. Ad esempio, target, source, state.
• LABEL_DESCRIPTION: descrive lo scopo dell'etichetta.
• LABEL_VALUE_TYPE: definisce il tipo di valore consentito. Ad esempio, string.
• LABEL_VALUES: specifica i valori validi per l'etichetta.
• CATCH-ALL : fornisce i valori di fallback per gli input non riconosciuti.
|
Metriche precedenti
|
Nuove metriche
|
Descrizione
|
|---|---|---|
|
• uploadFailedTransfers
• uploadStartedTransfers
• uploadCompletedTransfers
• uploadCancelledTransfers
|
thingworx_file_transfer_upload_total
|
Questa metrica acquisisce le operazioni di caricamento dei file.
Al momento della definizione, i filtri inclusi saranno Target e State.
|
|
• downloadCompletedTransfers
• downloadCancelledTransfers
• downloadFailedTransfers
• downloadStartedTransfers
|
thingworx_file_transfer_download_total
|
Questa metrica acquisisce le operazioni di download dei file.
Al momento della definizione, i filtri inclusi saranno Source e State.
|
|
• acrossRepoStartedTransfers
• acrossRepoCancelledTransfers
• acrossRepoFailedTransfers
• acrossRepoCompletedTransfers
|
thingworx_file_transfer_acrossrepo_total
|
Questa metrica acquisisce il trasferimento di file tra i repository.
Al momento della definizione, i filtri inclusi saranno Source, Target e State.
|
Per configurare le etichette, utilizzare il servizio ConfigureMetricsAttributeFiltering nel sottosistema Piattaforma.
Ad esempio, durante il caricamento, metricName deve essere thingworx_file_transfer_upload e metricAttributesValueBasedFilterConfig. La struttura JSON può essere la seguente:
{
"labelConfig": [
{
"LABEL_NAME": "target",
"ALLOWED_VALUES": [
"SystemRepository",
"SupportRepository"
],
"DEFAULT_VALUE": "otherrepository"
}
]
}
"labelConfig": [
{
"LABEL_NAME": "target",
"ALLOWED_VALUES": [
"SystemRepository",
"SupportRepository"
],
"DEFAULT_VALUE": "otherrepository"
}
]
}
In questo caso, se i file vengono trasferiti da repository diversi da quelli presenti in ALLOWED_VALUES, il valore della destinazione sarà otherrepository. Lo stesso comportamento può essere osservato per le operazioni di download e copia con le rispettive etichette. È possibile aggiungere più configurazioni di etichette in labelConfig, separate da virgola (,).
Disattivazione delle metriche precedenti
Per la nuova installazione di ThingWorx Platform 9.7.x sono disponibili solo le nuove metriche. Per gli utenti che eseguono l'aggiornamento da ThingWorx Platform 9.6.x a ThingWorx Platform 9.7.x, sono disponibili le metriche precedenti. PTC consiglia vivamente agli utenti che hanno effettuato l'upgrade di utilizzare le nuove metriche.
Per una nuova installazione
Durante l'utilizzo del programma di installazione, le metriche di trasferimento file precedenti non sono disponibili in /GetPerformanceMetrics e nell'endpoint /Metrics. Sono disponibili solo le nuove metriche di trasferimento file.
Per l'aggiornamento
Durante l'utilizzo del programma di installazione, sono disponibili le metriche di trasferimento file precedenti e quelle nuove.
 |
Al momento dell'aggiornamento, è possibile disattivare le metriche precedenti modificando l'elenco delle metriche di disattivazione. Utilizzare DisabledMetricsList nel file platform-settings.json per disattivare le metriche. Per ulteriori informazioni, vedere Opzione per disattivare le metriche e Dettagli di configurazione di platform-settings.jsons.
|
Migrazione
Dopo la migrazione, le metriche di trasferimento file precedenti non sono disponibili. Sono disponibili solo le nuove metriche di trasferimento file.
Metriche degli istogrammi
Per conoscere la dimensione e la durata del trasferimento dei file, è possibile utilizzare le metriche degli istogrammi riportate di seguito.
Queste metriche sono disponibili nel sottosistema Trasferimento file nell'endpoint /Metrics solo dopo il completamento dell'operazione di trasferimento file.
|
Metrica
|
Descrizione
|
|---|---|
|
thingworx_file_transfer_size_bytes
|
Questa metrica indica la dimensione totale del file che viene trasferito.
A questa metrica è associata l'etichetta operation. I valori possono essere UPLOAD, DOWNLOAD e ACROSSREPO, a seconda del tipo di operazione eseguita.
Questa metrica presenta l'insieme di default di bucket - <1 KB, 10 KB, 100 KB, 1 M, 10 M, 100 M, 1 G >1 G
|
|
thingworx_file_transfer_duration_ms
|
Questa metrica mostrerà la durata del trasferimento del file.
A questa metrica è associata l'etichetta operation. I valori possono essere UPLOAD, DOWNLOAD e ACROSSREPO, a seconda del tipo di operazione eseguita.
Questa metrica presenta l'insieme di default di bucket - 100 ms, 1 s, 10 s, 100 s, 1000 s, >1000 s
|
I bucket dell'istogramma sono incrementali nel modo seguente:
• Per l'istogramma del tempo di trasferimento file - Se il trasferimento impiega più di 100 ms e un tempo inferiore o pari a 1 secondo, rientrerà nel bucket di 1 secondo e negli altri bucket corrispondenti.
• Per l'istogramma della dimensione di trasferimento file - Se la dimensione del file di trasferimento è superiore a 1 KB e inferiore o uguale a 10 KB, rientrerà nel bucket di 10 KB e negli altri bucket corrispondenti.
Per modificare le dimensioni di default dei bucket, ad esempio.per personalizzare thingworx_file_transfer_duration_ms in [200 ,2000, 20000, 200000] e thingworx_file_transfer_size_bytes in [2048, 20480, 204800, 2097152, 20971520], aggiornare quanto segue
In locale
Aggiornare il file platform-settings.json come segue.
"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]
}
}
}
Per Docker
Aggiornare i file riportati di seguito.
◦ Nel file .env aggiungere quanto segue, se non disponibile.
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]
}'
◦ Nel file docker-compose aggiungere quanto segue, se non disponibile.
HISTOGRAM_BUCKET_SIZE_LIST: ${HISTOGRAM_BUCKET_SIZE_LIST}