Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Aktifkan deteksi anomali pada sensor di seluruh aset
<a name="anom-detection-sensors-across-asset"></a>

## Buat model komputasi ()AWS CLI
<a name="create-computation-model-across-assets"></a>

Untuk membuat model komputasi, gunakan AWS Command Line Interface ()AWS CLI. Setelah Anda menentukan model komputasi, latih model dan jadwal inferensi untuk melakukan deteksi anomali di seluruh aset di. AWS IoT SiteWise

Langkah-langkah berikut menjelaskan proses ini:

1. Untuk mengatur deteksi anomali, gunakan [UpdateAssetModel(AWS CLI)](https://docs.aws.amazon.com/cli/latest/reference/iotsitewise/update-asset-model.html), dan penuhi persyaratan berikut:

   1. Setidaknya satu properti input yang merupakan salah satu `DOUBLE` atau tipe `INTEGER` data. Ini adalah properti pengukuran atau transformasi, dan digunakan untuk melatih model.

   1. Properti hasil dari tipe `STRING` data. Ini harus menjadi properti pengukuran, dan menyimpan hasil deteksi anomali.

1. Buat file `anomaly-detection-computation-model-payload.json` dengan konten berikut:
**catatan**  
Buat model komputasi dengan langsung menyediakan `assetProperty` sebagai sumber data.

   ```
   {
       "computationModelName": "name of ComputationModel",
       "computationModelConfiguration": {
           "anomalyDetection": {
               "inputProperties": "${properties}",
               "resultProperty": "${p3}"
           }
       },
       "computationModelDataBinding": {
           "properties": {
               "list": [
                   {
                       "assetProperty": { 
                           "assetId": "asset-id",
                           "propertyId": "input-property-id-1"
                       }
                   },
                   {
                       "assetProperty": { 
                           "assetId": "asset-id",
                           "propertyId": "input-property-id-2"
                       }
                   }
               ]
           },
           "p3": {
               "assetProperty": { 
                   "assetId": "asset-id",
                   "propertyId": "results-property-id"
               }
           }
       }
   }
   ```

1. Jalankan perintah berikut untuk membuat model komputasi:

   ```
   aws iotsitewise create-computation-model \
       --cli-input-json file://anomaly-detection-computation-model-payload.json
   ```

## ExecuteAction Persiapan muatan API
<a name="create-action-payload-across-assets"></a>

 Langkah selanjutnya untuk menjalankan pelatihan dan inferensi dilakukan dengan [ExecuteAction](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ExecuteAction.html)API. Baik pelatihan dan inferensi dikonfigurasi dengan konfigurasi muatan tindakan JSON. Saat menjalankan [ExecuteAction](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ExecuteAction.html)API, muatan tindakan harus diberikan sebagai nilai dengan `stringValue` muatan. 

 Muatan harus benar-benar mematuhi persyaratan API. Secara khusus, nilainya harus berupa **string datar** tanpa **karakter kontrol** (misalnya, baris baru, tab, atau pengembalian carriage). Opsi berikut menyediakan dua cara andal untuk memasok muatan tindakan yang valid. 

### Opsi 1: Gunakan file payload bersih
<a name="clean-payload-file-across-assets"></a>

Prosedur berikut menjelaskan langkah-langkah untuk file payload bersih:

1. Bersihkan file untuk menghapus karakter kontrol.

   ```
   tr -d '\n\r\t' < original-action-payload.json > training-or-inference-action-payload.json
   ```

1. Jalankan tindakan dengan file`@=file://...`.

   ```
   aws iotsitewise execute-action \
       --target-resource computationModelId=<MODEL_ID> \
       --action-definition-id <ACTION_DEFINITION_ID> \
       --action-payload stringValue@=file://training-or-inference-action-payload.json
   ```

### Opsi 2: String sebaris dengan tanda kutip lolos
<a name="inline-string-quotes-across-assets"></a>

Langkah-langkah berikut menjelaskan langkah-langkah untuk memasok payload inline, dan menghindari file perantara:
+ Gunakan tanda kutip ganda yang lolos (`\"`) di dalam string JSON.
+ Bungkus seluruh `StringValue=..` ekspresi dalam tanda kutip ganda.

**Example dari muatan tindakan yang lolos:**  

```
aws iotsitewise execute-action \
    --target-resource computationModelId=<MODEL_ID> \
    --action-definition-id <ACTION_DEFINITION_ID> \
    --action-payload "stringValue={\"exportDataStartTime\":1717225200,\"exportDataEndTime\":1722789360,\"targetSamplingRate\":\"PT1M\"}"
```

## Latih model (AWS CLI)
<a name="start-training-cli-across-assets"></a>

1. Jalankan perintah berikut untuk menemukan `AWS/ANOMALY_DETECTION_TRAINING` tindakan. `actionDefinitionId` Ganti `computation-model-id` dengan ID yang dikembalikan pada langkah sebelumnya.

   ```
   aws iotsitewise describe-computation-model \
       --computation-model-id computation-model-id
   ```

1. Buat file bernama `anomaly-detection-training-payload.json` dan tambahkan nilai-nilai berikut:
**catatan**  
 Muatan harus sesuai dengan. [Opsi 1: Gunakan file payload bersih](#clean-payload-file-across-assets) 

   1. `StartTime`dengan dimulainya data pelatihan, disediakan dalam hitungan detik.

   1. `EndTime`dengan berakhirnya data pelatihan, disediakan dalam hitungan detik.

   1. Anda dapat mengonfigurasi [Konfigurasi inferensi lanjutan](advanced-inference-configurations.md) secara opsional.

      1. (Opsional) `TargetSamplingRate` dengan laju pengambilan sampel data.

      1. (Opsional) `LabelInputConfiguration` untuk menentukan periode waktu ketika perilaku anomali terjadi untuk pelatihan model yang ditingkatkan.

      1. (Opsional) `ModelEvaluationConfiguration` untuk mengevaluasi kinerja model dengan menjalankan inferensi pada rentang waktu tertentu setelah pelatihan selesai.

   ```
   {
     "exportDataStartTime": StartTime,
     "exportDataEndTime": EndTime
   }
   ```  
**Example dari contoh muatan pelatihan:**  

   ```
   {
     "exportDataStartTime": 1717225200,
     "exportDataEndTime": 1722789360
   }
   ```

1. Jalankan perintah berikut untuk memulai pelatihan (tanpa menyediakan aset sebagai sumber daya target). Ganti parameter berikut dalam perintah:

   ```
   aws iotsitewise execute-action \
       --target-resource computationModelId=computation-model-id \
       --action-definition-id training-action-definition-id \
       --action-payload stringValue@=file://anomaly-detection-training-payload.json
   ```

1. Jalankan perintah berikut untuk memeriksa status proses pelatihan model. Ringkasan eksekusi terbaru menunjukkan status eksekusi (`RUNNING`/`COMPLETED`/`FAILED`).

   ```
   aws iotsitewise list-executions \
       --target-resource-type COMPUTATION_MODEL \
       --target-resource-id computation-model-id
   ```

1. Jalankan perintah berikut untuk memeriksa konfigurasi model terlatih terbaru. Perintah ini menghasilkan output hanya jika setidaknya satu model telah menyelesaikan pelatihan dengan sukses.

   ```
   aws iotsitewise describe-computation-model-execution-summary \
       --computation-model-id computation-model-id
   ```

## Mulai dan hentikan pelatihan ulang model ()AWS CLI
<a name="start-stop-retraining-cli-model"></a>

 Setelah pelatihan model awal, Anda dapat mengonfigurasi pelatihan ulang otomatis untuk mengatasi penyimpangan data dan mempertahankan akurasi model dari waktu ke waktu. Penjadwal pelatihan ulang memungkinkan Anda mengatur pembaruan model berkala dengan mode promosi yang dapat dikonfigurasi. 

### Mulai pelatihan ulang penjadwal
<a name="start-retraining-scheduler-model"></a>

1. Siapkan muatan yang sama seperti yang disebutkan di[Mulai pelatihan ulang penjadwal](anom-detection-sensors-asset.md#start-retraining-scheduler).

1. Jalankan tindakan pelatihan (tanpa menyediakan aset sebagai sumber daya target). Ganti parameter berikut dalam perintah:

   1. `computation-model-id`dengan ID model komputasi target.

   1. `training-action-definition-id`dengan ID `AWS/ANOMALY_DETECTION_TRAINING` tindakan.

   ```
   aws iotsitewise execute-action \
       --target-resource computationModelId=computation-model-id \
       --action-definition-id training-action-definition-id \
       --action-payload stringValue@=file://anomaly-detection-start-retraining-payload.json
   ```

1. Jalankan perintah berikut untuk memeriksa status proses penjadwal pelatihan ulang mulai. Ringkasan eksekusi terbaru menunjukkan status eksekusi (`RUNNING`/`COMPLETED`/`FAILED`).

   ```
   aws iotsitewise list-executions \
       --target-resource-type COMPUTATION_MODEL \
       --target-resource-id computation-model-id
   ```

### Hentikan penjadwal pelatihan ulang
<a name="stop-retraining-scheduler-model"></a>

1. Siapkan muatan yang sama seperti yang disebutkan di[Hentikan penjadwal pelatihan ulang](anom-detection-sensors-asset.md#stop-retraining-scheduler).

1. Jalankan tindakan pelatihan (tanpa menyediakan aset sebagai sumber daya target). Ganti parameter berikut dalam perintah:

   1. `computation-model-id`dengan ID model komputasi target.

   1. `training-action-definition-id`dengan ID `AWS/ANOMALY_DETECTION_TRAINING` tindakan.

   ```
   aws iotsitewise execute-action \
       --target-resource computationModelId=computation-model-id \
       --action-definition-id training-action-definition-id \
       --action-payload stringValue@=file://anomaly-detection-stop-retraining-payload.json
   ```

1. Jalankan perintah berikut untuk memeriksa status proses penjadwal berhenti pelatihan ulang. Ringkasan eksekusi terbaru menunjukkan status eksekusi (`RUNNING`/`COMPLETED`/`FAILED`).

   ```
   aws iotsitewise list-executions \
       --target-resource-type COMPUTATION_MODEL \
       --target-resource-id computation-model-id
   ```

## Mulai dan hentikan inferensi ()AWS CLI
<a name="start-stop-inference-across-assets"></a>

Setelah melatih model, mulailah inferensi, yang menginstruksikan AWS IoT SiteWise untuk mulai memantau aset industri Anda untuk anomali.

### Mulai inferensi
<a name="start-inference-across-assets"></a>

1. Jalankan perintah berikut untuk menemukan `AWS/ANOMALY_DETECTION_INFERENCE` tindakan. `actionDefinitionId` Ganti `computation-model-id` dengan ID sebenarnya dari model komputasi yang dibuat sebelumnya.

   ```
   aws iotsitewise describe-computation-model \
       --computation-model-id computation-model-id
   ```

1. Buat file `anomaly-detection-start-inference-payload.json` dan tambahkan kode berikut. Ganti parameter berikut seperti yang dijelaskan:
**catatan**  
 Muatan harus sesuai dengan. [Opsi 1: Gunakan file payload bersih](#clean-payload-file-across-assets) 

   1. `DataUploadFrequency`: Konfigurasikan frekuensi di mana jadwal inferensi berjalan untuk melakukan deteksi anomali. Nilai yang diizinkan adalah:`PT5M, PT10M, PT15M, PT30M, PT1H, PT2H..PT12H, PT1D`.

      ```
      "inferenceMode": "START",
      "dataUploadFrequency": "DataUploadFrequency"
      ```

   1. (Opsional) `DataDelayOffsetInMinutes` dengan offset penundaan dalam hitungan menit. Tetapkan nilai ini antara 0 dan 60 menit.

   1. (Opsional) `TargetModelVersion` dengan versi model untuk mengaktifkan.

   1. (Opsional) Konfigurasikan `weeklyOperatingWindow` dengan konfigurasi shift.

   1. Anda dapat mengonfigurasi [Konfigurasi inferensi lanjutan](advanced-inference-configurations.md) secara opsional.

      1. [Inferensi frekuensi tinggi (5 menit - 1 jam)](advanced-inference-configurations.md#high-frequency-inferencing).

      1. [Inferensi frekuensi rendah (2 jam — 1 hari)](advanced-inference-configurations.md#low-frequency-inferencing).

      1. [Penjadwalan yang fleksibel](advanced-inference-configurations.md#flexible-scheduling).

1. Jalankan perintah berikut untuk memulai inferensi. Ganti parameter berikut dalam file payload.

   1. `computation-model-id`dengan ID model komputasi target.

   1. `inference-action-definition-id`dengan ID `AWS/ANOMALY_DETECTION_INFERENCE` tindakan dari Langkah 1.

   ```
   aws iotsitewise execute-action \
       --target-resource computationModelId=computation-model-id \
       --action-definition-id inference-action-definition-id \
       --action-payload stringValue@=file://anomaly-detection-inference-payload.json
   ```

1. Jalankan perintah berikut untuk memeriksa apakah inferensi masih berjalan. `inferenceTimerActive`Bidang diatur ke `TRUE` saat inferensi aktif.

   ```
   aws iotsitewise describe-computation-model-execution-summary \
       --computation-model-id computation-model-id
   ```

1. Perintah berikut mencantumkan semua eksekusi inferensi:

   ```
   aws iotsitewise list-executions \
       --target-resource-type COMPUTATION_MODEL \
       --target-resource-id computation-model-id
   ```

1. Jalankan perintah berikut untuk menggambarkan eksekusi individu. Ganti `execution-id` dengan id dari Langkah 5 sebelumnya.

   ```
   aws iotsitewise describe-execution \
       --execution-id execution-id
   ```

### Hentikan inferensi
<a name="stop-inference-across-assets"></a>

1. Jalankan perintah berikut untuk menemukan `AWS/ANOMALY_DETECTION_INFERENCE` tindakan. `actionDefinitionId` Ganti `computation-model-id` dengan ID sebenarnya dari model komputasi yang dibuat sebelumnya.

   ```
   aws iotsitewise describe-computation-model \
       --computation-model-id computation-model-id
   ```

1. Buat file `anomaly-detection-stop-inference-payload.json` dan tambahkan kode berikut.

   ```
   {
       "inferenceMode": "STOP"
   }
   ```
**catatan**  
 Muatan harus sesuai dengan. [Opsi 1: Gunakan file payload bersih](anom-detection-sensors-asset.md#clean-payload-file) 

1. Jalankan perintah berikut untuk menghentikan inferensi. Ganti parameter berikut dalam file payload:

   1. `computation-model-id`dengan ID model komputasi target.

   1. `inference-action-definition-id`dengan ID `AWS/ANOMALY_DETECTION_INFERENCE` tindakan dari Langkah 1.  
**Example dari perintah stop inferensi:**  

   ```
   aws iotsitewise execute-action \
   --target-resource computationModelId=computation-model-id \
   --action-definition-id inference-action-definition-id \
   --action-payload stringValue@=file://anomaly-detection-stop-inference-payload.json
   ```